z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


XES/Notify Exit Communication

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

Similar to the contention exit, the notify exit receives the current resource request queue as input. The queue is presented in the form of a notify exit parameter list (NEPL), mapped by the macro IXLYNEPL. The NEPL for locking requests has a header containing information pertaining to the connector and the lock structure along with a lock section that includes the identification of the resource that is in contention. These sections are followed by a series of entries (mapped by NEPLENT) that reflect the interest of other connectors (both owners and waiters) in the specified resource. The NEPL information includes:
  • Header section information
    • Connect data, such as the connect token and connect name of the resource owner (NEPLCONTOKEN, NEPLCONNAME)
    • Structure information, such as rebuild status (NEPLREBUILD)
  • Lock section
    • Lock data, if any, that was specified when resource ownership was obtained (NEPLLOCKDATA)
    • Resource identifiers, such as resource name, length, and hash value (NEPLRNAME@, NEPLRNAMELEN, NEPLHASHVAL)
    • 32-byte work area, passed from the contention exit (NEPLWORK)

      This work area which is shared between the contention exit and the notify exit. Specifically, when the contention exit requests that the notify exit be executed, the contents of the work area within the corresponding CEPL entry (CEPLEWORK) is passed to the notify exit. The notify exit receives this information by way of the NEPLWORK field. Any changes made to this area by the notify exit are subsequently presented to the contention exit.

    • Ownership data, such as state and user data for this resource owner (NEPLSTATE, NEPLUDATA)
    • An input/output area which can be used in conjunction with the IXLSYNCH service to update the ownership data (NEPLOUT).
  • Entry information
    • Requestor information, such as version, connection identifier, and connect name (NEPLECONVERSION, NEPLECONID, NEPLECONNAME)
    • Ownership data, such as state and user data, for both the held state and the requested state (NEPLEHELD, NEPLEREQ).

See z/OS® MVS™ Data Areas in the z/OS Internet library for the IXLYNEPL macro.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014