Worksheet for the installation customization program

This section contains a worksheets 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 worksheets consist 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.

Start of change
Note: If you are creating the CICS IA DB2 database on a version of DB2 running in compatability mode, then make sure you set the DB2 Compatability Mode option to YES during configuration.
End of change

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

Output data sets

The CICS IA configuration execution produces separate DB2 and CICS configurations.

The DB2 configuration has the following variables, see the table Variables for DB2 configuration, for CICS configuration see the table Variables for CICS configuration.

The CICS IA configuration execution produces separate output data sets depending on the type of configuration that you have performed.

Variables for DB2 configuration

Table 1. Variables for DB2 configuration. The output data set for a DB2 configuration.
Variable Description Value
_outsmp2d_
Start of change OUTPUT DSN FOR SCIUSAMP.DB2 End of change
The output data set that contains the modified database related hlq.SCIUSAMP members.

REQUIRED

 
Start of change _outsqld_ End of change Start of change
OUTPUT DSN FOR DB2 SCIUSQL
The output data set that contains the modified SCIUSQL members to configure DB2 objects.

REQUIRED

End of change
Start of change   End of change
Start of change _outdat1d_ End of change Start of change
OUTPUT DSN FOR DB2 SCIUDAT1
The output data set that contains the copied SCIUDAT1 members to configure DB2 objects.

REQUIRED

End of change
Start of change   End of change
Start of change _outdat2d_ End of change Start of change
OUTPUT DSN FOR DB2 SCIUDAT2
The output data set that contains the copied SCIUDAT2 members to configure DB2 objects.

REQUIRED

End of change
Start of change   End of change
_volserd_
OUTPUT DEVICE TYPE
The output data set that contains the device type to configure DB2 objects.

REQUIRED

 
_dsver_
DATA SET VERIFICATION
The data set verification. Defines whether it's necessary to verify the existence of data sets or not (DB2 load data set name, DB2 runlib data set name, DB2 proclib data set name).

REQUIRED

 

DB2 variables

Table 2. DB2 variables
Variable Description Value
_db2hlq_
DB2 LOAD DATASET NAME
The name of the DB2 data set for SDSNLOAD.

REQUIRED

 
Start of change _db2run_ End of change Start of change
DB2 RUNLIB DATASET NAME
The name of the DB2 data set for RUNLIB.LOAD.

REQUIRED

End of change
Start of change   End of change
_db2proc_
DB2 PROCLIB DATASET NAME
The DB2 data set name for the PROCLIB that contains DSNUPROC.

REQUIRED

 
_db2templ_
DB2 LOAD TEMPLATE
The DB2 template using during DB2 LOAD processing.

REQUIRED

 
_db2vcat_
DB2 VCAT QUALIFIER
Start of change The DB2 data set qualifier for the CICS IA DB2 data sets. End of change

REQUIRED

 
_db2sys_
DB2 SUB SYSTEM
Start of change The DB2 sub system identifier. End of change

REQUIRED

 
_db2qual_
DB2 TABLE QUALIFIER
Start of change The DB2 qualifier (schema) for the CICS IA DB2 objects. End of change

REQUIRED

 
_db2own_
DB2 TABLE OWNER
The TSO userid that will own the DB2 resources.

REQUIRED

 
_db2vol_
DB2 DASD VOLUME
The DASD volume on which DB2 resources will be cataloged. See SCIUSQL(CIUMAIN).

REQUIRED

 
_db2ver_
DB2 VERSION
The DB2 version.

REQUIRED

 
Start of change _db2mode_ End of change Start of change
DB2 COMPATIBILITY MODE
The DB2 compatibility mode.

REQUIRED

End of change
Start of change   End of change
_db2grp_
DB2 RACF® GROUP
The RACF group that is authorized to access the DB2 resources.

OPTIONAL

 
_db2bfpt_
DB2 BUFFERPOOL FOR TBSPC
The BUFFERPOOL value, used in CREATE TABLESPACE statements.

