jnlatunl (Control the automatic unloading facility)

-j sys

Indicates that the automatic unloading facility is executed for system journal files. This option is mandatory.

-i

Specify this option to display the operating status of the automatic unloading facility.

-b

Specify this option to restart the automatic unloading facility while OpenTP1 is running. Immediately after the restart of the automatic unloading facility, the command uses the directory that was used last in the previous operation as the directory for storing unload journal files.

-t

Specify this option to cancel the automatic unloading facility. The command forcibly ends the unload being executed.

-w

When you have specified the -t option to cancel the automatic unloading facility, specify this option to delay the end of the command until unloading of the generation currently being unloaded is completed. The -w option is valid only when the -t option is specified. If you specify the -t option and omit the -w option, the automatic unloading facility is canceled when the jnlatunl command is executed and the unloading being executed is forcibly terminated.

When you specify the -w option, the maximum time for waiting for a response for the completion of unloading is about 9 hours (32,768 seconds). If the unloading is not completed within this time, the automatic unloading facility is canceled at that point and the unloading being executed is forcibly terminated.

When the -i option is specified

Status    Now unloading the file group   unload-destination-directory
aa....aa    bb....bb                         cc....cc
 
current generation information
file-group   generation-no   run-ID   unload-file-name
dd....dd       ee....ee          ff....ff     gg....gg

aa...aa: Operating status of the automatic unloading facility; ACTIVE: Active; STOP: Inactive; STOPPING: The command is stopped, or OpenTP1 is waiting for a response indicating the end of automatic unloading.; -: The automatic unloading facility is not available.

bb....bb: File group name of the system journal file being unloaded. ******** appears if no system journal file is being unloaded.

cc....cc: Name of the unload journal file storage directory being used

dd....dd: File group name of the system journal file of the current generation

ee....ee: Generation number of the system journal file of the current generation

ff....ff: Run ID of the system journal file of the current generation

gg....gg: Name of the file that is created when the current generation is automatically unloaded

Message ID	Description	Output destination
KFCA01141-E	The command cannot be executed because OpenTP1 is running in journal fileless mode.	Standard error output
KFCA01160-I	The journal utility service is started.	Message log file
KFCA01161-I	The journal utility service is terminated.	Message log file
KFCA01162-E	The journal utility service cannot be started.	Standard error output
KFCA01163-W	Processing continues even though an error occurred during termination processing of the journal utility service.	Message log file
KFCA01168-W	Unloading is canceled.	Message log file
KFCA01169-W	A definition clause is incorrect. OpenTP1 starts in a mode that does not use the automatic unloading facility for journal files.	Message log file
KFCA01170-I	Automatic unloading of a journal file started.	Standard error output
KFCA01171-I	A journal file will be automatically unloaded.	Message log file
KFCA01172-I	Automatic unloading of a journal file is complete.	Message log file
KFCA01173-W	The automatic unloading facility for journal files is stopped.	Message log file
KFCA01174-W	Automatic unload processing is canceled.	Message log file
KFCA01175-I	OpenTP1 is waiting for the end of automatic unload processing.	Message log file
KFCA01176-I	The specified directory is set as the automatic unloading destination directory.	Message log file
KFCA01177-E	A file error occurred during automatic unloading.	Message log file
KFCA01178-E	An error occurred during automatic unloading.	Message log file
KFCA01179-W	The automatic unloading destination directory cannot be changed.	Message log file
KFCA01299-I	Help message	Standard output

If the automatic unloading facility is not being used in your system execution environment, you cannot specify the -b option and the -t option.
If the jnlatunl command is executed with the -b option to restart the automatic unloading facility, the facility may not restart properly despite the jnlatunl command terminating normally, due to a problem such as an error in the automatic unloading process. Specify the -i option to check whether the automatic unloading facility started properly.
If you execute the jnlatunl command with the -t or -w option specified, and OpenTP1 is forcibly terminated or terminates abnormally while still waiting for the automatic unloading facility to shut down, the jnlatunl command does not terminate normally, and instead aborts with the error code olkcrt2. However, this has no effect on online operation, and you do not need to restart OpenTP1.