The CICS startup procedure, DFHSTART

All the IVP jobs include a procedure to start up CICS. You can use this procedure as a basis for your own CICS startup procedures. This procedure, DFHSTART, 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--execute 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.

The following symbolic parameters are defined in the IVP jobs:

INDEX1
is the high-level index of the CICS run-time data sets, as specified on the DSINFO parameter of the DFHISTAR job. Default: INDEX1=hlq
INDEX2
is the high-level index of the CICS load libraries, as specified on the INDEX parameter of the DFHISTAR job. Default: INDEX2=hlq
REGNAM
is the REGION name for a single or MRO region. Default: REGNAM=TR
REG
defines the MVS region size for the CICS step. Default: REG=32M
START
is the type of CICS startup to be performed. Default: START=AUTO
DUMPTR
specifies whether dump and trace analysis is required. Default: DUMPTR=YES
RUNCICS
specifies whether CICS is to be started. Default: RUNCICS=YES
OUTC
is the output print class. Default: OUTC='*'
SIP
is the suffix of the DFH$SIP member (in the SYSIN data set) to be used during CICS startup. Default: SIP=T
Notes:
  1. The step CICS (to start up CICS) is executed only if you code RUNCICS=YES (the default). Code RUNCICS=NO if you want to perform dump and trace analysis without starting CICS.
  2. The steps PRTDMPA, PRTDMPB, DFHAUXT, and DFHBUXT are executed only if you specify DUMPTR=YES (the default).
  3. When you run the DFHISTAR job, it overrides the default values in the IVP jobs with the values you specified in the DFHISTAR job.

DD statements for CICS data sets

The startup job step contains DD statements for the CICS data sets that are listed in Table 17.

Table 17. DD statements for CICS data sets in the DFHSTART procedure
DDname Description
SYSIN SYSIN data set, containing the DFH$SIPn members that specify system initialization parameter overrides.
DFHCMACD Messages data set, needed for the CICS messages transaction, CMAC.
FILEA Sample VSAM data set, needed by the FILEA sample applications.
DFHTEMP Auxiliary temporary storage data set, needed by the FILEA sample applications.
DFHINTRA Transient data intrapartition data set, needed by the FILEA sample applications.
DFHAUXT
DFHBUXT
First auxiliary trace (A) data set.
Second auxiliary trace (B) data set.

The auxiliary trace data sets, DFHAUXT and DFHBUXT, are needed
because the IVP jobs run with auxiliary trace switched on, and the
auxiliary trace data set switching facility set to switch once only.
DFHLCD (Mandatory) CICS local catalog data set (VSAM), used by the CICS domains to save some of their information between CICS runs, and to preserve this information across a cold start.
DFHGCD (Mandatory) CICS global catalog data set (VSAM), has a variety of uses, including: during a CICS run, holding resource definitions that are installed; and, during a controlled shutdown, recording part of the warm keypoint information.
DFHCXRF Transient data extrapartition data set, used by CICS as the target for messages sent to any transient data destination before CICS has completed intrapartition transient data initialization. Use of this DDname is optional, but if it is not used, any messages that would have been written here are lost.
DFHLRQ The local request queue data set is used to store pending BTS requests;for example, timer requests or requests to run activities. It is recoverable and used to ensure that, if CICS fails, no pending requests are lost. For more information, see the CICS Business Transaction Services.
LOGUSR Data set for the extrapartition transient data destination, LOGA, used by the CICS sample programs.
MSGUSR Data set for the extrapartition transient data destination, CSSL, used by a number of CICS services.
PLIMSG Data set for the extrapartition transient data destinations used by PL/I application programs. This data set is the destination for PL/I statistics and messages Start of change(CPLI). End of change
COUT Data set for the extrapartition transient data destinations used by C/370 application programs. This data set is the destination for the C/370 output data streams, stdout (CCSO) and, indirectly, stderr (CCSE).
DFHDMPA
DFHDMPB
First transaction dump (A) data set.
Second transaction dump (B) data set.
 
The dump data sets are included because CICS always tries to open a transaction dump data set, and issues a warning message if it is unable to do so for any reason.
DFHCSD (Mandatory) CICS system definition data set (VSAM).
[[ Contents Previous Page | Next Page Index ]]