System initialization parameters to set up a CICS region
The CICS® system initialization parameters that you must configure, or change from their default values, to set up a CICS region are listed. The system initialization parameters that you might consider whether to configure are also listed.
For parameters that are not listed in the following sections, it is unlikely that you need to change them from their defaults unless there are specific requirements for your environment.
For a complete list of system initialization parameters and their defaults, see System initialization parameter descriptions and summary.
System initialization parameters that you must configure
You
must configure the following system initialization parameters:
- APPLID
- The APPLID parameter specifies the z/OS® Communications Server application identifier for this CICS region. See APPLID system initialization parameter.
- CICSSVC
- The CICSSVC parameter specifies the number that you have assigned to the CICS type 3 SVC. See CICSSVC system initialization parameter.
- GRPLIST
- The GRPLIST system initialization parameter specifies the names (each 1 - 8 characters) of up to four lists of resource definition groups on the CICS system definition (CSD) file. See GRPLIST system initialization parameter.
- ISC
- The ISC system initialization parameter specifies whether the CICS programs required for multiregion operation (MRO) and intersystem communication over SNA are to be included. See ISC system initialization parameter.
- MXT
- The MXT system initialization parameter specifies the maximum number, in the range 10 through 2000, of user tasks that can exist in a CICS system at the same time. The MXT value does not include CICS system tasks. See MXT system initialization parameter.
- PLTPI
- The PLTPI system initialization parameter specifies a program list table, which contains a list of programs to be run in the final stages of system initialization. See PLTPI system initialization parameter.
- PLTSD
- The PLTSD system initialization parameter specifies a program list table that contains a list of programs to be run during system termination. See PLTSD system initialization parameter.
- SIT
- The SIT system initialization parameter specifies the suffix, if any, of the system initialization table that you want CICS to load at the start of initialization. See SIT system initialization parameter.
- START
- The START system initialization parameter specifies the type of start for the system initialization program. See START system initialization parameter.
- SUFFIX
- The SUFFIX system initialization parameter specifies the last two characters of the name of this system initialization table. See SUFFIX system initialization parameter.
- SYSIDNT
- The SYSIDNT system initialization parameter specifies a 1- to 4-character name that is known only to your CICS region. See SYSIDNT system initialization parameter.
- TCPIP
- The TCPIP system initialization parameter specifies whether CICS TCP/IP services are to be activated at CICS startup. See TCPIP system initialization parameter.
- USSHOME
- The USSHOME system initialization parameter specifies the name and path of the root directory for CICS Transaction Server files on z/OS UNIX. See USSHOME system initialization parameter.
System initialization parameters that you might need to configure
You must consider whether you need to configure
the following system initialization parameters:
- AICONS
- The AICONS parameter specifies whether you want autoinstall support for consoles. See AICONS system initialization parameter.
- AIRDELAY
- The AIRDELAY parameter specifies the delay period that elapses after an emergency restart before autoinstalled terminal and APPC connection entries that are not in session are deleted. See AIRDELAY system initialization parameter.
- CLINTCP
- The CLINTCP parameter specifies the default client code page to be used by the DFHCNV data conversion table, but only if the CLINTCP parameter in the DFHCNV macro is set to SYSDEF. See CLINTCP system initialization parameter.
- CMDPROT
- The CMDPROT parameter specifies whether to allow or inhibit CICS validation of start addresses of storage referenced as output parameters on EXEC CICS commands. See CMDPROT system initialization parameter.
- CONFDATA
- The CONFDATA parameter specifies whether CICS is to suppress user data that might otherwise appear in CICS trace entries or in dumps. See CONFDATA system initialization parameter.
- CONFTXT
- The CONFTXT system initialization parameter specifies whether CICS is to prevent z/OS Communications Server from tracing user data. See CONFTXT system initialization parameter.
- CPSMCONN
- The CPSMCONN parameter specifies whether you want CICS to invoke the specified CICSPlex® SM component during initialization of the region. See CPSMCONN system initialization parameter.
- CRLPROFILE
- The CRLPROFILE parameter specifies the name of the profile that is used to authorize CICS to access the certification revocation lists (CRLs) that are stored in an LDAP server. See CRLPROFILE system initialization parameter.
- CSDDISP
- The CSDDISP parameter specifies the disposition of the data set to be allocated to the CSD. See CSDDISP system initialization parameter.
- CSDDSN
- The CSDDSN parameter specifies the 1-44 character JCL data set name (DSNAME) to be used for the CSD. See CSDDSN system initialization parameter.
- CSDFRLOG
- The CSDFRLOG parameter specifies a number that corresponds to the journal name that CICS uses to identify the forward recovery log stream for the CSD. See CSDFRLOG system initialization parameter.
- CSDLSRNO
- The CSDLSRNO system initialization parameter specifies whether the CSD is to be associated with a local shared resource (LSR) pool. See CSDLSRNO system initialization parameter.
- CSDRECOV
- The CSDRECOVsystem initialization parameter specifies whether the CSD is a recoverable file. See CSDRECOV system initialization parameter.
- DATFORM
- The DATFORM system initialization parameter specifies the external date display standard that you want to use for CICS date displays. See DATFORM system initialization parameter.
- DBCTLCON
- The DBCTLCON system initialization parameter specifies whether you want CICS to start the DBCTL connection automatically during initialization. See DBCTLCON system initialization parameter.
- DB2CONN
- The DB2CONN system initialization parameter specifies whether you want CICS to start the DB2® connection automatically during initialization. See DB2CONN system initialization parameter.
- DFLTUSER
- The DFLTUSER system initialization parameter specifies the RACF® userid of the default user; that is, the user whose security attributes are used to protect CICS resources in the absence of other, more specific, user identification. See DFLTUSER system initialization parameter.
- DOCCODEPAGE
- The DOCCODEPAGE system initialization parameter specifies the default host code page to be used by the document domain. See DOCCODEPAGE system initialization parameter.
- DSALIM
- The DSALIM system initialization parameter specifies the upper limit of the total amount of storage within which CICS can allocate the individual dynamic storage areas (DSAs) that reside in 24-bit storage (below 16 MB, also known as below the line). See DSALIM system initialization parameter.
- DSRTPGM
- The DSRTPGM system initialization parameter specifies the name of a distributed routing program. The distributed routing program must be specified in the routing region and each target CICS region. See DSRTPGM system initialization parameter.
- DTRPGM
- The DTRPGM system initialization parameter specifies the name of a dynamic routing program. See DTRPGM system initialization parameter.
- DUMPSW
- The DUMPSW system initialization parameter specifies whether you want CICS to switch automatically to the next dump data set when the first is full. See DUMPSW system initialization parameter.
- EDSALIM
- The EDSALIM system initialization parameter specifies the upper limit of the total amount of storage within which CICS can allocate the individual extended dynamic storage areas (EDSAs) that reside in 31-bit (above-the-line) storage; that is, above 16 MB but below 2 GB. See EDSALIM system initialization parameter.
- FCQRONLY
- The FCQRONLY system initialization parameter specifies whether you want CICS to force all file control requests to run under the CICS QR TCB. This parameter applies to file control requests that access VSAM RLS files and local VSAM LSR files. Requests for all other file types always run on the QR TCB. See FCQRONLY system initialization parameter.
- GMTEXT
- The GMTEXT system initialization parameter specifies whether the default logon message text (WELCOME TO CICS) or your own message text is to be displayed on the screen. See GMTEXT system initialization parameter.
- GMTRAN
- The GMTRAN system initialization parameter specifies the name of a transaction ID. See GMTRAN system initialization parameter.
- GRNAME
- The GRNAME system initialization parameter specifies the z/OS Communications Server generic resource name, as 1 through 8 characters, under which a group of CICS terminal-owning regions in a CICSplex register to z/OS Communications Server. See GRNAME system initialization parameter.
- ICV
- The ICV system initialization parameter specifies the region exit time interval in milliseconds. See ICV system initialization parameter.
- ICVR
- The ICVR system initialization parameter specifies the default runaway task time interval in milliseconds as a decimal number. See ICVR system initialization parameter.
- INITPARM
- The INITPARM system initialization parameter specifies that parameters are to be passed to application programs that use the ASSIGN INITPARM command. See INITPARM system initialization parameter.
- IRCSTRT
- The IRCSTRT system initialization parameter specifies whether IRC is to be started up at system initialization. See IRCSTRT system initialization parameter.
- JVMPROFILEDIR
- The JVMPROFILEDIR system initialization parameter specifies the name (up to 240 characters long) of a z/OS UNIX directory that contains the JVM profiles for CICS. CICS searches this directory for the profiles it needs to configure JVMs. See JVMPROFILEDIR system initialization parameter.
- KEYRING
- The KEYRING system initialization parameter specifies the fully qualified name of the key ring, within the external security manager's database, that contains the keys and X.509 certificates used by CICS support for the secure sockets layer (SSL) and for web services security. See KEYRING system initialization parameter.
- LGNMSG
- The LGNMSG system initialization parameter specifies whether z/OS Communications Server logon data is to be made available to an application program. See LGNMSG system initialization parameter.
- LOCALCCSID
- The LOCALCCSID system initialization parameter specifies the default CCSID for the local region. See LOCALCCSID system initialization parameter.
- LPA
- The LPA system initialization parameter specifies whether CICS and user modules can be used from the link pack areas. See LPA system initialization parameter.
- MN
- The MN system initialization parameter specifies whether monitoring is to be switched on or off at initialization. See MN system initialization parameter.
- MNPER
- The MNPER system initialization parameter specifies whether the monitoring performance class is to be made active during CICS initialization. See MNPER system initialization parameter.
- MQCONN
- The MQCONN system initialization parameter specifies whether you want CICS to start a connection to WebSphere® MQ automatically during initialization. See MQCONN system initialization parameter.
- MSGCASE
- The MSGCASE system initialization parameter specifies how you want the message domains to display mixed case messages. See MSGCASE system initialization parameter.
- NATLANG
- The NATLANG system initialization parameter specifies the single-character code for the language to be supported in this CICS run. See NATLANG system initialization parameter.
- PGCHAIN
- The PGCHAIN system initialization parameter specifies the character string that is identified by terminal control as a BMS terminal page-chaining command. See PGCHAIN system initialization parameter.
- PGCOPY
- The PGCOPY system initialization parameter specifies the character string that is identified by terminal control as a BMS command to copy output from one terminal to another. See PGCOPY system initialization parameter.
- PGPURGE
- The PGPURGE system initialization parameter specifies the character string that is identified by terminal control as a BMS terminal page-purge command. See PGPURGE system initialization parameter.
- PGRET
- The PGRET system initialization parameter specifies the character string that is recognized by terminal control as a BMS terminal page-retrieval command. See PGRET system initialization parameter.
- PLTPISEC
- The PLTPISEC system initialization parameter specifies whether you want CICS to perform command security or resource security checking for PLT programs during CICS initialization. See PLTPISEC system initialization parameter.
- PLTPIUSR
- The PLTPIUSR system initialization parameter specifies the user ID that CICS uses for security checking for PLT programs that run during CICS initialization. See PLTPIUSR system initialization parameter.
- PSBCHK
- The PSBCHK system initialization parameter specifies whether CICS is to perform PSB authorization checks for remote terminal users who use transaction routing to initiate a transaction in this CICS region to access an attached IMS™ system. See PSBCHK system initialization parameter.
- RLS
- The RLS system initialization parameter specifies whether CICS is to support VSAM record-level sharing (RLS). See RLS system initialization parameter.
- RRMS
- The RRMS system initialization parameter specifies whether CICS is to register as a resource manager with recoverable resource management services (RRMS). See RRMS system initialization parameter.
- SDTRAN
- The SDTRAN system initialization parameter specifies the name of the shutdown transaction to be started at the beginning of normal and immediate shutdown. See SDTRAN system initialization parameter.
- SECPRFX
- The SECPRFX system initialization parameter specifies whether CICS prefixes the resource names in any authorization requests to the external security manager. See SECPRFX system initialization parameter.
- SPOOL
- The SPOOL system initialization parameter specifies whether the system spooling interface is required. See SPOOL system initialization parameter.
- SRBSVC
- The SRBSVC system initialization parameter specifies the number that you have assigned to the CICS type 6 SVC. See SRBSVC system initialization parameter.
- SRVERCP
- The SRVERCP system initialization parameter specifies the default server code page to be used by the DFHCNV data conversion table but only if the SRVERCP parameter in the DFHCNV macro is set to SYSDEF. See SRVERCP system initialization parameter.
- STARTER
- The STARTER system initialization parameter specifies whether the generation of starter system modules (with $ and # suffixes) is permitted, and various MNOTES are suppressed. See STARTER system initialization parameter.
- STATRCD
- The STATRCD system initialization parameter specifies the interval statistics recording status at CICS initialization. See STATRCD system initialization parameter.
- STGPROT
- The STGPROT system initialization parameter specifies whether you want storage protection to operate in the CICS region. See STGPROT system initialization parameter.
- TBEXITS
- The TBEXITS system initialization parameter specifies the names of your backout exit programs for use during emergency restart backout processing. See TBEXITS system initialization parameter.
- TCT
- The TCT system initialization parameter specifies which terminal control table, if any, is to be loaded. See TCT system initialization parameter.
- TD
- The TD system initialization parameter specifies the number of VSAM buffers and strings to be used for intrapartition transient data (TD). See TD system initialization parameter.
- TRANISO
- The TRANISO system initialization parameter specifies, together with the STGPROT system initialization parameter, whether you want transaction isolation in the CICS region. See TRANISO system initialization parameter.
- TS
- The TS system initialization parameter specifies whether you want to perform a cold start for temporary storage, as well as the number of VSAM buffers and strings to be used for auxiliary temporary storage. See TS system initialization parameter.
WLMHEALTH
The WLMHEALTH system initialization
parameter specifies the time interval and the health adjustment value to be used by CICS on z/OS Workload
Manager Health API (IWM4HLTH) calls, which CICS makes to
inform z/OS WLM about the health state of a CICS region. See
WLMHEALTH.
- XAPPC
- The XAPPC system initialization parameter specifies whether RACF session security can be used when establishing APPC sessions. See XAPPC system initialization parameter.
- XDB2
- The XDB2 system initialization parameter specifies whether you want CICS to perform DB2ENTRY security checking. See XDB2 system initialization parameter.