Any remarks for the MNOTE instruction statement must be separated
by one or more spaces from the apostrophe that ends the message.
If
severity is provided, or
severity is
omitted but the comma separating it from
message is
present, the message is treated as an error message; otherwise the
message is treated as comments. The rules for specifying the contents
of
severity are:
- The severity code can be specified as any arithmetic expression
allowed in the operand field of a SETA instruction. The expression
must have a value in the range 0 through 255.
Example:
MNOTE 2,'ERROR IN SYNTAX'
The
generated result is:
2,ERROR IN SYNTAX
- If the severity code is omitted, but the comma separating it from
the message is present, the assembler assigns a default value of 1
as the severity code.
Example:
MNOTE ,'ERROR, SEV 1'
The
generated result is:
,ERROR, SEV 1
- An asterisk in the severity code subfield causes the message and
the asterisk to be generated as a comment statement.
Example:
MNOTE *,'NO ERROR'
The generated
result is:
*,NO ERROR
Here
is an example taken from a CICS® macro:
MNOTE 8,'FIELD IS DEFINED OUTSIDE OF THE SIZE OPERAND'
MNOTE *,'PARAMETERS SPECIFIED IN THE DFHMDI MACRO,'
MNOTE *,'MACRO REQUEST IS IGNORED.'
A further advantage
of this approach is that only one severity 8 error is seen instead
of three.
- If the severity code subfield is omitted, including the comma
separating it from the message, the assembler generates the message
as a comment statement.
Example:
MNOTE 'NO ERROR'
The
generated result is:
NO ERROR
Notes: - An MNOTE instruction causes a message to be printed, if the current
PRINT option is ON, even if the PRINT NOGEN option is specified.
- The statement number of the message generated from an MNOTE instruction
with a severity code is listed among any other error messages for
the current source module. However, the message is printed only if
the severity code specified is greater than or equal to the severity
code nnn specified in the FLAG(nnn)
assembler option.
- The statement number of the comments generated from an MNOTE instruction
without a severity code is not listed among other error messages.