Edit the DFHISTAR Job

Edit the DFHISTAR job, to assign values to installation parameters for your environment. The DFHISTAR job is in the TDFHINST library when you copy RELFILE(2) from the distribution tape. You can either edit the DFHISTAR job directly, or copy the DFHISTAR job (to preserve the IBM-supplied values) and edit your copy.

Remember that the product is installed using cataloged data sets.

This topic describes the process of editing the parameters in the DFHISTAR job. It contains the following sub-topics in an order that corresponds to the order of parameters in the DFHISTAR job:

To help you look up details about a particular parameter, Table 4 lists the DFHISTAR parameters, in alphabetical order, with their predefined values. (The parameters in the DFHISTAR job itself are listed in associated groups.)

The default values of the parameters are the same as the IBM-supplied values.

You can use the IBM-supplied values, define your own values, or let the CICS Transaction Server installation process determine default values for you.

Note:
You can enter your values for parameters of the DFHISTAR job in lowercase; except for the HFS-related parameters (USSDIR, USSDIRA, and JAVADIR), the values are translated into uppercase when you run the DFHISTAR job.
Table 4. Alphabetical list of parameters for the DFHISTAR job
Parameter CICS-supplied value Your value ? See page
 
ADDTVOL CICS31 SYSALLDA   Specify Attributes of any additional target Libraries
AINDEX CICSTS31.A   Specify Attributes of any additional target Libraries
ALINDEX SYS1.CICSTS31.A   Specify Attributes of any additional target Libraries
ASMPLTS CICSTS31.A.SMPLTS   Specify Attributes of any additional target Libraries
ASMPMTS CICSTS31.A.SMPMTS   Specify Attributes of any additional target Libraries
ASMPSCDS CICSTS31.A.SMPSCDS   Specify Attributes of any additional target Libraries
ASMPSTS CICSTS31.A.SMPSTS   Specify Attributes of any additional target Libraries
AZONE AZONE   Specify Attributes of any additional target Libraries
AZONECSI CICSTS31.A.AZONE   Specify Attributes of any additional target Libraries
AZONELOG CICSTS31.A.AZONE.SMPLOG   Specify Attributes of any additional target Libraries
BLKFB80 0   Specify Block Sizes
BLKISPF 3200   Specify Block Sizes
BLKU 32760   Specify Block Sizes
CMACVOL CICS31   Specify Disk Volumes
CSSLIB SYS1.CSSLIB   Specify the Data Set Name of the CSSLIB Library
DEFVOL CICS31 SYSALLDA   Specify Disk Volumes
DINDEX CICSTS31   Specify the Indexes of CICS Transaction Server Data Sets
DISTVOL CICS31 SYSALLDA   Specify Disk Volumes
DSINFO CICSTS31 CICS31 SYSALLDA .   Specify Attributes of the CICS Transaction Server system Data Sets
DZONE DZONE   Specify SMP/E Zone Attributes
DZONECSI CICSTS31.DZONE NEW CICS31 SYSALLDA   Specify SMP/E Zone Attributes
DZONELOG CICSTS31.DZONE.SMPLOG NEW   Specify SMP/E Zone Attributes
GINDEX CICSTS31   Specify the Indexes of CICS Transaction Server Data Sets
GZONE NEW CICSOPT   Specify SMP/E Zone Attributes
GZONECSI CICSTS31.GZONE NEW CICS31 SYSALLDA   Specify SMP/E Zone Attributes
GZONELOG CICSTS31.GZONE.SMPLOG NEW   Specify SMP/E Zone Attributes
HFS0DSN OMVS.USR.LPP.CICSTS   Specify the CICS TS HFS Directories and Data Sets
HFS1DSN OMVS.USR.LPP.CICSTS.CICSTS31   Specify the CICS TS HFS Directories and Data Sets
HFSADSN OMVS.USR.LPP.CICSTS.CICSTS31..A   Specify the CICS TS HFS Directories and Data Sets
JAVADIR java142s/J1.4   Specify the Name of the Java directory
JES JES2   Specify the Type of JES to be Used
JOB (No valid value)   Specify the JOB Parameters for Installation Jobs
LIB CICSTS31.XDFHINST   Specify the CICS Transaction Server Temporary Installation Libraries
LINDEX SYS1.CICSTS31   Specify the Indexes of CICS Transaction Server Data Sets
LOGGER-INFO 001 500 4096 64000 2048 MVSX XXXXXXXX XXXXXXXX   Specify Log stream and Log stream Structure Attributes.
OPTVOL CICS31 SYSALLDA   Specify Disk Volumes
PREFIX DFH   Specify the Prefix of CICS Transaction Server Jobs
SCEECICS SYS1.SCEECICS   Specify the Data Set Name of the SCEECICS & SCEERUN libraries
SCEECPP SYS1.SCEECPP   Specify the Data Set Name of the SCEECPP Library
SCEELIB SYS1.SCEELIB   Specify the Data Set Name of the SCEECICS & SCEERUN libraries
SCEEBND2 SYS1.SCEEBND2   Specify the Data Set Name of the SCEECICS & SCEERUN libraries
SCEERUN SYS1.SCEERUN   Specify the Data Set Name of the SCEECICS & SCEERUN libraries
SCEERUN2 SYS1.SCEERUN2   Specify the Data Set Name of the SCEECICS & SCEERUN libraries
SCEELKED SYS1.SCEELKED   Specify the Data Set Name of the SCEELKED Library
SCEELKEX SYS1.SCEELKEX   Specify the Data Set Name of the SCEELKEX Library
SCEEOBJ SYS1.SCEEOBJ   Specify the Data Set Name of the SCEEOBJ Library
SCLBSID SYS1.SCLBSID   Specify the Data Set Name of the SCLBSID Library
SCSQLOAD SYS1.SCSQLOAD   Specify the Data Set Name of the SCSQLOAD Library
SCOPE ALL   Specify the Scope of the Installation
SDSNLOAD SYS1.SDSNLOAD   Specify the Data Set Name of the SDSNLOAD Library
SCSQLOAD SYS1.SCSQLOAD   Specify the Data Set Name of the SCSQLOAD Library
SCSQANLE SYS1.SCSQANLE   Specify the Data Set Name of the SCSQANLE Library
SCSQCICS SYS1.SCSQCICS   Specify the Data Set Name of the SCSQCICS Library
SCSQAUTH SYS1.SCSQAUTH   Specify the Data Set Name of the SCSQAUTH Library
SEZACMTX SYS1.SEZACMTX   Specify the Data Set Name of the SEZARPCL and SEZACMTX libraries
SEZARPCL SYS1.SEZARPCL   Specify the Data Set Name of the SEZARPCL and SEZACMTX libraries
SISPLOAD SYS1.SISPLOAD   Specify the Data Set Name of the SISPLOAD Library
SMPLTS CICSTS31.SMPLTS   Specify Attributes of the Permanent SMP/E Data Sets
SMPMTS CICSTS31.SMPMTS   Specify Attributes of the Permanent SMP/E Data Sets
SMPPTS CICSTS31.SMPPTS   Specify Attributes of the Permanent SMP/E Data Sets
SMPSCDS CICSTS31.SMPSCDS   Specify Attributes of the Permanent SMP/E Data Sets
SMPSTS CICSTS31.SMPSTS   Specify Attributes of the Permanent SMP/E Data Sets
SMPVOL CICS31 SYSALLDA   Specify Disk Volumes
SMPWORK SYSALLDA   Specify Attributes of the Temporary SMP/E Work Data Sets
SMS NO   Specify SMS Option for DASD Allocations
TAPEUNIT 3480   Specify the distribution tape device type
TARGVOL CICS31 SYSALLDA   Specify Disk Volumes
TEMPLIB CICSTS31.TDFHINST   Specify the CICS Transaction Server Temporary Installation Libraries
TINDEX CICSTS31   Specify the Indexes of CICS Transaction Server Data Sets
TZONE TZONE   Specify SMP/E Zone Attributes
TZONECSI CICSTS31.TZONE NEW CICS31 SYSALLDA   Specify SMP/E Zone Attributes
TZONELOG CICSTS31.TZONE.SMPLOG NEW   Specify SMP/E Zone Attributes
USSDIR .   Specify the CICS TS HFS Directories and Data Sets
USSDIRA .   Specify Attributes of any additional target Libraries
UTILITIES ASMA90 IEWL GIMSMP IEBCOPY   Specify the Utilities to be used
WORKUNIT SYSALLDA   Specify the Disk Unit for Work Data Sets
XTRAQUAL . . .   Specify extra qualifiers

