OpenTP1 Version 7 System Definition

[Contents][Index][Back][Next]

jnladdpf (Define archive journal physical file)

Format

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

Function

The jnladdpf command defines a physical file that makes up the file group of an archive journal file.

Only one jnladdpf command can be used for each file group. Each physical name must be unique within an OpenTP1 system.

Options

-g archive-journal-file-group-name~<1-8 character identifier>

Specify the name of the file group of an archive journal file. The file group name to be specified here must be predefined by the jnladdfg command.

-e element-file-name~<1-8 character identifier>

Specify the element file that makes up this file group. The element file name you specify in this option must be unique in the archive journal service definition.

If you parallelize access (the value of the jnl_max_file_dispersion operand is 2 or larger), always specify this option. If you do not parallelize access, you do not need to specify this option.

If you do not specify the -e option when parallelizing access, a definition parse error occurs. Make sure that the number of element files specified for one file group is in the following range:

jnl_max_file_dispersion [Figure] number-of-element-files [Figure] jnl_min_file_dispersion

If the number of element files specified by using jnladdpf definition commands is more than the value of the jnl_max_file_dispersion operand, only as many element files as the operand value are used online. If the number of element files specified by using jnladdpf definition commands is less than the value of the jnl_min_file_dispersion operand, the file group is unavailable.

-a physical-file-name~<path name>

Specify the physical file making up a file group in the form of a full path name. No environment variable can be used. The physical file must be an OpenTP1 file that has been created as a journal-related file.

If duplication of a file is specified by the jnl_dual operand (set format), specify the physical file name of a system A file.

-b physical-file-name~<path name>

Specify the physical file name of a system B file if duplication of the file is specified by the jnl_dual operand (set format). No environment variable can be used. The physical file must be an OpenTP1 file that has been created as a journal-related file.

If, with duplication not specified, physical file names -a and -b are specified, the -a name becomes valid. If only -b is specified independently of duplication, the entire command is discarded.