OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

dcsetup (Catalog OpenTP1 into OS, delete OpenTP1 from OS)

Format

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

Function

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.

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.

Options

-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.

Command arguments

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.

Notes