Home Up Search Credits Site Map Contact Info. Links Disclaimer Download





Use the MSGRT command to establish or change message routing instructions for displays from the DISPLAY, TRACK, or CONFIG commands to a specified message area, console, or both. MSGRT also controls the action of the CONTROL, MONITOR, STOPTR, and STOPMN commands. The instructions you specify remain in effect until another MSGRT command is issued for that message area or console or you IPL the system. The command can route display information or stop the routing of display information.

The MSGRT parameter on the CONSOLE statement in the CONSOLxx member of SYS1.PARMLIB controls the display routing instructions at IPL.

The MSGRT command has no effect on extended MCS consoles or on system consoles, and is not valid for managing these consoles. The MSGRT command also has no effect on commands issued via the ROUTE *ALL or ROUTE systemgroupname commands.


The complete syntax for the MSGRT command is:


MR {[D=(operand[,operand]...)][,L={a }] }

{ |TR=A {cc } }

{ |K {cca } }

{ |CF {name } }

{ |MN {name-a} }

{ }

{REF }

{ }


{ }

{CONTn }


The parameters are:


The system is to route DISPLAY command output to the specified MCS console. Any display operand that produces a status display is valid on this command. If you specify only one operand, the parentheses are not necessary. Note that the operands on the MSGRT parameter on the CONSOLE statement in the CONSOLxx member are not always the same  as the operands on the D= operand of the MSGRT command.

The possible values of operand are:

A Display the number of active batch jobs, logged-on time-sharing users, and active initiators.


Display information about any page data sets the system is currently using.

C Display a summary of the CONTROL command operands and the functions they perform.


Display the status of the system console configuration.

D Display the domain description table. The value of D= can be the first operand of any DISPLAY command. For example,

D= A

will route the response to


commands to the console specified by L=.


Display DUMP operands and the status of the SYS1.DUMPxx data sets.


Display the current MIH time intervals.

M Display the status of processors, channel paths, devices, and storage.

R Display the identification numbers of messages waiting for replies,

unfulfilled mount requests, and any units requiring operator intervention.

S Display SLIP trap information

U Display unit information about all devices.


Display SMF status or options.


Display information about the storage management subsystem (SMS).


Display the state of the global resource serialization complex.


Display the status of the message processing facility (MPF)


Display OS/390 UNIX System Services status.


Display the commands associated with program function keys (PFKs).


The system is to route the TRACK A command display and the action of the

STOPTR command to the specified MCS console.

K Subsequent CONTROL command action is to affect the specified MCS console

until the option is discontinued or you IPL the system. Only those CONTROL

functions that you can explicitly route with the L=cca or name-a operand can be

routed by default using MSGRT.


The system is to route the reply to the CONFIG command to the specified MCS


L=a, cc, cca, name, or name-a

Specifies the display area (a), console (cc), both (cca), console name (name),

or both (name-a) where the display will be presented. For cc, you must specify

a decimal number from 1 to 99.

MSGRT Command


For the console on which you enter the command, the system is to discontinue

all current message routing instructions for displays.


The system is to display the current message routing instructions.


The system is to continue the display response to a previous MR REF command. When CONTn appears in the display response, all current routing instructions have not been displayed. Issue MR CONTn to continue the display with the nth line, where n is a decimal digit from 1 to 9.


The system is to route the displays produced by the MONITOR command and the action of the STOPMN command to the specified MCS console.


1. You can enter multiple DISPLAY (D), TRACK (TR), MONITOR (MN), and CONTROL (K) command routings in one MSGRT command by enclosing the operands in parentheses and separating them with commas. For example, MR


2. The MSGRT routing instructions for a console can be temporarily overridden by:

A command the system generates internally

A command on which you specify the location (L=cca) operand

The overridden MSGRT instructions, however, go back into effect as soon as the overriding command finishes. For example, when a VARY command is issued for a range of devices, the VARY command processor internally issues a DISPLAY command, defining the target console for the output as the console that issues the VARY command. For that one issuance of the DISPLAY command, the routing instructions for the target console are overridden. In the case of an instream command or a command from member COMMNDxx of SYS1.PARMLIB, the master console receives the output.

The information on this site is the combined effort of a lot of people, please credit the authors if you use their information.
Please read the Disclaimer page for the restrictions, copyright, and other uses of the information contained on this site.
For problems or questions regarding this web contact Bob.
Last updated: August 27, 2001.