SETL (Set Limits) Macro

Format

Requirements for the caller

AMODE:

24

RMODE:

24

ASC Mode:

Primary

Parameters

filename | (r1)

Specifies the same name as that used in the DTFIS header entry, as a symbol or in register notation. Register notation is necessary if your program is to be self-relocating.

id-name | (r2)

Specifies that processing is by record ID. The operand specifies the symbolic name of the 8-byte field in which you supply the starting (or lowest) reference for ISAM use. This field contains the information that is shown in Table 1.

KEY

Specifies that processing begins with a key you supply. The key is supplied in the field that is specified by the DTFIS KEYARG operand. If the specified key is not present in the file, an indication is given at filenameC.

BOF

Specifies that retrieval is to start at the beginning of the logical file.

GKEY

Indicates that selected groups of records within a file that contains identical characters or data in the first locations of each key can be selected. GKEY allows processing to begin at the first record (or key) within the wanted group.

You must supply a key that identifies the significant (high order) bytes of the required group of keys. The remainder (or insignificant) bytes of the key must be padded with blanks, binary zeros, or bytes lower in collating sequence than any of the insignificant bytes in the first key of the group to be processed. For example, a GKEY specification of D6420000 would permit processing to begin at the first record (or key) containing D642xxxx, regardless of the characters that are represented by the x's.

Your program must determine when the generic group is completed. Otherwise, ISAM continues through the remainder of the file.