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.