REQUIRED

 
_db2bfpi_
DB2 BUFFERPOOL FOR INDEX
The BUFFERPOOL value, used in CREATE INDEX statements.

REQUIRED

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

REQUIRED

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

REQUIRED

 
_dsntep2p_
DB2 PLAN NAME FOR DSNTEP2
The plan name for DSNTEP2 program used in jobs.

REQUIRED

 
_dsntiaul_
DB2 PLAN NAME FOR DSNTIAUL
The plan name for DSNTIAUL used in jobs.

REQUIRED

 
_db2styn_
USE EXISTING STORAGE GROUP
Use existing storage groups or create new one.

REQUIRED

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

REQUIRED

_db2planb_
DB2 PLAN NAME FOR BATCH
The plan name for batch programs.

OPTIONAL

 
_db2cc_
DB2 CCSID (CODE PAGE)
The code character set identifier for SBCS data that is found in the input file during DB2 LOAD processing.

REQUIRED

 
_db2wlm_
DB2 WLM PROCEDURE NAME
WLM (workload manager) environment, in which the stored procedure is to run.

REQUIRED

 
_db2pack_
DB2 COLLECTION ID
The package collection that is to be used when the stored procedure is executed.

REQUIRED

 

Migration variables

Table 3. Migration variables
Variable Description Value
_ciuhlq_
IA PRODUCT QUALIFIER
The CICS IA data set qualifier

REQUIRED

 
_migver_
PREVIOUS RELEASE
The CICS IA release number to be migrated from.

REQUIRED

 
_ciuhlqo_
PREVIOUS IA QUALIFIER
The CICS IA data set qualifier for VSAM files used in the previous version.

OPTIONAL

 
_oldqual_
OLD DB2 TABLE QUALIFIER
The implicit TSO user ID for unqualified names of DB2 resources (tables) used in the previous version of CICS IA.

OPTIONAL

 

General variables

Table 4. General variables
Variable Description Value
_ciuhlqq_
QSAM FILE QUALIFIER
Prefix for QSAM data sets. This qualifier is used to create the CSV files for application load and the table space unload data sets in the DB2 UNLOAD tablespace utiliy.

REQUIRED

 
_ciuspacd_
QSAM FILE SPACE UNITS
The space units to express the data set size in.

REQUIRED

 
_ciupquad_
QSAM FILE PRIMARY QTY
The primary allocation quantity for the QSAM files, in cylinders, tracks, records, kilobytes or megabytes as indicated in the SPACE UNITS field.

REQUIRED

 
_ciusquad_
QSAM FILE SECNDRY QTY
The secondary allocation quantity for the QSAM files, in cylinders, tracks, records, kilobytes or megabytes as indicated in the SPACE UNITS field.

OPTIONAL

 
Start of change

Variables for CICS configuration

Table 5. Variables for CICS configuration . The output data set for CICS configuration.
Variable Description Value
_db2conf_
DB2 CONFIGURATION FOR IA
The name of DB2 configuration. You can type the name of existing DB2 configuration for CICS IA or press PF4 to select from a list of DB2 configurations.

REQUIRED

 
_outsmp1_
OUTPUT DSN FOR SCIUSAMP
The output data set that contains the modified SCIUSAMP members to configure CICS objects.

REQUIRED

 
_outsamn_
OUTPUT DSN FOR CICS SCIUSAME/K
The output data set that contains the modified SCIUSAME/K members to configure CICS objects.

REQUIRED

 
Start of change _outsql_ End of change Start of change
OUTPUT DSN FOR CICS SCIUSQL
The output data set that contains the modified SCIUSQL members to configure CICS objects.

REQUIRED

End of change
Start of change   End of change
_outdat1_
OUTPUT DSN FOR CICS SCIUDAT1
The output data set that contains the copied SCIUDAT1 members to configure CICS objects.

REQUIRED

 
_volserd_
OUTPUT DEVICE TYPE
The output data set that contains the device type to configure CICS objects.

REQUIRED

 
_dsver_
DATA SET VERIFICATION
The data set verification defines whether or not it is necessary to verify the existence of data sets. (CICS load data set name, DB2 runlib data set name, CICS qualifier, CICS CSD file name, LE SCEERUN data set.)

