/SMCOPY command

The /SMCOPY command is used by the master terminal operator to control the printing of certain output to the secondary master terminal.

This command can be issued to an IMSplex using the Batch SPOC utility.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Table 1. Valid environments for the /SMCOPY command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/SMCOPY X   X
MASTER X   X
MSG X   X
TERMINAL X   X

Syntax

Read syntax diagramSkip visual syntax diagram/SMCOPY/SMC,MASTERONOFFTERMINALONOFFMSGONOFF

Keywords

The following keywords are valid for the /SMCOPY command:

MASTER
Turns ON or OFF the printing of the above subset of IMS commands and command responses when issued from the master terminal.
TERMINAL
Turns ON or OFF the printing of the above subset of IMS commands and command responses when issued from terminals other than the master terminal.

Input coming through Operations Manager is not reflected in the secondary master. This also applies to input coming from MCS/E-MCS terminals.

MSG
ON
All system messages will be logged to the secondary master. This is the default.

Before logging a message to the secondary master, if the installation type-2 exit routine indicated it needs to be called for messages, the exit routine is called first. The exit routine then determines if the message is logged to the secondary master.

OFF
IMS does not send system messages to the secondary master.

Usage notes

System definition establishes whether the commands and their responses will be printed on the secondary master and the origin of the printed command (master terminal, remote terminal, or both). /SMCOPY provides online control of the printing established by system definition.

Example

A system definition has established that copies of the above subset of commands and command responses, when issued from any terminal, will be printed on the secondary master terminal (operand COPYLOG=ALL was specified on the COMM macro).

Entry ET: 
  /SMCOPY TERMINAL OFF
Response ET: 
  DFS058I  SMCOPY COMMAND COMPLETED

Explanation: The secondary master terminal does not receive copies of IMS commands and command responses issued from remote terminals. Commands and responses issued from the master terminal are still received.