gtps1m39System Macros

IGATC-Get Global Attribute Table Entry

Use this system macro to obtain addressability for the attributes of globals.

Format




Notes:

  1. If REGO is not coded, the register used is the same as that used for REGI.

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

REGI=Rx
Input register, required. REGI must specify a register from R14 through R7 that contains the address of a global directory slot. For C-type programs only, you must specify R1.

REGO=Rx
Output register, optional.

If coded, you must specify a register from R14 through R7 that will contain the address of the corresponding global attribute table entry.

If not coded, REGI will be used for both input and output. If the TPF system does not contain extended globals, the value returned in REGO will be the same as the value received in REGI. In C-type programs this parameter is not needed because R1 is always used.

ERR=label
Error routine, optional.

If coded, must specify a label where control will be transferred if the contents of REGI are note valid.

Entry Requirements

Return Conditions

Programming Considerations

Examples

IGATC REGI=R1

This invocation specifies that the input register is R1. The output register defaults to R1 as well.

IGATC REGI=R14,REGO=R4,ERR=GATERR

This invocation specifies that the input register is R14 but the output register is R4. C-type programs cannot use this invocation, since they are limited to R1. If the contents of R14 are invalid, control is transferred to the label GATERR.