Specify the CICS Transaction Server Temporary Installation Libraries

Specify the data set names you want to use for the two temporary libraries that will be used to install CICS Transaction Server. If you do not want to use the default names, record your values for the TEMPLIB and LIB parameters.

TEMPLIB library_name
This specifies the name of the temporary installation library that contains the skeleton installation jobs. Specify the name of the data set into which you copied RELFILE(2) from the distribution tape (in the topic Copy RELFILE(2) from the Distribution Tape in the Program Directory).

Also specify this name on the SYSPROC DD statement of the DFHISTAR job.

LIB library_name
Specifies the name of the installation output library to which the jobs generated by the DFHISTAR job are added.

Specify the JOB Parameters for Installation Jobs

Decide what parameters you want to use on the JOB statements of the CICS Transaction Server installation jobs, and specify them on the JOB parameter:

JOB accounting_information
Specifies the JOB statement and accounting information that you want substituted into the jobs generated by the DFHISTAR job. For example:
JOB //XXXXXXXX JOB 1,userid,MSGCLASS=A,MSGLEVEL=(1,1),
JOB //         CLASS=A,NOTIFY=userid
JOB /*JOBPARM SYSAFF=node1
JOB /*ROUTE PRINT node2.userid
Notes:
  1. Do not change XXXXXXXX given in the sample JOB statement in the DFHISTAR job. This is the 8-character job name that is substituted by the DFHISTAR job. For example, for the installation job DFHIVPBT, the DFHISTAR job changes XXXXXXXX to DFHIVPBT.
  2. Normal JCL rules for coding JOB statements apply to the JOB parameter.
  3. If you want to add a TIME parameter to the CICS Transaction Server installation jobs, sample run times are given in Run Times of the Installation Jobs.
  4. Delete (or comment out) extra lines of the JOB statement that you do not need.
  5. Normal JCL rules apply when coding the JOB statement (for example, all lines except the last line must end in a comma).

Specify the Scope of the Installation

Specify the scope of the CICS Transaction Server installation on the SCOPE parameter:

SCOPE ALL|BASE|POST
Specifies whether you want to generate all the CICS Transaction Server installation and post-installation jobs, or only the post-installation jobs. When installing CICS Transaction Server from the distribution tape, you would normally specify SCOPE ALL (the default). You would normally code the other options, if necessary, during some post-installation tasks, as described in Post-installation requirements.
ALL
Specifies that you want to generate all the CICS Transaction Server installation jobs and all the post-installation jobs.
BASE
Specifies that you want to generate only the installation jobs (DFHINST1 through DFHINST6, DFHIHFS0, DFHIHFS1, and DFHISMKD) that you use to install CICS Transaction Server from the distribution tape.
POST
Specifies that you want to generate only the post-installation jobs, that you can use to create the CICS Transaction Server data sets, and run the IVPs.

Specify the Type of JES to be Used

Specify the type of job entry subsystem (JES) that you intend to use to install CICS Transaction Server on the JES parameter: This enables the DFHISTAR job to generate jobs with statements suitable for JES2 or JES3.

JES JES2|2|JES3|3
Specifies the release of JES that you are using. If you are using JES2, specify JES2 or 2. If you are using JES3, specify JES3 or 3.

Specify the Utilities to be used

Specify the utilities to be used to install CICS Transaction Server on the UTILITIES parameter:

UTILITIES asmprog binder smpeprog copyutil
Specifies the names of utility programs to be used when installing CICS Transaction Server elements and programs that it uses.
asmprog
is the program name of the assembler. Specify ASMA90, for High Level Assembler/MVS & VM & VSE, which is required.
binder
is the program name of the OS/390® binder. Ensure that program IEWL references the OS/390 program management binder.
smpeprog
is the program name of the SMP/E program. Ihe IBM-supplied name is GIMSMP.
copyutil
is the program name of the data set copy utility program. The IBM-supplied name is IEBCOPY.
Note:
The High Level Assembler must be either in the LINKLST concatenation or you must add a STEPLIB DD statement that points to the library containing the High Level Assembler in any jobs that invoke SMP/E.

Specify the Prefix of CICS Transaction Server Jobs

Specify the prefix, as one through six characters, to be added to the jobs generated by the DFHISTAR job. This prefix overwrites the first characters of the job name. For example, PREFIX USERID changes the job name DFHINST1 to USERIDT1.

PREFIX prefix
One through six characters.

Specify the Indexes of CICS Transaction Server Data Sets

Specify the high-level indexes for the CICS Transaction Server distribution, target, and SMP/E libraries allocated by the installation process.

DINDEX library_prefix
Assigns a high-level index to the CICS Transaction Server SMP/E distribution libraries (except for the SDFHLINK and SDFHLPA target libraries) allocated by the installation process.

The library_prefix value must not be longer than 26 characters, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (for example, DINDEX CICSTS31.TEST).

GINDEX library_prefix
Assigns a high-level index to the CICS Transaction Server SMP/E global libraries (except for the SDFHLINK and SDFHLPA target libraries) allocated by the installation process.

The library_prefix value must not be longer than 26 characters, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (for example, GINDEX CICSTS31.TEST).

LINDEX library_prefix
Assigns a high-level index to the SDFHLPA, SDFHLINK, SDFJLPA, SEYULINK and SEYULPA libraries allocated by the installation process. The library_prefix value must be defined in the MVS™ Master Catalog.

The library_prefix value must not be longer than 26 characters, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (for example, LINDEX SYS1.CICSTS31.CICS.TEST).

TINDEX library_prefix
Assigns a high-level index to the CICS Transaction Server SMP/E target libraries (except for the SDFHLINK, SDFHLPA, SDFJLPA, SEYULINK, and SEYULPA target libraries) allocated by the installation process.
Notes:
  1. The high-level index for the SDFHLINK and SDFHLPA libraries is defined by the LINDEX parameter.
  2. The high-level index for the data sets created by the jobs DFHCOMDS and DFHDEFDS is defined by the dsindex operand of the DSINFO parameter.

The library_prefix value must not be longer than 26 characters, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (for example, TINDEX CICSTS31.TEST).

Specify the CICS TS HFS Directories and Data Sets

The DFHISTAR job has parameters that enable you to customize the UNIX system services HFS directories.

Note:
When discussing HFS Directory names, this topic and the Program Directory use different methods to show fixed and variable names, as follows:
Table 5.
This topic uses: the Program Directory uses: to show:
/variable /@variable@ a variable value
/constant /constant a fixed value
pathprefix
The name of an optional prefix to the CICS® TS directory /usr/lpp/cicsts. For example:
/example/usr/lpp/cicsts
ussdir
The name of the CICS TS directory under /pathprefix/usr/lpp/cicsts.

The full name is therefore /pathprefix/usr/lpp/cicsts/ussdir.

Ussdir is a name that you can choose. The default for ussdir is the value of the TINDEX parameter in lowercase.

The default path is:

/pathprefix/usr/lpp/cicsts/cicsts31
Note:
The name of the UNIX System Services directory after the root directory (/usr/lpp) is always /cicsts.
HFS0DSN
The dataset name of the HFS to be mounted at directory /pathprefix/usr/lpp/cicsts/cicsts31.

Note that these directory names are fixed. The default is data set name OMVS.USR.LPP.CICSTS .

See The DFHIHFS0 Job for details of the job that uses this parameter.

HFS1DSN
The dataset name of the HFS to be mounted at directory /pathprefix/usr/lpp/cicsts/ussdir, where ussdir is the name of the directory specified on the ussdir parameter in the DFHISTAR job. The default is data set name OMVS.USR.LPP.CICSTS.CICSTS31.

See The DFHIHFS1 Job for details of the job that uses this parameter.

HFSADSN
The dataset name of the HFS equivalent of the SMP/E "additional target zone", to be mounted at directory /pathprefix/usr/lpp/cicsts/ussdira, where ussdira is the name of the directory specified on the ussdira parameter in the DFHISTAR job. The default data set name is OMVS.USR.LPP.CICSTS.CICSTS31.A.

See the list step about running DFHIHFSA in topic DFHIHFSA for details of the job that uses this parameter.

Specify extra qualifiers

Specify extra qualifiers that can optionally be inserted into the data set name of the 'target', 'distribution' and 'additional' zone data sets respectively, and inserted before the last data set qualifier. For example, XTRAQUAL JDOE . . changes the name of the target zone libraries to the values set by TINDEX.CICSTS31.CICS.JDOE.SDFHLOAD.

XTRAQUAL . . .
Three qualifiers to be used by 'target', 'distribution' and 'additional' zone data sets. If a qualifier is not required, specify a period (.).

Specify Block Sizes

Specify the block sizes to be used when allocating data sets during installation on the BLKFB80 and BLKU parameters:

BLKFB80 {0|blocksize}
The block size to be used when allocating data sets that have a fixed block record format and record length of 80 bytes.

The IBM-supplied value in DFHISTAR is 0. You are recommended to leave this value specified as 0 to allow OS/390 to determine the optimum block size for you.

BLKU {32760|blocksize}
The block size to be used when allocating data sets that have an undefined record length.
BLKISPF {3200|blocksize}
The block size to be used when allocating data sets in CICSPlex® System Manager that are intended to be used by ISPF.

Specify the Disk Unit for Work Data Sets

Specify the UNIT parameter for the disk or disks on which work data sets are stored on the WORKUNIT parameter:

WORKUNIT disktype
a unit identifier.

Specify SMS Option for DASD Allocations

Specifies the extent to which you want to leave the allocation of CICS TS installation data sets to SMS. You can either let SMS handle all DASD allocation, or you can opt to use volume parameters to control the allocations that do not have to be SMS-managed.

Note:
Some CICS TS data sets are installed in PDSE data sets. These are:

See the topic DASD Storage Requirements in the Program Directory for information about these data sets.

SMS Y|N
If you specify SMS Y, the VOLUME parameter is omitted from the generated installation jobs, and all data set allocations are handled by SMS.

If you specify SMS N, the VOLUME parameter is included on the generated installation jobs, and will be honored according to your SMS configuration. The VOLUME parameters used are those specified on the ADDTVOL, DEFVOL, DISTVOL, CMACVOL, OPTVOL, SMPVOL, and TARGVOL parameters.

Specify Disk Volumes

If you intend installing CICS Transaction Server into disk space managed by the storage management subsystem (SMS)1 component of MVS/DFP, you do not need to specify your own disk volumes; device assignment can be determined by SMS. In this case, proceed to Specify SMP/E Zone Attributes.

To allow you to make the best use of your disk space, you can specify your own disk volumes and device types to be used to install CICS Transaction Server. You can specify your own disk details on the following parameters:

DEFVOL volume disktype
Defines the default disk on which the contents of the disk volumes CMACVOL, DISTVOL, OPTVOL, SMPVOL, and TARGVOL will reside if the appropriate parameter is not coded in the DFHISTAR job. For example, if you do not code the DISTVOL parameter, the CICS distribution libraries will reside on the disk defined by DEFVOL.
volume
is one of the following:
  • The volume serial identifier, in the range 1 through 6 characters, of the default volume.
  • A period (.) if all volumes other than CMACVOL and SMPVOL that are not specifically defined by the appropriate parameter of the DFHISTAR job will be put onto any available volume. The CMACVOL and SMPVOL volumes will be put onto the same volume as the library specified by the TEMPLIB parameter.
disktype
is the UNIT parameter of the volume.

If you omit the DEFVOL parameter altogether, all volumes that are not specifically defined by the appropriate parameter of the DFHISTAR job will be put onto the same volume as the library specified by the TEMPLIB parameter.

DISTVOL volume disktype
Defines the disk on which the CICS Transaction Server distribution libraries will reside.
volume
is one of the following:
  • The volume serial identifier, in the range 1 through 6 characters, of the volume on which the distribution libraries will reside.
  • A period (.) if the CICS Transaction Server libraries are to be put onto any available volume.
disktype
is the UNIT parameter of the volume.
Note:
If you omit the DISTVOL parameter, the distribution libraries will be put on the volume specified by the DEFVOL parameter. If the DEFVOL parameter is omitted, or if a period (.) is specified for its volume operand, the distribution libraries will be put onto any available volume.
TARGVOL volume disktype
Specifies details of the disk containing the CICS Transaction Server target libraries.
volume
is one of the following:
  • The volume serial identifier, in the range 1 through 6 characters, of the volume on which the CICS Transaction Server target libraries are to reside.
  • A period (.) if the CICS Transaction Server target libraries are to be put onto any available volume.
disktype
is the UNIT parameter for the volume.
Note:
If you omit the TARGVOL parameter, the CICS Transaction Server target libraries will be put onto the volume specified by the DEFVOL parameter. If the DEFVOL parameter is omitted, or if a period (.) is specified for its volume operand, the CICS Transaction Server target libraries will be put onto any available volume.
SMPVOL volume disktype
Specifies the disk that contains the permanent, non-VSAM SMP/E data sets for CICS Transaction Server that are associated with global or distribution zones, and are therefore unique.
volume
is one of the following:
  • The volume serial identifier, in the range 1 through 6 characters, of the volume on which the permanent non-VSAM SMP/E data sets are to reside.
  • A period (.) if the permanent non-VSAM SMP/E data sets are to be put onto the same volume as the library specified by the TEMPLIB parameter.
disktype
is the UNIT parameter for the volume.
Note:
If you omit the SMPVOL parameter, the permanent non-VSAM SMP/E data sets for CICS Transaction Server will be put on the volume specified by the DEFVOL parameter. If the DEFVOL parameter is omitted, or if a period (.) is specified for its volume operand, the data sets will be put onto the same volume as the library specified by the TEMPLIB parameter.
OPTVOL volume disktype
Specifies details of the disk onto which the optional source material is copied.
volume
is one of the following:
  • The volume serial identifier, in the range 1 through 6 characters, of the volume on which the optional source material is to reside.
  • A period (.) if the optional source material is to be put on any available volume.
disktype
is the UNIT parameter of the volume. This is needed only if volume is specified.
Note:
If you omit the OPTVOL parameter, the optional source material will be put on the volume specified by the DEFVOL parameter. If the DEFVOL parameter is omitted, or if a period (.) is specified for its volume operand, the optional source material will be put onto any available volume.
CMACVOL volume
Defines the disk on which the VSAM KSDS, DFHCMACD, will reside. This data set is used for the CICS Transaction Server messages facility (CICS-supplied transaction CMAC).
volume
is one of the following:
  • The volume serial identifier, in the range 1 through 6 characters, of the volume on which the VSAM KSDS, DFHCMACD, will reside
  • A period (.) if the DFHCMACD data set is to be put onto the same volume as the library specified by the TEMPLIB parameter.
Note:
If you omit the CMACVOL parameter, the DFHCMACD data set will be put onto the volume specified by the DEFVOL parameter. If the DEFVOL parameter is omitted, or if a period (.) is specified for its volume operand, the DFHCMACD data set will be put onto the same volume as the library specified by the TEMPLIB parameter.

When Are These Volumes Used?

DFHISTAR
Volume
Parameter
 
Installing
 
 
Applying
Service
 
Customizing
 
Assembling
Resource
Tables
 
Running
CICS Transaction Server
SMPVOL X X X X
DISTVOL X X X
TARGVOL X X X X X
DZONECSI1 X X X
TZONECSI1 X X X X
GZONECSI1 X X X X

1 The entries for xZONECSI parameters are also for the associated xZONE parameters.

During installation

The RELFILE data sets on SMPVOL are needed during installation only.

Applying Service or Customizing CICS Transaction Server

SMPVOL, DISTVOL, TARGVOL, DZONE, TZONE, and GZONE are needed whenever you apply service or customize your CICS Transaction Server programs.

SMPVOL and GZONE are needed whenever you apply service or customize your alternative libraries for use with the extended recovery facility.

Assembling CICS Transaction Server Tables

SMPVOL, TARGVOL, TZONE, and GZONE are needed whenever you assemble your CICS Transaction Server tables.

SMPVOL and GZONE are needed whenever you assemble CICS Transaction Server tables for the second (alternate) CICS Transaction Server region.

Running CICS Transaction Server

Only TARGVOL is needed to run CICS Transaction Server.

Allocate the Space for CICS Transaction Server Disk Volumes

Whether or not you use SMS-managed data sets, you still need enough disk space in which to create the CICS Transaction Server disk volumes.

The space required by the installation jobs on these volumes depends on the type of disk you intend to use. The number of cylinders required on the different types of DASD are given in Table 6. The size of the CICS Transaction Server distribution and target libraries are given in the topic DASD Storage Requirements in the Program Directory .

Table 6. DASD storage requirements for CICS Transaction Server
Identification 3380 3390
CICSTS31.TDFHINST 1 1
CICSTS31.XDFHINST 1 1
Relfile data sets on SMPVOL 325 300
SMP/E non-VSAM data sets on SMPVOL 26 25
DISTVOL 312 288
TARGVOL 749 678
DZONE 11 11
TZONE 11 11
GZONE 11 11
Total during installation 1447 1327
Total after installation 1122 1027

Allow up to 15% on the values in Table 6 for servicing requirements. Secondary allocations are 10% of the primary allocations.

If you intend to store other IBM® software or your own application programs in these libraries, then you must modify the generated jobs accordingly.

Specify Attributes of the Temporary SMP/E Work Data Sets

You must define the attributes of the temporary SMP/E work data sets (SMPWRK1, SMPWRK2, SMPWRK4, and SMPWRK6): for the following CICS Transaction Server jobs: DFHINSTJ, DFHLPJPN, DFHLPUMD, and DFHSMPE. You define the attributes of those SMP/E data sets on the SMPWORK parameter:

The CICS Transaction Server jobs used to install CICS Transaction Server for z/OS® have DD statements for the SMP/E data sets that they need to know about.

SMPWORK disktype
This is the UNIT parameter for the disk that is to contain the temporary SMP/E work data sets (SMPWRK1, SMPWRK2, SMPWRK4, and SMPWRK6) needed to install CICS Transaction Server.

If you specify a value for disktype, or omit the SMPWORK parameter altogether, //SMPWRKn DD statements are added to the following jobs generated by the DFHISTAR job:

If you specify NO, a period (.), or a null string, CICS Transaction Server assumes that SMP/E knows about the temporary SMP/E work data sets. To define the attributes of the SMP/E work data sets, you must do one of the following:

Notes:
  1. The SMPWRK6 data set must not be allocated to Virtual I/O (VIO). If you specify a value for disktype, ensure that this cannot happen.

Specify Attributes of the Permanent SMP/E Data Sets

Specify the attributes of the permanent SMP/E data sets on the following parameters:

SMPPTS dsname
Specifies the name of the SMP/E primary data set used to store temporarily PTF function SYSMODs or other fixes that are in RECEIVE or APPLY status; that is, PTF fixes that have not been rejected or accepted.
SMPMTS dsname
Specifies the name of the SMP/E macro temporary store (MTS) data set used to store updated versions of macros. Although required by SMP/E, this MTS data set is not used by CICS.
SMPSTS dsname
Specifies the name of the SMP/E source temporary store (STS) data set used to store updated versions of source elements. Although required by SMP/E, this STS data set is not used by CICS.
SMPSCDS dsname
Specifies the name of the SMP/E saved control data set (SCDS) used to store old target zone entries that have been modified by inline JCLIN processing in a SYSMOD.
SMPLTS dsname
Specifies the name of the linkedit temporary (LTS) data set used with the CALLLIBS function. This dataset must always be an SMS-managed PDSE, whether or not Java™ is installed unless you have installed the PTFs for HFS and PDSE support on non-managed SMS volumes listed in Flash10007 which can be found by links from:
    http://www.ibm.com/support/techdocs

The CICS Transaction Server jobs that need to know the attributes of the SMP/E data sets have DD statements for them.

Specify SMP/E Zone Attributes

Specify the attributes of the SMP/E distribution zone, global zone, target zone, and any additional target zones.

Note:
The CICS-DB2 attachment facility contains modules named with the DSN prefix. Therefore, to prevent existing DB2® modules with the same DSNxxxxx names from being overwritten, you should not install CICS Transaction Server into the same target and distribution zones as DB2.

To specify SMP/E zone attributes, use the following parameters:

GZONELOG dsname NEW|OLD
Specifies details of the SMP/E log for the global zone CSI.
dsname
is the name of the global zone log.
NEW|OLD
Specifies whether an existing global zone log is to be used. If you specify NEW, any existing global zone log with the specified dsname is deleted, and a new global zone log is allocated. If you specify OLD, an existing global zone log is used.
TZONELOG dsname NEW|OLD
Specifies details of the SMP/E log for the target zone CSI.
dsname
is the name of the target zone log.
NEW|OLD
Specifies whether an existing target zone log is to be used. If you specify NEW, any existing target zone log with the specified dsname is deleted, and a new target zone log is allocated. If you specify OLD, an existing target zone log is used.
DZONELOG dsname NEW|OLD
Specifies details of the SMP/E log for the distribution zone CSI.
dsname
is the name of the distribution zone log.
NEW|OLD
Specifies whether an existing distribution zone log is to be used. If you specify NEW, any existing distribution zone log with the specified dsname is deleted, and a new distribution zone log is allocated. If you specify OLD, an existing distribution zone log is used.
GZONECSI cluster NEW|OLD volume disktype
Specifies details of the global zone CSI.
cluster
is the VSAM cluster name, minus the qualifier ‘.CSI’.
NEW|OLD
Specifies whether an existing global zone CSI is to be used. If you specify NEW, any existing global zone CSI with the specified cluster name is deleted, and a new global zone CSI is allocated. If you specify OLD, an existing global zone CSI is used.
volume
is either the volume serial (volser) identifier for the volume on which the global zone CSI is to be allocated or a period (.) if the CSI is to be put on a volume determined by the CICS Transaction Server installation process.
disktype
is the UNIT parameter for the volume.
TZONECSI cluster NEW|OLD volume disktype
Specifies details of the target zone CSI.
cluster
is the VSAM cluster name, minus the qualifier ‘.CSI’.
NEW|OLD
Specifies whether an existing target zone CSI is to be used. If you specify NEW, any existing target zone CSI with the specified cluster name is deleted, and a new target zone CSI is allocated. If you specify OLD, an existing target zone CSI is used.
volume
is either the volume serial (volser) identifier for the volume on which the target zone CSI is to be allocated or a period (.) if the CSI is to be put on a volume determined by the CICS Transaction Server installation process.
disktype
is the UNIT parameter for the volume.
DZONECSI cluster NEW|OLD volume disktype
Specifies details of the distribution zone CSI.
cluster
is the VSAM cluster name, minus the qualifier ‘.CSI’.
NEW|OLD
specifies whether an existing distribution zone CSI is to be used. If you specify NEW, any existing distribution zone CSI with the specified cluster name is deleted, and a new distribution zone CSI is allocated. If you specify OLD, an existing distribution zone CSI is used.
volume
is either the volume serial (volser) identifier for the volume on which the distribution zone CSI is to be allocated or a period (.) if the CSI is to be put on a volume determined by the CICS Transaction Server installation process.
disktype
is the UNIT parameter for the volume.
GZONE NEW|OLD options
Specifies whether the global zone to be used already exists.
NEW|OLD
Specifies whether an existing global zone is to be used. The DFHISTAR job as supplied specifies NEW. Optionally change this to OLD if you want to use an existing global zone. If you specify OLD, CICS Transaction Server is installed into an existing SMP/E global zone.
Note:
Specify NEW if you want to preserve your existing releases of CICS Transaction Server in their current SMP/E zones and install the new release in its own zones.

If you specify OLD, the existing SMP/E zones are used and any existing release of the product is deleted.

If you specify OLD, but specify NEW for the GZONECSI parameter, both parameters are assigned the NEW disposition.

options
Specifies the name of the SMP/E options (on the SET BOUNDARY command) to be used.
TZONE zonename
Specifies the name of the target zone.
zonename
is the name of the target zone to be used by SMP/E. This name must be unique to the target zone. It must not be longer than 7 characters, and the leading character must be alphabetic.
DZONE zonename
Specifies the name of the distribution zone.
zonename
is the name of the distribution zone to be used by SMP/E. This name must be unique within the global zone. It must not be longer than 7 characters, and the leading character must be alphabetic.

SMP/E Zone and Zone Log Dispositions

As supplied, the DFHISTAR job assumes that you are going to install CICS Transaction Server into new target and distribution zones. However you can specify a new or old global zone, and new or old zone logs by the disposition option NEW|OLD on the associated parameters of the DFHISTAR job. The disposition option NEW means that the DFHINST3 job deletes any existing zone or zone log with name specified before redefining it. For example, if you specify the parameter

GZONELOG CICSTS31.GZONE.SMPLOG NEW

the DFHINST3 job deletes any existing SMP/E global zone log with the name CICSTS31.GZONE.SMPLOG before defining a new SMP/E global zone log with that name.

Further, if you specify different dispositions for a zone parameter and its associated zone log parameter, they are both given the default disposition NEW. This is to ensure that both a zone and its zone log have the same disposition.

If you intend installing CICS Transaction Server using one new CSI for all zones, you must specify the disposition NEW on all three CSI parameters of the DFHISTAR job. For example:

DZONE          DZONE
DZONECSI       CICSTS31.SMPZONE NEW CICS31 SYSALLDA
DZONELOG       CICSTS31.DZONE.SMPLOG NEW
GZONE          NEW CICSOPT
GZONECSI       CICSTS31.SMPZONE NEW CICS31 SYSALLDA
GZONELOG       CICSTS31.GZONE.SMPLOG NEW
TZONE          TZONE
TZONECSI       CICSTS31.SMPZONE NEW CICS31 SYSALLDA
TZONELOG       CICSTS31.TZONE.SMPLOG NEW

Specify the High-level Qualifiers for SMP/E Data Sets

For each different high-level qualifier that you have specified for SMP/E zone CSIs, logs, and other SMP/E data sets, you must create an ALIAS definition in the master catalog before the data sets can be used.

Specify the distribution tape device type

Specify the type of device that is to be used to load the CICS Transaction Server distribution tape on the TAPEUNIT parameter:

TAPEUNIT devicetype
Specifies the device type to be used to read the distribution tape. Use 3480 for the 3480 tape cartridge, 3400-6 for the 6250 tape, or the unit names in use in your installation.

Specify Attributes of the CICS Transaction Server system Data Sets

Specify attributes of the CICS Transaction Server system data sets, to be created when you run the post-installation jobs DFHCOMDS and DFHDEFDS2 jobs, on the DSINFO parameter:

DSINFO dsindex volume disktype qualifier
Defines the following attributes of CICS system data sets:
dsindex
Assigns a high-level index to all the data sets defined by the jobs, DFHCOMDS and DFHDEFDS.

The leading character of dsindex must be alphabetic. dsindex can have one or two levels of index, but each level must be no longer than eight characters. If you specify more than one level of index, the names must be separated by a period (for example, CICSTS31.CICSHTC1).

volume
is the volume identifier of the volume.
disktype
is the UNIT parameter for the volume.
qualifier
is a partial qualifier added to the index for the data sets created by the jobs DFHCOMDS and DFHDEFDS. You can specify a partial qualifier of up to four alphanumeric characters; these characters are appended to the characters CICS to make the qualifier. If you specify a period (.) no qualifier is used.

Specify Attributes of any additional target Libraries

If you want to create extra copies of the CICS Transaction Server target libraries, specify the attributes of those libraries on the following parameters:

AINDEX library_prefix
Assigns a high-level index to the additional set of CICS target libraries copied by a version of the DFHINSTA job.
Notes:
  1. The high-level index for the additional SDFHLINK and SDFHLPA libraries is defined by the ALINDEX parameter.
  2. The high-level index for the data sets created by the jobs DFHCOMDS and DFHDEFDS is defined by the dsindex operand of the DSINFO parameter.

The AINDEX value must be unique (for example, it must be different from the INDEX value), it must not be longer than 26 characters, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (for example, AINDEX CICSTS31.A.TEST).

ALINDEX library_prefix
Assigns a high-level index to the additional SDFHLPA and SDFHLINK libraries allocated by running a version of the DFHINSTA job.

The library_prefix value must not be longer than 26 characters, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (for example, ALINDEX SYS1.CICSTS31.A.TEST

AZONELOG dsname
Specifies details of the SMP/E log for the additional target zone CSI.
dsname
is the name of the additional target zone log to be used by SMP/E.
AZONECSI cluster
Specifies details of the additional target zone CSI. The CSI data set is created on the volume and unit specified by the ADDTVOL parameter.
cluster
is the VSAM cluster name, minus the qualifier .CSI.
AZONE zonename
Specifies the name of the additional target zone, to be used for the set of CICS Transaction Server target libraries copied by a version of the DFHINSTA job.
zonename
is the name of the additional target zone to be used by SMP/E. This name must be unique to the target zone. It must not be longer than seven characters, and the leading character must be alphabetic.
ASMPSCDS dsname
Specifies the name of the additional zone SMP/E SCDS data set.
dsname
is the name of the additional zone SMP/E SCDS data set.
ASMPMTS dsname
Specifies the name of the additional zone SMP/E MTS data set.
dsname
is the name of the additional zone SMP/E MTS data set.
ASMPSTS dsname
Specifies the name of the additional zone SMP/E STS data set.
dsname
is the name of the additional zone SMP/E STS data set.
ASMPLTS dsname
Specifies the name of the additional zone SMP/E LTS data set.
dsname
is the name of the additional zone SMP/E LTS data set.
ADDTVOL volume disktype
Specifies the volume and unit type to contain all the additional zone data sets.
volume
is the volume serial identifier of the volume.
disktype
is the UNIT parameter for the volume.
USSDIRA dsname
Specifies the name of the UNIX System Services directory for the Additional Target zone. See job DFHINSTA.

The default is the value of the AINDEX parameter in lowercase.

The UNIX System Services directory path will start /ussindex/cicsts/ussdira where ussindex is the translated value of the USSINDEX parameter, and ussdira is the value of the USSDIRA parameter.

The default path will be: /pathprefix/usr/lpp/cicsts/cicsts31.a

Note:
The name of the UNIX System Services directory after the root directory (/usr/lpp/) is always cicsts.

Specify the Data Set Name of the SISPLOAD Library

Specify the full data set name, up to 44 characters, of the library that contains ISPLINK (SISPLOAD for ISPF Version 4 and above, or ISPLOAD for ISPF version 3 and below).
For example, SISPLOAD SYS1.USERID.SISPLOAD changes the SISPLOAD library name to SYS1.USERID.SISPLOAD. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SISPLOAD dsname
Up to 44 characters.

Specify the Data Set Name of the CSSLIB Library

Specify the full data set name, up to 44 characters, of the CSSLIB library.
For example, CSSLIB SYS1.USERID.CSSLIB changes the CSSLIB library name to SYS1.USERID.CSSLIB. This library is accessed, as read-only, during the installation of CICS Transaction Server.

CSSLIB dsname
Up to 44 characters.

Specify the Data Set Name of the SCEECPP Library

Specify the full data set name, up to 44 characters, of the SCEECPP library.
For example, SCEECPP SYS1.USERID.SCEECPP changes the SCEECPP library name to SYS1.USERID.SCEECPP. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCEECPP dsname
Up to 44 characters.

Specify the Data Set Name of the SCEELKED Library

Specify the full data set name, up to 44 characters, of the SCEELKED library.
For example, SCEELKED SYS1.USERID.SCEELKED changes the SCEELKED library name to SYS1.USERID.SCEELKED. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCEELKED dsname
Up to 44 characters.

Specify the Data Set Name of the SCEELKEX Library

Specify the full data set name, up to 44 characters, of the SCEELKEX library.
For example, SCEELKEX SYS1.USERID.SCEELKEX changes the SCEELKEX library name to SYS1.USERID.SCEELKEX. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCEELKEX dsname
Up to 44 characters.

Specify the Data Set Name of the SCEEOBJ Library

Specify the full data set name, up to 44 characters, of the SCEEOBJ library.
For example, SCEEOBJ SYS1.USERID.SCEEOBJ changes the SCEEOBJ library name to SYS1.USERID.SCEEOBJ. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCEEOBJ dsname
Up to 44 characters.

Specify the Data Set Name of the SCEESAMP Library

Specify the full data set name, up to 44 characters, of the SCEESAMP library.
For example, SCEESAMP SYS1.USERID.SCEESAMP changes the SCEESAMP library name to SYS1.USERID.SCEESAMP. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCEESAMP dsname
Up to 44 characters.

Specify the Data Set Name of the SCLBSID Library

Specify the full data set name, up to 44 characters, of the SCLBSID library.
For example, SCLBSID SYS1.USERID.SCLBSID changes the SCLBSID library name to SYS1.USERID.SCLBSID. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCLBSID dsname
Up to 44 characters.

Specify the Data Set Name of the SCSQLOAD Library

Specify the full data set name, up to 44 characters, of the SCSQLOAD library.
For example, SCSQLOAD SYS1.USERID.SCSQLOAD changes the SCSQLOAD library name to SYS1.USERID.SCSQLOAD. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCSQLOAD dsname
Up to 44 characters.

Specify the Data Set Name of the SCSQANLE Library

Specify the full data set name, up to 44 characters, of the SCSQANLE library.
For example, SCSQANLE SYS1.USERID.SCSQANLE changes the SCSQANLE library name to SYS1.USERID.SCSQANLE. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCSQANLE dsname
Up to 44 characters.

Specify the Data Set Name of the SCSQCICS Library

Specify the full data set name, up to 44 characters, of the SCSQCICS library.
For example, SCSQCICS SYS1.USERID.SCSQCICS changes the SCSQCICS library name to SYS1.USERID.SCSQCICS. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCSQCICS dsname
Up to 44 characters.

Specify the Data Set Name of the SCSQAUTH Library

Specify the full data set name, up to 44 characters, of the SCSQAUTH library.
For example, SCSQAUTH SYS1.USERID.SCSQAUTH changes the SCSQAUTH library name to SYS1.USERID.SCSQAUTH. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCSQAUTH dsname
Up to 44 characters.

Specify the Name of the Java directory

Specify the name of the Java directory for use by CICS JVM application programs.

JAVADIR directory name
This parameter is appended to /pathprefix/usr/lpp/, giving a full path name of /pathprefix/usr/lpp/javadir.

Specify the Data Set Name of the SDSNLOAD Library

Specify the full data set name, up to 44 characters, of the DB2 SDSNLOAD library.
For example, SDSNLOAD SYS1.USERID.SDSNLOAD changes the SDSNLOAD library name to SYS1.USERID.SDSNLOAD. This library is accessed, as read-only, during the installation of CICS Transaction Server.

Note:
The REXX for CICS element contains some modules that are link-edited against the DB2 load library, SDSNLOAD. If you do not have DB2 installed, the DFHINST6 job fails because SDSNLOAD cannot be allocated to the job. To avoid this, define a dummy SDSNLOAD data set, with LRECL=0 and RECFM=U, and specify the name of this empty data set on the SDSNLOAD parameter.
SDSNLOAD dsname
Up to 44 characters.

Specify the Data Set Name of the SEZARPCL and SEZACMTX libraries

Specify the full data set names, up to 44 characters, of the SEZARPCL and SEZACMTX libraries.
For example, SEZARPCL SYS1.USERID.SEZARPCL changes the SEZARPCL library to SYS1.USERID.SEZARPCL and SEZACMTX SYS1.USERID.SEZACMTX changes the SEZACMTX library name to SYS1.USERID.SEZACMTX. These libraries are accessed, as read-only, during the installation of CICS Transaction Server.

SEZARPCL dsname
Up to 44 characters.
SEZACMTX dsname
Up to 44 characters.

Specify the Data Set Name of the SCEECICS & SCEERUN libraries

Specify the full data set names, up to 44 characters, of the SCEECICS & SCEERUN libraries.
For example, SCEECICS SYS1.USERID.SCEECICS changes the SCEECICS library to SYS1.USERID.SCEECICS and SCEERUN SYS1.USERID.SCEERUN changes the SCEERUN library name to SYS1.USERID.SCEERUN. These libraries are accessed, as read-only, during the installation of CICS Transaction Server.

SCEECICS dsname
Up to 44 characters.
SCEERUN dsname
Up to 44 characters.

Specify the Data Set Name of the SCEERUN2 & SCEELIB libraries

Specify the full data set names, up to 44 characters, of the SCEERUN2 & SCEELIB libraries.
For example, SCEERUN2 SYS1.USERID.SCEERUN2 changes the SCEERUN2 library to SYS1.USERID.SCEERUN2 and SCEELIB SYS1.USERID.SCEELIB changes the SCEELIB library name to SYS1.USERID.SCEELIB. These libraries are accessed, as read-only, during the installation of CICS Transaction Server.

SCEERUN2 dsname
Up to 44 characters.
SCEELIB dsname
Up to 44 characters.

Specify the Data Set Name of the SCEEBND2 library

Specify the full data set name, up to 44 characters, of the SCEEBND2 library.
For example, SCEEBND2 SYS1.USERID.SCEEBND2 changes the SCEEBND2 library to SYS1.USERID.SCEEBND2. This library is accessed, as read-only, during the installation of CICS Transaction Server.

SCEEBND2 dsname
Up to 44 characters.

Specify Log stream and Log stream Structure Attributes.

Specify attributes of the CICS Transaction Server log streams and the coupling facility structures that you will use when you run the post-installation jobs DFHILG1, DFHILG2, DFHILG3 and DFHILG43 jobs, on the LOGGER-INFO parameter:

LOGGER-INFO strsfx logsz shuntsz jnlsz gensz sysname loghlq logmodel
Defines the following attributes of CICS Transaction Server system data sets:
strsfx
The last part of the coupling facility structure names, can be any three characters allowed in a structure name. Default 001. Used in DFHILG1, DFHILG2, DFHILG3 and DFHILG4.
logsz
The Avgbufsize for system log streams in the LOG_DFHLOG_strsfx structure. Default 500. Used in DFHILG1.
shuntsz
The Avgbufsize for shunted system log streams in the LOG_DFHSHUNT_strsfx structure. Default 4096. Used in DFHILG1.
jnlsz
The Avgbufsize for unforced user journal log streams in the LOG_USERJRNL_strsfx structure. Default 64000. Used in DFHILG1.
gensz
The Avgbufsize for forced user journal log streams and forward recovery log streams in the LOG_GENERAL_strsfx structure. Default 2048. Used in DFHILG1.
sysname
The MVS system name used to create model log streams for DFHLOG and DFHSHUNT. Default MVSX. Used in DFHILG1.
loghlq
The first qualifier of the model name for general logs and DFHLGLOG. Used in DFHILG3 and DFHILG4.
logmodel
The second qualifier of the model name for general logs. Used in DFHILG3.

1.
For further information about installing system-managed storage, and about planning for and migrating storage to an SMS-managed environment, see the MVS Storage Management Library: Storage Management Subsystem Migration Planning Guide, SC26-4406.
2.
For more information about the post-installation jobs DFHCOMDS and DFHDEFDS jobs, see Creating data sets common to all CICS regions, DFHCOMDS job.
3.
For more information about the post-installation jobs DFHILG1, DFHILG2, DFHILG3 and DFHILG4 jobs, see Defining the logger environment for CICS journaling.

[[ Contents Previous Page | Next Page Index ]]