gtpi1m3g | System Installation Support Reference |
The FILE_CY2KT user exit, UPX7, performs accounting or utility functions
when the TPF system files a pool section keypoint table (CY2KT). The
FILE_CY2KT user exit also provides a mechanism that allows you to supply
your own function to convert CY2KT from its current format to pool expansion
(PXP) format or to a user-defined format that is compatible with PXP
format.
The FILE_CY2KT user exit is called by the FILE_CY2KT function from
segment CYH6.
Input
- EBXSW0
- Contains the index of the data level where CY2KT is to be filed.
The index is in the form of data level 0 (D0) to data level F (DF).
CY2KT is in 32-way loosely coupled pool support format or a user-defined
format compatible with 32-way loosely coupled pool support format.
Return Values
- R6=0
- Default return code. If this value is returned, CYH6 converts CY2KT
from 32-way loosely coupled pool support format back to PXP format and moves
CY2KT into keypoint 9 (CTK9). Use this return code if you code this
user exit and do not change CY2KT.
- R6=1
- If this value is returned, CYH6 does not change CY2KT or copy it to
CTK9. Use this return code if you code this user exit to convert CT2KT
to PXP format or a user-defined format compatible with PXP format. Your
user exit code must move the converted CY2KT to the appropriate fields in CTK9
and file CTK9 to DASD.
Programming Considerations
- This user exit is called by CYH6 when the conversion mode indicator
(CY1MD32) in CTK9 is PXP or CONVERTING. If the conversion mode
indicator is 32LC or FALLING_BACK, CYH6 does not call this user
exit.
- As shipped by IBM, this user exit issues a BACKC macro to return to the
caller. The CY2KT on the data level specified by EBXSW0 remains
unchanged.
- 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 R6=0 on return, CY2KT must be on the data level specified by EBXSW0 and
in 32-way loosely coupled pool support format.
- If R6=1 on return, the CY2KT on the data level specified by EBXSW0 must be
placed in CTK9 and filed to DASD. The CY2KT is still on the data level
specified by EBXSW0.
References
See TPF Database Reference for more information
about pool support.