REQUIRED

 
End of change

CICS IA variables

Table 6. CICS IA variables
Variable Description Value
_ciuhlq_
IA PRODUCT QUALIFIER
The CICS IA data set qualifier.

REQUIRED

 
_ciuhlqv_
IA VSAM FILE QUALIFIER
The CICS IA data set qualifier for the VSAM files used by CICS IA.

REQUIRED

 
_ciuhlqc_
IA CSV FILE QUALIFIER
The CICS IA data set qualifier for the QSAM CSV files. If it is blank then the IA VSAM FILE QUALIFIER is used.

OPTIONAL

 
_lsnamhlq_
IA LOG STREAM QUALIFIER
The stream name qualifier for the CIUMTJNL log stream data sets used by the Task Command Flow option.

REQUIRED

 
_lscfdasd_
COUPLING FACILITY or DASD
Define the log stream using the Coupling Facility or DASD-only.

REQUIRED

 
_lshlq_
LOG STREAM DATASET NAME HLQ
The stream name qualifier for DASD.

REQUIRED

 
_lsstrcnm_
IA LOG STREAM STRUCTNAME
The name of the coupling facility structure associated with the coupling facility log stream being defined.

OPTIONAL

 
_lsretpd_
LOG STREAM RETENTION PERIOD
Retention period for log stream can be from 0 to 999 days.

OPTIONAL

 
_ciugdg_
IA GDG DATASET QUALIFIER
Prefix for GDG data set.

REQUIRED

 
_smsdatac_
IA VSAM FILE DATACLASS
The data class that to use for the allocation of the VSAM data sets.

OPTIONAL

 
_smsstorc_
IA VSAM FILE STORAGECLS
The storage class that should be used for the allocation of the VSAM data sets.

OPTIONAL

 
_smsmngc_
IA VSAM FILE MNGMNTCLASS
The management class that should be used for the allocation of the VSAM data sets.

OPTIONAL

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

REQUIRED

 
_ciupquan_
IA VSAM FILE PRIMARY QTY
Prefix for GDG data set.

REQUIRED

 
_ciusquan_
IA VSAM FILE SECNDRY QTY
The data class that should be used for the allocation of the VSAM data sets.

OPTIONAL

 
Start of change _dumphlq_ End of change Start of change
DUMP QUALIFIER
The dump qualifier. Default to DUMP.

REQUIRED

End of change
Start of change   End of change

DB2 variables for CINT

Table 7. DB2 variables for CINT
Variable Description Value
_db2ireq_
COLLECTING DB2 INFORMATION
To check collecting DB2 information for CINT.
Value YES or NO.

REQUIRED

 
Start of change _db2hlqc_ End of change Start of change
DB2 LOAD DATASET NAME
The DB2 data set name for SDSNLOAD.

OPTIONAL

End of change
Start of change   End of change
_db2runc_
DB2 RUNLIB DATASET NAME
The DB2 data set name for RUNLIB.LOAD.

OPTIONAL

 
_db2sysc_
DB2 SUB SYSTEM
The DB2 sub system identifier.

OPTIONAL

 
_db2ownc_
DB2 TABLE OWNER
The TSO user ID that owns the DB2 resources.

OPTIONAL

 
_db2verc_
DB2 VERSION
The DB2 version. Defaults to V910.

OPTIONAL

 
_db2modec_
DB2 COMPATIBILITY MODE
The DB2 compatability mode.

OPTIONAL

 
_db2grpc_
DB2 RACF GROUP
The RACF group which grants access to DB2 resources.

OPTIONAL

 
_db2bfpic_
DB2 BUFFERPOOL FOR INDEX
The BUFFERPOOL value used in the CREATE INDEX statements.

OPTIONAL

 
_dsntep2c_
DB2 PLAN NAME FOR DSNTEP2
The name for plans for the DSNTEP2 program used in jobs.

