Messages and message variables structured field introducers

When messages or message variables are returned to you as output data, they are put into your output buffer as structured fields as shown in Figure 1.

Figure 1. Structured field introducers for messages and message variables

    <MSGL - message line             : nn , character:         >
    <MSGL - message line             : nn , character:         >
 
or
 
  <Begin MESSAGE group>
    <MSGN - message number           : 8  , character:         >
    <xxx  - variable>
  <End MESSAGE group>
  <Begin MESSAGE group>
    <MSGN - message number           : 8  , character:         >
    <xxx  - variable>
  <End MESSAGE group>

When you use the CONTINUE operand on any SEARCH subcommand, the DFSMSrmm API returns the continue information at the message group with the CONT SFI as shown in Figure 2.

Figure 2. Message group with the CONT SFI

<Begin VOLUME group>
  <Begin MESSAGE group>
    <MSGN - message number            : 8 , character:         >
    <ENTN - number of entries         : 4 , bin(1):            >
  <End MESSAGE group>
  <Begin MESSAGE group>
    <MSGN - message number            : 8 , character:         >
    <CONT -continue information       :84 , character:         >
  <End MESSAGE group>
<End VOLUME group>

When you specify OUTPUT=LINES, messages issued by DFSMSrmm are placed in your output buffer using the LINE SFI.

When you specify OUTPUT=FIELDS, only the messages listed in Table 1 are placed in your output buffer. These messages, some of which are issued only in conjunction with a subcommand parameter such as POOL or COUNT, are included in the output because they contain data and codes that can be especially useful to your application. Your application program should use the return and reason codes that it receives rather than messages to determine whether or not the subcommand request was successful.

Table 1 lists:

The structured field introducers that follow the <MSGN> SFI
The applicable subcommands
A non-inclusive list of the return codes (RC) and reason codes (RSN).

Table 1. Message related structured field introducers
Message	SFI ID(s)	Subcommand(s)	RC	RSN(s)
EDG3010	ENTN	All SEARCH subcommands when no (0) entry is returned	4	8
EDG3011	ENTN	All SEARCH subcommands when 1 entry returned	0 4	0 2 and 4
EDG3012	ENTN	All SEARCH subcommands when > 1 entry returned	0 4	0 2 and 4
EDG3013	VOL	AV	12	many
EDG3014	CNT	AV	12	many
EDG3015	OWN VOL	GV	0	0
EDG3016	RCK	AV CV	0	0
EDG3017	RCK	AB AR	12	18 68 70
EDG3018	CNT	AB AR	12	18 68 70
EDG3019	RCK	DB DR	12	many
EDG3020	CNT	DB DR	12	many
EDG3025	CONT	All SEARCH subcommands	4	2
EDG3277	FRC FRS	AV CV	12	122
EDG3278	CSG	AV CV	12	124
EDG3288	FRC FRS VOL	CV DV	12	132
EDG3289	FRC FRS	CV	12	134
EDG3292	CLIB	AV CV	12	140
EDG3301	FRC FRS	AV CV GV	12	152
EDG3310	CLIB	CV DV	12	170
EDG3311	FRC FRS	AV CV DV	12	172
EDG3314	MEDN	CV	12	176
EDG3328	KEYF KEYT TYPF TYPT	SD SV	4	12

For a detailed explanation of these messages, see z/OS MVS System Messages, Vol 5 (EDG-GFS). For DFSMSrmm return and reason codes, see z/OS DFSMSrmm Managing and Using Removable Media.