gtps1m4nSystem Macros

RLNKC-Return to CP Calling Routine and Reset Stack Pointer

Use this system macro to reload the linkage data from the stack, reset the stack pointer, and return to the calling control program (CP) routine. This macro is used with other standardized linkage macros such as the CLNKC, DLNKC, and SLNKC macros. See the following for more information about these macros:

Format




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

BASE=R15|Rx
The register specified, default R15, was used as the link-to register by the calling routine (CLNKC).

LINK=R14|Ry
The register specified, default R14, will be used as the link register from this routine. The calling routine used this register as its link-from register.

LOREG=Rn|NO
Required. If a register Rn is specified, all registers, beginning with the specified register, will be reset from the stack. If NO is specified, no registers are reset from the stack.

POP
Specify one of the following:

YES
The stack register will be popped, that is, adjusted by the length of this routine's stack area.

NO
The stack register will not be 'popped,' since there is no stack area used by this routine and it does not call any routine.

Used in conjunction with the PUSH parameter on the SLNKC macro.

PARMS=Rn|(Rm,...,Rn)
This is optional. The register (or registers) specified by this parameter will not be reset from the stack since it is assumed to contain data.

Entry Requirements

Return Conditions

The macro generates code to load the appropriate registers from the stack, excluding the parameter registers. It adjusts the stack register by the size of the stack area for this routine and returns to the calling routine via the LINK register.

Programming Considerations

Examples

None.