Creating and defining activities for the IVP jobs

In preparation for running the IVP jobs, create the CICS® data sets, install the CICS SVC, define and activate the CICS applids, and define log streams.

Creating the CICS data sets for the IVP jobs

Before you can run any of the CICS-suppled IVP jobs, create the data sets that they use. For further information about creating the data sets for the IVP jobs, see Jobs for creating the CICS data sets.

Installing the CICS SVC for the IVP jobs

All the IVP jobs require the CICS Type 3 SVC, which must be installed in the LPA.

If you have not already installed the CICS SVC in the LPA, described in Installing CICS modules in the MVS link pack area, do so now before you attempt to run any of the IVP jobs. The IVP jobs do not use the Type 6 SVC (DFHHPSVC).

Defining and activating the CICS applids

If you want to use SNA with a CICS region started by any of the CICS IVP jobs, create and activate an SNA APPL definition for the CICS region application identifier (applid).

The applid defined to SNA must match the applid that is specified on the APPLID system initialization parameter that is used by the IVP job. For example, to be able to log on to the CICS region that is started by the DFHIVPOL job, you must perform one of the following actions:
  • Create and activate an APPL definition for your own applid, which you specify on the APPLID parameter of the DFH$SIP1 member of the SYSIN data set.
  • Define and activate an APPL definition for the default applid DBDCCICS, which you specify on the APPLID parameter of the DFH$SIP1 member of the SYSIN data set.

For more information about creating and activating SNA APPL definitions for CICS, see Defining CICS regions as applications to SNA and Data set naming conventions.

Further, if you want to use SNA cross-domain services to communicate between CICS regions on separate MVS images, you must create and activate SNA CDRSC definitions in both MVS images involved in the communication. For more information about creating and activating SNA CDRSC definitions for CICS, see Defining cross-domain services when using SNA.

Defining log streams

CICS automatically attempts to connect to its system log stream, unless you define a journal model resource definition to define the log stream as TYPE(DUMMY). You decide whether you want to run the IVPs with system logs or to run with dummy logging.

If you decide to run with real log streams, see Defining the logger environment for CICS for information about defining log streams.

Alternatively, you can define a CICS JOURNALMODEL resource definition with TYPE(DUMMY) to avoid having to define log streams. To run the IVPs with the minimum effort:
  • Define JOURNALMODEL resource definitions in the CSD for the primary and secondary system logs, DFHLOG and DFHSHUNT respectively, specifying TYPE(DUMMY); see Figure 1 for a sample job.
  • Add the CSD group that contains your dummy system log journal models to your own group list, and include your group list on the GRPLIST system initialization parameter.

    Note that your group list must follow the IBM-supplied list DFHLIST. DFHLIST includes group DFHLGMOD, which contains DFHLOG and DFHSHUNT JOURNALMODEL definitions. Concatenating your list after DFHLIST ensures that your DUMMY definitions replace the IBM® definitions.

Figure 1. Sample job to define DUMMY JOURNALMODELs for CICS system logs
//CSDUP EXEC PGM=DFHCSDUP,REGION=1M,PARM='CSD(READWRITE)'
//STEPLIB DD DSN=CICSTS54.SDFHLOAD,DISP=SHR
//DFHCSD DD DSN=CICSTS54.DFHCSD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABOUT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSIN DD *
*
* DEFINE JOURNAL MODELS FOR CICS LOG STREAMS AS DUMMY *
DEFINE JOURNALMODEL(DFHLOG) GROUP(LOGTEST)
DESCRIPTION(DEFINE SYSTEM LOG AS DUMMY)
JOURNALNAME(DFHLOG) TYPE(DUMMY)
ADD GROUP(LOGTEST) LIST(mylist) 
/*
//                               


dfha1c0052.html | Timestamp icon Last updated: Sunday, 4 June 2017