WRKJRNA (Work with Journal Attributes)
WRKJRNA Command syntax diagram
Purpose
The Work with Journal Attributes (WRKJRNA) command allows the user to display and work with the creation and operational attributes of a journal, including the names of the journal receivers currently attached to the journal. From the primary display, options can be selected to display the names of all objects currently journaled to the journal, the names of all database files currently having their access paths journaled to the journal, the names of all remote journals currently associated with this journal and detailed information about a remote journal, the receiver directory, and detailed information about a journal receiver. Journal receivers can also be deleted from the receiver directory.
If output is printed with the job's spooled printer output, then all of the information that is optionally displayed is printed, except for:
- Detailed information about journal receivers; for that information, use the Display Journal Receiver Attributes (DSPJRNRCVA) command.
- Detailed information about the relational database directory entries associated with any remote journals.
Required Parameters
- JRN
- Specifies the journal whose attributes are to be displayed.
*INTSYSJRN: The internal system journal associated with the journal specified on the JRNID parameter is used. Internal system journals are not stored in libraries.
Note: You must have *ALLOBJ special authority to specify JRN(*INTSYSJRN). The name of the journal can be qualified by one of the following library values:
*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library to be searched.
journal-name: Specify the name of the journal whose attributes are to be displayed.
Optional Parameters
- OUTPUT
- Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in commonly used parameters.
*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.
*PRINT: The output is printed with the job's spooled output.
- JRNID
- Specifies the five-character journal identification number (ID) of the internal system journal (*INTSYSJRN) to be displayed. Journal IDs are assigned by the system. The first two characters represent the journal type, and the last three characters are the auxiliary storage pool (ASP) identifier. Following is a listing of journal types.
- Journal Types
- 10
- System-managed access-path protection (SMAPP)
- 20
- Directory
Example for WRKJRNA
WRKJRNA JRN(MYLIB/JRNLA)This command allows the user to work with the current journal attributes of JRNLA in library MYLIB.
Error messages for WRKJRNA
*ESCAPE Messages
- CPF70FF
- Internal system journal function failed.
- CPF701B
- Journal recovery of an interrupted operation failed.
- CPF702C
- An attached receiver has previously been destroyed.
- CPF706B
- Not authorized to specify JRN(*INTSYSJRN).
- CPF706C
- Value &1 for JRNID parameter not valid.
- CPF708D
- Journal receiver found logically damaged.
- CPF9801
- Object &2 in library &3 not found.
- CPF9802
- Not authorized to object &2 in &3.
- CPF9803
- Cannot allocate object &2 in library &3.
- CPF9810
- Library &1 not found.
- CPF9820
- Not authorized to use library &1.
- CPF9871
- Error occurred while processing.
- CPF9875
- Resources exceeded on ASP &2.