When you route a command to multiple systems, command responses
are returned to the issuing console as part of message IEE421I.
If an out-of-line display area exists on the issuing console, IEE421I
is written to the out-of-line display area.
If the L= parameter is specified on a ROUTE *ALL or ROUTE sysgrpname command,
the aggregated response will be redirected as specified by the L=
parameter.
Note: Do not use system symbols on the L= parameter when
aggregating command responses.
MVS™ returns an aggregated response when one of
the following occurs:
- MVS has received at least one response from all
systems and a period of time has elapsed during which it has received
no additional responses. MVS calculates this period of time
based on the pattern of responses received for the command.
- The maximum timeout interval in effect for the ROUTE command is
reached.
For command responses to be aggregated, the maximum timeout interval
that is in effect for the ROUTE command cannot be zero. The maximum
timeout interval in effect for a ROUTE command is determined as follows:
- The current sysplex-wide default, which is determined as follows:
- The IBM-defined default for the maximum timeout interval is 30
seconds. This can be changed by any of the following conditions.
- An installation-defined default for the maximum timeout interval
can be specified in the CONSOLxx parmlib member of the first system
to join the sysplex. (This is specified on the ROUTTIME keyword of
the INIT statement.) This installation-defined default applies to
all other systems joining the sysplex.
- The operator can dynamically change the default maximum timeout
interval for all systems in the sysplex by issuing the CONTROL M,ROUTTIME=
command.
- When entering the ROUTE command, the operator can specify the
maximum timeout interval in effect for that one time by specifying
the T= operand on the ROUTE command itself.
For a specific command response to appear in the aggregated response,
individual responses to the routed command must meet these criteria:
- The command processor for the routed command must direct command
response(s) to the console ID where the command originated.
If,
when issuing a command response, a command processor does not use
the console ID of the command issuer, MVS cannot
return the command responses to the ROUTE command issuer.
- The specific command response must be received at the originating
system before the originating system stops aggregating responses.
Command responses that do not meet the above criteria are not aggregated.
However, if MVS receives command responses after the timeout
period, MVS attempts to return the responses to the originator
of the ROUTE command.