Work with Journal (WRKJRN)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No

The Work with Journals (WRKJRN) command shows you a menu from which options for journal operations can be selected. From the primary menu, options can be selected to:

Display the status of the journal
Perform forward or back-out object recovery
Recover damaged journals and journal receivers
Associate journal receivers with a journal.

All of these options are supported for local journals. For remote journals, only the associate journal receivers option is supported.

See the Journal management topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for details on the specific options.

If forward or back-out recovery needs to be performed for a large number of objects, you should consider using the Apply Journaled Changes (APYJRNCHG) or the Remove Journaled Changes (RMVJRNCHG) command. These commands allow you to specify groups of objects such as all objects in a library, all objects in multiple libraries, all objects journaled to the journal, or all objects in a directory subtree.

Top

Parameters

Keyword	Description	Choices	Notes
JRN	Journal	Single values: *PROMPT Other values: Qualified object name	Optional, Positional 1
	Qualifier 1: Journal	Generic name, name, *ALL
	Qualifier 2: Library	Name, ALL, CURLIB, *LIBL

Top

Journal (JRN)

Specifies the journals to be shown on the Work with Journals display.

Single values

*PROMPT: The Specify Journal Name display will be shown to allow for journal selection prior to displaying the Work with Journals display.

Qualifier 1: Journal

*ALL: All journals in the specified library will be shown.
generic-name: Specify the generic name of the journal to be shown. A generic name is a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, all journals that have names with the same prefix as the generic name are shown.
name: Specify the name of the journal to be shown.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched. All journals in these libraries with the specified journal name are shown.
*ALL: All libraries on the system, including QSYS, and all libraries on any independent auxiliary storage pool (IASP) associated with the job, are searched.
*CURLIB: The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
name: Specify the name of the library to be searched.

Top

Examples

Example 1: Show Specify Journal Name Panel

WRKJRN

This command displays the Specify Journal Name panel. Once a journal name and library are specified, the Work with Journals panel is shown.

Example 2: Show Journals That Match Generic Name

WRKJRN   JRN(*LIBL/ABC*)

This command displays the Work with Journals panel and includes all journals whose names begin with 'ABC' and are found in libraries within the library list.

Top

Error messages

*ESCAPE Messages

CPF9801: Object &2 in library &3 not found.
CPF9802: Not authorized to object &2 in &3.
CPF9809: Library &1 cannot be accessed.
CPF9810: Library &1 not found.
CPF9820: Not authorized to use library &1.
CPF9825: Not authorized to device &1.
CPF9871: Error occurred while processing.

Top