dcmakecon [identifier]

This command creates a new console that is to be used to execute commands by the OpenTP1 with the specified OpenTP1 identifier. If the identifier is omitted, the command creates a new console that is to be used to execute commands by the original OpenTP1. You can execute this command whether OpenTP1 is online or offline.

You can execute this command only from the console for the original OpenTP1.

In a multiOpenTP1, you execute commands by the original OpenTP1 from the console that is created by execution of this command. Note that none of the following commands can be executed from the console for the multiOpenTP1:

• dcdls
• dcmakecon
• dcsetupml

The environment variables listed in the table below are set at the new console created by execution of this command. These settings are effective only at the corresponding console.

Table 7-2 Environment variable settings in the console

Environment variable	Setting
DCCONFPATH	The same value as the DCCONFPATH environment variable value defined in OpenTP1-setup-folder-corresponding-to-OpenTP1-identifier\conf\env is set.
DCDIR	OpenTP1-setup-folder-corresponding-to-OpenTP1-identifier is set.
DCUAPCONFPATH	The same value as the DCUAPCONFPATH environment variable value defined in OpenTP1-setup-folder-corresponding-to-OpenTP1-identifier\conf\env is set.
INCLUDE	OpenTP1-setup-folder-corresponding-to-OpenTP1-identifier\include is added at the beginning.
LIB	OpenTP1-setup-folder-corresponding-to-OpenTP1-identifier\lib is added at the beginning.
PATH	OpenTP1-setup-folder-corresponding-to-OpenTP1-identifier\bin is added at the beginning in order to execute the corresponding OpenTP1's commands with top priority.

identifier ~<1 to 4 single-byte alphanumeric characters>

Specifies the character string that was specified when the multiOpenTP1 was set up.

If you execute the command without specifying a command argument, the command creates a console for manipulating the original OpenTP1.

Message ID	Description	Output destination
KFCA26551-E	Command execution failed.	Standard error
KFCA26552-E	A specified command argument is invalid.	Standard error
KFCA26555-I	Help message	Standard error

• When you use a multiOpenTP1, make sure that you use the console created by this command to change environment variables. If you use any other method to change environment variables, the operation cannot be guaranteed.
• If you execute the dcsetupml command, all installed program products are copied to the multiOpenTP1. Use the console created by this 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 use Add or Remove Programs from Control Panel to uninstall the original OpenTP1 in the multiOpenTP1 system, all multiOpenTP1s will also be deleted. In such a case, all folders under the multiOpenTP1 setup folders (bin, etc, examples, include, lib, spool, tmp, and tools) are also deleted. If you have created files under these folders, be sure to back them up before you start uninstallation of the original OpenTP1.
• 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)
• If you use this command to create a console for a multiOpenTP1 and then change the multiOpenTP1 definitions or the DCCONFPATH and DCUAPCONFPATH environment variable settings, you must execute this command again after the change to re-create the console for the multiOpenTP1.