Parameters

MAIN=

Specifies a 1- to 8-character name of the main to which these definitions apply. The name must match the name you specify on the NAME parameter on a MAINPROC statement.

routecode =

Specifies the MVS™ routing code and a console name or destination class to which you want messages sent.

routecode: Specifies an MVS routing code which between 1 and 128 inclusive.
destclass: Specifies a JES3 console destination class to which you want messages with the designated MVS routing code mapped.
console: Specifies the name of an MCS console or an extended MCS console.
J: Specifies that the routing code equivalent of the destination class is to be used for the message instead of the message's original routing code(s). If you do not specify "J", the routing code equivalent will be merged with the message's original routing code(s).

Table 1. MSGROUTE Summary - Message from the Local
MSGROUTE Parameter	Console
None or routing code omitted	The message is displayed on consoles receiving the original routing code(s).
Destination class only	The message is displayed on consoles receiving the original routing code and on consoles receiving the equivalent routing code of the destination class.
Destination class and J	The message is displayed on consoles receiving the equivalent routing code of the destination class.
Console name only	The message is displayed on consoles receiving the original routing code(s) and on the console with the specified name.
J only	MCS and extended consoles receiving the hardcopy destination
Destination class and console name	Consoles receiving the original routing code(s) and on consoles receiving the equivalent routing code of the destination class. Also displayed on the console with the specified name.
Console name and J	Console with the specified name.
Destination class, console name and J	Console with the specified name and on consoles receiving the equivalent routing code of the specified destination class.

The following table summarizes message routing for messages issued from the global processor.

Table 2. MSGROUTE Summary - Message from the Global
MSGROUTE Parameter	Console
None or routing code omitted	The message is displayed on consoles receiving the original routing code(s).
Destination class only	Consoles receiving the original routing code and on consoles receiving the equivalent routing code of the destination class.
Destination class and J	The message is displayed on consoles receiving the equivalent routing code of the destination class.
Console name only	The message is displayed on consoles receiving the original routing code(s) and on the console with the specified name.
J only	MCS and extended consoles receiving the hardcopy destination.
Destination class and console name	Consoles receiving the original routing code(s) and on consoles receiving the equivalent routing code of the destination class. Also displayed on the console with the specified name.
Console name and J	Console with the specified name.
Destination class, console name and J	Console with the specified name and on consoles receiving the equivalent routing code of the specified destination class.

Many factors influence the routing of message traffic. See z/OS JES3 Initialization and Tuning Guide for additional information.

If you have not defined any console to display a message, it is sent only to the system log provided you define at least one of the message's original routing code(s) on HARDCOPY parameter in the CONSOLxx member of SYS1.PARMLIB or the issuer originally specified that the message be sent to the log (and no other facility such as MPF overrides that specification). Otherwise, the message does not appear on any console or in the system log.