How to create a SMP/E USERMOD for CA Spool?

Document ID : KB000030422
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction:

In this article we describe what steps are required to create and install a SMP/E USERMOD to modify CA Spool User Exits or Translation Tables.

Instructions:

Review and tailor the following sample JCLs provided in your CA Spool installation libraries:

CAI.CBQ4JCL(BQ4JUREC) - SMP/E USERMOD RECEIVE model JOB      
CAI.CBQ4JCL(BQ4JUAPC) - SMP/E USERMOD APPLY CHECK model JOB      
CAI.CBQ4JCL(BQ4JUAP) - SMP/E USERMOD APPLY model JOB

Steps follows:

1.- Create a SMP/E USERMOD PDS member using the following sample MCS cards

CA Spool Release 11.7
++USERMOD(SCB70xx).             /* SYSMOD ID              */
++VER(Z038) FMID(CBQ4B70).      /* BASE FUNCTION          */
++SRC(ESFU0nnX or ESFTRAN).     /* USER VERSION OF SOURCE */
Your ESFU0nnX or ESFTRAN code from the CBQ4SRC library goes here   

CA Spool Release 12.0
++USERMOD(SCBC0xx).             /* SYSMOD ID              */
++VER(Z038) FMID(CBQ4C00).      /* BASE FUNCTION          */
++SRC(ESFU0nnX or ESFTRAN).     /* USER VERSION OF SOURCE */
Your ESFU0nnX or ESFTRAN code from the CBQ4SRC library goes here   

The nn string represents the suffix of the User Exit you will be changing. Use suffix TR (SCB70TR or SCBC0TR) for the Translation Table.

2.- Modify your ESFU0nnX or ESFTRAN code included in the SMP/E USERMOD as needed.
3.- Run the SMP/E RECEIVE, APPLY CHECK and APPLY JOBs to install it.
4.- Once the JOBs runs with RC=00, copy/replace the affected modules from your SMP/E Target CBQ4LOAD to your running load library.
5.- Consider a refresh of your LLA prior to the recycle in case your running load library is defined in the System's Linklist concatenation.
6.- Follow all of these steps with a CA Spool WARM restart.
7.- Last, proceed with any required tests to validate the changes made to the modified User Exit or Translation Table were implemented as expected.

Additional Information:

CA Technologies recommends implementing user code via standalone user exits. First introduced as part of CA Spool Release 11.7, they are installed as independent load modules rather than part of our main code.  Sample skeleton source members can be found in the CBQ4SRC library as members that do not contain the 'X' suffix, for example, ESFU009 instead of ESFU009X. The names can be user defined.  The names are specified via the UEXxxxx keyword parameters of the LOADEXIT statement in the ESFPARM initialization parameter file. A sample JCL to assemble and link edit your standalone user exits is available in CBQ4JCL(BQ4JUXIT).