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:
- ASCII
- Transactions use ASCII.
- EBCDIC
- 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.
Locking
- 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.
Recovery
- 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.
Compression
- 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
- 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:
- Binary
- The programs define attributes as binary values. This is the default.
- Character
- The programs define attributes as characters.
- MFS Null Character
- Specify the character to use as the MFS NULL character. The default is X'36'.
- Hexadecimal
- 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:
- None
- No information is deleted. This is the default setting.
- 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 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:
- Name
- Specify the name of the MPR.
- Class(es)
- 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.
- Description
- Optionally, specify a text description of the MPR.
You can view a list of MPRs displayed in the Message Processing Regions table.