OpenTP1 Version 7 User's Guide

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

System environment definition

For details about the operands that are not explained here, see the list in 5.1(1) System environment definition.

Formats

set format

 
[set mode_conf=AUTO]
[set shmpool_attribute=free]
[set user_command=user-environment-setting-command]
[set redirect_file=Y|N]
[set redirect_file_name=output-file-name]
[set redirect_file_size=maximum-size-of-output-file]
[set console_output=Y|N]

putenv format

 
[putenv DCADMDEBUG 0|1]
 

dcputenv format

 
[dcputenv DCCONFPATH definition-file-storage-folder]
[dcputenv DCUAPCONFPATH user-service-definition-file-storage-folder]
 

Description

Operands in the set format

mode_conf=AUTO

~<<AUTO>>

Only AUTO can be specified as the system startup method. For differences in the startup mode depending on the mode of the previous termination, see 6.2.4 Determining the startup mode.

There are no other differences.

shmpool_attribute=free

~<<free>>

fixed is not supported because a shared memory pool for system services cannot be fixed in memory. There are no other differences.

user_command=user-environment-setting-command

~<path name>

Specifies the complete path name of the user environment setting command that is to be executed before OpenTP1 is started.

Do not specify a command or batch file that will cause a default input wait status.

There are no other differences.

redirect_file=Y|N

~<<N>>

This operand is specific to OpenTP1 for Windows. It specifies whether the contents of standard output and standard error issued from processes under OpenTP1 are to be output to a file (whether the standard output redirect facility is to be used).

Y
Output the contents of standard output and standard error to a file. The OpenTP1 console window is not displayed in such a case.

N
Do not output the contents of standard output and standard error to a file.

The standard output redirect facility cannot be used when you specify the prc_port or rpc_port_base operand in the system common definition. For details, see 2.2.4 Relationship among system definitions.

If you specify Y in this operand when you have specified the prc_port or rpc_port_base operand, OpenTP1 issues the KFCA26520-W message, ignores this operand, and resumes startup of OpenTP1. When the KFCA26520-W message is issued, either delete the prc_port or rpc_port_base operand or delete the redirect_file operand.

redirect_file_name=output-file-name

~<path name>

This operand is specific to OpenTP1 for Windows. It specifies the absolute path name of the file to which the contents of standard output and standard error are to be output.

If file generations are managed, a generation number (1 or 2) is added at the end of the file name. If the file name is omitted, the two files %DCDIR%\spool\prclog1 and %DCDIR%\spool\prclog2 are created.

redirect_file_size=maximum-size-of-output-file

~<unsigned integer>((0 to 65535))<<1024>>(kilobytes)

This operand is specific to OpenTP1 for Windows. It specifies (in kilobytes) the maximum size of the file to which the contents of standard output and standard error are to be output.

Two generations of output files are managed based on the specified file size. The size of an output file might exceed the specified value depending on the messages that are output.

If 0 is specified, the output file will be an incremental file that increases monotonically because the file is not managed as having generations.

If you use the standard output redirect facility and output a large number of messages concurrently, the two output files might be updated at the same time and the most recent file generation might be assigned as the current file the next time OpenTP1 starts. Therefore, as a guideline, specify the size of one generation of file that takes at least one second to fill up.

console_output=Y|N

~<<N>>

This operand is specific to OpenTP1 for Windows. It specifies whether the contents of standard output and standard error are to be output to the console (whether the OpenTP1 console output facility is to be used).

Y
Output the contents of standard output and standard error to the console.

N
Do not output the contents of standard output and standard error to the console.

Even when Y is specified in this operand, the contents of standard output and standard error might not be output to the console, depending on the values set in other operands. For details, see 2.2.4 Relationship among system definitions.

Operands in the putenv format

DCADMDEBUG 0|1

~<<1>>

The default value is 1. There are no other differences.

Operands in the dcputenv format

DCCONFPATH definition-file-storage-folder

~<path name>

The value of the DCCONFPATH environment variable is case sensitive. Make sure that the specified character strings are identical throughout the computer.

Enclose each environment variable in percent signs (%), not dollar signs ($). There are no other differences.

DCUAPCONFPATH user-service-definition-file-storage-folder

~<path name>

Enclose each environment variable in percent signs (%), not dollar signs ($). There are no other differences.