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
- Control is returned to the next sequential instruction (NSI) if the
program name was found. If the program name was not found, control is
transferred to the label specified by the ERROR parameter.
- The general register specified on the PAT parameter contains the PAT
address of the requested program if the program was found or zero if the
search was unsuccessful.
- The contents of R0 through R7 are preserved with the exception of the
register specified on the PAT parameter.
- If the program name specified is a transfer vector, the address of the PAT
entry of the parent program will be returned unless PARENT=NO is coded.
For this condition, the address of the transfer vector PAT entry will be
returned.
Programming Considerations
- This macro is restricted for use by E-type programs only. C-type
programs can issue the PROGC macro to generate a DSECT for the PROGC parameter
list.
- If the program specified is I-stream unique, the PAT entry address
returned will be the program's PAT entry unique to the I-stream from
which the macro was invoked.
Examples
None.