What next?

You should next copy the CICS Transaction Server procedures into a cataloged procedure library, load any CICS® features that you have, and tailor the CICS Transaction Server to your needs. For information about copying the CICS Transaction Server procedures, and loading the CICS Transaction Server features, see the following topics:

. For information about tailoring CICS Transaction Server to your needs, see Tailoring the CICS-supplied skeleton jobs.

Copy the CICS Transaction Server Procedures into a Procedure Library

CICS Transaction Server supplies the procedures listed in Table 7.

Table 7. CICS Transaction Server-supplied procedures
Procedure Description
DFHASMVS Assembles some CICS Transaction Server programs and user-written assembler language programs.
DFHAUPLE Assembles and link-edits CICS Transaction Server control tables, and makes the assembly and link-edit information available to SMP/E.
Note:
DFHAUPLE is installed in SDFHINST.
DFHBMSU Runs the BMS load module disassemble utility program, DFHBMSUP.
DFHEBTAL Translates, assembles, and link-edits assembler application programs using EXEC DLI commands in a batch environment under Language Environment®.
DFHEITAL Translates, assembles, and link-edits assembler application programs using the command-level interface.
DFHEXTAL Translates, assembles, and link-edits assembler application programs using the external CICS Transaction Server interface.
DFHLNKVS Link-edits CICS Transaction Server programs and application programs.
DFHMAPS Prepares physical and symbolic maps.
DFHMAPT Prepares physical and symbolic maps for C++.
DFHSMPE Executes SMP/E.
Note:
DFHSMPE is installed in SDFHINST.
DFHSTART Starts CICS.
Note:
DFHSTART is installed in SDFHINST.
DFHUPDVS Updates.
DFHYBTPL Translates, compiles, and link-edits PL/I application programs using EXEC DLI commands in a batch environment under Language Environment.
DFHYBTVL Translates, compiles, and link-edits COBOL application programs using EXEC DLI commands in a batch environment under Language Environment.
DFHYITDL Translates, compiles, and link-edits C/370™ application programs using the command-level interface under Language Environment.
DFHYITEL Translates, compiles, and link-edits C++ application programs using the command-level interface under Language Environment.
DFHYITPL Translates, compiles, and link-edits PL/I application programs using the command-level interface under Language Environment.
DFHYITVL Translates, compiles, and link-edits VS COBOL application programs using the command-level interface under Language Environment.
DFHYXTDL Translates, compiles, and link-edits C/370 application programs using the external CICS Transaction Server interface under Language Environment.
DFHYXTEL Translates, compiles, and link-edits C++ application programs using the external CICS Transaction Server interface under Language Environment.
DFHYXTPL Translates, compiles, and link-edits PL/I application programs using the external CICS Transaction Server interface under Language Environment.
DFHYXTVL Translates, compiles, and link-edits VS COBOL application programs using the external CICS Transaction Server interface under Language Environment.
DFHZITCL Translates, compiles, and link-edits COBOL application programs using the external CICS Transaction Server interface under Language Environment.
Start of changeDFHZITDLEnd of change Start of changeTranslates, compiles, and link-edits XL C application programs using the external CICS Transaction Server interface under Language Environment. End of change
Start of changeDFHZITELEnd of change Start of changeTranslates, compiles, and link-edits XL C++ application programs using the external CICS Transaction Server interface under Language Environment. End of change
Start of changeDFHZITFLEnd of change Start of changeTranslates, compiles, and link-edits XL C XPLINK programs using the external CICS Transaction Server interface under Language Environment. End of change
Start of changeDFHZITGLEnd of change Start of changeTranslates, compiles, and link-edits XL C++ XPLINK programs using the external CICS Transaction Server interface under Language Environment. End of change
DFHZITPL Translates, compiles, and link-edits PL/1 application programs using the external CICS Transaction Server interface under Language Environment.
ICCFCC CICS foundation classes
ICCFCCL CICS foundation classes
Start of changeICCFCGLEnd of change Start of changeCICS foundation classes End of change
ICCFCL CICS foundation classes
Note:

For further information about using the CICS Transaction Server-supplied procedures, see:

  • The CICS Operations and Utilities Guide, SC34-6431, for information about DFHCRST
  • The CICS TS-supplied SMP/E procedure, for information about DFHSMPE and DFHSTART
  • The CICS System Definition Guide, SC34-6428, for information about the other procedures.

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

