z/OS MVS IPCS Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Input

z/OS MVS IPCS Customization
SA23-1383-00

In addition to the input considerations described in Conditions on Entry to an IPCS Exit Routine, the following special input considerations apply to TCB exit routines.

On entry to a TCB exit routine, register 1 points directly to the IPCS task variable (ABDPL data area).
  • Field ADPLASID identifies the address space in which the TCB resides whenever the address space resides in virtual storage. When the address space resides in an address space other than virtual storage, field ADPLASID is set to zero.

    This field can be set by TCB exit routines to specify an ASID before t he exit routines invoke the storage access service to retrieve virtual storage, or when the exit routines call formatter or model processor services to retrieve virtual storage data before formatting it.

  • Field ADPLTCB (also called ADPLCBP) contains the virtual storage dump address of the TCB being processed. If a block does not reside in virtual storage, this field is zeroed, and the exit routine must use ADPLESYP to find the address of the block in the storage mapped by BLSRESSY. This can only happen in the IPCS environment.
  • When IPCS is the host, field ADPLESYP is set to address a block of storage described by mapping macro BLSRESSY. That block of storage, in turn, describes the address space, address, and the type of data for which a formatting exit routine is being invoked. This allows the exit routine to pass the data unaltered, to the storage access function of the IPCS symbol service and retrieve an image of the block from the dump.
    Note: The block of storage described by mapping macro BLSRESSY can reside in storage whose address is greater than X'FFFFFF'. Formatting exit routines that wish to utilize this support must run in AMODE(31) during that portion of their processing that accesses this parameter.

    When SNAP is active, this pointer contains zero upon entry to the post-formatting exit routine.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014