IMS Configuration

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

Click APPLY to save any configuration changes.

IMS General

Codeset Bias
Choose the default codeset to use for transactions running on this enterprise server:
Transactions use ASCII.
Transactions use EBCDIC.
ACB File Directory
Specify the location of the .dat, .idx, and .acb files produced by DBDGENs, IMSGENs and PSBGENs. This field maps to the ES_ACBLIB environment variable.
GEN File Directory
Specify the full path to the transaction definition file for this enterprise server. This field maps to the ES_IMSLIB environment variable.

DB General

Database Path
Specify the location of the IMS data files and any .slf files to be used by the IMSDBUEA segment exit routine.


IRLM Locking
Check this to enable the Internal Lock Resource Manager (IRLM) locking algorithm. IRLM locking more closely parallels mainframe IMS database DB locking behavior, reducing data constraint and potential for deadlock. Maps to the ES_IMS_IRLM environment variable.
Dump on Lock Timeout
Check this to create a system dump when IMS DB control is unable to access a locked record before the specified Locked resource timeout period expires. Maps to the ES_IMS_DUMP_ON_TIMEOUT environment variable.
Dump on Deadlock
Check this to create a system dump when a deadlock is detected. Maps to the ES_IMS_DUMP_ON_DEADLOCK environment variable.
Locked Resource Timeout
Specify the number of seconds during which IMS DB control continues to retry a locked record before timing out. Valid values are 0 to 65535. The default is 30 seconds; a value of 0 indicates an indefinite wait time. Maps to the ES_IMS_LOCK_TIMEOUT environment variable.


Enable Forward Recovery
Check this to enable the IMS forward recovery feature. Maps to the ES_IMS_ROLLFORWARD environment variable.
IMS Transaction Log Path
Specify the path to a directory where IMS forward recovery log files are stored. Maps to the ES_IMS_TLOG_PATH environment variable.


Key Compression
Check this to turned on key compression.
Data Compression
The data compression routine number. Valid values are the same as those that can be specified for the Compiler directives DATACOMPRESS and KEYCOMPRESS.


Application Path
Specify the location of the transaction programs running on this enterprise server. Default is $IDE_LAODLIB.
Trailing Space
Check this to specify that you must add a trailing space when entering transaction names in this enterprise server. This is checked by default.
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 is 0.
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:
The programs define attributes as binary values. This is the default.
The programs define attributes as characters.
MFS Null Character
Specify the character to use as the MFS NULL character. The default is X'36'.
Check this to if you specify the MFS Null Character in hexadecimal form. This setting only has an effect on programs compiled using the ASCII character set; it is ignored for programs compiled using EBCDIC.

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
Specify an alternative path and filename for the IMS 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 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 more information.
Buffer Count
This is the tuning control. More buffers means less swapping of blocks in memory for message queue activity. By default this is 2.
Cold Start
Choose the information that is deleted when you next start this enterprise server:
No information is deleted. This is the default setting.
Stats Only
Only statistics are deleted.
Definitions and Stats
Resource definitions and statistics are deleted.
A fresh copy of the message queue dataset is allocated, discarding all previous content.
Check this to specify that the action you specified in the Cold Start field occurs each time this enterprise server starts. The default setting is unchecked.
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 is 64. Specifying 0 indicates that keypoints are only generated when the enterprise server starts and shuts down.

Message Processing Regions

Click * NEW to open the MPR Properties dialog box and configure a message processing region (MPR) for this server:

Specify the name of the MPR.
Specify the list of transaction classes that this MPR can run.
Enable Pseudo Wait-for-Input (PWFI)[10]
Check this field to enable Pseudo Wait-For-Input (PWFI) dispatch behavior. When enabled, the MPR stays scheduled until another input message is received.
Optionally, specify a text description of the MPR.

You can view a list of MPRs displayed in the Message Processing Regions table.