The CICS startup procedure, DFHSTART

All the IVP jobs include a procedure to start CICS®. You can use this procedure as a basis for your own CICS startup procedures.

The DFHSTART procedure comprises the following steps:
  1. CICSCNTL: determine whether CICS is to be started.
  2. DTCNTL: determine whether dump and trace analysis is to be performed.
  3. CICS: run CICS.
  4. PRTDMPA: print any contents of the CICS DFHDMPA dump data set.
  5. PRTDMPB: print any contents of the CICS DFHDMPB dump data set.
  6. PRTAUXT: print any contents of the auxiliary trace DFHAUXT data set.
  7. PRTBUXT: print any contents of the auxiliary trace DFHBUXT data set.

When you run the DFHISTAR job, it overrides the default values in the IVP jobs with the values you specified in the DFHISTAR job.

The following symbolic parameters are defined in the IVP jobs:
ACTIVE(SDFHLIC)
Is the type of license module used:
  • SDFHLIC - Normal Licence
  • SDFHVUE - Value Unit Edition
  • SDFHDEV - Developer Trial
INDEX1(hlq)
Is the high-level index of the CICS runtime data sets, as specified on the DSINFO parameter of the DFHISTAR job.
INDEX2(hlq)
Is the high-level index of the CICS load libraries, as specified on the INDEX parameter of the DFHISTAR job.
INDEX3(hlq)
Is the high-level index of the CPSM load libraries, as specified on the INDEX parameter of the DFHISTAR job.
INDEX4(hlq)
Is the high-level index of the activation module load library, as specified on the INDEX parameter of the DFHISTAR job.
REGNAM(TR)
Is the REGION name for a single or MRO region.
REG(80M)
defines the MVS™ region size for the step to run CICS.
MEMLIM(8G)
The z/OS® MEMLIMIT parameter limits the amount of 64-bit (above-the-bar) storage that the CICS address space can use.
START(AUTO)
Is the type of CICS startup to be performed.
DUMPTR(YES)
Specifies whether dump and trace analysis is required. The steps PRTDMPA, PRTDMPB, DFHAUXT, and DFHBUXT are run only if you specify DUMPTR=YES.
RUNCICS(YES)
Specifies whether CICS is to be started. The step to run CICS runs only if you code RUNCICS=YES (the default). To perform dump and trace analysis without starting CICS, code RUNCICS=NO.
OUTC(*)
Is the output print class.
SIP(T)
Is the suffix of the DFH$SIP member (in the SYSIN data set) to be used during CICS startup.
CICSSVC(216)
Specifies the CICSSVC number that you have assigned to the CICS type 3 SVC.
USSHOME(/usr/lpp/cicsts/cicsts53)
Specifies the name and path of the root directory for CICS Transaction Server files on z/OS UNIX.