OpenTP1 Version 7 System Definition

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

jnladdpf (Define physical files making up system journal file group)

Format

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

Function

The jnladdpf command defines the physical files that make up a system journal file group. Only one command can be specified for each file group.

For a file group, at least one jnladdpf definition command must be specified. The maximum number of jnladdpf definition commands that can be specified is eight.

Each physical file name must be unique within an OpenTP1 system.

Options

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

Specify the file group name of the system journal file. This name must be pre-defined with the jnladdfg command. Note that if the value of this option is changed, the system journal file must be initialized.

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

Specify the name of one of the element files that constitute the file group.

The element file name you specify in this option must be unique in the system 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 full path name as the name of the physical file making up the file group. In this case, no environment variables can be used.

This physical file uses the OpenTP1 file created for the journal function. If Y was specified in the jnl_dual operand with the set format, specify the physical file name of the system A file. If duplication is specified but only -a is specified, the entire command is ignored.

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

If Y was specified in the jnl_dual operand with the set format, specify the full path name as the name of the physical file of the system B file. In this case, no environment variables can be used.

This physical file uses the OpenTP1 file created for the journal function. If duplication is not specified, and -a and -b are specified as physical file names, -b will be ineffective. Also, if only -b is specified, the entire command will be ignored, whether or not duplication is specified.

Note

If Y has been specified for the jnl_fileless_option operand in the system common definition, you can omit the jnladdpf definition command.