3270 Print

3270 SNA Simulate end-bracket

Add

Auto Install Exit

Aux Trace

Basic Mapping Page Commands, Chain

Basic Mapping Page Commands, Copy

Basic Mapping Page Commands, Purge

Basic Mapping Page Commands, Retrieve

Basic Mapping Page Commands, Single Key

CICS Release

Cold Start

Commarea

Copy

Date Format

Deadlock Timeout

Defer Install

Delete

Description

Development SIT

Dump

Dump On, Abend

Dump On, System Abend

Ext. Shutdown

Ext. Shutdown, Security Key

Fileshare

Fileshare Srvr (non-recoverable temporary storage queues)

Fileshare Srvr (non-recoverable transient data queues)

Fileshare Srvr (recoverable temporary storage queues)

Fileshare Srvr (recoverable transient data queues)

Fileshare User

IBM Client, Count

IBM Client, Port

IBM Client, Yes

IBM MQ

IBM MQ CKTI

ID Timeout

Initial Tran ID

Initiation Q

Input Timeout

Local Trace Entry Count (AUX)

Local Trace Entry Count (MFCS)

Name

Password

Path (non-recoverable temporary storage queues)

Path (non-recoverable transient data queues)

Path (recoverable temporary storage queues)

Path (recoverable transient data queues)

Print Destination

Program, Force Phase In

Program Lists, Post Initialization

Program Lists, Shut Down

Q Manager

Remote 3270

Require Def.

Runaway Timeout

Separators, Date

Separators, Time

Startup List

SysID

TCP Connect, Port

TCP Connect, Yes

Temp. Storage, Cold Start

Terminal, Force Wait on Send

Trace Points, all

Trace Points, api

Trace Points, cci

Trace Points, comms

Trace Points, dmp

Trace Points, exits

Trace Points, fcp

Trace Points, fh

Trace Points, fh-enable

Trace Points, icp

Trace Points, jcp

Trace Points, kcp

Trace Points, msg

Trace Points, scp

Trace Points, tcp

Trace Points, tmp

Trace Points, ts-td

Trace Points, user

Transient Data, Cold Start

Work Area

CICS SIT - sit_name

Use this page to create a new SIT.

If you displayed this page by clicking Copy on a previous page, the values on the previous page are used as the basis for the new SIT.

If you displayed this page by clicking New on a previous page, some values on this page are already set to default values.

Top

Add

Click this to save changes you have made to the page, refresh the page and add the new SIT to the server.

Top

Name

Specify a name for the SIT. Can be up to eight characters from A-Z, 0-9, #, @, $.

Top

Description

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

Top

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 region is initialized.

Top

Work Area

Specify 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 (enterprise server).

Top

SysID

Specify the system ID of the region (enterprise server). (This is the name by which it is known to other regions.)

Top

Initial Tran ID

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

Top

Auto Install Exit

Specify the name of the program to be used to autoinstall terminals. Choose from:

Top

Date Format

Choose a 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.

Top

3270 Print

Check this to indicate that the region supports a printer.

Top

3270 SNA Simulate end-bracket

Check this if you want MTO 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.

Top

Remote 3270

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.

Top

Separators, Date

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

Top

Separators, Time

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

Top

TCP Connect, Yes

Not used.

Top

TCP Connect, Port

Not used.

Top

ID Timeout

Specify the time in minutes that the system will allow an ESMAC or TN3270 client session to remain idle before logging off the user. A value of 0 indicates that there is no timeout. You can override this value at runtime by changing the ID Timeout on the ESMAC Control screen.

Top

IBM Client, Yes

Check this to indicate that an IBM Universal Clients gateway is to be established when the region starts up.

Top

IBM Client, Port

Specify the TCP/IP port number to use for the Universal Clients gateway. This must match the TCP/IP port number you specify in the Universal Clients configuration file except that if you use the defaults, the value in the configuration file is 0 whereas the value here is 1435.

Top

IBM Client, Count

Specify the number of sessions you want allocated to servicing inbound requests per connection, where connection corresponds to a client machine.

Top

Input Timeout

Specify the maximum time in seconds allowed for operator response to an explicit CICS RECEIVE command before the transaction is abended. A value of 0 indicates that there is no timeout. You can override this value at runtime by changing the Input Timeout on the ESMAC Control screen. You can also override this value for an individual transaction through the relevant Program Control Table entry.

Top

Local Trace Entry Count (MFCS)

Specify 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 ES Admin. If you specify a value here it overrides that value.

Top

Runaway Timeout

Specify the maximum continuous period of time in seconds that the region will allow a transaction to run without making a CICS, EZASOKET or MQSeries 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 at runtime by changing the Runaway Timeout on the ESMAC Control screen. You can also override this value for an individual transaction through the relevant Program Control Table entry.

Top

Local Trace Entry Count (AUX)

Specify 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, etc. 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 ES Admin. If you specify a value here it overrides that value.

Top

Deadlock Timeout

