Worksheet for the installation customization program

This section contains a worksheet for use with the installation customization program.

The installation customization program allows you to create 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. 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.

Note: If you are creating the IA DB2 database on V8.1 of DB2 in compatability mode, enter V710 into the DB2 version variable in the configuration exec.

The installation customization program is described in Running the installation customization program.

Table 1. Variables that can be passed to the installation customization program
Section Variable Description Value
Output datasets _outsmp1_

REQUIRED

OUTPUT DSN FOR SCIUSMP1
Start of changeThe output data set that contains the modified hlq.SCIUSAMP members except the database related ones. Default value is SYSDA.End of change
 
_outsmp2_

REQUIRED

OUTPUT DSN FOR SCIUSMP2(DB2)
Start of changeThe output data set that contains the modified database related hlq.SCIUSAMP members.End of change
 
_outsamn_

REQUIRED

OUTPUT DSN FOR SCIUSAME/K
The output data set that contains the modified hlq.SCIUSAME/K members.
 
_outclis_

REQUIRED

OUTPUT DSN FOR SCIUCLIS
The output data set that contains the modified hlq.SCIUCLIS members.
 
_outsql_

REQUIRED

OUTPUT DSN FOR SCIUSQL
The output data set that contains the modified hlq.SCIUSQL members.
 
_outdat1_

REQUIRED

OUTPUT DSN FOR SCIUDAT1
The output data set that contains the copied hlq.SCIUDAT1 members.
 
_outdat2_

REQUIRED

OUTPUT DSN FOR SCIUDAT2
The output data set that contains the copied hlq.SCIUDAT2 members.
 
_vvv_

REQUIRED

OUTPUT DEVICE TYPE
The output device on which the CICS IA VSAM files are catalogued.
 
CICS IA variables _hlq_

OPTIONAL

IA PRODUCT QUALIFIER
The high-level qualifier (hlq) of the CICS IA data sets. Passed as input to the CIUCNFG1 program.
 
_ciuhlq_

REQUIRED

IA VSAM FILE QUALIFIER
The data set qualifier for the CICS IA VSAM and output files.
 
_ciuhlqc_

OPTIONAL

IA CSV FILE QUALIFIER
The data set qualifier for QSAM CSV files.
 
_lsnamhlq_

REQUIRED

IA LOG STREAM QUALIFIER
 
_lscfdasd_

REQUIRED

COUPLING FACILITY or DASD
Specify CF if the logstream to be managed by Coupling Facility, or DASD for a DASD-only logstream definition. Default value is CF.
 
_lshlq_

REQUIRED

LOG STREAM DATASET NAME HLQ
The high-level qualifier for both the log stream data set name and the staging data set name. Default value is IXGLOGR.
 
_lsstrcnm_

OPTIONAL

IA LOG STREAM STRUCTNAME
The name of the coupling facility structure associated with the coupling facility log stream being defined. Default value is LOG_CIUMTJNL_001.
 
_lsretpd_

OPTIONAL

LOG STREAM RETENTION PERIOD
The retention period, in days, for log data in the log stream. Default value is 24.
 
CICS IA variables (continued) _ciugdg_

REQUIRED

IA GDG DATASET QUALIFIER
The high-level qualifier for the GDG data set name.
 
_smsdatac_

OPTIONAL

IA VSAM FILE DATACLASS
The DFSMS data class to be used for CICS IA file definitions.
 
_smsstorc_

OPTIONAL

IA VSAM FILE STORAGECLS
The DFSMS storage class to be used for CICS IA file definitions.
 
_smsmngc_

OPTIONAL

IA VSAM FILE MNGMNTCLASS
The DFSMS management class to be used for CICS IA file definitions.
 
_ciuspace_

REQUIRED

IA VSAM FILE SPACE UNITS
The space units that reflect the data set size.
 
_ciupquan_

REQUIRED

IA VSAM FILE PRIMARY QTY
 
_ciusquan_

