Change CICS SIT Entry (CHGCICSSIT)

Where allowed to run:
  • Batch job (*BATCH)
  • Interactive job (*INTERACT)
  • Batch program (*BPGM)
  • Interactive program (*IPGM)
  • Batch REXX procedure (*BREXX)
  • Interactive REXX procedure (*IREXX)
  • Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)
Threadsafe: No
Parameters
Examples
Error messages

Use the Change CICS System Initialization Table (CHGCICSSIT) command to change the entry in the SIT.

The System Initialization Table (SIT) is used to specify the initial startup conditions and control parameters for your system. 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).

Note: It should be understood that changes to the SIT can affect the performance and run-time characteristics of your CICS system. Changes made to a SIT entry should be well tested and understood before being put into a production environment.

Top

Parameters

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

Library (LIB)

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

Top

Group (GROUP)

Enter the name of the group containing the SIT entry to be changed.

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 #.

Top

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 starting the CICS control region.

Possible values are:

Top

Common work area size (WRKARASIZE)

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

Possible values are:

Top

Application (APPLID)

Enter the VTAM application identifier for the CICS control region.

Possible values are:

Top

Date format (DATFORM)

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

Possible values are:

Top

CICS system dumps allowed (DUMP)

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

Possible values are:

Top

CICS device processing (DEVCTL)

Enter the parameters used by the terminal control facility.

Possible values are:

Top

File processing (FILECTL)

Enter the parameters used by the file control facility.

Possible values are:

Top

Internal trace processing (INTTRCCTL)

Enter the control parameters used by the internal tracing facility.

Possible values are:

Top

Auxiliary trace processing (AUXTRCCTL)

Enter the control parameters used by the auxiliary tracing facility in the CICS control region.

Possible values are:

Top

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:

Top

Temporary storage processing (TSCTL)

Enter the control parameters used by the temporary storage facility.

Possible values are:

Top

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:

Top

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 requirement values are:

Possible system requirement values are:

Possible user requirement values are:

Top

Interval control processing (ITVCTL)

Enter the parameters used by the interval control facility.

Possible values are:

Top

Transient data information (TDCTL)

Enter the control parameters used by transient data facility

Possible values are:

Element 1: ATI user profile

The iSeries user profile to be associated with the transaction that is automatically initiated when the transient data trigger level is reached.

Top

Datastream compression (DSCOMP)

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

Possible values are:

Top

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:

Top

Examples

None
Top

Error messages

Unknown
Top