gtps1m2iSystem Macros

ESFAC-Obtain Symbolic File Address Information

Use this system macro to obtain information about the characteristics of a specific symbolic file address as follows:


Required Authorizations
Key0 Restricted System Common Storage

X

Format




Notes:

  1. file_address

  2. extended_info_address

label
A symbolic name can be assigned to the macro statement.

file_address
Location of the file address.

Dx
A file address reference word (D0-DF) which contains the file address.

(Rx)
A register that contains the file address. For E-type programs this may be R0-R7. For control programs (CPs), this may be R1-R10, R14, or R15.

ADDR=(Rz)|label1
This parameter specifies the general register containing the location, or a label indicating the location, of an 8-byte file address. For E-type programs, this can be R1-R7. For CPs, this can be R1-R10, R14, or R15.

extended_info_address
This parameter specifies the address of where the extended information is to be returned.

(Ry)
A register specifying the address where the extended information is to be returned. For E-type programs this may be R1-R7. For CPs, this may be R0-R10, R14, or R15.

scon_label
A label that is resolvable as an S-type constant. For E-type programs, the SCON base must be in the range R1-R7 or R9 if an entry control block (ECB) work area is used. For CPs, the SCON base may be any register.

The address specified by the second positional parameter points to a data area structured according to DSECT DCTSON.

Entry Requirements

Return Conditions

Programming Considerations

This macro can be run on any I-stream.

Examples

None.