The following are the register contents on entry to the CBRUXSAE installation exit:

Register

Contents

0

Contents on entry are unpredictable.

1

Contains the address of a parameter list, which contains four pointers:

1. Pointer to an 8-character field, which contains the OSREQ function being performed. Possible values are STORE, RETRIEVE, QUERY, CHANGE, DELETE. Note that during a store sequence using the STOREBEG, STOREPRT, and STOREEND functions, the CBRUXSAE exit is only invoked once for the sequence, the invocation will occur during the STOREBEG function, and will be identified to the exit with the value STORE.
2. Pointer to a 44-character field, which contains the object name associated with the requested function.
3. Pointer to a 44-character field, which contains the collection name associated with the requested function.
4. Pointer to an 8-character field, which contains the user ID associated with the requested function.

2–8

Contents on entry are unpredictable.

9

Contains the address of a 1024-byte storage area that can be used as automatic storage for the exit. The storage provided adheres to environment dependent restrictions. If more storage is needed, or there is a preference to obtain your own storage, environment dependent functions must adhere to GETMAIN restrictions. For example, a CICS environment must use CICS GETMAIN service to obtain storage instead of using MVS OBTAIN.

10–12

Contents on entry are unpredictable.

13

Contains the address of a 72 byte save area (standard linkage).

14

If the return code from CBRUXSAE is not 0, 16 or 255 (or 253 or 254 when storing to an existing collection); return and reason codes are issued indicating that the user ID is not authorized to perform the particular OSR function. For more information concerning return and reason codes associated with this exit, refer to z/OS DFSMSdfp Diagnosis.