set format

[set jnl_arc_terminate_timeout=maximum-waiting-time]
[set max_socket_descriptors=maximum-number-of-file-descriptors-
     for-sockets]
[set jnl_arc_ipc_buff_size=TCP/IP-send-and-receive-buffer-size]
[set jnl_watch_time=time-the-global-archive-journal-service-waits-for-a-communication-response]

Command format

jnldfsv -a global-archive-journal-service-resource-group-name
        [[,global-archive-journal-service-resource-group-name]...]

The global archive journal service definition defines the execution environment for using the global archive journal service. TP1/Multi is required to use this facility.

jnl_arc_terminate_timeout=maximum-waiting-time~<unsigned integer> ((0-3600)) <<0>> (Unit: seconds)

Specify the maximum waiting time in seconds until all connected nodes to be archived are released after terminating the archive node. If the connection is released in the specified time, the archive node terminates. If the node to be archived that passed the specified time is connected, the archive node does not terminate.

If a 0 is specified, the archive node end processing is continues until all nodes to be archived are disconnected.

max_socket_descriptors=maximum-number-of-file-descriptors-for-sockets~<unsigned integer> ((32-2032))

Specify the maximum number of file descriptors to be used for sockets by the processes under control of OpenTP1^#.

The processes under control of OpenTP1^# exchange the process information with the system servers or user servers through the TCP/IP communication using sockets. Therefore, you must change the maximum number of file descriptors for sockets depending on the number of UAP processes that run concurrently and the number of other nodes to communicate with.

#: OpenTP1 processes other than the MCF services (MCF manager service, MCF communication service, and application startup service). For the MCF services, see the sections on the system service information definition and the system service common information definition.

Use the following formula for calculating the maximum number of file descriptors for sockets:

(Number of nodes that request a service of the global archive journal service^#1 + number of system service processes^#2)/0.8

: Rounded up to the nearest whole integer.

#1: The number of nodes that request a service of the global archive journal service is the sum of the following values:

• Number of node names specified in the all_node operand for the local OpenTP1
• Number of other nodes that specify the local node name in the all_node operand for OpenTP1

#2: The number of system service processes in the local OpenTP1.

If the value specified for this operand is too small, the connection cannot be set with other processes under control of OpenTP1. The process terminates abnormally after outputting the KFCA00307-E error message.

The order of priority of the specified values is 1 > 2.

1. Global archive journal service definition
2. System common definition

If this operand is omitted, the system assumes the value in the system common definition.

jnl_arc_ipc_buff_size=TCP/IP-send-and-receive-buffer-size~<unsigned integer>((8192-1048576)) <<61440>> (units: bytes)

Specify the size of the TCP/IP send-and-receive buffer used by the archive journal reception process that receives the journal data transferred from the archive source node.

In a high-speed communication environment, you can improve performance by increasing the value of this operand. When you specify the operand, make sure that the value does not exceed the maximum TCP/IP buffer size that can be specified in the OS. Also, note that the value of the operand must be equal to the value of the jnl_arc_ipc_buff_size operand in the journal service definition on the archive source node.

jnl_watch_time=time-the-global-archive-journal-service-waits-for-a-communication-response ~<unsigned integer> ((0-65535)) <<180>> (units: seconds)

Specify the maximum time that the global archive journal service waits from the time it sends a service request until it receives a service response for inter-process communication that uses RPCs. If no response to an RPC is received within the specified time, the RPC returns a timeout error.

If 0 is specified, the global archive journal service continues to wait until a response is received, in which case OpenTP1 might not be able to terminate.

Do not change the setting of this operand unless special tuning is required.

The scope of the jnl_watch_time operand is the following:

• jnlopnfg command
• jnlclsfg command
• jnlchgfg command
• jnlunlfg command
• jnlswpfg command^#
• jnlardis command
• Time to wait for a response to a swap request when the journal file failed or became full

#:

For the jnlswpfg command, the time specified by the jnl_watch_time operand is doubled.

The command format is described on the next page.