Run the DFHISTAR Job

When you have edited the DFHISTAR job with the values of installation parameters for your CICS Transaction Server environment, save it.

When you are ready to tailor the skeleton jobs, submit the DFHISTAR job.

In addition to the UNIX system services HFS jobs, there are three other HFS-related members supplied in SDFHINST. These are DFHBPXP0, DFHBPXP1, and DFHBPXPA.

DFHBPXP0
This member contains a MOUNT command for inclusion in a BPXPRMxx member of the SYS1.PARMLIB dataset. The MOUNT command applies to the HFS dataset specified in the HFS0DSN parameter of the DFHISTAR job to be mounted at directory /pathprefix/usr/lpp/cicsts.

Add this mount command to the BPXPRMxx PARMLIB member after you have run the DFHIHFS0 job.

DFHBPXP1
This member contains a MOUNT command for inclusion in a BPXPRMxx member of the SYS1.PARMLIB dataset. The MOUNT command applies to the HFS dataset specified in the HFS1DSN parameter of the DFHISTAR job to be mounted at directory /pathprefix/usr/lpp/cicsts/ussdir, where ussdir is the name of the directory specified in the ussdir parameter in the DFHISTAR job

Add this mount command to the BPXPRMxx PARMLIB member after you have run the DFHIHFS1 job.

DFHBPXPA
This member contains a MOUNT command for inclusion in a BPXPRMxx member of the SYS1.PARMLIB dataset. The MOUNT command is for HFS dataset specified in the HFSADSN parameter of the DFHISTAR job to be mounted at directory /pathprefix/usr/lpp/cicsts/ussdira, where ussdira is the name of the directory specified in the ussdira parameter in the DFHISTAR job.

Add this mount command to the BPXPRMxx PARMLIB member after you have run the DFHIHFSA job.

When the DFHISTAR job has run, the jobs listed in the topic Skeleton jobs in RELFILE(2) copied to the TDFHINST library in the Program Directory (apart from the DFHISTAR job) are tailored to your CICS Transaction Server environment and added to the library that you specified on the LIB parameter of the DFHISTAR job (by default, the CICSTS31.XDFHINST library). If necessary, the DFHISTAR job creates the library specified on the LIB parameter.

The highest expected return code is 0.

Check the Output from the DFHISTAR Job

Check the output from the DFHISTAR job, and if needed, edit and submit the DFHISTAR job again.

The DFHISTAR job produces a job log and, if necessary, an error code:

You can run the DFHISTAR job any number of times to alter the attributes of the jobs that it creates.

When running the DFHISTAR job after the first time, you can select specific jobs to be created, by using the SCOPE or SELECT 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 six installation jobs DFHINST1 through DFHINST6 that you can 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.
SELECT jobname newname
Specifies the new name for a copy of a post-installation job to be generated when you run the DFHISTAR job. You can specify several SELECT parameters to select several post-installation jobs to be regenerated in one run of the DFHISTAR job. The SELECT parameter overrides the POST parameter; that is, if you use the SELECT parameter in the DFHISTAR job, only those jobs specified by SELECT are generated.
Note:
If you are using the SELECT parameter to generate copies of the post-installation jobs for a new CICS Transaction Server region, you should also change the DSINFO parameter to specify details of the data sets for the new CICS® region.

For example, to create copies of the jobs DFHDEFDS and DFHIVPOL for the CICS Transaction Server region CICSINS you could specify the DSINFO and SELECT parameters of the DFHISTAR job:

DSINFO userid.CICSTS31 H3P061 SYSALLDA INS
SELECT DFHDEFDS INSDEFDS
SELECT DFHIVPOL INSIVPOL

If you then run the DFHISTAR job, it would create the INSDEFDS job as a copy of the DFHDEFDS job, and the INSIVPOL job as a copy of the DFHIVPOL job, substituting the values that you specified on DSINFO into the new jobs.

You could then change the DSINFO and SELECT parameters, and run the DFHISTAR job to create other copies of the post-installation jobs for another CICS Transaction Server region.

[[ Contents Previous Page | Next Page Index ]]