set format

 set tam_max_tblnum=maximum-online-TAM-table-count
 set tam_max_filesize=maximum-online-TAM-table-capacity
 set tam_max_recsize=maximum-TAM-table-record-length
[set tam_jnl_err_flag=STOP|CONTINUE]
[set tam_pool_attri=fixed|free]
[set tam_tbl_lock_mode=LOCK|NOLOCK]
[set tam_cbl_level=COBOL-API-lock-level]
[set tam_max_trnnum=maximum-number-of-concurrent-transaction-
                    branches]
[set tam_max_trnfilnum=maximum-number-of-access-tables-in-a-
                       transaction]
[set watch_time=maximum-response-waiting-time]

command format

{{tamtable [-o loading-point] [-a access-format] [-i] [-j]
         TAM-table-name physical-file-name}}

The TAM service definition defines the execution environment to manage TAM files.

tam_max_tblnum=maximum-online-TAM-table-count~<unsigned integer> ((1-65535))

Specify the maximum number of TAM tables to be used online. Files in an amount up the specified value can be added during online operation, therefore consider the number of files to be added in specifying a value.

tam_max_filesize=maximum-online-TAM-table-capacity~<unsigned integer> ((136-1000000000)) (Unit: bytes)

Specify the maximum capacity of TAM tables to be used online. Consider the capacity of both files at online startup and files to be added online.

tam_max_recsize=maximum-TAM-table-record-length~<unsigned integer> ((1-1000000000)) (Unit: bytes)

Specify the maximum record length of TAM tables to be used online.

tam_jnl_err_flag=STOP|CONTINUE~<<STOP>>

Specify whether TAM service should be suspended if a journal reading error occurs during a restart of the TAM service.

STOP

TAM service is suspended.

CONTINUE

All TAM tables are shutdown, and TAM service is restarted.

tam_pool_attri=fixed|free~<<For HP-UX or Solaris: fixed; for AIX, Linux, or Windows: free>>

Specify whether a memory pool for exclusive TAM service use should be fixed in the shared memory. This memory pool is used, for example, to manage the tables for loading or accessing TAM tables. Consider the amount of mounted memory, the capacity of the shared memory pool as a ratio of overall memory usage, and other factors in specifying this value.

fixed

A memory pool for TAM service is fixed. Processing will not slow down due to paging of the shared memory. However, if the amount of mounted memory is small, paging of text and data segments in other than shared memory could occur.

fixed can be specified only when the OS is HP-UX or Solaris. Note that even when the OS is Solaris, fixed cannot be specified in some cases, depending on the environment being used. For details, see the Release Notes.

free

A memory pool for TAM service use is not fixed. If the amount of mounted memory is too small, paging of shared memory could occur, causing processing speed to slow down.

tam_tbl_lock_mode=LOCK|NOLOCK~<<LOCK>>

Specify the table lock mode for TAM tables whose access mode is "reference" or "update but not add/delete".

LOCK

The table when accessed is locked.

NOLOCK

The table when accessed is not locked.

This mode enhances the processing performance of the table when accessed. Although a lock is specified by UAP, the table will not be locked.

tam_cbl_level=COBOL-API-lock-level~<unsigned integer> ((0-2)) <<0>>

Specify the lock level if the lock of COBOL API conflicts.

This specification is valid only for COBOL API.

0

Unlock is waited unconditionally.

Specifying data name I of COBOL API is invalid.

1

An error return occurs without waiting for unlock.

Specifying data name I of COBOL API is invalid.

2

Specifying this value follows the unlock of data name I of COBOL API.

tam_max_trnnum=maximum-number-of-concurrent-transaction-branches~<unsigned integer> ((1-8192) <<20>>

Specify the number of concurrent transaction branches that access to the TAM table. If this specified value is large, the memory on the TAM server is shared greatly. If the shared memory cannot be secured, the TAM server may not be started. If the specified value is small, a memory shortage may occur in the API function.

tam_max_trnfilnum=maximum-number-of-access-tables-in-a-transaction~<unsigned integer> ((1-1024)) <<5>>

Specify the maximum number of TAM tables to be accessed in one transaction branch. If this specified value is large, the memory on the TAM server is shared greatly. If the shared memory cannot be secured, the TAM server may not be started. If the specified value is small, a memory shortage may occur in the API function.

watch_time=maximum-response-waiting-time~<unsigned integer> ((0-65535)) (Unit: seconds)

Specify the maximum waiting time between sending a service request and receipt of a response when communicating between processes by RPC.

OpenTP1 may suspend termination processing for the length of time specified in this operand. Therefore, if you specify a large value, the termination processing of OpenTP1 may take some time.

If no response is received within the specified time, RPC returns a transmission timeout error.

Specify 0 if the system is to wait for a response. When you specify 0, OpenTP1 may not terminate.

Use the default of the watch_time operand of the system common definition for this operand.

We recommend that you do not change the operand unless special tuning is necessary.

If a value that is much greater or smaller than the default of the watch_time operand of the system common definition is specified, a failure may occur causing OpenTP1 to go down.

When this operand is omitted, the value is as follows:

• When the watch_time operand of the system common definition is also omitted, 0 is assumed.
• When the watch_time operand of the system common definition is specified, the specified value is assumed.

When this operand is specified in both the system common definition and TAM service definition, the priorities of specified values are (1.>2.):

1. TAM service definition
2. System common definition

Described on the following page.