z/OS DFSMSrmm Application Programming Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Structured field introducers for return and reason codes

z/OS DFSMSrmm Application Programming Interface
SC23-6872-00

The structured field introducers shown in Table 1 provide return codes and reason codes in your output buffer.

The DFSMSrmm API issues the return and reason code structured field introducers only when the subcommand fails. Each return and reason code pair is grouped within the SYSRETC group. The FRC and FRS structured field introducers are used for return and reason codes that are returned from OAM. The RSNC and RTNC structured field introducers are used for return and reason codes that are from another system service.

When the DFSMSrmm API builds a SYSRETC group for an error reported by a system service, look for additional information that is available from system messages in places like the operator terminal, SYSTSPRT, job log, and SYSLOG data set.

Subcommands are described using standard DFSMSrmm abbreviations. For example, AV is for ADDVOLUME as shown in Table 1. The structured field introducer values are enclosed in single quotes (') to signify that they are 8-byte hexadecimal values. Two spaces are included in the IDs for readability.

Table 1. Reason and return code structured field introducers
SFI Number SFI Name SFI Length SFI Data Type Data Description Subcommand
X'400000' FRC 12 Binary(32) Function return code AV CV DV GV
X'401000' FRS 12 Binary(32) Function reason code AV CV DV GV
X'402000' RSNC 12 Binary(32) Reason code Any subcommand
X'403000' RTNC 12 Binary(32) Return code Any subcommand
X'404000' SVCN 16 Character (variable length) Service name Any subcommand

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014