gtpi1m3j | System Installation Support Reference |
The FIND_STCCR user exit, UPX2, performs accounting or utility functions
when the TPF system retrieves a short-term common control record
(STCCR). The FIND_STCCR user exit also provides a mechanism that
allows you to supply your own function to convert the STCCR from its current
format to 32-way loosely coupled pool support format or a user-defined format
compatible with 32-way loosely coupled pool support format.
The FIND_STCCR user exit is called by the FIND_STCCR function from
segment CYH2.
Input
- EBXSW3
- Contains the ordinal of the STCCR that was retrieved (X'00'
- X'0C').
- Data Level E
- Data level E (DE) contains the retrieved STCCR in pool expansion (PXP)
format or a user-defined format compatible with PXP format.
Return Values
- R6=0
- Default return code. If this value is returned, CYH2 converts the
STCCR from PXP format to 32-way loosely coupled pool support format.
Use this return code if you code this user exit and do not change the
STCCR.
- R6=1
- If this value is returned, CYH2 returns to its caller without changing the
STCCR. Use this return code if you code this user exit and your code
converts the STCCR from its current format to 32-way loosely coupled pool
support format or a user-defined format compatible with 32-way loosely coupled
pool support format.
Programming Considerations
- This user exit is called by CYH2 when the format indicator in the STCCR
(CY$32LC in CY$CON) on data level E (DE) is not set to 32-way loosely coupled
pool support format.
- As shipped by IBM, this user exit calls the BACKC macro to return to the
caller. The STCCR on data level E (DE) is not changed.
- You can use all data levels and registers if the data levels and registers
are saved before use and restored before returning to the caller.
- If your user exit sets the return code to 0 (R6=0), the STCCR on data
level E (DE) must be in PXP format.
- If your user exit sets the return code to 1 (R6=1), the STCCR on data
level E (DE) must be in 32-way loosely coupled pool support format or a
user-defined format compatible with 32-way loosely coupled pool support
format.
References
See TPF Database Reference for more information
about pool support.