1.3.1 Creation and checking of the system definition

The OpenTP1 administrator must create the system definition before the superuser catalogs OpenTP1 into the OS. By running the dcdefchk command after creating the system definition, you can make sure that no values have been specified incorrectly before starting OpenTP1. For details about the system definition and how check it, see the manual OpenTP1 System Definition.

Organization of this subsection
(1) Checks performed by the dcdefchk command
(2) Flow of checking with the dcdefchk command
(3) Cautionary notes

(1) Checks performed by the dcdefchk command

The dcdefchk command performs the checks described below.

(a) Checking the syntax of the system definition

The syntax of the system definition is checked as follows:

(b) Checking the logic of the system definition

The logic of the system definition is checked to determine whether any of the values specified in an operand or a definition command may cause problems with OpenTP1 operation. The logic is checked as follows:

(c) Checking OpenTP1 files

OpenTP1 files are checked to determine whether the correct files are specified in the system definition.

(2) Flow of checking with the dcdefchk command

The dcdefchk command performs checks in the following sequence:

  1. Checks the syntax of operands.
    The command checks the syntax of operands in the system definition files located in the definition directories. The check sequence is as follows:
    1. System definition files under the directory specified by the $DCCONFPATH environment variable
    2. User service definition files under the directory specified by the $DCUAPCONFPATH environment variable
  2. Outputs the KFCA00258-I message.
    A list of definition files checked for syntax in step 1 is output in a KFCA00258-I message. At this time, only the files that are checked as the system service definition are output. The files that are checked as the user service definition are not output.
  3. Outputs the KFCA00254-R message.
    When the -r option is specified in the dcdefchk command and an error is found during the syntax check in step 1, a KFCA00254-R message is output. The KFCA00254-R message asks you whether to continue or stop command processing.
  4. Checks the syntax (and some logic aspects) of definition commands specified in the system definition (excluding the user service definition).
    The command checks the syntax (and some aspects of logic) of definition commands in the system definition files located in the definition directories (the directories specified by the environment variables $DCCONFPATH and $DCUAPCONFPATH).
    After each of the checks described in 4 to 7, the command outputs a message with one of the following indicating the message type labels. Note that some output messages may not be assigned a category.
    Labels indicating message type:
    ERROR: This type of message is output on detection of a problem that prevents OpenTP1 from starting or stopping, or impairs some aspects of OpenTP1 operation.
    WARNG: This type of message is output when a specified value is not the recommended value.
    CHECK: This type of message is output to prompt the user to check the validity of a specified definition.
  5. Checks the logic of system definitions (excluding the user service definition).
    The command checks the logic of the definitions specified in the system definitions located in the definition directories.
  6. Checks the syntax (and some logic aspects) of the definition commands specified in the user service definition).
    The command checks the syntax (and some aspects of logic) of the definition commands specified in the user service definitions located in the definition directories.
  7. Checks the logic of user service definitions.
    The command checks the logic of the definitions specified in the user service definitions located in the definition directories.

The following table shows the order in which the various checks take place. The numbers in the table correspond to the steps listed above. Note that checking of OpenTP1 files takes place in steps 4. and 5. of the flow of checking with the dcdefchk command.

Table 1-2 Flow of checks performed by the dcdefchk command

TypeOperand
(set format)
Definition commands (command format)
Other than user service definitionUse service definition
Syntax check1.4.6.
Logic check5. and 7.4. and 5.6. and 7.

(3) Cautionary notes