Previous Topic

Next Topic

Book Contents

Book Index

Redirecting IOA messages

Messages can be redirected by using the MSGROUT member, residing in the IOA PARM library. MSGROUT is provided as an empty member. A sample is shown below:

MSGCODE=msg-prefix,ROUT=(OUT),DDN=PPP

MSGCODE=XMM79,ROUT=(OUT),DDN=PPP

MSGCODE=IOAD97,ROUT=(LOG)

MSGCODE=IOAD91E,ROUT=(WTO),ROUTCDE=(1,2,3),DESC=(1,2,8)

MSGCODE=IOAD9,ROUTCDE=(1,2,3),DESC=(1,2,8)

MSGCODE=IOAD,ROUT=(LOG)

The MSGROUT parameters are described in the following table.

The values given to the ROUT, ROUTCDE, and DESC parameters must be enclosed in parentheses.

MSGROUT is provided with sample lines. Each line that starts with an asterisk (*) is specified as a comment line. Remember to remove the asterisks from the appropriate lines before saving the edited MSGROUT member.

Note: When an IOA message is redirected, some of the fields, which appear in the IOA log, are suppressed in the message as it appears in the WTO, WTOR, and OUT destinations.

Changes to MSGROUT member definitions are not dynamically refreshed. For changes to take effect, refresh any affected monitor.

Table 49 MSGROUT Parameters

Parameter

Description

MSGCODE

Up to 7 characters in length. If it is less than 7 characters, MSGCODE is treated as a generic code. For example, all messages beginning with XMM79 are routed to OUT.

ROUT

May contain up to 3 ROUT codes. Note that this ROUT parameter overrides the ROUT parameter that is hard-coded in the application. Valid values are:

  • WTO
  • WTOR - WTOR will be ignored if it has not been hard-coded in the application.
  • OUT
  • LOG
  • NONE - Use ROUT=NONE to suppress a message

DDN

This is the DDNAME when ROUT=(OUT), or when the ROUT parameter that has been hard-coded in the application is OUT. Default: SYSPRINT

ROUTCDE

Up to 3 route codes can be specified. Valid values for ROUTCDE are in the range from 1 to 128. ROUTCDE is used when ROUT=(WTO) or ROUT=(WTOR).

DESC

Up to 3 descriptor codes can be specified. Valid values for DESC are in the range from 1 to 16. DESC is used when ROUT=(WTO) or ROUT=(WTOR).

Parent Topic

Modifying IOA Messages