Creating and customizing MAS data sets

Use DFHISTAR to create and customize your managed CICS® system (MAS) data sets, according to the parameters that you set when you submit the DFHISTAR job.

DFHISTAR postinstallation members for a MAS

When you run DFHISTAR, with a SCOPE of POST or ALL, it creates the following postinstallation members for a managed CICS system (MAS) in the XDFHINST library:
  • EYUCSYDS – creates and starts all the data sets for a MAS. EYUCSYDS 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 that you run the job. EYUCSYDS contains the following steps:
    1. DELHIST and DEFHIST delete and define CICSPlex® SM history data sets EYUHISTA and EYUHISTB.
    2. HISTINIT uses the EYU9XHID utility to start the history data sets.
    3. JES3DELA and JES3DEFA are included if you specify the DFHISTAR JES=JES3 option. They delete and define the CICS local catalog, the global catalog, and the local request queue.
    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 start the CICS local catalog.
    12. DEFGCD defines the CICS global catalog, DFHGCD.
    13. INITGCD uses the DFHRMUTL utility to start the CICS global catalog.
    14. DEFLRQ defines the CICS local request queue data set, DFHLRQ.
    15. JES3DEFA 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 start the DFHCSD data set.
  • EYUJHIST creates a pair of CICSPlex SM history data sets. EYUCSYDS includes steps to create two history data sets, EYUHISTA and EYUHISTB. You can use EYUJHIST if you want to add more history data sets (up to a maximum of 26). It contains the following steps:
    • DELHIST and DEFHIST delete and define a pair of CICSPlex SM history data sets.
    • HISTINIT uses the EYU9XHID utility to start the history data sets.
  • EYULMSSP provides CICS system initialization overrides for a managed CICS system.
  • EYULMS0P provides CICSPlex SM EYUPARM parameters for a managed CICS system.
  • EYUCSYSP starts a managed CICS system.
  • EYUCSYSJ starts a managed CICS system. It runs EYUCSYSP.
If you use the default values for the CICSPlex SM parameters, the EYUCSYSP PROC statement is shown in the following code sample: 
EYUCSYSP  PROC DSNCSD='CICSTS52.CPSM.CSYS01.DFHCSD',         
     RGNHLQ='CICSTS52.CPSM.CSYS01',                  
     CICSHLQ='CICSTS52.CICS',                       
     CPSMHLQ='CICSTS52.CPSM',                       
     PRMLIB='CICSTS52.XDFHINST',
     CICSPRM=EYULMSSP,               CICS Parameters         
     CPSMPRM=EYULMS0P                CPSM Parameters

Customizing postinstallation jobs using DFHISTAR

You can use DFHISTAR to generate copies of the managed CICS system postinstallation jobs for a different CICS region. Use the DFHISTAR SELECT parameter to specify a new name for a copy of a postinstallation job. It has this format: 
SELECT jobname newname
jobname
Is the name of the job that 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 MAS with the name CSYS02 and a CICS system identifier of CS02, you can change your DFHISTAR parameters to specify these options:
CMASNAME name of the CMAS to which this managed system connects
CMSSYSID CICS system identifier of the CMAS to which this managed system connects
CSYSPLEX name of the CICSplex to which this managed system is to be associated
CSYSNAME CSYS02
CSYSYSID CS02
SELECT EYUCSYDS CS02CSDS                 JCL to create the data sets for CSYS02     
SELECT EYULMSSP CS02CSSP                 CICS system initialization overrides for CSYS02
SELECT EYULMS0P CS02CS0P                 CICSPlex SM EYUPARM parameters for CSYS02
You can then start the managed CICS system, CSYS02, using the procedure EYUCSYSP: 
START EYUCSYSP, DSNCSD='CICSTS52.CPSM.CSYS02.DFHCSD',
RGNHLQ='CICSTS52.CPSM.CSYS02', CICSHLQ='CICSTS52.CICS', 
CPSMHLQ='CICSTS52.CPSM', PRMLIB='CICSTS52.XDFHINST'
CICSPRM=CM02CSSP, CPSMPRM=CM02CS0P
If you are using EYUCSYSJ to start the WUI, edit it to specify these options:
CICSPRM=CS02CSSP, CPSMPRM=CS02CS0P