gtps1m4cSystem Macros

PROGC-Return Program Information

Use this system macro to return the address of a program's program allocation table (PAT) entry. This macro searches the PAT for the program name specified and, if a match occurs, returns the address of the program's entry in the PAT. If the program name specified is not found in the PAT, no address is returned and the macro branches to the label specified in the ERROR parameter of the macro.

Required Authorizations
Key0 Restricted System Common Storage

X

Format




NAME=prog|(Rx)
This parameter specifies the name of the program to be located. The name is 4 alphanumeric characters that should have been allocated at system generation time.

prog
The name of the program whose PAT entry is to be located.

(Rx)
A register (R0 through R7) that contains the name of the program whose PAT entry is to be located.

PAT=Rx
This parameter specifies the general register (R0 through R7) that will contain the address of the requested program's PAT entry on output.

ERROR=label
This parameter, a symbolic name, specifies the location to which control will be given if no match is found.

IDLOC
Specifies whether the request will be serviced using the program base ID or the database ID.

PBI
The request will be serviced using the program base ID located in CE1PBI. This is the default.

DBI
The request will be serviced using the database ID located in CE1DBI.

PARENT=NO
Specifies that the request will return the transfer vector PAT address if the program is a transfer vector. Otherwise, the PAT address of the parent is returned.

Entry Requirements

R9 must contain the address of the ECB being processed.

Return Conditions

Programming Considerations

Examples

None.