set format

 
  set module="executable-program-name"
[set nice=change-of-process-priority]
[set message_store_buflen=message-storage-buffer-pool-size]
[set message_cell_size=scheduled-message-storage-cell-size]
[set prc_abort_signal=signal-number-for-abort]
[set process_privilege_restrict=Y|N]
[set process_privilege_name="privilege-name"[,"privilege-name"...]]
 

putenv format

 
{{[putenv environment-variable-name environment-variable-value]}}
 

dcputenv format

 
{{[dcputenv environment-variable-name environment-variable-value]}}
 

module="executable-program-name"

~<identifier consisting of 1 to 14 characters>

Do not specify the .exe extension in executable-program-name. For example, if the executable program name is spp.exe, specify set module ="spp". There are no other differences.

nice=change-of-process-priority

~<unsigned integer>((0 to 39))

The meaning of this value varies. In OpenTP1 for Windows, this operand value is interpreted as follows:

nice operand value	Priority to be applied
0 to 9	THREAD_PRIORITY_NORMAL
10 to 19	THREAD_PRIORITY_BELLOW_NORMAL
20 to 29	THREAD_PRIORITY_LOWEST
30 to 39	THREAD_PRIORITY_IDLE

message_store_buflen=message-storage-buffer-pool-size

~<unsigned integer>((1024 to 31457280))(bytes)

If you change this operand's value while OpenTP1 is online, the KFCA00850-E message might be issued.

The reason for this is that a shortage has occurred in the internal resources that had been allocated based on the operand value in effect before the change was made. You can prevent this from occurring by terminating OpenTP1 and then restarting it.

Note that when you change this operand's value, the required size of the static shared memory changes. For the formula for determining the memory size, see the manual OpenTP1 Version 7 System Definition.

message_cell_size=scheduled-message-storage-cell-size

~<unsigned integer>((512 to 31457280))(bytes)

If you change this operand's value while OpenTP1 is online, the KFCA00850-E message might be issued.

The reason for this is that a shortage has occurred in the internal resources that had been allocated based on the operand value in effect before the change was made. You can prevent this from occurring by terminating OpenTP1 and then restarting it.

Note that when you change this operand's value, the required size of the static shared memory changes. For the formula for determining the memory size, see the manual OpenTP1 Version 7 System Definition.

prc_abort_signal=signal-number-for-abort

~<unsigned integer>((3, 6, 15))

Specify 3, 6, or 15 as the signal number. There are no other differences.

process_privilege_restrict=Y|N

~<<N>>

Specifies whether the user server's Windows privileges are to be limited.

Y

Limit the user server's privileges (other than SeChangeNotifyPrivilege).

When you specify Y, you can grant privileges to the user server by specifying the privileges to be granted in the process_privilege_name operand.

N

The user server is to have all the privileges set for the service logon account.

process_privilege_name=privilege-name"[,"privilege-name"...]

~<character string>

Specifies the names of Windows privileges (such as SeSecurityPrivilege) that are to be granted to the user server.

This operand is effective only when Y is specified in the process_privilege_restrict operand.

A privilege specified in this operand will not be granted to the user server if that privilege is not set for the service logon account. When you grant a privilege, evaluate whether the privilege is really needed.

environment-variable-name environment-variable-value

~<character string>

The differences from OpenTP1 for UNIX are as follows (there are no other differences):

• If you specify the LANG environment variable in the putenv format in the user service definition or user service default definition, specify the same value as in the system common definition. If this environment variable is not defined in the system common definition, do not specify any value other than C.
• If you specify the PATH environment variable in the putenv format in the user service definition or user service default definition, include in the specification the location of OpenTP1 commands, UAP load modules, and DLLs used by the UAP.

environment-variable-name environment-variable-value

~<character string>

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

If you add a new user service definition while OpenTP1 is online, the KFCA00850-E message might be issued.

The reason for this is that a shortage has occurred in the internal resources that had been allocated based on the definition in effect before the new definition was added. You can prevent this from occurring by terminating OpenTP1 and then restarting it.

Note that if you add a user service definition, the required size of the static shared memory changes. For the formula for determining the memory size, see the manual OpenTP1 Version 7 System Definition.