Implementing a TPX user exit

Products

• TPX - Session Management
• Vman Session Management for z/OS

Issue/Introduction

How to set up a TPX user exit

Environment

TPX® Session Management for z/OS

Resolution

TPX sample user exit source code is delivered with the TPX product install package.  Refer to the CB0VSRC library for out-of-the-box sample user exits.

The TPX user exit documentation can be found here: Set Up User Exits.
Review the description provided at the beginning of each sample exit to ascertain its usefulness.

To assemble the exits, use the JCL provided in the ASMUXIT member of the CB0VSRC library.

IMPORTANT:

• When customizing TPX user exits, it is recommended that you create a site-specific version of the exit source and leave the original source in the CBOVSRC dataset unchanged.
• The customized exit should be assembled with the correct exit name and placed in a separate customer defined load library that is defined on the TPX proc '//STEPLIB DD' statement concatenated in front of the TPX product load library CB0VLOAD.
• See parm TPXLMOD below.

Tips for specifying the parameters in ASMUXIT:
 

1. //ASMTPX   PROC RENT=RENT,                                                  
   //             TPXMAC='TPX.GENLIB',                <<< CB0VMAC
   //             TPXSYS='TPX.LOADLIB',               <<< CB0VLOAD                   
   //             TPXIN='TPX.SOURCE',                 <<< CB0VSRC or your custom source library
   //             TPXINN='** NAME OF SOURCE MEMBER **',                        
   //             TPXLMOD='TPX.LOADLIB.CUSTOM',       <<< NOT CB0VLOAD
   //             TPXMODN='** TPX EXIT NAME  **'                               
   
   TPX would then need to be recycled for the new or modified exit to become active,
   
   -or-
   
   TPX r5.4 has been enhanced so that a TPX restart is not needed. User exits can be activated or deactivated dynamically.
   For access to this enhancement, apply Published Solutions for TPX 5.4: PTFs RO86230 & RO86231
   
   Use RELOAD TPXOPER command to Reload user exits. This only activates/refreshes exits.
   RELOAD EXIT={name-of-exit-module}
   
   To quiesce/deactivate an exit, use:
   Q EXIT={name-of-exit-module}

Additional Information

Note:

1. Reload and Quiesce command must be issued from TPXOPER main panel (TEN0200 or HEN0200). 
2. When on panel TEN0229 (D EXIT), issuing the command Q EXIT=exitname or RELOAD EXIT=exitname would not work. From that panel, the option is to place the cursor in the exit you want to update, and press PF9=Updt key.