CICS Resources - SIT

Name

The name of the SIT.

Description

A short description of the SIT. The SIT description can contain the characters A-Z, 0-9, #, @, and $.

Startup List

Choose the startup list that you want to associate with this SIT from the dropdown list. The startup list determines which resources are loaded when the server is initialized.

Group List

Type the group lists that you want to associate with this SIT. You can specify up to four comma-delimited patterns that matches a Startup List. This means that the SIT can use more than one Startup List. Each pattern can be up to 8 characters long and must only contain A through Z, 0 through 9, @, and the wildcard characters $, #, *, and +.

Note: Using multiple startup lists loads more resources into the process shared memory which might have an impact on an enterprise server region's performance. Micro Focus recommends you limit active resources where possible.

Development SIT

Check this to indicate that this is a development SIT. If you have specified a group with the same name as the SIT, the group is automatically added to the startup list and security is turned off even if the group has security turned on.

Work Area (CWA)

Specifies the size of the region's Common Work Area (CWA) in bytes in the range 0 through 32767. This area is shared among applications running in the region.

Minimum Commarea

Specifies the minimum amount of storage to be allocated to the communications area (COMMAREA) to allow MSS to behave like mainframe CICS. The size is in the range 0 through 32767. When a program is passed to a COMMAREA smaller than the COMMAREA specified in the program, the passed COMMAREA is automatically extended in length to fill the defined space.

SysID

Specifies the system ID of the region. This is the name by which it is known to other regions.

Initial Tran ID

Specifies the ID of an initial transaction that runs on every terminal when it logs on to the region.

Force Program Phase In

Check this to have MSS reload programs each time they are invoked. This applies only to programs that are not marked resident and have not been loaded with the hold attribute.

Defer Install Groups (PCTs only)

Choose the number of PCT groups whose loading you want to defer. If you choose None, all PCT entries are loaded into memory when the region starts up. This is the default. If you choose All groups, none of the PCT entries are loaded into memory when the region starts up. If you choose one of the other values, Last 63 groups, Last 62 groups and so on, the PCT entries in those groups are not loaded into memory when the region starts up. For example, if you choose Last 3 groups, the last three groups in the startup list's precedence order are not loaded into memory when the region starts up.

Addressing Mode

Specifies the format in which pointers are stored:

Native

Pointers are stored in the format used by the operating system.

24 Bit

Pointers are stored in a 24-bit format. This format is compatible with "below-the-line" storage on the mainframe, in which the top eight bits of the pointer are masked off when the address of a linkage item is set from the pointer. This means that the top eight bits can be manipulated directly by your code.

31 Bit

Pointers are stored in a 31-bit format. This format is compatible with "above-the-line" storage on the mainframe, in which the top bit of the pointer is masked off when the address of a linkage item is set from the pointer. This means that the top bit can be manipulated directly by your code.

Program List Post Initialization (PLTPI)

A program list table (PLT) entry that specifies the initialization programs to be run when the region is started. If you leave this field blank then no special processing is done when the region is started.

Program List Shut Down (PLTSD)

A program list table (PLT) entry that specifies the shutdown programs to be run when the region is stopped. If you leave this field blank then no special processing is done when the region is stopped.

IBM Client Sessions

The number of IBM Universal Client sessions you want allocated to servicing inbound requests per connection, where connection corresponds to a client machine.

CICS Release

The version of CICS that MSS is emulating. This is the number returned by an EXEC CICS INQUIRE SYSTEM RELEASE () command.

NQRNL

Enable global resource serialization to use RNL processing for enqueue and dequeue requests from CICS.

TCP Connect

Not used.

Port

Not used.

3270

Auto Install Exit

The name of the program to be used to autoinstall terminals:

DFHZATDX

The autoinstall program supplied with MSS. This is the default value.

user-specified

The name of your autoinstall exit program. Up to 8 characters from 0 through 9, A through Z, @, # and $. The first character must not be numeric.

3270 Print

Check this to indicate that the region supports a printer.

Print Destination

Specify the printer destination, up to 14 characters in length. You must check 3270 Print before you specify a printer destination.

3270 SNA simulate end-bracket

Check this if you want MSS to simulate SNA end-of-transaction keyboard unlock. You might want to do this if you have migrated applications that were accessed on the mainframe from SNA devices and are now using TN3270 clients to access them. It is an alternative to specifying the free keyboard bit in the CTLCHAR operand of the SEND 3270 CICS command.

Remote 3270 on orig sys

Check this to indicate that when a remote CICS region handles a START request shipped to it by this CICS region, and the terminal that should be started is not defined on the remote system, the remote region should assume that the terminal is defined on the originating system and should start a terminal anyway. If you leave this unchecked, the remote system returns a TERMIDERR to the originating region.

