The MSGMBR tag defines a message member.
Syntax
>>-<MSGMBR--NAME=message-member-name--+---------+--------------->
'-CCSID=n-'
>--+---------------+-->--</MSGMBR>-----------------------------><
| .-76-. |
'-WIDTH=-+-68-+-'
Parameters
- NAME=message-member-name
- This
specifies the name of the message member, which also serves as the
prefix for all identifiers of messages within the member.
The message-member-name can
be specified as a 3-7 character name, conforming to ISPF message member
standard naming convention. The last two positions must be numeric.
The preceding characters can be A-Z, a-z, or #, $, @.
Lowercase
characters are translated to their uppercase equivalents.
If
you specify NAME=*, the message-member-name is
set to the input DTL source member name. If multiple dialog element
definitions have been combined within a single source file, then this
notation should be used for only one dialog element definition within
the file. See Dialog elements for a description
of dialog element types created by the conversion utility.
The message-member-name is
also used to build the name used for storing messages. For example,
if NAME=MSGA12, the default name used to store the message members
is userid.MSGS(MSGA12). This can be changed by specifying a message
file on the conversion utility invocation panel. See Using the conversion utility for more information about ISPDTLC syntax.
for
information about allocating a message library at run time, refer
to the z/OS ISPF User's Guide Vol I.
- CCSID=n
- CCSID
specifies the coded-character-set identifier as defined by the Character Data Representation Architecture. CCSID
should be entered as a five-position numeric value. For more information
on using the CCSID attribute, refer to the z/OS ISPF Dialog Developer's Guide and Reference.
- WIDTH=76 | 68
- This
attribute specifies the width of the formatted messages. When WIDTH=68,
the resulting messages are formatted entirely within a normal Edit
or View screen.
Comments
The
MSGMBR tag defines a message member. You can code multiple message
members for a single application.
The message-member-name is
an explicit part of the identifier for messages coded in the message
member. Each message member contains multiple messages. You use the
MSG tag to define\ messages within a message member.
Restrictions
- The MSGMBR tag requires an end tag.
- You cannot code the MSGMBR tag within any other tag definition.
Processing
Table 1. Tags you can code within an MSGMBR definitionTag |
Reference |
Usage |
Required |
---|
COMMENT |
COMMENT (Comment) |
Multiple |
No |
MSG |
MSG (Message) |
Multiple |
Yes |
Examples
Here is markup that
defines the message member
MSGM88, which contains nine MSG
definitions.
Figure 1 shows the generated
ISPF message member.
<!DOCTYPE DM SYSTEM>
<VARCLASS NAME=msgcls TYPE='char 20'>
<VARLIST>
<VARDCL NAME=phoneno VARCLASS=msgcls>
<VARDCL NAME=cnum VARCLASS=msgcls>
</VARLIST>
<MSGMBR NAME=msgm88>
<MSG SUFFIX=1>Name must be alphabetic.
<MSG SUFFIX=2>Enter only number of days.
<MSG SUFFIX=3 MSGTYPE=critical>The only rooms we have available
are either SINGLE or DOUBLE. Please call the manager of the hotel
who will arrange equivalent lodging at another
hotel in the area. This is our mistake, and we will, of course,
pick up the bill. Please call collect <VARSUB VAR=phoneno>.
<MSG SUFFIX=4 MSGTYPE=action LOCATION=modal>Please enter either
BIGCHARGE, V I S T A, EZCARD, CHECK, or CASH.
<MSG SUFFIX=5 MSGTYPE=warning LOCATION=modeless>Please enter your name.
<MSG SUFFIX=6>Please enter Y or N.
<MSG SUFFIX=7>Card number is a seven-digit number.
<MSG SUFFIX=8 MSGTYPE=warning>The card number you
entered, <VARSUB VAR=cnum> is not valid.
<MSG SUFFIX=9>Message '9' contains embedded quotes.
</MSGMBR>
Figure 1. Message memberMSGM881 .TYPE=NOTIFY
'Name must be alphabetic.'
MSGM882 .TYPE=NOTIFY
'Enter only number of days.'
MSGM883 .TYPE=CRITICAL
'The only rooms we have available are either SINGLE or DOUBLE. Please call th' +
'e manager of the hotel who will arrange equivalent lodging at another hotel ' +
'in the area. This is our mistake, and we will, of course, pick up the bill. ' +
'Please call collect &PHONENO.'
MSGM884 .TYPE=ACTION .WINDOW=RESP
'Please enter either BIGCHARGE, V I S T A, EZCARD, CHECK, or CASH.'
MSGM885 .TYPE=WARNING .WINDOW=NORESP
'Please enter your name.'
MSGM886 .TYPE=NOTIFY
'Please enter Y or N.'
MSGM887 .TYPE=NOTIFY
'Card number is a seven-digit number.'
MSGM888 .TYPE=WARNING
'The card number you entered, &CNUM is not valid.'
MSGM889 .TYPE=NOTIFY
'Message '9'' contains embedded quotes.'