Distributed FileManager/MVS SRVDGN data items

The server-diagnostic-information (SRVDGN) field provides diagnostic information for DDM reply messages that are returned to the source system. The SRVDGN can be used with the other architected fields. These fields are for DDM reply messages. The other fields are used for problem determination and resolution.

For a list DDM reply messages returned by Distributed FileManager/MVS, see DDM reply messages returned by Distributed FileManager/MVS.

Figure 1 shows the SRVDGN format that is returned by Distributed FileManager/MVS. The SRVDGN consists of two sections: a constant section (always supplied) and a variable section (contents depend on the reported error). The constant section contains the Distributed FileManager/MVS return and reason codes. The last two bytes of the Distributed FileManager/MVS reason code are an error code. Distributed FileManager/MVS implementation specific codes lists the Distributed FileManager/MVS error codes and their descriptions.

The variable section of the SRVDGN is in the form of keyed data items. Data items apply to a reported error. Each data item in the SRVDGN consists of a two-byte field. This field is followed by a key field that is also two bytes. The key field is followed by the data item value. The length field only specifies ( in bytes) the length of the date item value. Most data items are used only by IBM® Service; however, some data items might be used by the MVS systems programmer for problem determination. These data items are documented in Table 1.

All SRVDGN information should be supplied to IBM Service when the source programmer, MVS system programmer, or application programmer cannot solve the problem.
Figure 1. Server Diagnostic Area (SRVDGN) Format. Length of field is in parenthesis following field description.
Server Diagnostic Area (SRVDGN) Format: DDM SRVDGN LLCP (2); Constant section: MVS/DFM return code (4) and MVS/DFM reason code (4), Variable section: data item #1 length (2), data item #1 key (2), data item #1 value (2), data item #2 length (2) and so on.
Table 1. Distributed FileManager/MVS SRVDGN Data Items
Data Item Key Data Item Length Data Item Description
X'8428' 4 SVC 99 return code
X'8429' 4 SVC 99 reason code
X'842A' 4 SVC 99 information code
X'842F' 4 SVC 99 error reason code
X'8505' 4 APPC return code
X'8667' 4 ALESERV return code
X'8430' 4 ATTACH return code
X'842B' 4 FAMS return code
X'842C' 4 FAMS reason code