bdfp1m2bProgramming Concepts and Reference

DBKEY-Activate a Key List

Use this macro to activate a key list that is used by subsequent macros that access the specified file. See Specifying Logical Records (LRECs) Using Keys for more information about keys.

Format




REF=dsectvv
specifies the file or subfile that you want to access, where dsectvv is the DSECT name and an optional 2-character version.

REF=refname
specifies the file or subfile that you want to access, where refname is a label that references the DSECT name in one of the following formats:

refname
is the label of an 8-byte field that contains the 6-byte DSECT name and an optional 2-character version.

A/refname
is the label of a 4-byte field that contains the storage address of the DSECT name and an optional 2-character version.

FILE=dsect
specifies the file or subfile that you want to access, where dsect is the DSECT name.

R3=address
specifies the location of the SW00SR slot for this subfile, where address is the label of a field that contains the address of the SW00SR slot. Register 3 will be loaded with this address.
Note:
Do not use this parameter; it is provided only for migration purposes. Use the REF parameter to specify the file that you want to access.

KEYLIST=keyloc
specifies a key list that you want to use with this macro, where keyloc is one of the following:

See Setting Up and Using a Key List for information about how to set up a key list.

NOPGM
specifies not to change the program stamp in a block when filing it.

Entry Requirements

None.

Normal Return

None.

Error Return

 See Identifying Return Indicators and Errors for information about how to check the error indicators. 

Programming Considerations

Examples

See Using a Key List with the DBSETK Macro for an example of activating key list with the DBKEY macro.

Related Macros