gtpg2m3lGeneral Macros

RELPC-Release Program From Storage Lock

Use this general macro to unlock a program from storage. This only affects programs previously locked using the GETPC macro. Requests not reflecting a previous lock are ignored.

Format




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

prog
The name of the program that is to be unlocked from storage.

NAME
The name of the program can alternately be provided via the NAME parameter. Either the positional parameter 'prog' or the keyword parameter 'NAME' is required.

prog
The name of the program that is to be unlocked from storage.

(Rx)
A register (R0-R7) that contains the name of the program that is to be unlocked from storage.

LOADSET=(Ry)
A register (R1-R7) that contains the address of an 8-byte character string. This character string is left justified, padded with blanks, and specifies the name of the loadset that contains the version of the program that is to be unlocked from storage.

If the character string contains all blank characters or if you do not specify this parameter, the version of the program associated with the requesting ECB is unlocked from storage. In this case, the name of the loadset that contains the version of the program associated with the requesting ECB is placed in the 8-byte character string.

Note:
This option requires Restricted authorization.

UNLOCK=SPECIAL
Specifies that the program had been locked through a GETPC LOCK=SPECIAL request.
Note:
This option requires Restricted authorization.

ERROR=label1
An optional symbolic name of a routine where control is passed, if an error occurs during RELPC processing. Register R15 contains an error code indicating the type of error.

Entry Requirements

R9 must contain the address of the entry control block (ECB) being processed.

Return Conditions

Programming Considerations

Examples

None.