Copying the CICS Transaction Server procedures into a procedure library

CICS® Transaction Server supplies procedures that can be tailored or are copied directly to your procedure library when you run the installation jobs. All procedures are described in the table.

The procedures DFHAUPLE, DFHSMPE, DFHSTART, EYUCMASP, EYUCSYSP, and EYUWUIP are tailored to your CICS Transaction Server environment and stored in the CICSTS56.XDFHINST library when you run the DFHISTAR job. The other procedures are not modified by the DFHISTAR job and are copied into the CICSTS56.SDFHPROC library when you run the CICS Transaction Server installation jobs.

Copy all these procedures into a cataloged procedure library; for example, SYS1.PROCLIB. Before you copy the procedures, read the following instructions:
  1. Your procedure library might already contain procedures, supplied with an earlier release of CICS, that have the same names as the new procedures but are, in fact, different. If so, you must find some way of selecting the right release. Here are some ways of using the new versions:
    1. For the time being, rename either set of procedures and modify the appropriate jobs to use the new names.
    2. Insert the new procedures into the job streams that use them and use the procedures as in-stream procedures. Place the inserted procedures between the JOB statement and the first EXEC statement. You must insert a // PEND statement after the inserted procedures. When the new release becomes the production system, you can copy the new procedures into your procedure library.
    3. Indicate the DDNAME of the cataloged procedure library that is to be used to convert the JCL for the job. For example, you could use the JES2 /*JOBPARM PROCLIB=xxxxxxxx. For more information about specifying DDNAMEs in JCL, see the z/OS MVS JCL Reference.
    4. Specify, in the JCLLIB statement, the name of the procedure libraries that you want to search for the named procedure or procedures. For more information about JCLLIB, see the z/OS MVS JCL Reference.
  2. If service is applied to the CICS Transaction Server procedures, the versions in the libraries CICSTS56.CICS.SDFHINST and CICSTS56.CICS.SDFHPROC are updated by SMP/E. You must then copy the updated procedures into your procedure library.
  3. The default for the symbolic parameter GZONE in the procedures DFHSMPE and DFHAUPLE is taken from the value that you specified by the GZONE parameter of the DFHISTAR job.
  4. The default for the ZNAME symbolic parameter in the procedures DFHSMPE and DFHAUPLE is taken from the value that you specified by the TZONE parameter of the DFHISTAR job. For a description of how the ZNAME parameter is used, see the SMPCNTL DD statement in The CICS TS-supplied SMP/E procedure.
  5. Change the OUTC parameter as required.
When you have read these instructions, and acted on them as necessary, copy the procedures into a cataloged procedure library. The CICS Transaction Server-supplied procedures are listed in Table 1.