Update sample HFICONFG

The CONFIG ddname in the ZCC server JCL procedure provides parameters that can be used to configure the ZCC server on startup. A sample configuration member is provided in HFI.SHFISAM1(HFICONFG), and the member can be customized as required.

Update the sample configuration member to suit your site, according to the comments in that member. In general terms, review the following items in the config file:

  • Alter ddname=SYSOUT=H to suitable classes for your site. For example, for tracing activity, the CONFIG=DEFAULT section contains a SPAWN_DD=HFITRACE=SYSOUT=H card that other configurations inherit and write trace output (if activated) to. Adjust this class to a class suitable for your site.
  • Alter SPAWN_STEPLIB data set names to the installation high-level qualifiers for the relevant libraries. The SPAWN_STEPLIB statement is not required if all of the libraries are already in the linklist for your site.
  • If a configuration makes use of the SPAWN_JOBNAME statement, then all address spaces that are launched for that connection type run with that specified jobname (the owner of each job reflects the user that is logged in).
  • Do not alter CONFIG=name and SPAWN_PROGRAM=name values unless otherwise detailed in the participating product's documentation.

The configuration file supports the setting and reference of substitution variables in the following form:

$VAR=value

For setting these variables, specify the above form before the first CONFIG statement, or between the CONFIG and SPAWN_PARMS_SECTION statements. If using concatenations for the CONFIG DD, the first CONFIG refers to the statements in the first of the concatenations.

In following statements in the configuration, occurrences of '$VAR' are replaced by the 'value' specified. This could be used to represent high level qualifiers that are repeated in the configuration file. For example, set the value: 

$HFIHLQ=SYS1.HFI

Then allow a reference in a following statement, such as: 

SPAWN_STEPLIB=$HFIHLQ.SHFIMODA

The sample HFICONFG makes use of this for high level qualifiers but it could also be used for other substitutions as desired.