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.
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.
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:
- 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.
- Normal JCL rules for coding JOB statements apply to the JOB
parameter.
- 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.
- Delete (or comment out) extra lines of the JOB statement that
you do not need.
- 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 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 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 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, 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 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:
- The high-level index for the SDFHLINK and SDFHLPA libraries
is defined by the LINDEX parameter.
- 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).
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 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 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 UNIT parameter for the disk or disks on which work
data sets are stored on the WORKUNIT parameter:
- WORKUNIT disktype
- a unit identifier.
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:
- The SMP/E SMPLTS data set.
- The distribution library, ADFJMOD.
- The target libraries SDFJLOAD, SDFJLPA, and SDFJAUTH.
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.
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.
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.
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:
- DFHINSTJ
- DFHLPUMD
- DFHSMPE
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:
- Provide appropriate DDDEFS for the temporary SMP/E work data
sets.
- Have applied the SMP/E sample usermod (SMP0001) that contains
superzap statements for updating the default attributes of the SMP/E data
sets in the GIMMPDFT module.
The GIMMPDFT module, which is part
of SMP/E, defines the default attributes of SMP/E data sets, and can be used
to dynamically allocate data sets to be used by all zones. The usermod is
in member GIMZPDFT in the SYS1.SAMPLIB library. You can use this usermod as
a model, change it to meet your needs, or install it as supplied. For further
information about the entries in the GIMMPDFT module and the sample entry
values in the usermod SMP0001, see the System Modification Program Extended: Reference manual, SA22-7772.
Notes:
- 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 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 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
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 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, 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.
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:
- The high-level index for the additional SDFHLINK and SDFHLPA
libraries is defined by the ALINDEX parameter.
- 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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.
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.
For more information about the post-installation jobs DFHCOMDS and DFHDEFDS
jobs, see
Creating data sets common to all CICS regions,
DFHCOMDS job.
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 ]]