Server Instance Properties: MSS IMS TM General

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

To access this page:

In ESCWA, select the enterprise server region you require.
Click IMS > Configuration to open the IMS Configuration page, and then click the TM tab.

Message Queue

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

Use Default Queue Name

Check this to use the default queue path and filename, which by default is %USERPROFILE%\Documents\Micro Focus User\Enterprise Developer\WORKAREA\esname\IMSMESGQ.dat where esname is the name of your enterprise server region.

Queue Name

Provide an alternative path and filename for the IMS message queue.

Maximum Blocks

The message queue consists of blocks of approximately 64K bytes. These blocks 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. If necessary, you can dynamically change this number while the enterprise server region is running. The value must be in the range of 4 through 63488. The default for an initial server definition is 32.

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

Note: To decrease the likelihood of a hang condition due to lack of space, Enterprise Server reserves a percentage of the allocated space (a cushion) to enable graceful intervention should it be required. In this case, to facilitate recovery, other message queue operations are restricted. These restrictions are removed when the cushion allocation is reacquired by TM. You can change the cushion percentage dynamically. See IMS Control for more information.

Buffer Count

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

CAUTION:

Micro Focus recommends you consider the implications before changing this setting.

Cold Start

Choose what information is deleted when you next start this enterprise server region:

None: No information is deleted. This is the default value.
Stats Only: Only statistics are deleted.
Definitions and Stats: Resource definitions and statistics are deleted.
Everything: A fresh copy of the message queue dataset is allocated, discarding all previous content.

Persist

Check this to specify that the action you specified in the Cold Start list occurs each time this enterprise server region starts. By default, this is unchecked.

MFS Path

Specify the location for the files produced by MFSGENs. The default value is $IDE_MODPATH.

MFS Attribute Bias

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

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

This is the default value.

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 Hexadecimal 0x00.

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

Active 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 value is 64. Specifying 0 indicates that keypoints are only generated when the enterprise server region 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 region. By default, this is checked.

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. The default value is 0.

Application Path

Specify the location of the transaction programs running on this enterprise server region. The default value is $IDE_LAODLIB.