Server Instance Properties: MSS IMS TM General

Use this page to configure IMS TM support for this enterprise server.

To access this page:

From the Enterprise Server Administration home page, at the left of the Enterprise Server instance to configure, click Edit.
On the server instance screen, select the Server > Properties > MSS > IMS > TM > General tabs.

Message queue

Use these fields to define the attributes of the IMS message queue.

Name

Specify the path to use for the message queue. The default is ESDEMO/IMSMESGQ.dat in the enterprise server's work area directory.

Maximum blocks

The message queue consists of blocks of approximately 64 kb.These consist of 254 segments (not message segments) which are the allocation unit for queue space.

Specify the maximum number of blocks to be used to store the message queue. The value must be in the range 4 through 63488. The default is 32.

When space is not available, a thread waits until the allocation request can be satisfied. The failure mode for "out of space" is a hang condition.

Queue buffer count

This is the tuning control. More buffers means less swapping of blocks in memory for message queue activity.

Note: Carefully consider changing this setting.

Cold start

Choose what happens when you next start this enterprise server:

None - No information is deleted.
Stats only - Only statistics are deleted.
Definitions and stats - Resource definitions and statistics are deleted.
Everything - All information (including the message queue) is deleted.

Persist

Check this to specify that the action you specified in the Cold start option occurs each time this enterprise server starts.

MFS path

Specify the location for the files produced by MFSGENs.

MFS attribute bias

Choose how attributes are assumed to be defined for transaction programs running on this enterprise server:

Binary - The programs define attributes as binary values, for example:

05 ATTRIBUTE-VARIABLES.
   10 CURSOR-ATTR    PIC X(2) VALUE X"C0C1". 
   10 ERROR-ATTR     PIC X(2) VALUE X"C0C9". 
   10 OK-ATTR        PIC X(2) VALUE X"00C1". 
   10 PROT-ATTR      PIC X(2) VALUE X"00F1".

Character - The programs define attributes as characters, for example:
```
05 ATTRIBUTE-VARIABLES.
   10 CURSOR-ATTR PIC X(2) VALUE "{A". 
   10 ERROR-ATTR PIC X(2) VALUE "{I". 
   10 OK-ATTR PIC X(2) VALUE " A".
   10 PROT-ATTR PIC X(2) VALUE " 1".
```
This setting only has an effect on programs compiled using the ASCII character set; it is ignored for programs compiled using EBCDIC.

Where you specify Character, Enterprise Server will automatically translate the values of MFS attributes to those that would be used if the program were compiled as EBCDIC. For example: the hexadecimal 7B41 value produced by assigning '{A' to an attribute and compiling with ASCII, will be converted to the correct C0C1 value. Where you specify that attribute values have been coded as binary data, Enterprise Server will take no action.

MFS null character

Specify the character to use as the MFS NULL character. You can enter the value in character or hexadecimal form. The default is X'36'.

This setting only has an effect on programs compiled using the ASCII character set; it is ignored for programs compiled using EBCDIC.

Actvity keypoint frequency

Specify how many thread requests are to be processed before a keypoint is generated. This must be in the range 0 through 65535. The default is 64. Specifying 0 indicates that keypoints are only generated when the enterprise server starts and shuts down.

Trailing space

Check this to specify that you must add a trailing space when entering transaction names in this enterprise server.

Transaction threshold

Specify 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. This must be in the range 0 through 65535. A value of 0 indicates that there is no threshold.

Application path

Specify the location of the transaction programs running on this enterprise server.

Transaction definition file path

Specify the full path of the transaction definition file for this enterprise server.