<msglist xreftext="csectname rules=ruleslevel"></msglist>:
The message list tag. You can only have one message list
per message table. If you include any data after the end
message list tag, </msglist>, the message generation program will
issue error message HZSM0009 and issue a return code of 8. See Generating the compilable assembler CSECT for the message table.
- csectname
- Specify the name of the generated message table CSECT. csectname must
be 1-8 alphanumeric characters. xreftext="csectname"
is required.
- ruleslevel
- Use the rules attribute to indicate whether or not your check
message input table uses message elements that apply only to z/OS® V1R8 and above systems. If
the message table does not conform to the rules level selected, the
HZSMSGEN exec will not be able to generate the message table.
- rules="3"
- Indicates that the check can run on systems at the z/OS V1R10 level or above and use R10 and above
functions, including all the rules="2" and rules="1" functions. The z/OS V1R10 enhancement includes:
- When a message class of report is used, and the message output
requires more than one line, leading blanks are suppressed at the
beginning of the new line.
If you specify rules="3" on a message list for a check that runs
on a system below the z/OS V1R10
level, the check abends when the system tries to add the check to
the system.
- rules="2"
- Indicates that the check can run on systems at the z/OS V1R8 level or above and use R8 and above
functions:
- You can use maxlen and fieldsize attributes for variables - see
"Variables for message text" in Message text (<msgtext>) and message variable (<mv>) tags.
- In rules="2" message list, you cannot enter leading blank characters
after the <p> and <msgtext> tags. If you need a blank in a rules="2"
messagelist, use symbol &rbl;, which inserts a required blank
into the formatted output. This is also useful for keeping words together
on one line. For example, to keep the words System A on
one line and together, code the following:
System&rbl;A
If you specify rules="2" on a message list for a check that runs
on a system below the z/OS V1R8
level, the check abends when the system tries to add the check to
the system.In order to convert a message list from rules="1" to
rules="2", you must:
- Specify rules="2" on the message list tag
- Use a required blank symbol, &rbl; if you require a leading
blank after a <p> tag or <msgtext> tag.
- rules="1"
- Indicates that the check can run on any system where IBM® Health Checker for z/OS is available, depending on what releases
the individual check supports - see IBM Health Checker for z/OS checks.
At rules level 1, a check message table cannot use z/OS V1R8 enhancements such as required blank
symbols or maxlen and fieldsize attributes for variables. For a rules="1"
message list, the system will ignore leading blank characters after
the paragraph tag, <p>, and message text tag, <msgtext>.