Coding a resource manager exit for IXGCONN

A resource manager exit provides a way for system logger to inform a resource manager of write and delete requests so that the resource manager can perform further processing.

When the resource manager connects to the log stream, it specifies:
  • The name of the resource manager on the RMNAME parameter.
  • The address of the resource manager exit on the RMEXIT parameter.
  • User-defined data on the RMDATA parameter.
  • The requests that will trigger the resource manager user exit (write and/or delete requests) on the RMEVENTS parameter.

You must be running in supervisor state and a system key to specify the RMNAME, RMEXIT, RMDATA, or RMEVENTS parameters on the IXGCONN request. The resource manager address space must be non-swappable with an AX value of 1, or all invocations of the resource manager exit will fail.

When a write or delete request occurs against the log stream, system logger gives control to the resource manager exit, passing a parameter list. The resource manager exit runs in the resource manager address space.

The resource manager exit is called as follows:
  • For a write request, the resource manager exit is called after the write request completes. If staging data sets are in use for the connection, the exit is called after the write to the staging data set completes.
  • For a delete request, the resource manager exit is called before the delete request is processed. This allows the resource manager exit to accept, reject, or override the delete request on behalf of the log stream. See Overriding delete requests.

The resource manager exit is always invoked before the request completion is reported to the system logger application that issued the request.