Running the installation customization program

The installation customization program helps you to customize the CICS® IA sample jobs, clists, and SQL definitions. It creates customized installation jobs in which the names of system entities, such as the high-level qualifier (hlq) of the CICS IA data sets, are set to specified values to suit your local environment.

Worksheet for the installation customization program contains a worksheet for use with the installation customization program. The worksheet consists of a table of installation variables, such as _dbid_, the identifier of the DB2® database, that can be passed to the installation customization program. You can record the value that you assign to each variable in the "Value" column of the table.

Before running the installation customization program talk to the relevant systems personnel to gather the information about the local system environment, such as the high-level qualifiers of data sets that you need to run the installation customization program. Use the worksheet as a memory jogger, and to record the values that you need.

To invoke the installation customization program, run member CIUCNFG1 of the SCIUEXEC library. The program requires two parameters to be passed to it:
  1. The high-level qualifier of the CICS IA data sets &HLQ.
  2. The national language to be used in messages and on panels &LANG. Two languages are supported:
    ENU
    American English (the default)
    JPN
    Japanese
For example, you could invoke the installation customization program by entering the following at an ISPF command line: Start of change
tso ex 'CICSIA.V320.SCIUEXEC(CIUCNFG1)' 'CICSIA.V320 ENU'
End of change
Customized members of each CICS IA library are saved as follows:

The members of '&HLQ.SCIUDAT1' and '&HLQ.SCIUDAT2' are not customized but are copied to '&HLQ.SCIUDAT1.OUT' and '&HLQ.SCIUDAT2.OUT'.

Note:
  1. For convenience, in this and the following sections the customized output files are given the names of their respective input files with a suffix of "OUT". However, you can change the names of the output files allowing you to create configured data for different CICSPlexes and different levels of CICS.
  2. You cannot change the names of some system entities using the installation customization program. For lists of those that can and those that cannot, see Worksheet for the installation customization program.