Before calling CSRL16J, you must build the L16J data area to form
a parameter list that defines the entry characteristics and register
contents for the target routine. Include the CSRYL16J mapping macro
to map data area L16J. To build the L16J parameter list, first initialize
the parameter list with zeroes and then fill in the desired fields.
This processing ensures that all fields requiring zeroes are correct.
You can specify the following characteristics for the target routine
in the indicated fields of data area L16J:
- L16JLENGTH
- Length of the L16J parameter list. Initialize this field with
constant L16J_LEN.
- L16JGRS
- General purpose registers (GPRs) 0-15 on entry to the target
routine.
- L16JARS
- Access registers (ARs) 0-15 on entry to the target routine,
if you set the L16JPROCESSARS bit on.
- L16JPSW
- Includes the following PSW information for the target routine.
See Principles of Operation for more information about
the contents of the PSW.
- PSW address and AMODE
- PSW ASC mode — primary or AR
- PSW program mask
- PSW condition code
APF-authorized callers, callers in supervisor state, PSW
key 0-7, or PKM allowing key 0-7, can specify:
- PSW state - problem or supervisor
- PSW key.
For unauthorized callers, the PSW state and key of the
calling program are used for the target routine.
- L16JPROCESSARS
- A bit indicating whether or not you want to specify the contents
of the access registers (ARs) for the target routine. Set the bit
on if you want to specify the contents of the ARs. If you set the
bit off, the access registers (ARs) contents are determined by the
system.
When CSRL16J passes control to the target routine, the GPRs contain:
- Register
- Contents
- 0-15
- Values specified by the caller
If the L16JPROCESSARS bit is set on, when CSRL16J passes control
to the target routine the access registers (ARs) contain:
- Register
- Contents
- 0-15
- Values specified by the caller
If the L16JPROCESSARS 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 callable service.
- 14-15
- Do not contain any information for use by the routine