OPTIONAL

IA VSAM FILE SECNDRY QTY
 
DB2 variables _db2hlq_

REQUIRED

DB2 LOAD DATASET NAME
The name of the DB2 data set for SDSNLOAD.
 
_db2run_

REQUIRED

DB2 RUNLIB DATASET NAME
The name of the DB2 data set for RUNLIB.LOAD.
 
_db2hlq2_

REQUIRED

DB2 PROCLIB DATASET NAME
The data set of the DB2 DB2PROC library.
 
_db2vcat_

REQUIRED

DB2 VCAT QUALIFIER
The qualifier of the CICS IA DB2 data sets.
 
_dbid_

REQUIRED

DB2 SUB SYSTEM
The identifier of the DB2 database.
 
_qual_

REQUIRED

DB2 TABLE QUALIFIER
The implicit qualifier to be used with unqualified names of DB2 tables, views, and so on.
 
_own_

REQUIRED

DB2 TABLE OWNER
The ID of the owner of the DB2 plans for authorization purposes.
 
_vol_

REQUIRED

DB2 DASD VOLUME
The DASD volume on which DB2 tables are to be created: for example, "SYSDA".
 
_vv_

REQUIRED

DB2 VERSION
Identifies the DB2 plan DSNTEP_vvvv_. Four characters representing the DB2 version number; for example, V810.
Note: If you are running in DB2 Version 8 compatability mode select V710.
 
_racfgrp_

OPTIONAL

DB2 RACF® GROUP
The RACF group that is authorized to access the CICS IA DB2 plans.
 
DB2 variables (continued) _db2bfpt_

REQUIRED

DB2 BUFFERPOOL FOR TBSPC
The BUFFERPOOL value, used in CREATE TABLESPACE statements. Default value is BP0.
 
_db2bfpi_

REQUIRED

DB2 BUFFERPOOL FOR INDEX
The BUFFERPOOL value, used in CREATE INDEX statements. Default value is BP0.
 
_db2stgt_

REQUIRED

DB2 STOGROUP FOR TBLSPCS
The STOGROUP value, used in CREATE TABLESPACE statements.
 
_db2stgi_

REQUIRED

DB2 STOGROUP FOR INDEXES
The STOGROUP value, used in CREATE INDEX statements.
 
_db2styn_

REQUIRED

USE EXISTING STORAGE GROUP
Specify YES to keep the existing storage groups or NO to generate a creation of new ones.
 
_db2dbnt_

REQUIRED

DB2 DATABASE FOR TBLSPCS
The database name to host all tablespaces.
_db2planc_

OPTIONAL

DB2 PLAN NAME FOR CICS
The plan name for CICS programs. Default value is CIUCICS.
 
_db2planb_

OPTIONAL

DB2 PLAN NAME FOR BATCH
The plan name for batch programs. Default value is CIUBTCH.
 
_ccsid_

REQUIRED

DB2 CCSID (CODE PAGE)
Code character set identifiers (CCSIDs) for the EBCDIC input file of LOAD utility. Default value is 00000.
 
Start of changeDB2 variables (continued)End of change Start of change_wlm_

REQUIRED

End of change
Start of change
DB2 WLM PROCEDURE NAME
WLM (workload manager) environment, in which the stored procedure is to run.
End of change
 
Start of change_db2pack_

REQUIRED

End of change
Start of change
DB2 COLLECTION ID
The name of the collection of the package the CICS IA programs to be included into. Default value is CPS4.
End of change
 
CICS variables _cicsver_

OPTIONAL

CICS VERSION
The product version of this CICS Transaction Server region: V130, V220, V230, V310, Start of changeV320, V410 or V420End of change. Default value is V410.
_cicshlq_

REQUIRED

CICS QUALIFIER
The data set qualifier of the CICS TS SDFHLOAD library.
 
_csdname_

REQUIRED

CICS CSD FILE NAME
The name of the CICS System Definition (CSD) data set.
 
_list_

