EYUINST EXEC parameters

Table 39 identifies all of the EYUINST EXEC parameters (supplied in the EYUISTAR and EYUISTRT members) and, when appropriate, their default values. The term None indicates that the parameter has no default. Lowercase characters indicate the source of the default value. Except as noted with the following parameter descriptions, you may specify your own values for any of these parameters.

The headings POST and STARTER, which also represent values you can specify with the SCOPE parameter, indicate the type of skeleton jobs you can tailor and generate, where:

The subheadings of CMAS and MAS indicate the environment to which the parameter applies.

Table 39. EYUINST EXEC parameters, when they are used, and their default values
Parameter POST STARTER Default value
CMAS MAS CMAS MAS
BLKU -- -- Yes Yes 6144
CINDEXnnn Yes -- Yes Yes None
CMASNAME Yes -- Yes -- None
CRELEASE Yes -- Yes Yes 6.4.0
DEFVOL Yes -- -- -- CPS310 3390
DSINFO Yes -- Yes Yes index defvol
ENVIRONMENT Yes Yes Yes Yes None
EYUIPRM Yes -- -- -- index.EYUIPRM NEW
EYUSDEF Yes -- -- -- index.EYUSDEF NEW
GZONECSI Yes Yes -- -- CICSTS31.GZONE NEW CPS310 3390
INDEX Yes Yes Yes Yes CICSTS31.CPSM
JOB Yes Yes Yes Yes //XXXXXXXX JOB
LIB Yes Yes Yes Yes index.XEYUINST
OLDDREP Yes -- -- -- None
PREFIX Yes Yes Yes Yes EYU
SCEESAMP -- -- Yes -- SYS1.SCEESAMP
SCOPE Yes Yes Yes Yes POST
SELECT Yes Yes Yes Yes None
SMPWORK Yes Yes -- -- SYSDA
SYSIDNT Yes -- -- -- None
TEMPLIB Yes Yes Yes Yes index.SEYUINST
TIMEZONE Yes -- -- -- None
TZONE Yes Yes -- -- TZONE
UTILITIES Yes Yes -- -- ASMA90 IEWL GIMSMP
Start of changeWORKUNITEnd of change Start of changeYesEnd of change Start of changeYesEnd of change Start of changeYesEnd of change Start of changeYesEnd of change Start of changeSYSDAEnd of change
Start of changeWORKVOLEnd of change Start of changeYesEnd of change Start of changeYesEnd of change Start of changeYesEnd of change Start of changeYesEnd of change Start of change-End of change

The EYUINST EXEC parameters are:

BLKU blocksize
Indicates the block size to be used when allocating data sets that have an UNDEFINED record length.

The default is 6144.

CINDEXnnn library_prefix
Where nnn represents a CICS® Transaction Server for z/OS® release

(Required.) The value of nnn must correspond to the release level specified for the CRELEASE parameter. That is:

The index value must not exceed 26 characters in length, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (as in CINDEX CICS.TEST) The index is used for the following data sets:

One or more CINDEXnnn parameters must be specified as required by the CRELEASE parameter values.

No default is assumed.

CMASNAME name
(Required when you specify CMAS with the ENVIRONMENT parameter.)

For POST, identifies a 1- to 8-character name that is to be assigned to a CMAS.

For STARTER, designates the Starter Set environment to be created so that the appropriate subset of members are selected from the library you identify via the TEMPLIB parameter.

The name of a CMAS must be unique within the CICSPlex® SM environment. It should not be the same as the name of another CMAS, a CICSplex, a CICS system, or a CICS system group.

EYUCMS1A
Indicates that all of the Starter Set jobs associated with System A are to be created.
EYUCMS1B
Indicates that all of the Starter Set jobs associated with System B are to be created.

No default is assumed.

CRELEASE value1 value2 value3 value4 value5
Identifies the CICS release level for each CICS region referenced by this run of EYUINST. From one to five values may be defined.

When SCOPE=STARTER, this identifies the CICS release level for each CICS region installed for one of the three MVS/ESA images associated with the Starter Set. When the SCOPE parameter is not equal to STARTER, only the first value is used. Valid values are 5.3.0, 6.2.0, 6.3.0 and 6.4.0..

The default is 6.4.0 for all five regions.

Table 40 shows the Starter Set CICS region that is assigned the values entered for the CRELEASE parameter. The EYUINST EXEC must be run three times in order to edit the Starter Set members for the three MVS™ images. For example, when the EYUINST EXEC is run to edit the Starter Set members for System B, the second value entered on the CRELEASE parameter determines the CICS release level assigned to the MAS1B CICS region.

