Subroutines > Detailed Descriptions

ISMROK

Updated August 2008

xcall ISMROK, ch, ida'alc, ida'avl, recsiz, keysiz, keypos, devdrv, idx'alc, idx'avl, ida'nxt, idx'nxt

ISMROK.SBR reads the “rock” of the traditional ISAM file open under channel ch and returns the requested parameters (all of which are optional and can be specified using any numeric data types). It will be left as an exercise to the reader to determine the usage of the above parameters (hint: check out ISMUTL.LIT).

Update Note

In A-Shell 5.1.1122.0 of 4 August 2008, A-Shell's ISAM underwent some major surgery for performance enhancement. As part of that project, ISMROK.SBR was given three new optional parameters, making the new syntax:

xcall ISMROK, ch, idaalc, idaavl{, recsiz, keysiz, keypos, devdrv, idxalc, idxavl, idanxt, idxnxt, idx'lvls, idx'blk'siz, idx'type}

idx'lvls  (Num)  [out]

returns the number of levels in the IDX

idx'blk'siz  (Num)  [out]

returns the IDX block size

idx'type  (Num)  [out]

returns a bitmap field indicating the index type:

Value

Description

&h0002

secondary index

&h0800

A-Shell extensions; requires A-Shell version 5.1.1122 or later