REQUIRED

CICS CSD LIST NAME
The CSD group list to which to append the CICS IA resource group.
 
_ciugrpt_

REQUIRED

CICS CSD COLLECTOR GROUP
The group name for CINT resource definitions.
 
_ciugrpf_

REQUIRED

CICS LOCAL FILES GROUP
The group name for file resource definitions defined locally.
 
_ciugrpr_

REQUIRED

CICS REMOTE FILES GROUP
The group name for file resource definitions defined remotely.
 
Start of change_groupw_

REQUIRED

End of change
Start of change
CICS WEB SUPPORT GROUP
The group name for web resource definitions.
End of change
 
_rls_

REQUIRED

RLSACCESS FOR VSAM FILES
A variable that defines whether RLS is used with VSAM files.
 
_lsr_

REQUIRED

LSRPOOLID FOR VSAM FILES
The identifier of the LSRPOOL for the VSAM file definitions.
 
CICS variables (continued) _for_

OPTIONAL

CICS FILE OWNING REGION
If you use a CICS file-owning region (FOR) to share the CICS IA VSAM files, the system identifier (SYSID) of the FOR.
 
Start of change_libnm_ End of change Start of change
LIBRARY RESOURCE NAME (for SCIULOAD)
CICS LIBRARY resource name for defining SCIULOAD dataset (used for CICS TS version 3.2 or higher).
End of change
 
Start of change_libnmek_End of change Start of change
LIBRARY RESOURCE NAME (for SCIULODE/K)
CICS LIBRARY resource name for defining SCIULODE/K dataset (used for CICS TS version 3.2 or higher).
End of change
 
Migration variables

OPTIONAL

PREVIOUS RELEASE
Start of changeThe previous release of CICS IA. Values can be 3.1. End of change
 
_ciuhlqo_

OPTIONAL

PREVIOUS IA QUALIFIER
The high-level data set qualifier of the VSAM and output files used in the previous version of CICS IA.
 
_ciuhlqn_

OPTIONAL

NEW IA QUALIFIER
The high-level data set qualifier of the VSAM and output files to be used in the new version of CICS IA.
 
_oldqual_

OPTIONAL

OLD DB2 TABLE QUALIFIER
The implicit qualifier used with unqualified names of DB2 tables, views, and other names, in the previous version of IA.
 
_newqual_

OPTIONAL

NEW DB2 TABLE QUALIFIER
The implicit qualifier to be used with unqualified names of DB2 tables, views, and other names, in the new version of IA.
 
  _tcpport_

REQUIRED

TCP IP PORT
The TCP/IP port used by Atom service to control the collector through CICS Explorer.
 
_atomcfg1_

REQUIRED

ATOM CONFIG FILE LOCATION
The location of the Atom service configuration file in the HFS file system. This is the first part of the HFS directory path that contains the CIUATM01 configuration file. The default will be "pathprefix/usr/lpp/cicsia/ciuver". The pathprefix and ciuver are variables used during the SMP/E install of CICS IA. This value will be concatenated with IBM/atomservices/config/CIUATM01 to define the location of the Atom service Configuration file for CICS IA.
 
General variables _asmblr_

OPTIONAL

ASSEMBLER PROGRAM
The assembler program: ASMA90 (default)or IEV90.
 
_lehlq_

REQUIRED

LE QUALIFIER
The high-level data set qualifier of the SCEERUN library.
 

Table 2 lists variables that cannot be customized by the installation customization program.

Table 2. Names that are not customized by the installation customization program
  Variable Description Value
Names that are not customized by the installation customization program _xxx_ CICS IA application suffixes.  
_cauhlq_ The high-level data set qualifier of the VSAM affinities file.  
_applid_ The CICS region APPLID used in reporting and load jobs.  
_ciudet_ The data set qualifier of the output data set used by the CICS IA Load Module Scanner.  
_scan_ The data set name of the load module to be scanned by the CICS IA Load Module Scanner.