You should copy all these procedures into a cataloged procedure library (for example, SYS1.PROCLIB). Before you copy the procedures, read the following:

  1. Your procedure library may 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. The inserted procedures should be placed 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 further information about specifying DDNAMEs in JCL, see theMVS/ESA JCL Reference manual.
  2. If service is applied to the CICS Transaction Server procedures, it is the versions in the libraries CICSTS31.CICS.SDFHINST and CICSTS31.CICS.SDFHPROC that will be 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 notes, and acted on them as necessary, copy the procedures into a cataloged procedure library.

Create Extra Sets of CICS Transaction Server Target Libraries (Optional)

You can use the CICS Transaction Server installation job, DFHISTAR, to generate an optional installation job, DFHINSTA, which you can use to create extra copies of the CICS Transaction Server target libraries and UNIX System Services directories.

Some of the benefits of using multiple libraries are:

Base the decision to use multiple libraries for CICS Transaction Server on the following factors:

You can use the DFHINSTA job, generated by the DFHISTAR job, to create extra sets of CICS Transaction Server target libraries fully under the control of SMP/E. Each time you run the DFHINSTA job, you can only generate one extra set of target libraries.

To create an extra sets of target libraries, you should complete the following steps. You can repeat the steps to create more sets of target libraries.

  1. Edit the DFHISTAR job to specify values for:

    For further information about editing the DFHISTAR job, and about the parameters of the DFHISTAR job, see Edit the DFHISTAR Job. The other parameters in the DFHISTAR job should not be changed.

  2. Submit the DFHISTAR job

    When you run the DFHISTAR job, it saves the generated version of the DFHINSTA job in the CICSTS31.XDFHINST library with the member name specified on the SELECT parameter in the DFHISTAR job. The data set name of the CICSTS31.XDFHINST library is specified in the LIB parameter of the DFHISTAR job.

  3. Consider running the DFHIHFSA job

    If you decide to create an additional SMP/E target zone using job DFHINSTA, run the DFHIHFSA job first before running the DFHINSTA job. DFHIHFSA creates an additional SMP/E target zone for HFS. This job:

    All steps of this job must end with return code zero for the job to be successful

    CICS requires the MOUNT issued by DFHIHFSA to access files stored in the HFS, but the MOUNT command is lost when you re-IPL MVS. SDFHINST member DFHBPXPA contains a MOUNT command for /pathprefix/usr/lpp/cicsts/ussdira. Copy this command into a BPXPRMxx member of the SYS1.PARMLIB dataset to ensure the mount is restored when MVS is IPLed.

  4. Submit DFHINSTA

    The DFHINSTA job (or a copy of it) copies the CICS Transaction Server target libraries specified by the INDEX parameter, and creates corresponding CICS Transaction Server SMP/E data sets for them. In particular, it allocates a new SMP/E CSI data set for the extra target zone.

    So that DFHINSTA job can be run more than once, step 1 deletes previous copies of the data sets to be created. Step 3 deletes the SMP/E CSI data set. Step 6 removes the ZONEINDEX entry for the extra target zone.

    The first time the DFHINSTA job is run, Step 6 will give the following messages:

         GIM35701E ** ZINDEX SUBENTRY azone WAS NOT DELETED BECAUSE
                           IT DOES NOT EXIST.
         GIM25601I    THE SPECIFIED ENTRY WAS NOT UPDATED BECAUSE OF
                           AN ERROR DURING UCLIN PROCESSING.

    You can ignore these messages the first time the job is run.

Load the CICS Transaction Server Source Material (Optional)

You can use the sample job, DFHOPSRC, to load the optional CICS Transaction Server source from the distribution tapes. The DFHOPSRC job is generated in the CICSTS31.XDFHINST library when you run the DFHISTAR job.

The DFHOPSRC job runs the MVS IEBCOPY utility program to load the optional source data sets from the tapes into a single DASD data set.

For further information about the IEBCOPY program, see the MVS/ESA Data Administration: Utilities Manual (SC26-4516).

Note:
The DFHOPSRC job loads the tape files to a DASD device of your choice, using a BLKSIZE parameter of 6160. You can specify a different BLKSIZE parameter on the DCB and SPACE statements if you want, in which case the space allocation should be reviewed (It may need to be changed.).

Load Other Optional Features

The sample job, DFHINSTJ, is supplied to be used to load other optional features that may be supplied. CICS Transaction Server V2R3 contains no optional features at General Availability time, but the sample job may be used if any optional features are shipped at a later date. The DFHINSTJ job is generated in the CICSTS31.XDFHINST library when you run the DFHISTAR job.

[[ Contents Previous Page | Next Page Index ]]