Message list tag - <msglist>

<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>.