Table 40. Starter Set CICS regions assigned values by the CRELEASE parameter
MVS Image CRELEASE value for each CICS region
6.4.0 6.4.0 6.4.0 6.4.0 6.4.0 6.4.0
System A CMS1A MAS1A MAS2A MAS3A MAS4A MAS5A
System B CMS1B MAS1B MAS2B MAS3B MAS4B MAS5B
DEFVOL volume disktype
Defines the default disk on which the CICSPlex SM libraries are to reside if the appropriate parameter is not coded in the job used to run the EYUINST EXEC. For example, if you do not code the DISTVOL parameter, the CICSPlex SM distribution libraries will reside on the disk defined using the DEFVOL parameter.
volume
Is the volume serial identifier (volser) of the volume.

Use a period to specify the volser allocated in the SYSPROC DD statement of the job used to run the EYUINST EXEC.

disktype
Is the UNIT parameter of the volume.

Use a period to specify the UNIT parameter of the volume allocated in the SYSPROC DD statement.

If both DEFVOL parameters are defined as SMS, then other statements including VOLUME and DISK values specified with a period, default also to SMS.

The defaults are the volser and unit specified with the SYSPROC DD statement.

DSINFO dsindex volume disktype
Defines details of the data sets to be created when you run either the post installation jobs or the Starter Set jobs.
dsindex
Is a high-level index that is to be assigned to all CICSPlex SM data sets defined by either the post-installation jobs or Starter Set jobs.

You can specify a multilevel index, where the leading character is alphabetic, each level does not exceed eight characters in length, and the total length of the data set name does not exceed 17 characters. If you specify more than one level of index, the names must be separated by a period (for example, data.set.index).

Use a period to specify the high level index associated with the INDEX parameter.

volume
Is the volser of the data sets to be created

Use a period to specify the volser associated with the DEFVOL parameter.

disktype
Is the UNIT parameter for the volume.

Use a period to specify the UNIT parameter associated with both DEFVOL parameters.

The defaults are the high-level index specified with the INDEX parameter and the volser and unit specified with the DEFVOL parameter. If you are using SMS, and values other than the DFHVOL defaults, you must code SMS for each of these values.

ENVIRONMENT CMAS|MAS
(Required.) Identifies the type of environment that is to be supported in the MVS image into which CICSPlex SM is installed.
CMAS
Indicates that the MVS image is to have one or more CMASs and MASs.
MAS
Start of changeIndicates that the MVS image is to have only one or more MASs, and no CMASs.End of change

No default is assumed.

EYUIPRM dsname NEW|OLD
Defines details of the CICSPlex SM cross-system definitions repository.
dsname
Is the data set name of the parameter repository.

Use a period to specify dsinfo.EYUIPRM, where dsinfo is the index specified with the DSINFO parameter.

NEW|OLD
Indicates whether an existing parameter repository is to be used. With NEW, any existing file with the specified name is deleted and a new parameter repository is allocated. With OLD, an existing parameter repository is used.

The default is NEW.

The defaults are index.EYUIPRM NEW.
EYUSDEF dsname NEW|OLD
Defines details of the CICSPlex SM screen repository.
dsname
Is the data set name of the screen repository.

Use a period to specify dsinfo.EYUSDEF, where dsinfo is the index specified with the DSINFO parameter.

NEW|OLD
Indicates whether an existing screen repository is to be used. With NEW, any existing file with the specified name is deleted and a new screen repository is allocated. With OLD, an existing screen repository is used.

The default is NEW.

The defaults are index.EYUSDEF NEW.
GZONECSI cluster NEW|OLD volume disktype
Specifies details of the global zone CSI. Ensure that the values specified correspond to the values used for GZONECSI for DFHISTAR.
cluster
Is the VSAM cluster name, minus the qualifier .CSI.

Use a period to specify index.GLOBAL, where index is the value associated with the INDEX parameter.

NEW|OLD
Specifies whether an existing global zone CSI is to be used. With NEW, any existing global zone CSI with the specified cluster name is deleted and a new global zone CSI is allocated. With OLD, an existing global zone CSI is used.

Use a period to specify OLD.

volume
Is the volser identifier for the volume on which the global zone CSI is to be allocated.

Use a period to specify the volser associated with the SMPVOL parameter.

disktype
Is the UNIT parameter for the volume.

Use a period to specify the UNIT parameter associated with the SMPVOL parameter.

The disposition, volume, and unit values are ignored when the SCOPE is POST.
INDEX library_prefix
Assigns a high-level index to the CICSPlex SM distribution, target and SMP/E libraries.

The index value must not exceed 26 characters in length, and the leading character must be alphabetic. If you specify more than one level of index, the names must be separated by a period (as in INDEX CICSTS31.CPSM.LEVEL2).

The default is the data set name, without the lowest level qualifier, specified with the SYSPROC DD statement in the EYUISTAR job.

