Working with the customization parameters file

These guidelines describe how to enter values in the customization parameters file.

The customization parameters file, USERHLQ.USERSAMP(CECCUSPC), contains pairs of keyword and value settings used to customize JCL and configuration files in the USERHLQ.USERSAMP and USERHLQ.USERCONF data sets.

The following sections provide guidelines for entering input into the customization parameters file, describe how the file is organized, and list the keyword and value settings that the customization parameters file contains. Other considerations include the use of job cards, pre-defined variables, and STEPLIB concatenations.

Input guidelines

The following guidelines describe how to enter values in the customization parameters file:
  • Keyword and value pairs:
    • You cannot change the keyword component.
    • You must delimit the value component with double quotes ("").
    • Spaces are allowed before and after the keyword and value.
    • Values cannot span multiple lines.
  • The minimum required parameters that you must change for a successful installation are denoted by an asterisk within parentheses at the end of the comment for that parameter. For example: CACINHLQ="&CACINHLQ" HLQ of Classic product(*)
  • Comments:
    • An asterisk (*) in column 1 defines the line as a comment line.
    • Any input that you include after the first space after the value component is treated as comments.

File organization

The following table describes the organization of the customization parameters file.
Table 1. Organization of the customization parameters file.
Section name Section content
Common installation section Parameters that apply to all installations, such as the high-level qualifier for the Classic product installation
Data server files parameters Parameters associated with the metadata catalog and configuration files needed for the data server.
Source server parameters section Parameters that apply to the data source that you specify for the SERVERROLE.
IMS data sources: The customization parameters file contains the following sections for source servers when you specify SERVERROLE=CDC_IMS_SRC.
Source server parameters Parameters that apply to the source server
Source catalog migration parameters Migration parameters that control catalog migration for the source server.
Source security parameters Security parameters that control user connections for the source server
Source log stream parameters Log stream parameters for the source server
Source IMS parameters IMS-specific parameters for the source server
Source IBM® MQ delimited publishing parameters Publishing parameters for delimited format subscriptions for the source server
VSAM data sources: The customization parameters file contains the following sections for source servers when you specify SERVERROLE=CDC_VSAM_SRC.
Source server parameters Parameters that apply to the source server
Source security parameters Security parameters that control user connections for the source server
Source log stream parameters Log stream parameters for the source server
Source VSAM parameters VSAM-specific parameters for the source server
Source MQ delimited publishing parameters Publishing parameters for delimited format subscriptions for the source server

Use of job cards

Job card information is defined in the common installation section of the customization parameters file. The following two-line job card information is used as a template when generating JCL members:
CACDJOB1="JOB (CLASSIC),'CLASSIC JOB',CLASS=A,"
CACDJOB2="MSGCLASS=X,NOTIFY=&SYSUID"
The CACDJOB1 value is placed after the job name in each generated JCL member. The CACDJOB2 value is provided on the second line of the job card in each JCL member.

The initial value for the job card keywords is populated from the job card that is specified on the JCL member.

Use of pre-defined variables

Many of the data set values in the customization parameters file contain pre-defined variables such as &CEC to reference previously defined high-level qualifiers. Most of the generated JCL members make use of inline PROC definitions. These variables reference the actual PROC variables. The following table describes what each variable defines:
Table 2. Pre-defined variables.
Variable Description
&CEC Classic product installation high-level qualifier
&USERHLQ User SCACSAMP high-level qualifier
&IMS IMS installation high-level qualifier

Library concatenations

For Classic data server parameters that require specific DD data set concatenation customization such as STEPLIB, parameters are provided for concatenation. You can specify the same parameter keyword multiple times. The order specified for the parameter keywords is the order in which the data sets will be included in the data set concatenation.