Specify the entry characteristics for the target in data area L16J,
which forms the parameter list passed from the calling program to
CSRL16J. Use the CSRYL16J mapping macro to see the format of the L16J
parameter list. To build the L16J parameter list, first initialize
the parameter list with zeroes and then fill in the desired fields.
This ensures that all fields requiring zeroes are correct. You can
specify the following characteristics for the target in L16J:
- Length of the L16J parameter list, L16JLENGTH field in mapping
macro CSRYL16J.
- Contents of the general purpose registers (GPRs) 0-15, L16JGRS
field in mapping macro CSRYL16J.
- Contents of the access registers (ARs) 0-15, L16JARS field in
mapping macro CSRYL16J.
- PSW information for the target routine, field L16JPSW field in
mapping macro CSRYL16J.
- PSW address and AMODE
- PSW ASC mode - primary or AR
- PSW program mask
- PSW condition code
Authorized callers, (callers in supervisor state, with PSW
key 0-7, or with a PKM that allows any key 0-7) can specify:
- PSW state - problem or supervisor
- PSW key.
For unauthorized callers, the system uses the PSW state
and key of the calling program for the target routine.
See Principles of Operation for more information about
the contents of the PSW.
- Bit indicating whether or not you want to specify the contents
of the access registers (ARs) for the target routine. This is the
L16JPROCESSARS bit in mapping macro CSRYL16J.
Set the bit on if
you want to specify the contents of the ARs. If you set the bit off,
the system determines the contents of the ARs.
If the bit is
set on when CSRL16J passes control to the target routine, the access
registers (ARs) contain:
- Register
- Contents
- 0-15
- Specified by the caller
If the bit is set off when CSRL16J passes control to
the target routine, the access registers (ARs) contain:
- Register
- Contents
- 0-1
- Do not contain any information for use by the routine
- 2-13
- The contents are the same as they were when the caller issued
the CSRL16J service.
- 14-15
- Do not contain any information for use by the routine