jnlclsfg (Close journal files)

Format

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

Function

The jnlclsfg command closes the open physical files comprising a specified file group, so the files will not be used in the online mode. Physical files that are constituents of the following file groups cannot be closed:

Additionally, the jnlclsfg command 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 closed:

sys: System journal files
cpd: Checkpoint dump files
jar: Archive journal file

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

Specifies the name of the server subject to this processing when checkpoint dump files are to be closed. Specifying the server name limits the search range of file group names.

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

If the -j option specifies sys or jar, the specification of the -s option is discarded.

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

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

If this option is omitted, the name of an online-mode archive journal file is assumed which is defined at the beginning of the definition command jnldfsv -a of the archive journal service definition. 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 closed.

-e element-file-name

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

-a

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

-b

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

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

When neither the -a nor -b option is specified, or when cpd is specified in the -j option, the command performs as follows:

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

Output messages

Message IDDescriptionOutput destination
KFCA01141-EThe command cannot be executed because OpenTP1 is running in journal fileless mode.Standard error output
KFCA01216-IFile group has been closed successfully.Message log file
KFCA01280-Ejnlclsfg command processing failed.Standard error output
KFCA01281-Ejnlclsfg command input format is invalid.Standard error output
KFCA01283-WInsignificant error occurred during jnlclsfg command execution.Standard error output
KFCA01285-ESwap processing is underway.Standard error output
KFCA01295-IHelp messageStandard error output
KFCA02128-ESpecified server name is invalid.Standard error output
KFCA02129-ESpecified 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-Ejnlclsfg command processing was cancelled due to an error.Standard error output
KFCA02168-WSpecified file group is already closed.Standard error output
KFCA02170-EFile close processing failed.Standard error output
KFCA02184-EClose processing cannot be performed, because there are not enough file groups.Standard error output

Notes

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