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.
  • If encrypted communication is required, and SSL_REQUIRED is set to a value other than NO, specify ATTLS=YES. Encrypted communication without AT-TLS is not supported.
  • You can optionally specify ATTLS_ERROR_ACTION before SPAWN_PARMS_SECTION to control how the server responds when an AT-TLS error is encountered. Valid values are STOP_SERVER and STOP_SESSION. The default is STOP_SERVER.
  • If SPAWN_TIME is omitted, or specified as 0 or less, the server uses a default value of 600 seconds. Values from 1 through 6 are invalid and cause a severe configuration error.

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.