JOB accounting_information
Specifies the JOB statement and JES information that you want substituted into the jobs generated by the job used to run the EYUINST EXEC. To do this, edit the sample JOB statement in the job used to run the EYUINST EXEC to specify the appropriate information, as in:
   JOB        //XXXXXXXX JOB 1,userid,MSGCLASS=A,MSGLEVEL=(1,1),
   JOB        //         CLASS=A,NOTIFY=userid
   JOB        /*JOBPARM SYSAFF=node1,LINES=99
   JOB        /*ROUTE PRINT node2.userid
Normal JCL rules for coding JOB statements apply to the JOB parameter.

The default is //XXXXXXXX JOB.

The job name is ignored. The name is the input member name after it is altered by the PREFIX parameter.

LIB library_name
Specifies the 1- to 44-character name of the library to which the customized members generated by the EYUISTAR program are to be added.

The default is the data set name specified with the SYSPROC DD statement in the job used to run the EYUINST EXEC, where the lowest level qualifier is replaced with XEYUINST, as in CICSTS31.CPSM.XEYUINST. (If necessary, the job used to run the EYUINST EXEC creates the library specified on the LIB parameter.)

OLDDREP dsname
Identifies an existing data repository that is being used by a previous release of CICSPlex SM. The records in the existing data repository are migrated to a new data repository for CICS TS for z/OS, Version 3.1. The existing data repository is not modified.
dsname
Is the VSAM cluster name of the existing data repository.

The new CICS TS for z/OS, Version 3.1 data repository will have the name:

  dsinfo.EYUDREP.cmasname

where:

dsinfo
Is the index specified with the DSINFO parameter.
cmasname
Is the name specified with the CMASNAME parameter.

Use a period to have an empty data repository created for CICS TS for z/OS, Version 3.1.

PREFIX prefix
Defines the 1- to 7-character prefix that is to be added to the jobs generated by the job used to run the EYUINST EXEC. This prefix overwrites up to seven characters of the job name. For example, PREFIX XYZ changes the name of the job EYUDEFDS to XYZDEFDS.

The default is EYU.

SCEESAMP data set name
Specifies the name of the Language Environment® library that contains the CEECCSD and CEECCSDX members. The default is SYS1.SCEESAMP.
SCOPE POST|STARTER
Indicates which group of jobs you want to generate. Specify:
POST
Generates only the post-installation jobs.
STARTER
Generates only the Starter Set jobs.

The SELECT parameter overrides the SCOPE parameter; that is, if you use both SCOPE and SELECT in the job used to run the EYUINST EXEC, only the job identified by SELECT is generated.

The default is for EYUISTAR is POST.

SELECT jobname1 [newname1]
Identifies the member containing the post-installation or Starter Set job you want to generate. To generate multiple jobs, specify a separate SELECT parameter for each.
jobname
Is the name of the member containing the job to be generated.
newname
Is a new 1- to 8-character name that is to be assigned to the member containing the job.

The SELECT parameter overrides the SCOPE parameter; that is, if you use both SCOPE and SELECT in the job used to run the EYUINST EXEC, only the job identified by SELECT is generated.

No default is assumed.

SYSIDNT value
(Required when you specify CMAS with the ENVIRONMENT parameter.) Specifies the 4-character system identifier used with the CICS TS for z/OS system initialization table (SIT) parameter SYSIDNT for the CMAS. This value is assigned to the data repository created by the EYUDEFDS post-installation job.

If you are setting up more than one CMAS, you must create a separate data repository for each CMAS.

No default is assumed.

TEMPLIB library_name
Identifies the 1- to 44-character name of the library containing the input members to be edited, when SCOPE is set to:

Using the suggested SMP/E target data sets of CICSTS31.CPSM.SEYUINST or CICSTS31.CPSM.SEYUJCL ensure that subsequent runs of the job used to run the EYUINST EXEC will use the updated version of the input members after maintenance is applied.

The default is the data set name specified with the SYSPROC DD statement in the job used to run the EYUINST EXEC.

TIMEZONE code
Required when you specify CMAS with the ENVIRONMENT parameter.

Specifies the time zone assigned to the data repository initialized by post-installation job EYUDEFDS for use by the CMAS named using the CMASNAME parameter.

For additional information about how CICSPlex SM uses the time zone codes, see the CICSPlex System Manager Administration manual.

TZONE zonename
Specifies 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 seven characters and the leading character must be alphabetic.

Use the same name as that specified for TZONE for DFHISTAR.

The default is TZONE.

UTILITIES asmprog lkedprog smpeprog
Specifies the names of the utility programs to be used when installing CICSPlex SM and programs that it uses.
asmprog
Is the program name of the assembler.

Use a period to specify ASMA90.

lkedprog
Is the program name of the linkage editor.

Use a period to specify IEWL.

smpeprog
Is the program name of the SMP/E program.

Use a period to specify GIMSMP.

The defaults are ASMA90 IEWL GIMSMP.
WORKUNIT
Specifies the UNIT parameter for the disk or disks on which work data sets are stored. Start of changeIf SMS is active, a value of NO may be used to prevent EYUINST from specifying a UNIT on the allocation of the work data sets. End of change

The default is SYSDA.

Start of changeWORKVOLEnd of change
Start of changeOptionally specifies the VOLUME parameter to be used by the work data sets allocated on the WORKUNIT unit.

The default is a period.

End of change
[[ Contents Previous Page | Next Page Index ]]