- 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 LocalMSGROUTE 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 GlobalMSGROUTE 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.