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.

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 (Windows) or /var/mfcobol/es/esname/IMSMESGQ.dat (UNIX) where esname is the name of your enterprise server region.

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

Queue buffer count

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

Note: Give careful thought before changing this setting.

Cold start

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

None - No information is deleted. Default.
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 option occurs each time this enterprise server starts. Default is unchecked.

MFS path

Specify the location for the files produced by MFSGENs. Default is $IDE_MODPATH.

MFS attribute bias

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

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

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. Default 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. Default is 0.

Application path

Specify the location of the transaction programs running on this enterprise server. Default is $IDE_LAODLIB.