IMS Connect Extensions host command summary

The IMS Connect Extensions host command environment for REXX supplies several commands to control operations in IMS, IMS Connect, and in IMS Connect Extensions.

The commands provided with the IMS Connect Extensions host command environment for REXX are summarized below. For a complete command reference, see IMS Connect Extensions host command environment for REXX.

REXX environment and system connection management

CONNECT command: Connect to an IMS Connect system so that subsequent host commands can be issued to that system.
OPTION command: Specify run-time options for the REXX host command environment. Use this command to adjust message verbosity and for connection management.
WTO command: Issue a Write To Operator message to the console. You can use this to automate responses to certain conditions.
DELAY command: Pause command execution for a specified number of seconds.

Settings and status queries

QUERY command

Retrieve a variety of IMS Connect statistics, status updates, and settings information via IMS Connect Extensions. The following information can be obtained using this command:

ACEE cache space and accounting statistics.
Information and statistics about the active IMS Connect Extensions journal.
The number of messages that are pending a response from IMS (messages that are in a Waiting for Datastore state).
The names of the currently active OTMA routing plan and ODBM routing plan.
Statistics and status of active sessions in IMS Connect.
Information and statistics for IMS Connect socket usage.
Display a variety of information and statistics from the IMS Connect Extensions status monitor. Retrieve information on TCP/IP ports, IMS Connect systems, IMS data stores, user exits, ODBM targets, IMS aliases, MSC links, and remote IMS Connect systems.
Status and settings for the IMS Connect Extensions trace.

UPDATE command

Allows certain settings to be changed both in-memory and in the IMS Connect Extensions repository definition. The following settings can be updated:

IMS Connect Extensions event collection level. Configuring event collection and journals.
Capacity weight rating (CWR) for an IMS data store or ODBM target. See Setting the capacity of an IMS data store for OTMA workloads and Setting the capacity of an ODBM target.
Session message limit and threshold. See Rebalancing sessions across IMS Connect systems.

ADD command

Add an entry to the in-memory IMS data store table for a data store that is defined to IMS Connect but was not defined to IMS Connect Extensions at system startup. See Dynamically adding IMS data stores as targets for OTMA routing.

REFRESH command

Rebuild the in-memory copy of the selected definitions stored in the IMS Connect Extensions repository for the target IMS Connect system. See Refreshing in-memory definitions from the IMS Connect Extensions repository.

Journals and tracing

SWITCH command: Switch the active journal for an IMS Connect system. See Managing the IMS Connect Extensions journal.
TRACE command: Control the IMS Connect Extensions trace. You can specify filter conditions to control which additional event records are written to the active journal data set. See Using the IMS Connect Extensions trace.

Message routing, workload balancing, and session management

ROUTE command: Suspend message routing to an IMS data store to drain it of in-progress transactions, or resume routing as required. See Suspending OTMA workload routing to IMS data stores using drain.
SET command: Activate or deactivate an OTMA or ODBM routing plan. See Setting in-memory IMS Connect Extensions definitions.
DRAIN command: Causes eligible IMS Connect sessions to be marked for closure at the next inbound message. Sessions are closed normally and not canceled. See Active Sessions.

Issuing IMS commands

SHELL command: Runs an IMS Connect command or IMS type-1 command on a specified target system or IMS data store. You can use this to automate some procedures such as stopping all the IMS data stores associated with an IMS system across multiple IMS Connect instances. See Issuing IMS Connect and IMS type-1 commands from the CONSOLE dialog.

Security

CLEAR command: Clears one or more users from the ACEE cache. See Issuing security commands.