Add CICS SIT Entry (ADDCICSSIT)

Use the Add CICS System Initialization Table (ADDCICSSIT) command to add an entry to the SIT.

The System Initialization Table (SIT) is used to specify the initial startup conditions and control parameters for your system. An Add is not valid if SIT entry already exists for this group.

Because only one set of conditions can apply to the system at any one time, only one SIT entry is allowed per group and per Group List Table (GLT). You can create as many SIT entries as you like, but each one must belong to a different group and a different GLT.

Parameters

Keyword Description Choices Notes
LIB Library Communications name, *LIBL, *CURLIB Required, Positional 1
GROUP Group Communications name Required, Positional 2
GLTLIB GLT library Communications name, *LIBL, *CURLIB Optional, Positional 3
GLTGRP GLT group Communications name, *NONE Optional, Positional 4
WRKARASIZE Common work area size 0-3584, 512 Optional, Positional 5
APPLID Application Communications name, DBDCCICS Optional, Positional 6
DATFORM Date format *MMDDYY, *DDMMYY, *YYMMDD Optional, Positional 7
DUMP CICS system dumps allowed *YES, *NO Optional, Positional 8
DEVCTL CICS device processing Element list Optional, Positional 9
Element 1: CICS device masking Character value, *DFT
Element 2: Autoinstall inactivity limit 0-180000, 0
Element 3: Device dependent suffixing *DDS, *NODDS
FILECTL File processing Element list Optional, Positional 10
Element 1: Maximum files left open 0-32767, 0
Element 2: Open file inactivity limit 0-1440, 0
INTTRCCTL Internal trace processing Element list Optional, Positional 11
Element 1: Maximum trace buffer entries 125-10000, 125
Element 2: Active at startup *NO, *YES
Element 3: Wrapped when full *YES, *NO
AUXTRCCTL Auxiliary trace processing Element list Optional, Positional 12
Element 1: Active at startup *NO, *YES
Element 2: Automatic switching *YES, *NO
Element 3: Auxiliary trace A object Qualified object name
Qualifier 1: Auxiliary trace A object Communications name
Qualifier 2: Library Communications name, *CURLIB
Element 4: Auxiliary trace B object Qualified object name
Qualifier 1: Auxiliary trace B object Communications name
Qualifier 2: Library Communications name, *CURLIB
USRTRC User trace active at startup *NO, *YES Optional, Positional 13
TSCTL Temporary storage processing Element list Optional, Positional 14
Element 1: Age limit 0-512, 0
Element 2: Recover data *YES, *NO
SHRSTG Shared storage information Element list Optional, Positional 15
Element 1: LSO storage requirements Element list
Element 1: Size 10-16000, 10
Element 2: Extent size 0-16000, 0
Element 3: Maximum extents 0-32767, 0
Element 2: System storage requirements Element list
Element 1: Size 46-16000, 46
Element 2: Extent size 0-16000, 0
Element 3: Maximum extents 0-32767, 0
Element 3: User storage requirements Element list
Element 1: Size 3-16000, 3
Element 2: Extent size 0-16000, 0
Element 3: Maximum extents 0-32767, 0
NONSHRSTG Nonshared storage processing Element list Optional, Positional 16
Element 1: LSO storage requirements Element list
Element 1: Size 7-16000, 7
Element 2: Extent size 0-16000, 0
Element 3: Maximum extents 0-32767, 0
Element 2: System storage requirements Element list
Element 1: Size 7-16000, 7
Element 2: Extent size 0-16000, 0
Element 3: Maximum extents 0-32767, 0
Element 3: User storage requirements Element list
Element 1: Size 5-16000, 5
Element 2: Extent size 0-16000, 0
Element 3: Maximum extents 0-32767, 0
ITVCTL Interval control processing Element list Optional, Positional 17
Element 1: Maximum active CICS shells 1-32767, 5
Element 2: Minimum active CICS shells 1-32767, 2
TDCTL Transient data information Element list Optional, Positional 18
Element 1: ATI user profile Simple name, *INVOKER
Element 2: Recover data *YES, *NO
DSCOMP Datastream compression *ALL, *NONE, 3270, 5250 Optional, Positional 19
TCPPORT TCP port number 1-65535, *NONE, *CICS Optional, Positional 20
INLTRN Initial Transaction Communications name, *NO, *EXT Optional, Positional 21

