OpenTP1 Version 7 Operation

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

jnlopnfg (Open journal files)

Format

jnlopnfg -j sys|cpd|jar [-s server-name]
         [-r resource-group-name] -g file-group-name
         [-e element-file-name] [-a] [-b]

Function

The jnlopnfg command opens a closed physical file that is a constituent of a specified file group so that the files can be used in the online mode.

The jnlopnfg can be entered only when OpenTP1 and the journal service are both operating.

Options

-j sys|cpd|jar

Specifies the type of journal files to be opened:

sys: System journal files

cpd: Checkpoint dump files

jar: Archive journal file

-s server-name~<identifier, 1-8 characters>

Specifies the name of a server that is to be subject to this processing when checkpoint dump files are to be opened.

When this option is omitted, the first (among all servers) checkpoint dump files with the matching file group name are opened.

If sys is specified for -j option, specification of the -s option is ignored.

-r resource-group-name~<1-8 character identifier>

Specifies the name of the target resource group. If jar is specified in the -j option, the name of the resource group in the file to be opened must be specified. It must be the definition file name specified in the archive journal service definition specified in the definition command jnldfsv -a of the global archive journal service definition.

When this option is omitted, the name of an online archive journal file defined at the beginning of the definition command jnldfsv -a of the archive journal service definition is assumed.

If other than jar is specified in the -j option, the specification of the -r option is discarded.

-g file-group-name~<identifier, 1-8 characters>

Specifies the file group name of the journal files to be opened.

-e element-file-name

Specifies the name of an element file in the journal file group to be opened.

-a

Specifies that physical files in system A are to be opened.

-b

Specifies that physical files in system B are to be opened.

If this option is specified when dual files are not being used, a command error occurs.

When the -a and -b options are both omitted, or when cpd is specified in the -j option, the command performs processing as follows:

If all physical files subject to open processing are already open, a warning message (KFCA01283-W or KFCA02167-W) is issued, although no command error occurs (command termination code: 0).

Output messages

Message ID Description Output destination
KFCA01141-E The command cannot be executed because OpenTP1 is running in journal fileless mode. Standard error output
KFCA01215-I File group has been opened successfully. Message log file
KFCA01280-E jnlopnfg command processing failed. Standard error output
KFCA01281-E jnlopnfg command input format is invalid. Standard error output
KFCA01283-W Insignificant error occurred during jnlopnfg command execution. Standard error output
KFCA01285-E Swap processing is underway. Standard error output
KFCA01294-I Help message Standard output,
standard error output
KFCA02128-E Specified server name is invalid. Standard error output
KFCA02129-E Specified file group name is invalid. Standard error output
KFCA02130-E -s option specification is invalid. Standard error output
KFCA02131-E -g option specification is invalid. Standard error output
KFCA02132-E jnlopnfg command processing was cancelled due to an error. Standard error output
KFCA02167-W Specified file group is already open. Standard error output
KFCA02169-E File open processing failed. Standard error output

Notes

The jnlopnfg command may result in an error if it is entered during swap processing or during the processing of another operation command.