OPTIONAL

 
Start of change _db2planc_ End of change Start of change
DB2 PLAN NAME FOR CICS
The DB2 plan name for CICS programs.

OPTIONAL

End of change
Start of change   End of change
_db2packc_
DB2 COLLECTION ID
The package collection that is used when the stored procedure is executed.

OPTIONAL

 

CICS variables

Table 8. CICS variables
Variable Description Value
_cicsver_
CICS VERSION
The CICS Transaction Server version.

OPTIONAL

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

REQUIRED

 
_cicscsd_
CICS CSD FILE NAME
The name of the CICS System Definition (CSD) file.

REQUIRED

 
Start of change _aorlist_ End of change Start of change
CICS AOR LIST NAME
The CICS AOR CSD group list to which to append the CICS IA resource group.

REQUIRED

End of change
Start of change   End of change
Start of change _forlist_ End of change Start of change
CICS FOR LIST NAME
The CICS FOR CSD group list to which to append the CICS IA local files resource group. If using RLS set this to the same value as your AOR CSD LIST to define the CICS IA files as local to the AOR.

REQUIRED

End of change
Start of change   End of change
_ciugrpt_
CICS CSD COLLECTOR GROUP
The CICS FOR CSD group list to which to append the CICS IA local files resource group.

REQUIRED

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

REQUIRED

 
_ciugrpr_
CICS REMOTE FILES GROUP
The group name for file resource definitions defined remotely.

REQUIRED

 
_ciugrpw_
CICS WEB SUPPORT GROUP
The group name for file resource definitions defined for web support.

REQUIRED

 
_cicsrls_
RLSACCESS FOR VSAM FILES
Are you using RLS to share VSAM files? Value must be YES or NO.

REQUIRED

 
_cicslsr_
LSRPOOLID FOR VSAM FILES
The CICS LSRPOOLID for VSAM resources.

REQUIRED

 
_cicssys_
CICS FILE OWNING REGION
The CICS SYSID for the file owning region.

OPTIONAL

 
_libnm_
LIBRARY RESOURCE NAME
(for SCIULOAD) CICS LIBRARY resource name for defining SCIULOAD data set (used for CICS TS version 3.2 or higher).

OPTIONAL

 
_libnmek_
LIBRARY RESOURCE NAME (for SCIULODE/K)
CICS LIBRARY resource name for defining SCIULODE/K data set (used for CICS TS version 3.2 or higher).

OPTIONAL

 

CICS IA plug-in for CICS Explorer variables

Table 9. CICS IA plug-in for CICS Explorer variables
Variable Description Value
_cntreg
CICS IA CONTROL REGION
A CICS region where you can administer CICS IA for all other regions that share the CICS VSAM Control file. This region is connected to using Atom services from CICS IA plug-in for CICS Explorer®. The region must be at CICS V4.1 and above.
 
_tcpport_
TCP IP PORT
The TCP/IP port used by Atom service to control the collector.

REQUIRED

 
_atomcfg1_
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 is pathprefix/usr/lpp/cicsia/ciuver. The pathprefix and ciuver are variables used during the SMP/E install of CICS IA. This value is concatenated with IBM/atomservices/config/CIUATM01 to define the location of the Atom service Configuration file for CICS IA.

OPTIONAL

 
Start of change

JCL settings variables

Table 10. JCL settings variables
Variable Description Value
_sortdsn_
SORT DATASET NAME
The name of the dataset name for SORT. Default to SYS1.SORTLIB.

REQUIRED

 
_sortpgm_
SORT PROGRAM NAME
The name of the program name for SORT. Default to SORT.

REQUIRED

 
End of change

General variables

Table 11. General variables
Variable Description Value
_asmprg_
ASSEMBLER PROGRAM
ASMA90 or IEV90.

OPTIONAL

 
_lehlq_
LE QUALIFIER
Data set qualifier of the SCEERUN library.

REQUIRED

 

Variables that are not customized by the installation customization program

Table 12. Variables that are not customized by the installation customization program
Variable Description Value
_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.  

Reference Reference

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ciuug8m.html