jnlchgfg -j sys|jar [-r resource-group-name] -g file-group-name [-d service-definition-name] [-s]

The jnlchgfg command places forcibly a specified file group on unloaded status. The status of the current file group cannot be changed.

The status of the archive journal file can forcibly be changed to archived status from archiving wait status.

-j sys|jar

Specifies the file group whose status is to be changed.

sys: System journal file

jar: Archive journal file

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

Specifies the name of the target resource group. If sys is specified in the -j option, the name must be the same file name as defined in the system journal service definition. If jar is specified in the -j option, the name must be the definition file name specified in the archive journal service definition whose status is to be changed. When this option is omitted, the resource group name specified in the journal service definition of $DCCONFPATH/jnl is assumed if sys is specified in the -j option. If jar is specified in the -j option, the system assumes the definition file name specified in the archive journal service definition that has been defined at the beginning of the definition command jnldfsv -a in the global archive journal service definition of $DCCONFPATH/jar.

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

Specifies the file group name of the system journal files whose status is to be changed.

-d service-definition-name~<path name> or <file name>

Specifies the name of the system journal service definition file that defines the file group whose status is to be changed, in one of the following formats:

• Complete path name beginning with / (root)
• Definition file name only

If only a definition file name is specified, the directory containing the definition file must be set in $DCCONFPATH.

If this option is omitted, the specification of the -r option predominates.

-s

Changes the status of the archive journal file from archiving wait status to archived status.

When jnl_arc_check_level is set to 2 in the system journal service definition, the file group cannot be reused unless unloading and archiving the archive journal file. If this option is specified when archiving cannot be performed due to an error on the archive journal service, the archive journal file can forcibly be placed in archived status. Therefore, the system operation can be continued.

However, if the file group forcibly placed in archived status becomes a swappable file group, the file group cannot be archived even when the archive journal service returns normally.

Message ID	Description	Output destination
KFCA01141-E	The command cannot be executed because OpenTP1 is running in journal fileless mode.	Standard error output

• Do not execute the jnlchgfg command during startup of the journal service. Startup spans the time from KFCA01100-I to KFCA01102-I in the case of a normal start, or from KFCA01101-I to KFCA01102-I in the case of a restart. If the jnlchgfg command is executed while this processing is underway, the status of the system journal file may not be recognized by OpenTP1. If this occurs, use the jnlclsfg command to close the corresponding file group after the journal service has completed startup, or restart processing, and then open the file group again using the jnlopnfg command. The status of the system journal file will then be recognized by OpenTP1.
• The jnlchgfg command references the definition file. For this reason, statuses cannot be changed properly if the definition file in effect at execution of the jnlchgfg command does not match the definition file that was in effect during the online session when the journal was collected.
• Specify the -d or -r option if the definition file in effect at execution of the jnlchgfg command does not match the definition file in effect at journal acquisition. Specify the -d option if the backup destination directory is not the directory specified by $DCCONFPATH, and specify the -r option if the file has been renamed. However, a backup of the system journal service definition or archive journal service definition that was in effect when the journal was acquired must be available.