MSGMBR (Message Member)

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 definition
Tag	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 member

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