Interstage Shunsaku Data Manager Operator's Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

A.6.2 Execution Parameter Explanation

Host

This parameter specifies the host name or IP address of the connection destination.

If this parameter is omitted, it defaults to "localhost".

Port

This parameter specifies the port number for the connection destination.

If this parameter is omitted, it defaults to "33101".

ShunsakuFile

This parameter specifies a File name or Domain name for the connection destination Shunsaku File.

Specifications for the Shunsaku File have the following priority order.

1. The specification made by the ShunConnection class constructor, the Connect method of ShunService class or the ShunConnect function.
2. The specification made by this parameter
3. The specification made by the DefaultFile parameter in the conductor environment file

WaitTimer

Specify the maximum time (in seconds) to wait for a response from Shunsaku. Specify a value between 0 and 3600 (seconds) inclusive. . If no response is received from Shunsaku within the specified time, a timeout will occur, an error will be sent to the application and the connection will be closed automatically.

If "0" is specified, the application will continue waiting for a response.

If this parameter is omitted, it defaults to 0.

SnapLevel

This parameter specifies the output level for the API snapshot.

SnapLevel	Content output
0	Does not output the API snapshot.
1	Outputs the API call sequence.
2	Outputs parameter information and data manipulation information when methods or functions are executed, in addition to level 1 information.

If this parameter is omitted, it defaults to 0.

If level 0 is specified execution parameters (LogFile, LogFileSize, LogFileBackup and PfmLog) do not need to be specified.

LogFile

This parameter specifies the absolute path to the log file where the API snapshot is output. It is used cyclically when it reaches the size specified by the LogFileSize parameter.

Be sure to specify this parameter if "1" or "2" has been specified for the SnapLevel parameter. If this parameter is omitted, API snaps will not be output.

A separate API snapshot is created for each application process.

The process ID is added to the file name as shown in the following examples.

Example

The absolute path specified for the LogFile parameter

C:\api\api.log

The log file that is actually created

C:\api\api_2435.log

Example

The absolute path specified for the LogFile parameter

/api/api.log

The log file that is actually created

/api/api_2435.log

• Specify a folder on the local disk for this parameter.
• If the folder name contains blank spaces or the hash character "#", enclose the entire folder name in double quotes.

• Directory names cannot include spaces or the hash character "#".

LogFileSize

This parameter specifies the file size at which the log file where the API snapshot is output switches over. Specify a value between 1 and 500 (megabytes) inclusive.

If this parameter is omitted, it defaults to 100

For example, if 1 is specified, a backup file will be created automatically when the file size exceeds 1 MB.

LogFileBackup

This parameter specifies the number of backups for the log files where API snaps are output. Specify a value between 0 and 2147483647 inclusive. If the number of backups exceeds the number specified by this parameter, the content of the oldest backup file will be lost.

For example, suppose "3" is specified for this parameter and three backup files called "api_2435.log.1", "api_2435.log.2" and "api_2435.log.3" are created. The next time a backup is required, the content of "api_2435.log.1" will be lost.

If this parameter is omitted, it defaults to 1.

PfmLog

This parameter specifies whether to output the request number that is output in the performance log (The 8-bytes number from the conductor) as the performance information in the API snapshot.

0: Do not output performance information to the API snapshot
1: Output performance information to the API snapshot

This parameter is valid if "1" or "2" has been specified for the SnapLevel parameter

If this parameter is omitted, it defaults to 0.

Refer to Appendix F Output Information of Performance Log for more information on the output of performance log.