Force Terminal Wait on Send

Check this to have MSS wait on each terminal control or BMS SEND operation until it receives a response. If you leave the box unchecked (the default) MSS does not wait on each SEND, thus enabling terminal control and send operations to be buffered, which improves performance.

GMTRAN

The disconnect parameter for CESN transaction. If Exit is selected a user can do F3/Clear to terminate CESN/CESL. If Disconnect is selected, a user will see the TN3270 disconnected if F3 or clear is used.

Date & Time

Reset Time

The action that CICS should take to handle automatic time changes:

Immediate

The system detects a timezone (date) change at any time. It then changes the clock in the region on the next transaction which is started.

No

The system detects a timezone change at midnight and writes a notification in the console.log. You then need to run a transaction that will issue the PERFORM RESETTIME for the time to be changed.

Yes

The system detects a timezone change at midnight and automatically resets the clock.

Date Format

The display format used to display the date. This is used in conjunction with the FULLDATE (for four-digit years) or DATE (for two-digit years) operands of the EXEC CICS FORMATTIME command. This setting only determines the order of day, month, and year; it does not prevent four digits from being displayed.

Date Separator

The character used to separate the day, month and year components of the date. You can specify any displayable character.

Time Separator

The character used to separate the hours, minutes and seconds components of the time. You can specify any displayable character.

Thresholds & Timeouts

ID Timeout

The time in minutes that the system will allow an ESMAC or TN3270 client session to remain idle before session timeout. A value of 0 indicates that there is no timeout.

Input Timeout

The maximum time in seconds allowed for an operator response to an explicit CICS RECEIVE command before the transaction is abended. A value of 0 indicates that there is no timeout.

Runaway Timeout

The maximum continuous period of time in seconds that the region will allow a transaction to run without making a CICS, EZASOKET or WebSphere MQ API call. When this time is exceeded, the transaction is abended. A value of 0 indicates that there is no timeout. You can override this value for an individual transaction through the relevant Program Control Table entry.

Deadlock Timeout

The maximum time in seconds that the region will permit an application to wait for a resource that has been locked by another process. A value of 0 indicates that there is no timeout. You can override this value for an individual transaction through the relevant Program Control Table entry.

Transaction Threshold

The maximum length of time in seconds that a transaction can run before a message is logged to the console to indicate that it has exceeded its threshold. A value of 0 indicates that there is no threshold. The Transaction Threshold value can be overridden using the Transaction Threshold field of a PCT entry.

IBM MQ

IBM MQ

Check this to enable support for IBM WebSphere MQ. See Configuring Enterprise Server for IBM WebSphere MQ in your product Help for more information.

IBM MQ CKTI

Check this to enable the transaction CKTI, which monitors the IBM WebSphere MQ initiation queue.

Q Manager

The name of the IBM WebSphere MQ queue manager. Can be up to 48 characters.

Initiation Q

The name of the IBM WebSphere MQ initiation queue. Can be up to 48 characters.

Dump & Trace

Cold Start Dump & Trace Datasets

Check this to indicate that the auxiliary trace and dump file is to be deleted at region startup.

Dump on ABEND

Check this to indicate that MSS should produce a dump if an abend occurs in any of your transaction programs. If you check this field, then you can control whether or not a dump is produced for an individual program by checking or unchecking Dump on ABEND on the PCT page. If you leave this field unchecked, MSS ignores the setting of Dump on ABEND on the PCT page.

Dump on System ABEND

Check this to indicate that MSS should produce a dump if an abend occurs in its own code.

Local Trace Entry Count (MFCS)

The number of entries the local trace table for service execution processes can hold before it wraps back to the start. A value of 0 (zero) means that no local trace table is allocated. Each service execution process has its own local trace table. Each entry is 24 bytes long. The default is the value specified in Local Trace Size on the Server > Properties > Diagnostics page in Enterprise Server Administration. If you specify a value here it overrides that value.

Local Trace Entry Count (AUX)

The number of entries the local trace table for auxiliary processes can hold before it wraps back to the start. A value of 0 (zero) means that no local trace table is allocated. Auxiliary processes include processes that handle journal control, extra-partition transient data, and so on. Each auxiliary process has its own local trace table. Each entry is 24 bytes long. The default is the value specified in Local Trace Size on the Server > Properties > Diagnostics page in Enterprise Server Administration. If you specify a value here it overrides that value.

Aux Trace

Check this to indicate that trace records are to be written to a file. You should do this only if you have adequate disk space available, since the file can become very big very quickly. Writing out to a file also degrades performance.

Fileshare

Fileshare Integrated

Check this to create a dedicated Fileshare server process as part of region startup.

Fileshare User

