dcsetup {[-j]|-d[-y|-n]} OpenTP1-directory

The dcsetup command catalogs OpenTP1 under a specified OpenTP1 directory into the OS, and starts or terminates a part of OpenTP1 with the OS.

The environmental variables TZ and LANG set in the dcsetup command execution environment are set in the OS as OpenTP1 environmental variables.

• LANG
• TZ

If environmental variable TZ or LANG is set in the putenv format of the system definition, they are overwritten when the definition phrase becomes effective.

The dcsetup command also deletes OpenTP1 from the OS. Terminate OpenTP1 before attempting deletion.

Only the superuser can execute the dcsetup command.

The input and output results of the dcsetup command are shown in message KFCA01895-I or KFCA01896-I. These messages are sent to syslog.

-j

Prevents any installed OpenTP1 resource managers from being cataloged into the system when the dcsetup command is executed.

If Y is specified for the jnl_fileless_option operand in the system common definition, specify the -j option when you use the dcsetup command to set up OpenTP1.

-d

Specifies that the OpenTP1 under a specified OpenTP1 directory is to be deleted from the OS.

When this option is omitted, the OpenTP1 under the specified OpenTP1 directory is cataloged into the OS.

When the command is executed with this option specified and the -y and -n options both omitted, the system asks the operator whether files that are needed for execution are to be deleted from the OpenTP1 directory.

If y is entered in response to this inquiry, the files needed for execution are deleted from the OpenTP1 directory. If n is entered, these files are not deleted.

To suppress output of this inquiry during command execution, execute the command with the -y or -n option specified.

-y

Suppresses querying of the operator about whether to delete the files required for execution of OpenTP1 in the specified OpenTP1 directory. When you specify this option, the files required for execution of Open TP1 in the specified OpenTP1 directory are deleted.

-n

Suppresses querying of the operator about whether to delete the files required for execution of OpenTP1 in the specified OpenTP1 directory. When you specify this option, the files required for execution of OpenTP1 in the specified OpenTP1 directory are not deleted.

OpenTP1-directory~<path name>

Specifies the OpenTP1 directory. A directory name can be 1-50 characters long.

If multiple OpenTP1s are to be created, they must all be specified in the directory.

• Save the file name inittabX (X is the serial number from 1 to 3) for backup under $DCDIR/conf/Inittab.
• While entering the dcsetup command, do not use an editor to edit /etc/inittab. If you edit it, /etc/inittab may be destroyed.
• Do not abort the dcsetup command processing by using a command such as the kill command. If processing stops, /etc/inittab may be destroyed.
• You can only execute the dcsetup command when the instance of OpenTP1 you are cataloging is not running.
• The dcsetup command creates a temporary file in /tmp. If the dcsetup command fails to create the temporary file, /etc/inittab may be destroyed. Check that there is sufficient free space in /tmp before executing the dcsetup command.
• Do not use a symbolic link to the OpenTP1 directory.
• Compilation processing by the dcsetup command searches for the target C compiler in the following sequence:
  
  1. /bin/cc and /lib/ccom
     Both /bin/cc and /lib/ccom are required.
     
  2. /usr/bin/cc
  3. /usr/vac/bin/cc
  If the target C compiler is not found in the above search sequence, OpenTP1 assumes the setting specified in the PATH environment variable of the process that executes the dcsetup command.