Creating and customizing CMAS data sets

DFHISTAR allows you to create and customize your CMAS data sets, according to the parameters you set when you submit the DFHISTAR job.

DFHISTAR postinstallation members for a CMAS

When you run DFHISTAR, with a SCOPE of POST or ALL, it creates the following postinstallation members for a CMAS in the XDFHINST library:

EYUCMSDS – creates and initializes all the data sets for a CMAS. EYUCMSDS includes steps to delete the data sets so that you can rerun the job, if required. These deletions are expected to fail the first time you run the job. EYUCMSDS contains the following steps:
1. DELDREP and DEFDREP delete and define a new CMAS data repository.
2. DREPINIT is included if you do not specify the DFHISTAR OLDDREP parameter. It initializes the new CMAS data repository using the EYU9XDUT utility. EYU9XDUT creates records on the data repository to define the CMAS and, by default, a WUI CICSplex. A WUI CICSplex is not created if you specify the DFHISTAR WUI=NO option.
3. DREPCNVT is included if you specify the name of an existing data repository using the DFHISTAR OLDDREP parameter. It copies all the records from the existing repository to the new data repository, upgrading them to a format suitable for the CICS® TS for z/OS®, Version 5.2 release.
4. DELREGDS deletes the CICS data sets.
5. DEFTRACE defines the CICS auxiliary trace data sets, DFHAUXT and DFHBUXT.
6. DEFHTML defines the CICS DFHHTML data set.
7. DEFDMPS defines the CICS transaction dump data sets, DFHDMPA and DFHDMPB.
8. DEFTSTD defines the CICS auxiliary temporary storage data set, DFHTEMP.
9. DEFINTD defines the CICS intrapartition transient data set, DFHINTRA.
10. DEFLCD defines the CICS local catalog, DFHLCD.
11. INITLCD uses the DFHCCUTL utility to initialize the CICS local catalog.
12. DEFGCD defines the CICS global catalog, DFHGCD.
13. INITGCD uses the DFHRMUTL utility to initialize the CICS global catalog.
14. DEFLRQ defines the CICS local request queue data set, DFHLRQ.
15. JES3DELA and JES3DELB are included if you specify the DFHISTAR JES=JES3 option. They delete and define the CICS DFHCSD data set.
16. DELCSD deletes the CICS DFHCSD data set.
17. DEFCSD defines the CICS DFHCSD data set.
18. INITCSD uses the DFHCSDUP utility to initialize the DFHCSD data set.
EYUCMSSP – CICS system initialization overrides for a CMAS.
EYUCMS0P – EYUPARM parameters for a CMAS.
EYUCMASP – starts a CMAS.
EYUCMASJ – JCL to start a CMAS. It runs EYUCMASP.

If you use the default values for the CICSPlex® SM parameters, the EYUCMASP PROC statement is shown in the following code sample:

EYUCMASP  PROC DSNCSD='CICSTS52.CPSM.CMAS01.DFHCSD',
     RGNHLQ='CICSTS52.CPSM.CMAS01',
     CICSHLQ='CICSTS52.CICS',
     CPSMHLQ='CICSTS52.CPSM',
     PRMLIB='CICSTS52.XDFHINST'
     CICSPRM=EYUCMSSP,                CICS Parameters          
     CPSMPRM=EYUCMS0P                 CPSM Parameters

Customizing postinstallation jobs using DFHISTAR

You can use DFHISTAR to generate copies of the CMAS postinstallation jobs for a different CMAS. DFHISTAR has a SELECT parameter that allows you to specify a new name for a copy of a postinstallation job. It has the format:

SELECT jobname newname

jobname: Is the name of the job you want to regenerate.
newname: Is the name for the new copy.

You can specify more than one SELECT parameter to select multiple jobs to be regenerated in a single run of the DFHISTAR job. When you include a SELECT parameter in the DFHISTAR job, only those jobs specified by the SELECT are generated.

For a CMAS with the name CMAS02 and a CICS system identifier of CM02, you can change your DFHISTAR parameters to specify the following values:

CMASNAME CMAS02 
CMSSYSID CM02 
WUI YES 
WUIPLEX WUIPCM02 
WUINAME WUINCM02 
WUISYSID WU02
SELECT EYUCMSDS CM02CMDS             JCL to create the data sets for CMAS02  
SELECT EYUCMSSP CM02CMSP             CICS SIT overrides for CMAS02 
SELECT EYUCMS0P CM02CM0P             CICSPlex SM EYUPARM parameters for CMAS02

Using these parameters, CM02CMDS includes a step to initialize the CMAS data repository with the definitions for a WUI called WUINCM02, in a CICSplex called WUIPCM02. You can then start CMAS CMAS02, using the procedure EYUCMASP, to specify these parameters:

START EYUCMASP, DSNCSD='CICSTS52.CPSM.CMAS02.DFHCSD', 
RGNHLQ='CICSTS52.CPSM.CMAS02', CICSHLQ='CICSTS52.CICS', 
CPSMHLQ='CICSTS52.CPSM', PRMLIB='CICSTS52.XDFHINST'
CICSPRM=CM02CMSP, CPSMPRM=CM02CM0P

If you are using EYUCMASJ to start the WUI, edit it to specify these values:

CICSPRM=CM02CMSP, CPSMPRM=CM02CM0P