The user ID to be used by the region to log on to all Fileshare servers that MSS is configured to use. Can be up to 100 characters. You should specify a user ID only if Fileshare security is enabled. If you specify a user ID, you must also specify a password in Password. The user ID and password combination must correspond to an entry in the password file of each Fileshare server the region is to access. See Security in the Fileshare Guide chapter of your product Help.

Fileshare User Password

The password used in conjunction with Fileshare User to log on to all Fileshare servers that MSS is configured to use. There are two password fields; you need to enter the password in both fields, and the two entries must match. Can be up to 100 characters.

Shutdown

External Shutdown

The type of external shutdown that you want. An external shutdown is a shutdown of the server initiated by you clicking Shutdown on the Control page, Stop Server on the Enterprise Server Administration Server Details page, or by issuing a casstop command. You can choose from:

Allowed

No special privileges are required.

Logon

A successful logon must be made first.

None

No external shutdown is allowed.

Note: If you choose Logon, you cannot shut down the server by clicking Stop Server on the Enterprise Server Administration Server Details page. You must use casstop and must supply an ESMAC user ID and password.

Ext. Shutdown Security Key

A security key number. MSS checks this against the shutdown security key specified when you shut down the region. You need to specify a security key number only if you choose Logon in External Shutdown.

Temporary Storage

Cold Start

Check to indicate that MSS should reset temporary storage queues at region startup.

FS Server

A Fileshare server ID for non-recoverable temporary storage queues.

Path (nr)

The path for non-recoverable temporary storage queues.

Cold Start

Check this to indicate that MSS should reset temporary storage queues at region startup.

FS Server

A Fileshare server ID for non-recoverable temporary storage queues.

Path (rc)

The path for recoverable temporary storage queues.

Transient Data

Cold Start

Check this to indicate that MSS should reset transient data queues at region startup.

FS Server

A Fileshare server ID for non-recoverable transient data queues.

Require Def.

Check this to indicate that a transaction program executing in this region can write to a transient data queue only if it has been defined in the destination control table (DCT). If this option is not checked, when a program attempts to write to a TDQ that has not been defined in the DCT, CICS will create a non-recoverable intra-partition TDQ that has no transaction associated with it. This might result in unexpected program and/or system behavior if the intention was to write to a pre-defined TDQ of a similar name. Micro Focus recommends that this option is always checked.

Path (nr)

The path for non-recoverable transient data queues.

Cold Start

Check this to indicate that MSS should reset transient data queues at region startup.

FS Server

A Fileshare server ID for non-recoverable transient data queues.

Path (rc)

The path for recoverable transient data queues.

Trace Points - Server

cluster

jcp

Check this to indicate that MSS is to trace its journal control component.

scp

Check this to indicate that MSS is to trace its storage control component.

trd

dmp

Check this to indicate that MSS is to trace its dump control component.

kcp

Check this to indicate that MSS is to trace its task control component.

srv

Check this to indicate that MSS is to trace SEP-hosted task control functions.

xfp-all

All

exits

Check this to indicate that MSS is to trace the user exits.

lock-data

tmp

Check this to indicate that MSS is to trace its table management component.

xfp-data

fh-enable

Do not check this unless advised by Micro Focus.

mds

trd-enq

xfp

fh

saf (security)

trd-stg

JCL/JES

common

Check this to indicate that MSS is to trace its communications component.

CICS

api

Check this to indicate that MSS is to trace the CICS API calls.

fcp

Check this to indicate that MSS is to trace its file control component.

pcp

Check this to indicate that MSS is to trace program management functions.

ts-td

Check this to indicate that MSS is to trace its temporary storage/transient data (TS/TD) component.

cws

icp

Check this to indicate that MSS is to trace its interval control component.

tcp

Check this to indicate that MSS is to trace its terminal control component.

user

Check this to enable user trace.

IMS

data

DB_ctl

storage

TM-ctl

Communications

cci

Do not check this unless advised by Micro Focus.

com-data

com-mfcs

com

com-data-all

Basic Mapping

Paging Command

Retrieve

Specify the character string that BMS control is to interpret as the BMS paging command RETRIEVE.

Chain

Specify the character string that BMS control is to interpret as the BMS paging command CHAIN.

Purge

Specify the character string that BMS control is to interpret as the BMS paging command PURGE.

Copy

Specify the character string that BMS control is to interpret as the BMS paging command COPY.

Single Key

For each key from PF1 through PF24 and PA1 through PA3, specify a character string on the PC to equate to a BMS paging command. Prefix the character string with the command you want to execute when the key is pressed, followed by any additional commands. For example, if the BMS PAGIN RETRIEVE command is set to /P and you want PF1 to execute a page forward, specify the /PN character string where /P executes the BMS PAGIN RETRIEVE command and N executes NEXT.