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.
CICS Transaction Server supplies the procedures listed in Table 7.
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. |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
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 |
![]() ![]() |
![]() ![]() |
ICCFCL | CICS foundation classes |
Note:
For further information about using the CICS Transaction Server-supplied procedures, see:
|
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:
When you have read these notes, and acted on them as necessary, copy the procedures into a cataloged procedure library.
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.
SELECT DFHINSTA INSTA111
will store the generated version of DFHINSTA into member INSTA111 of the CICSTS31.XDFHINST library when you submit the DFHISTAR job.
Each time you copy DFHINSTA (to create a new set of target libraries), you should specify a new name on the SELECT parameter (to save each copy with a different name in case you need it again in the future).
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.
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.
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.
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.
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).
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 ]]