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, and if needed, edit and submit
the DFHISTAR job again.
The DFHISTAR job produces a job log and, if necessary, an error code:
- The output job log lists the values that were actually used for the parameters
of the DFHISTAR job.
- If any error occurs when running the DFHISTAR job, an error code of 4
or 12 is returned. For error code 4, the skeleton jobs are tailored and added
to the CICSTS31.XDFHINST library. For error code 12, the skeleton jobs are
not tailored or copied. To resolve the cause of either error code, examine
the output job log and, if necessary, edit and submit the DFHISTAR job again.
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 ]]