z/OS MVS Programming: Callable Services for High-Level Languages
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Defining the entry characteristics of the target routine

z/OS MVS Programming: Callable Services for High-Level Languages
SA23-1377-02

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

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014