Title

Issue Cross-System Commands

Name

CTORMT

Table

CTORMT

Command

CTORMT target-smfid
WMODE=Y (Yes), N (No)
[WRESP=Y (Yes), N (No)]
[RMSG=response-message-ID]
[TOUT=timeout-value]
CMD=remote-command-text

Command Description

Issue cross system commands according to rule arguments.

Basic Scheduling Parameters

Always schedule this rule.

Runtime Scheduling Parameters

No special considerations.

Global Variables

• %%RMT_ROUTE_smfid
  Command routing information. For more details, see customization instructions of rule RMTINIT in Table 152.
• %%CTORMT_CNT
  Remote command request counter. Used to assign a unique request ID to each request.

Rule Logic

The rule arguments are parsed. And the command is issued to the remote system according to these arguments. Response messages are stored in local variables in the originating rule.

Rule Actions

• Parse rule arguments and perform validity checks.
• If the command must be issued without waiting for a response, issue the command to the remote system and terminate.
• If the rule is to issue the command and then wait to receive the response, do the following:
  – Obtain a unique request ID by increasing counter %%CTORMT_CNT.
  – Issue the command to Control-O on the remote system, including request ID and response parameters. command is issued in command-response mode and the expected response message ID is CTORP<rid> where <rid> is the unique request ID.
  – Set local variable %%RLINEn to the nth response line.
  – Set local variable %%RLINES to the total number of response lines.

Activating the Rule

Once scheduled, the rule remains active until deleted from Control-O.

Recommended Mode or Category

During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule.

SolveWare Category for this rule is 1—minimal or no customization is required.

Title

CTORMT Initialization

Name

RMTINIT

Table

CTORMT

Event

RMTINIT

Event Description

This Event rule initializes solution CTORMT.

Basic Scheduling Parameters

Always schedule this rule.

Runtime Scheduling Parameters

No special considerations.

Global Variables

%%RMT_ROUTE_smfid
Command routing information. For more details, see the Customization item in this table.

Rule Logic

This rule instructs the CTORMT solution how to communicate from one system to another in a given MVS complex.

The rule is triggered following the loading of the CTORMT rule table to the Control-O Active environment. Command routing information is stored in global variables according to the target system SMF ID. This information is then used by other rules for cross-system communication.

Rule Actions

For each system in the complex, sets global variable %%RMT_ROUTE_smfid to the appropriate command routing information.

Activating the Rule

The rule is activated once upon loading to the Active environment.

Recommended
Mode or Category

During the testing period, activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule.

The SolveWare Category for this rule is 2—some customization is required before implementation.

Customization

In JES2 sites, routing variables (%%RMT_ROUTE_smfid) must contain the NJE node and (optionally) MAS member according to the syntax of JES2 command $N. For instance, MAS member 3 in NJE node 2 must have the value 2M3.

In JES3 sites, these variables must contain system name according to the *SEND JES3 command.