OPSRMT Command Processor—Issue TSO Commands to Other Systems

POI Command Processors › OPSRMT Command Processor—Issue TSO Commands to Other Systems

OPSRMT Command Processor—Issue TSO Commands to Other Systems

The OPSRMT command processor lets you issue a TSO command to other systems from an OPS/REXX program, a TSO/E REXX program, a CLIST, a TSO terminal, or from a console logged on to the CA OPS/MVS ECF component. The command can contain up to 255 characters.

Abbreviation: OR is the abbreviation of OPSRMT.

OPSRMT provides a positional format and an operand format for issuing a command.

The positional format for the OPSRMT command processor:
```
OPSRMT
```
You must specify both keywords in this order:
```
{sysid|*}
{command}
```
When using the positional format, OPSRMT considers all text beyond sysid to be part of the command text.

Example: The TSO command text is LISTBC:
```
OPSRMT SYS2 LISTBC
```
Example: The TSO command text is LISTCAT LEVEL(SYS1):
```
OR SYSTEM3 LISTCAT LEVEL(SYS1)
```
The operand format for the OPSRMT command processor:
```
OPSRMT
{sysid|*}
{COMMAND('cmdtext')}
[DELAY(seconds)]
[MAXLINES(1024,lines)]
[NOCLIST]
[OUTPUT|NOOUTPUT]
[SUBSYS(OPSS,ssid)]
[SYSTEM(msfids|ALL|EXT)]
[SYSWAIT(seconds)]
[WAIT(seconds)]
```
When using the operand format, the cmdtext that you specify on the COMMAND keyword may or may not be enclosed in single quotes.

Example: The TSO command text is OI REXXPGM1:
```
OPSRMT SYS2 COMMAND('OI REXXPGM1')
```
Example: The TSO command text is also OI REXXPGM1:
```
OPSRMT SYS2 COMMAND(OI REXXPGM1)
```

sysid

The sysid operand specifies the MSF system IDs of those copies of CA OPS/MVS to which the command should be routed. The subsystem does routing on the local system, from where the command was issued, which was specified on the SUBSYS keyword (or OPSS by default).

Values for the sysid operand are:

*

Indicates that only the local system receives the command. Specify this asterisk when you are not using the CA OPS/MVS MSF.

sysname

Indicates the MSF system ID of a single MSF-connected system (remote or local) that receives the command.

ALL

Indicates that all active MSF-connected systems receive the command, including the local system.

EXT

Indicates that all active MSF-connected systems other than the local system receive the command.

Default: sysid.

Important! You must specify the EXT value explicitly.

Note: If more than one system is specified, then the NOOUTPUT keyword is forced.

DELAY

(Optional) Specifies the number of seconds CA OPS/MVS waits before issuing the command. The delay is applied before each command that is to be issued, even if OPSRMT executes in subcommand mode.

Value: 1 to 300 seconds

MAXLINES

(Optional) Specifies the maximum number of output lines that OPSRMT can return.

Default: 1024

Value: 100 to 32767 lines

If the NOOUTPUT keyword is also specified, this keyword is ignored.

NOCLIST

(Optional) Suppresses the generation of the &SYSOUTLINEnW variables that are produced when &SYSOUTTRAP is set. TSO still produces the &SYSOUTLINEn variables.

OUTPUT and NOOUTPUT

(Optional) Determines whether to return the command output. If NOOUTPUT is specified, then no command output is returned. If OUTPUT is specified, then command output is returned in the manner appropriate for the caller.

Default: OUTPUT

SUBSYS

(Optional) For more information on the SUBSYS keyword, see Specify a Subsystem ID on a POI Command Processor.

SYSTEM

(Optional) For more information on the SYSTEM keyword, see Specify an MSF System ID on a POI Command Processor.

Note: If more than one system is specified, then the NOOUTPUT keyword is implied.

SYSWAIT

(Optional) Specifies how many seconds OPSRMT waits for output from the command it issues, due to MSF network delay time between the local (source) system and the remote (target) system.

Value: 0 and 600 seconds

Default: The value that was specified on the DELAY keyword for the ADDRESS OPSCTL MSF DEFINE command issued on the local (source) system to define the remote (target) system, or the CA OPS/MVS MSFSYSWAIT parameter if the DELAY keyword was not specified.

Unless the WAIT keyword is also specified, the wait time specified on the SYSWAIT keyword is conditional. That is, the response can terminate before the number of seconds specified if the actual command response has terminated. Contrast with the WAIT keyword, which is used to specify unconditional wait time.

WAIT

(Optional) Specifies how many seconds OPSRMT waits for output from the command it issues.

Value: 1 to 60

Default: The value of the CA OPS/MVS OCWAIT parameter. After the specified number of seconds elapse, OPSRMT considers the command to have completed and ignores any additional command output.

The wait time specified on the WAIT keyword is unconditional; that is, the response does not terminate until the complete number of seconds specified has elapsed. Contrast with the SYSWAIT keyword. If both the WAIT and SYSWAIT keywords are specified, then the SYSWAIT time is added to the WAIT time for a cumulative unconditional wait time.

The WAIT and NOOUTPUT keywords are mutually exclusive.