DBC command return and reason codes
Return and reason codes from specific XML command streams are sent to the DBC either by the DBC API or through the BMC Execution Component for z/OS (DBC) batch utility.
DBC reason codes are composed of two 2-byte components, where the high order 2-bytes (bits 0-15) indicate the internal DBC component that detected the error and the low order 2-bytes (bits 16-31) contain the error code.
The following table describes the return codes.
Return codes
Return code | Description |
|---|---|
0 | The reason code is not applicable and is therefore not returned to the caller. |
4 | The high-order 2-bytes (that is, the component code) of the reason code will always be zero. |
8 | The high-order 2-bytes (that is, the component code) of the reason code will always be set to indicate which routine detected the error. |
The following table describes the expected return and reason codes.
DPR command return and reason codes
Command | Return code | Reason code | Description |
|---|---|---|---|
CMDDEF | 0 | n/a | The command was defined successfully. |
CMDDEF | 4 | 52(34) | This command is already defined to this DBC subsystem. |
CMDDEF | 8 | 116(74) | The user is not authorized for this command. |
CMDDEL | 0 | n/a | The command definition was deleted successfully. |
CMDDEL | 8 | 116(74) | The user is not authorized for this command. |
CMDDEL | 8 | 704(2C0) | The command definition could not be deleted because the command is not defined. |
DISABLE | 0 | n/a | The product object was disabled successfully. |
DISABLE | 4 | 196(C4) | The product instance was not found. The product has not been initialized through an INITPROD command. |
DISABLE | 4 | 407(197) | An error occurred during the deconcatenation of the logical STEPLIB. The object was disabled. |
DISABLE | 4 | 415(19F) | An error occurred while deallocating one or more logical STEPLIB data sets. The object was disabled. |
DISABLE | 8 | 116(74) | The user is not authorized for this command. |
DISABLE | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class not found. |
DISABLE | 8 | 193(C1) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |
DISABLE | 8 | 263(107) | An agent object was not found. The specified agent is not a component of this product instance. |
DISABLE | 8 | 266(10A) | The process object was not found. The specified process is not a component of this product instance. |
DISABLE | 8 | 271(10F) | The function object was not found. The specified function is not a component of this product instance. |
ENABLE | 0 | n/a | The product object was successfully enabled. |
ENABLE | 4 | 196(C4) | The product instance not found. The product has not been initialized through an INITPROD command. |
ENABLE | 4 | 258(102) | The object is already enabled. |
ENABLE | 8 | 55(37) | The open of the pseudo STEPLIB concatenation DD failed. |
ENABLE | 8 | 56(38) | The dynamic allocation of the pseudo STEPLIB failed. |
ENABLE | 8 | 67(43) | The directed load of a consumer program associated with object definition failed. |
ENABLE | 8 | 70(46) | The dynamic concatenation of the pseudo STEPLIB failed. |
ENABLE | 8 | 116(74) | The user is not authorized for this command. |
ENABLE | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class was not found. |
ENABLE | 8 | 256(100) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |
ENABLE | 8 | 263(107) | The agent object was not found. The specified agent is not a component of this product instance. |
ENABLE | 8 | 266(10A) | The process object was not found. The specified process is not a component of this product instance. |
ENABLE | 8 | 271(10F) | The function object was not found. The specified function is not a component of this product instance. |
EXECUTE | 0 | n/a | The function was executed successfully. |
EXECUTE | 4 | 196(C4) | The product instance not found. The product has not been initialized through an INITPROD command. |
EXECUTE | 8 | 3(3) | The storage allocation failed. The address space is short on storage. |
EXECUTE | 8 | 55(37) | The DPR component could not open a pseudo STEPLIB concatenation DD. |
EXECUTE | 8 | 69(45) | A SAS/C environment error occurred. The buildm failed. |
EXECUTE | 8 | 116(74) | The user is not authorized for this command. |
EXECUTE | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class was not found. |
EXECUTE | 8 | 175(AF) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |
EXECUTE | 8 | 260(104) | The SVC screening service failed to enable for this task. |
EXECUTE | 8 | 271(10F) | The function object not found. The specified function is not a component of this product instance. |
EXECUTE | 12 | 34(22) | A severe internal failure occurred because of an invalid or missing parameter on internal function call. |
FINDDB2 | 4 | 42(2A) | An optional XML element was specified but a value was not supplied |
INITPROD | 0 | not applicable | The product registration with the DPR component of the DBC was successful. |
INITPROD | 4 | 52(34) | An instance of this product is already registered with this specific DBC subsystem. |
INITPROD | 4 | 42(2A) | An optional XML element was specified but a value was not supplied. |
INITPROD | 4 | 93(5D) | The persist option was requested; however, this INITPROD command is already stored in the DPR repository data set. |
INITPROD | 4 | 195(C3) | The product was successfully registered; however, an <AUTOEXEC> request for an individual product component failed to execute. |
INITPROD | 4 | 401(191) | The persist was requested but no repository data set was defined for this DBC subsystem. |
INITPROD | 8 | 3(3) | The storage allocation failed. The address space is short on storage. |
INITPROD | 8 | 60(3C) | An XML element value was supplied but is an invalid data type (for example, an invalid number or a value out of range). |
INITPROD | 8 | 116(74) | The user is not authorized for this command. |
INITPROD | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class was not found. |
INITPROD | 8 | 183(B7) | An internal error occurred during INITPROD command parsing. This error is accompanied by diagnostic messages issued to the DBCPRINT DD of the DBC subsystem startup JCL. |
INITPROD | 8 | 186(BA) | The persist option was requested; however, the open operation for the repository data set failed. |
INITPROD | 8 | 187(BB) | The persist option was requested; however, the close operation for the repository data set failed. |
INITPROD | 8 | 272(110) | A duplicate <FUNCTION> was found within the product definition XML document. |
INITPROD | 8 | 273(111) | A duplicate <AGENT> was found within the product definition XML document. |
INITPROD | 8 | 274(112) | A duplicate <ENCLAVE> was found within the product definition XML document. |
INITPROD | 12 | 117(75) | A severe internal failure occurred during command authorization checking. Internal storage corruption occurred. |
SEND | 0 | n/a | The message was sent successfully. |
SEND | 4 | 141(8D) | An agent task has terminated. |
SEND | 4 | 142(8E) | An agent task is stopping and unable to receive messages. |
SEND | 4 | 196(C4) | The product instance was not found. The product has not been initialized through an INITPROD command. |
SEND | 4 | 264(108) | The instance of the agent object (that is, the target of the SEND message) is not active. |
SEND | 8 | 94(5E) | The send message to a specific task queue failed. Note: This reason code is accompanied by message BMCDBC046E to indicate the specific cause of the error. |
SEND | 8 | 116(74) | The user is not authorized for this command. |
SEND | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class was not found. |
SEND | 8 | 179(B3) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |
SEND | 8 | 263(107) | An agent object was not found. The specified agent is not a component of the identified product instance. |
STARTAGENT | 0 | not applicable | The agent task was started successfully. |
STARTAGENT | 4 | 38(26) | The service is stopping. The DPR main service is in the process of stopping; therefore, the start agent request cannot be processed. |
STARTAGENT | 4 | 196(C4) | The product instance was not found (that is, the product has not been initialized through an INITPROD command). |
STARTAGENT | 4 | 265(109) | The instance of this agent object is already active. |
STARTAGENT | 8 | 3(3) | The storage allocation failed. The address space is short on storage. |
STARTAGENT | 8 | 10(A) | The address of the message is zero. |
STARTAGENT | 8 | 11(B) | The length of the message pointer is zero. |
STARTAGENT | 8 | 20(14) | The address of the message type is zero. |
STARTAGENT | 8 | 73(49) | The DPR component was unable to identify the entry point of the agent task. |
STARTAGENT | 8 | 116(74) | The user is not authorized for this command. |
STARTAGENT | 8 | 117(75) | An internal failure during command authorization checking. The SAF resource class was not found. |
STARTAGENT | 8 | 176(B0) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |
STARTAGENT | 8 | 263(107) | The agent object was not found. The specified agent is not a component of this product instance. |
STARTAGENT | 12 | 1(1) | A severe internal failure occurred. The DBCT anchor was not found. |
STARTAGENT | 12 | 34(22) | A severe internal failure occurred. A parameter for an internal function call was invalid or missing. |
STARTAGENT | 12 | 117(75) | A severe internal failure occurred during command authorization checking. Internal storage was corrupted. |
STARTAGENT | 111 | 156(9C) | See EACCES6. |
STARTAGENT | 112 | 156(9C) | See EAGAIN6. |
STARTAGENT | 118 | 156(9C) | See EFAULT6. |
STARTAGENT | 120 | 156(9C) | See EINTR6. |
STARTAGENT | 121 | 156(9C) | See EINVAL6. |
STARTAGENT | 132 | 156(9C) | See ENOMEM6. |
STARTAGENT | 1141 | 156(9C) | See EIDRM6. |
STARTPROCESS | 0 | n/a | The process (address space) instance was started successfully |
STARTPROCESS | 4 | 196(C4) | The product instance not found. The product has not been initialized through an INITPROD command. |
STARTPROCESS | 4 | 268(10C) | The instance of this process object is already active. |
STARTPROCESS | 4 | 269(10D) | The process has terminated. |
STARTPROCESS | 8 | 3(3) | The storage allocation failed. The address space is short on storage. |
STARTPROCESS | 8 | 116(74) | The user is not authorized for this command. |
STARTPROCESS | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class was not found. |
STARTPROCESS | 8 | 180(B4) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |
STARTPROCESS | 8 | 266(10A) | The process object was not found. The specified process is not a component of this product instance. |
STARTPROCESS | 8 | 270(10E) | The process state is unknown because an internal error occurred when locating available address space. |
STARTPROCESS | 12 | 34(22) | A severe internal failure occurred because of invalid or missing parameter on an internal function call. |
STOPAGENT | 0 | not applicable | The agent task was stopped successfully. |
STOPAGENT | 4 | 38(26) | The service is stopping. The DPR main service is in the process of stopping, so the agent start request cannot be processed. |
STOPAGENT | 4 | 196(C4) | The product instance was not found. The product has not been initialized through an INITPROD command. |
STOPAGENT | 4 | 264(108) | This instance of agent object is not active. |
STOPAGENT | 8 | 3(3) | The storage allocation failed. The address space is short on storage. |
STOPAGENT | 8 | 116(74) | The user is not authorized for this command. |
STOPAGENT | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class was not found. |
STOPAGENT | 8 | 177(B1) | A command parsing error occurred because either the XML is badly formed or a parameter is invalid or missing. |
STOPAGENT | 8 | 263(107) | The agent object was not found. The specified agent is not a component of the identified product instance. |
STOPAGENT | 12 | 1(1) | A severe internal failure occurred. The DBCT anchor was not found. |
STOPAGENT | 12 | 34(22) | A severe internal failure occurred. A parameter for an internal function call was invalid or missing. |
STOPAGENT | 12 | 117(75) | A severe internal failure occurred during command authorization checking. Internal storage was corrupted. |
STOPPROCESS | 0 | n/a | The process (address space) instance was stopped successfully. |
STOPPROCESS | 4 | 196(C4) | The product instance not found. The product was not initialized through an INITPROD command. |
STOPPROCESS | 4 | 267(10B) | This instance of process object is not active. |
STOPPROCESS | 8 | 181(B5) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |
STOPPROCESS | 8 | 266(10A) | The process object was not found. The specified process is not a component of this product instance. |
STOPPROCESS | 111 | 156(9C) | See EACCES. |
STOPPROCESS | 112 | 156(9C) | See EAGAIN6. |
STOPPROCESS | 118 | 156(9C) | See EFAULT6. |
STOPPROCESS | 120 | 156(9C) | See EINTR6. |
STOPPROCESS | 121 | 156(9C) | See EINVAL6. |
STOPPROCESS | 132 | 156(9C) | See ENOMEM6. |
STOPPROCESS | 1141 | 156(9C) | See EIDRM6. |
TERMPROD | 0 | n/a | The product deregistration with the DPR component of the DBC was successful. |
TERMPROD | 4 | 195(C3) | The AUTOEXEC at termination returned an error; however, the product was disabled. |
TERMPROD | 4 | 196(C4) | The product instance not found. The product has not been initialized through an INITPROD command. |
TERMPROD | 8 | 116(74) | The user is not authorized for this command. |
TERMPROD | 8 | 117(75) | An internal failure occurred during command authorization checking. The SAF resource class not found. |
TERMPROD | 8 | 187(BB) | The repository failed to close upon completion of persist request. |
TERMPROD | 8 | 186(BA) | The repository could not be opened. The request could not be persisted. |
TERMPROD | 8 | 192(C0) | A command parsing error occurred due to badly formed XML or an invalid or missing parameter. |