OpenTP1 Version 7 User's Guide
dcsetupml (sets up a multiOpenTP1 or cancels setup of a multiOpenTP1)
Format
dcsetupml [{-u|-d} ]
multiOpenTP1-setup-directory identifier
Function
This command sets up (or deletes) a multiOpenTP1 in a specified folder. The OpenTP1 identifier is used to identify each OpenTP1 within the same node. The user specifies this identifier as 1 to 4 single-byte alphanumeric characters. This command can be executed only when OpenTP1 is offline.
You can execute this command only from the console for the original OpenTP1.
Options
-u
Updates the multiOpenTP1 whose identifier is specified in the command argument to its most recent status.
-d
Deletes the multiOpenTP1 whose identifier is specified in the command argument.
Command arguments
multiOpenTP1-setup-directory ~<path name>
Specifies the folder in which the multiOpenTP1 is to be set up, expressed as 1 to 50 characters.
identifier ~<1 to 4 single-byte alphanumeric characters>
Specifies the character string used to identify the multiOpenTP1.
Output messages
Message ID |
Description |
Output destination |
KFCA26551-E |
Command execution failed. |
Standard error |
KFCA26552-E |
A specified command argument is invalid. |
Standard error |
KFCA26553-I |
Help message |
Standard output, standard error |
Notes
- Execute this command while the original OpenTP1 and the target multiOpenTP1 are not running.
- This command must be executed by a user with Administrators group permissions.
- This command copies the folders contained in the OpenTP1 installation folder (bin, etc, examples, include, lib, and tools). Note that if you have changed or added files in folders under the OpenTP1 installation folder, those files are also copied as is.
- When you execute this command, all installed program products are copied to the multiOpenTP1. Use the console created by the dcmakecon command to manipulate other program products as well, in addition to TP1/Server Base (such as TP1/FS/Direct Access, TP1/FS/Table Access, and TP1/Message Control).
- If you intend to execute this command with the -u or -d option specified and have created user-specific files in the folders under the multiOpenTP1 setup folder (bin, etc, examples, include, lib, spool, tmp, and tools), back up these files before you execute the command.
- If you have connected another company's resource manager to the multiOpenTP1 and you uninstall TP1/Server Base or update the multiOpenTP1, the resource manager information will be reset. When you update or set up the multiOpenTP1 again, use the trnlnkrm command again to connect the other company's resource manager.
- If you execute this command or perform uninstallation while another OpenTP1 command is executing or a command prompt is open under the OpenTP1 setup folder, folders and files might remain, or copy processing might fail. Make sure that you execute this command or perform uninstallation only after all other command executions and folder operations have been completed.
- In a system of multiOpenTP1s, you must set a unique port number for the name service of each OpenTP1. Also make sure that all other port numbers that are specified explicitly are unique. If any port number is duplicated, the KFCA00107-E message will be displayed in Event Viewer and OpenTP1 might terminate abnormally.
- Do not close the console or press the Ctrl + Break keys together while this command is executing.
- If a serious failure occurs during execution of this command, back up the following data as soon as possible and then contact maintenance personnel:
- %TEMP%\dcsetupml.log
- %TEMP%\trnlnkrm.log
- %DCDIR%\spool\errlog\*.* (%DCDIR% indicates the original OpenTP1's installation folder)
All Rights Reserved. Copyright (C) 2012, Hitachi, Ltd.