Start of change

Recovering from VTAM ACB OPEN problems

The Db2 distributed data facility (DDF) might terminate after startup due to a VTAM ACB OPEN failure. You can diagnose the situation to determine how to resolve the problem.

Symptoms

Db2 messages, such as DSNL013I and DSNL004I, are issued to indicate the problem.
DSNL013I
Contains the error field value that is returned from the VTAM ACB OPEN. For information about possible values, see OPEN macroinstruction error fields.
DSNL004I
Normally specifies a fully qualified LU name, network-name.luname. The absence of the network-name indicates a problem.

Resolving the problem

  1. Determine whether VTAM is up:
    • If VTAM is not up, start VTAM, and then start DDF.
    • If VTAM did not start completely before DDF was started, start VTAM, and then start DDF.
    If neither of these situations exists, continue with the next step.
  2. If VTAM is up, determine the reason for the problem. One possible reason that the VTAM ACB OPEN failed is that one of the following problems exists for the LU name that was defined to Db2 through the Db2 change log inventory (DSNJU003) utility DDF statement:
    • The LU name is not defined to VTAM.
    • The LU name is defined, but the LU did not start automatically during VTAM startup.
    • The LU name that is displayed in the DSNL004I message is not valid. In this case, stop Db2, run a DSNJU003 utility job, and restart Db2.
    To diagnose the problem within VTAM:
    1. Issue the following command: DISPLAY NET,ID=luname,SCOPE=ALL, where luname is displayed in message DSNL004I, and examine the output of the DISPLAY command.
      • If the output suggests that the LU name does not exist, display each APPL node by issuing the DISPLAY APPLS command. For command details, see DISPLAY APPLS command .
      • If you do not find an active APPL node that contains the LU name or a model LU name (a wildcard LU name) that Db2 can use, take one of the following actions:
        • If no active APPL node exists and no APPL major node definition exists in any library that is referenced by the VTAM started procedure VTAMLST DD specification, define an APPL node to VTAM, start it, and then start DDF.
        • If no active APPL node exists, but an APPL major node definition exists in a library that is referenced by the VTAM started procedure VTAMLST DD specification, start the major node, and then start DDF. The cause of this situation is that the major node was not automatically started during VTAM startup.
    2. Work with your VTAM administrator to ensure that the required APPL node or APPL major node is started automatically during VTAM startup in the future. For more information, see The APPL statement.
  3. If the previous steps do not resolve the problem, examine the reason code from the DSNL013I message. If the reason code is X'24', the PRTCT value in the APPL definition does not match the password value that was defined to Db2 in the DSNJU003 DDF statement. If the password specification to Db2 is missing or incorrect, with Db2 stopped, run a DSNJU003 utility job, specifying a DDF statement with the correct password, and restart Db2.
  4. If none of the previous steps resolves the issue, contact your VTAM administrator for additional help in resolving the problem.
End of change