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

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:

• System journal file or archive journal file on current or nonwritable status
• Checkpoint dump file involved in a write operation or on nonwritable status

Additionally, the jnlclsfg command can be entered only when OpenTP1 and the journal service are both operating.

-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 dual files are not being used, physical files in system A are closed in the same manner as when the -a option is specified.
• If dual files are being used, physical files in both systems A and B are closed in the same manner as when the -a and -b options are both specified.
• When one-system operation is unavailable in dual system configuration, a command error occurs if adding either the -a or -b option to -j cpd.

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).

Message ID	Description	Output destination
KFCA01141-E	The command cannot be executed because OpenTP1 is running in journal fileless mode.	Standard error output
KFCA01216-I	File group has been closed successfully.	Message log file
KFCA01280-E	jnlclsfg command processing failed.	Standard error output
KFCA01281-E	jnlclsfg command input format is invalid.	Standard error output
KFCA01283-W	Insignificant error occurred during jnlclsfg command execution.	Standard error output
KFCA01285-E	Swap processing is underway.	Standard error output
KFCA01295-I	Help message	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	jnlclsfg command processing was cancelled due to an error.	Standard error output
KFCA02168-W	Specified file group is already closed.	Standard error output
KFCA02170-E	File close processing failed.	Standard error output
KFCA02184-E	Close processing cannot be performed, because there are not enough file groups.	Standard error output

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