Library (LIB)

Enter the name of the library that contains the group. Possible values are:

Group (GROUP)

Enter the name of the group to which this SIT entry is to be added.

group-name: The group name may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

GLT library (GLTLIB)

Enter the name of the IBM i library that contains the group holding the group list table. This name is also used to identify this SIT entry.

Possible values are:

GLT group (GLTGRP)

Enter the name of the group that contains the group list table. All the groups specified in the group list table will be used when the CICS control region is started.

Possible values are:

Common work area size (WRKARASIZE)

Enter the size of the Common Work Area (CWA) portion of the Common System Area (CSA).

Possible values are:

Application (APPLID)

Enter the VTAM application identifier for the CICS control region.

Possible values are:

Date format (DATFORM)

Indicates how the CICS control region system date is formatted when the EXEC CICS FORMATTIME command is issued.

Possible values are:

CICS system dumps allowed (DUMP)

Indicates whether or not a CICS control region dump can be taken.

Possible values are:

CICS device processing (DEVCTL)

ez.*********************************************************************

Enter the terminal control parameters.

Possible values are:

File processing (FILECTL)

Enter the parameters used by the file control facility.

Possible values are:

Internal trace processing (INTTRCCTL)

Enter the control parameters used by the internal tracing facility.

Possible values are:

Auxiliary trace processing (AUXTRCCTL)

Specified the control parameters used by the auxiliary tracing facility.

Possible values are:

User trace active at startup (USRTRC)

Indicates whether or not user trace entries can be created when the CICS control region is started.

Possible values are:

Temporary storage processing (TSCTL)

Enter the parameters to be used by the temporary storage facility. During a warm start, all recoverable temporary storage queues are recovered.

Possible values are:

Shared storage information (SHRSTG)

Enter the shared storage requirements.

Note: The maximum size that each of the three types of shared storage can be is 16,775,216. To calculate the maximum size add the following; the size * 1024, and the extent size * maximum extents * 1024.

Possible LSO storage requirement values are:

Possible system storage requirement values are:

Possible user storage requirement values are:

Nonshared storage processing (NONSHRSTG)

Enter the non-shared storage requirements.

Note: The maximum size that each of the three types of non-shared storage can be is 16,775,216. To calculate the maximum size add the following; the size * 1024, and the extent size * maximum extents * 1024.

Possible LSO storage requirement values are:

Possible System storage requirement values are:

Possible User storage requirement values are:

Interval control processing (ITVCTL)

Enter the parameters used by interval control facility.

Possible values are:

Element 1: Maximum active CICS shells

Transient data information (TDCTL)

Enter the control parameters used by the transient data facility during an emergency restart. During a warm start, all recoverable transient data queues are recoverable.

Possible values are: Element 1: ATI User Profile

Datastream compression (DSCOMP)

Indicates the device types for which datastream compression is to be enabled.

Possible values are:

TCP port number (TCPPORT)

Specifies if the CICS TCP/IP Listener should be started at control region startup, and if so, the TCP port that CICS Clients will use to connect to the listener.

The possible values are:

Initial Transaction (INLTRN)

Enter the name of the transaction to be invoked immediately after the CICS control region completes the initialization process.

o The transaction is executed on a separated batch job. By default under the QBATCH subsystem. The job name is "AEGINLTRN" for transactions, while "AEGEXTPGM" is used for non-CICS programs.

o The transaction must have an entry defined in the Program Control Table (PCT), its program object must have an entry defined in the Processing Program Table (PPT) and be stored in the local system.

o Non-CICS program object must be named "EXTPGM" and its library be in the Library list of the job under which the CICS control region runs.

Single values

Examples

None

Error messages

Unknown