DTLMSGO Statements - Syntax and Parameters

/*Message sent to multiple destinations
msg_number,{
msg_dest},{
msg_dest}, ...
/*Message destination is not overriden
msg_number
/*Suppress message 
msg_number,NONE

Comment lines must begin with “/*” in column 1.
If the same message appears more than once in the DTLMSGO file, only the last occurrence is used.

msg_number

Required. Specify a message number. The message number must exist in the DTLMSG file on i5/OS or z/OS or in the dtlmsg.txt file on Linux, UNIX, or Windows. Message numbers are 5-digit numbers with no prefix.

Specify the message number with or without the leading zeroes. You cannot specify a mask with wildcards for a

msg_number

value.

msg_dest

Optional. Select one or more options to indicate the override destinations for the specified message number. Options are:

null
. If no destination is specified for the message number, the message is not redirected to a different destination. The message is treated as if it is not included in the DTLMSGO file.
LOG
. The message is routed to the primary PowerExchange message log or to an alternative log file. If alternative logging is enabled but the alternative logging subtask has not initialized, the message is routed to the PowerExchange message log file.
NONE
. The message is suppressed. The message is not displayed in any location. Do not specify this value with any other option.
STDOUT
. The message is routed to the standard output location, which varies by system.
On z/OS, STDOUT is sent to the SYSPRINT DD data set if specified or to a dynamically allocated temporary JES SPOOL data set.
On i5/OS, STDOUT is sent to QPRINT if PowerExchange is running as a background job or to the terminal if PowerExchange is running interactively.
On Linux, UNIX, and Windows, STDOUT is sent to the terminal by default unless you redirect it elsewhere.
SYSCONS
. On i5/OS and z/OS, the message is displayed in the system operator interface.
On z/OS, the message is processed by the Write-To-Operator (WTO) macro and displayed in the system operator console. No routing code is associated with the WTO so the ROUTCODE value that is specified in the DEFAULT statement of CONSOLxx is used for routing.
On i5/OS, the message is sent to the operator message queue.
On Linux, UNIX, and Windows, SYSCONS is ignored.

The

null

and NONE options are mutually exclusive. The other options can be specified together.

DTLMSGO File Example

/*
/* Sample file to change message destinations
/*
/* region size msg to console
594,SYSCONS
/* use pwx defaults
00595
/* multiple destinations
00650,SYSCONS,LOG
00651,SYSCONS,LOG,STDOUT
/* suppress stats msg
00408,NONE
/*
607,STDOUT,LOG
/*