set format

[set jnl_dual=Y|N]
[set jnl_singleoperation=Y|N]
[set jnl_rerun_swap=Y|N]
[set jnl_max_file_dispersion=maximum-number-of-distributions-to-
                             enable-parallel-access]
[set jnl_min_file_dispersion=minimum-number-of-distributions-to-
                             enable-parallel-access]
[set jnl_unload_check=Y|N]
[set jnl_arc_max_datasize=maximum-size-of-data-transferred-during-archiving]

Command format

{{{{jnladdfg -g archive-journal-file-group-name [ONL]}}
  {{jnladdpf -g archive-journal-file-group-name
             [-e element-file-name]
              -a physical-file-name
             [-b physical-file-name]}}}}

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

jnl_dual=Y|N~<<N>>

Specify whether to duplicate an archive journal.

Y

The archive journal file is duplicated.

N

The archive journal file is not duplicated.

jnl_singleoperation=Y|N~<<N>>

Specify whether to use the file group with one system closed when Y is specified in the jnl_dual operand.

Y

The file group is used.

N

The file group is not used.

jnl_rerun_swap=Y|N~<<N>>

Specify whether to swap the archive journal file when a node under the global archive journal service reruns.

Y

The archive journal file is swapped.

N

The archive journal file is not swapped.

jnl_max_file_dispersion=maximum-number-of-distributions-to-enable-parallel-access~<unsigned integer> ((1-8)) <<1>>

Specify the maximum number of distributions to enable parallel access to the archive journal.

The value you specify in this operand is the maximum number of element files used for one file group. If you specify 1 or if you do not specify this operand, the specification of the jnl_min_file_dispersion operand has no effect.

jnl_min_file_dispersion=minimum-number-of-distributions-to-enable-parallel-access~<unsigned integer> ((1-8)) <<1>>

Specify the minimum number of distributions to enable parallel access to the archive journal.

Specify the minimum number of element files required for the file group to continue to operate if some of the element files that constitute the file group become unavailable due to an error or for another reason. The file group no longer operates when the number of available element files is less than the value specified in this operand.

Make sure that the value specified in this operand satisfies the following condition:

Maximum number of distributions minimum number of distributions 1

jnl_unload_check=Y|N~<<Y>>

Specify whether to check the unload wait status when determining the file group of the swap destination.

Y

The unload wait status is checked.

N

The unload wait status is not checked.

When Y is specified, if a normal forced start is performed on OpenTP1 following a forced termination or abnormal termination of OpenTP1, the journal file that was being used as the current file during the previous online session is closed. The journal file cannot be used until the status of the file group is changed with the jnlunlfg or jnlchgfg command.

When N is specified, the archive journals that are not unloaded will be lost. Therefore, N is usually specified when journals are not required such as tests (editing the operation statistics). Note that since journals are lost, some commands that specify the unload journal file may not be used.

For details, see the manual OpenTP1 Operation.

jnl_arc_max_datasize=maximum-size-of-data-transferred-during-archiving~<unsigned integer> ((1020-8188))<<1020>> (units: KB)

Specify the maximum size of journal data transferred during archiving from the archive source node. Make sure that the value you specify in this operand is equal to the largest transfer data size specified for the archive source nodes connected to the relevant resource group.

If you specify a value greater than 1020 in this operand, make sure that the value of the rpc_max_message_size operand in the system common definition is equal to or greater than the value obtained from the following formula:

rpc_max_message_size  (jnl_arc_max_datasize x 1024 + 4096) / 1048576

If the value of the rpc_max_message_size operand is less than the value obtained from the above formula, OpenTP1 outputs the KFCA01113-E message, with reason code 425 indicated, during startup of OpenTP1, and stops the startup processing.

The command format is described on the next page.