jnlatunl (Control the automatic unloading facility)

Format

jnlatunl -j sys [{-i|-b|-t[-w]}]

Function

The jnlatunl command controls the automatic unloading facility. You can use the command to do the following:

Options

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

Output format

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

Output messages

Message IDDescriptionOutput destination
KFCA01141-EThe command cannot be executed because OpenTP1 is running in journal fileless mode.Standard error output
KFCA01160-IThe journal utility service is started.Message log file
KFCA01161-IThe journal utility service is terminated.Message log file
KFCA01162-EThe journal utility service cannot be started.Standard error output
KFCA01163-WProcessing continues even though an error occurred during termination processing of the journal utility service.Message log file
KFCA01168-WUnloading is canceled.Message log file
KFCA01169-WA definition clause is incorrect. OpenTP1 starts in a mode that does not use the automatic unloading facility for journal files.Message log file
KFCA01170-IAutomatic unloading of a journal file started.Standard error output
KFCA01171-IA journal file will be automatically unloaded.Message log file
KFCA01172-IAutomatic unloading of a journal file is complete.Message log file
KFCA01173-WThe automatic unloading facility for journal files is stopped.Message log file
KFCA01174-WAutomatic unload processing is canceled.Message log file
KFCA01175-IOpenTP1 is waiting for the end of automatic unload processing.Message log file
KFCA01176-IThe specified directory is set as the automatic unloading destination directory.Message log file
KFCA01177-EA file error occurred during automatic unloading.Message log file
KFCA01178-EAn error occurred during automatic unloading.Message log file
KFCA01179-WThe automatic unloading destination directory cannot be changed.Message log file
KFCA01299-IHelp messageStandard output

Note