Specify 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 at runtime by changing the Deadlock Timeout on the ESMAC Control screen. You can also override this value for an individual transaction through the relevant Program Control Table entry.

Top

IBM MQ

Check this to enable support for IBM MQSeries®.

Top

Q Manager

Specify the name of the IBM MQSeries® queue manager. Can be up to 48 characters.

Top

IBM MQ CKTI

Check this to enable the transaction CKTI, which monitors the IBM MQSeries® initiation queue.

Top

Initiation Q

Specify the name of the IBM MQSeries® initiation queue. Can be up to 48 characters.

Top

Print Destination

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

Top

Program Lists, Post Initialization

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

Top

Program Lists, Shut Down

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

Top

Fileshare

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

Top

Fileshare User

Specify the user ID to be used by the region to log on to all Fileshare servers that MTO is configured to use. Can be up to 20 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.

For more information about Fileshare security, see the chapter Security in the Fileshare Guide.

Top

Password

Specify the 20-character password used in conjunction with User ID to log on to all Fileshare servers that MTO 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 20 characters.

Top

Ext. Shutdown

Choose 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 issuing a casstop command. You can choose from:

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.

Top

Ext. Shutdown, Security Key

Specify a security key number. MTO 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.

Top

CICS Release

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

Top

Program, Force Phase In

Check this to have MTO 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.

Top

Development SIT

Check this to indicate that this is a development SIT. The effect of this is:

Top

Terminal, Force Wait on Send

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

Top

Commarea

Specify the minimum amount of storage to be allocated to the communications area (COMMAREA) to allow MTO to behave like mainframe CICS. The size is in the range 0 through 32767. The effect of this is that when a program is passed a COMMAREA smaller than the COMMAREA defined in the program, the passed COMMAREA is automatically extended in length to fill the defined space.

Top

Defer Install

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.

Top

Dump On, Abend

Check this to indicate that MTO 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, MTO ignores the setting of Dump on ABEND on the PCT page.

Top

Dump On, System Abend

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

Top

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.

Top

Cold Start

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

Top

Trace Points, all

Choose a setting to apply to all the trace points:

Note: When you set all the trace points on at once, the trace points CCI, fh and fh-enable are unaffected. This is because these trace points should be used only when advised by Micro Focus.

Top

Trace Points, api

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

Top

Trace Points, cci

Do not check this unless advised by Micro Focus.

Top

Trace Points, comms

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

Top

Trace Points, dmp

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

Top

Trace Points, exits

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

Top

Trace Points, fcp

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

Top

Trace Points, icp

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

Top

Trace Points, jcp

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

Top

Trace Points, kcp

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

Top

Trace Points, msg

Check this to indicate that MTO is to trace its messages component.

Top

Trace Points, scp

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

Top

Trace Points, tcp

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

Top

Trace Points, tmp

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

Top

Trace Points, ts-td

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

Top

Trace Points, user

Check this to enable user trace.

Top

Trace Points, fh

Do not check this unless advised by Micro Focus.

Top

Trace Points, fh-enable

Do not check this unless advised by Micro Focus.

Top

Temp. Storage, Cold Start

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

Top

Fileshare Srvr (non-recoverable temporary storage queues)

Specify a Fileshare server ID for non-recoverable temporary storage queues.

Top

Path (non-recoverable temporary storage queues)

Specify the path of the Fileshare server for non-recoverable temporary storage queues.

Top

Fileshare Srvr (recoverable temporary storage queues)

Specify a Fileshare server ID for recoverable temporary storage queues.

Top

Path (recoverable temporary storage queues)

Specify the path of the Fileshare server for recoverable temporary storage queues.

Top

Transient Data, Cold Start

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

Top

Require Def.

Check this to indicate that a transaction program executing in this region can create a transient data queue only if it has been defined in the destination control table (DCT). Applies only to intrapartition transient data queues.

Top

Fileshare Srvr (non-recoverable transient data queues)

Specify a Fileshare server ID for non-recoverable transient data queues.

Top

Path (non-recoverable transient data queues)

Specify the path of the Fileshare server for non-recoverable transient data queues.

Top

Fileshare Srvr (recoverable transient data queues)

Specify a Fileshare server ID for recoverable transient data queues.

Top

Path (recoverable transient data queues)

Specify the path of the Fileshare server for recoverable transient data queues.

Top

Basic Mapping Page Commands, Retrieve

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

Top

Basic Mapping Page Commands, Chain

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

Top

Basic Mapping Page Commands, Purge

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

Top

Basic Mapping Page Commands, Copy

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

Top

Basic Mapping Page Commands, Single Key

For each key from PF1 through PF24 and PA1 through PA3, specify a character string on the PC that is to equate to a BMS paging command.

Top

Delete

Click this to delete this SIT. This button is displayed only after you click Add.

Top

Copy

Click this to create a new SIT, using the values set on this page as the basis for the new SIT. This button is displayed only after you click Add.

Top

Dump

Click this to create and view dump information for this SIT. This button is displayed only after you click Add.

Top