DSNT057I DSNTMVSB PROGRAM ENDED, RETURN CODE = return-code, COMMAND COMPLETION CODE = command-completion-code.

Explanation

The batch program DSNTMVSB has completed.
return-code
The return code encountered during processing:
return-code
0

The batch program did not encounter any errors during processing.

command-completion-code is set to 0 or 4.

4
The batch program issued the command but was unable, within the prescribed wait time, to determine the command execution status based on the command messages retrieved. All command messages and any ssnmMSTR or irlmproc job status messages retrieved within the prescribed wait time are written to DD:CMDOUT.

command-completion-code is set to 8 or 16.

8
The batch program issued the command but was unable to determine the command execution status due to an internal error. All the command messages and any ssnmMSTR or irlmproc job status messages retrieved so far are written to DD:CMDOUT.

command-completion-code is set to 8 or 16.

12
The batch program encountered an error during processing. A message describing the error is written to SYSPRINT.
16
The batch program did not encounter any errors during processing. However, the command completed abnormally.

command-completion-code is set to 12.

command-completion-code
0

The command completed successfully.

Table 1. Details for command-completion-code 0
Command command-completion-code meaning Message received
START DB2 Successful completion DSN9022I cmd_prefix
STOP DB2 Successful completion DSN9022I cmd_prefix

If system services address space (ssnmMSTR) termination monitoring is requested: message 'ssnmMSTRNOT FOUND' was found in the 'D J, ssnmMSTR' command output.
4

The command was not processed. For example, Db2 was already stopped when STOP DB2 was requested.

Table 2. Details for command-completion-code 4
Command command-completion-code meaning Message received
START DB2 Db2 was already active when the command was issued. DSNY003I cmd_prefix
STOP DB2 When the command was issued, Db2 was already stopped or Db2 was in the process of stopping and it stopped successfully. If Db2 MSTR or IRLM address space termination monitoring is not requested, any of the following messages are received:
  • DSN3106I cmd_prefix
  • DSNY004Icmd_prefix and DSN9022I cmd_prefix

If system services address space (ssnmMSTR) termination monitoring is requested, both of the following messages were received:

  • DSNY004I cmd_prefix and DSN9022Icmd_prefix
  • 'ssnmMSTR NOT FOUND' in 'D J, ssnmMSTR' command output

If IRLM address space termination monitoring is requested, both of the following messages were received:

  • DSNY004I cmd_prefix and DSN9022Icmd_prefix
  • 'irlm_job NOT FOUND' in 'D J, 'irlm_job' command output
8

The command started but the completion status is unknown.

Table 3. Details for command-completion-code 8
Command command-completion-code meaning Message received Expected message not received
START DB2 Db2 is in the process of starting, but the completion status of the START DB2 command is unknown. DSNY024I cmd_prefix Any of the following messages:
  • DSN9023I cmd_prefix
  • DSNV086E cmd_prefix
  • DSN3104I cmd_prefix
  • DSN9022I cmd_prefix
  • DSN3100I cmd_prefix
STOP DB2 Db2 is in the process of stopping, but the completion status of the STOP DB2 command is unknown. One of the following messages was received:
  • DSNY002I cmd_prefix
  • DSNY004I cmd_prefix
 One of the following messages was not received:
  • DSN9022I cmd_prefix
  • DSN9023I cmd_prefix
Or DSN9022I cmd_prefix was received along with one of the following conditions:
  • If system services address space (ssnmMSTR) termination monitoring is requested, and 'ssnmMSTR NOT FOUND' was not found in 'D J, ssnmMSTR' command output
  • If IRLM address space (irlmproc) termination monitoring is requested, and 'irlm_job NOT FOUND' is not found in 'D J, 'irlm_job' command output.
12

The command completed abnormally.

Table 4. Details for command-completion-code 16
Command command-completion-code meaning Message received
START DB2 Abnormal completion. One of the following messages was received:
  • DSN9023I cmd_prefix
  • DSNV086E cmd_prefix
  • DSN3100I cmd_prefix
  • DSN3104I cmd_prefix
  • DSN3106I cmd_prefix
  • DSN3107I cmd_prefix
STOP DB2 Abnormal completion. One of the following messages was received:
  • DSN9023I cmd_prefix
  • DSN3107I cmd_prefix
16

The command output does not satisfy the conditions that are listed for command-completion-code 0, 4, 8, or 12.

command-completion-code
The completion status of the command.

System action

The program terminates.

User response

Use the information provided for the return-code and command-completion-code to determine the status of command execution.