STRJRNOBJ (Start Journal Object)

STRJRNOBJ Command syntax diagram

 

Purpose

The Start Journal Object (STRJRNOBJ) command is used to start journaling changes (made to an object or list of objects) to a specific journal. The object types which are supported through this interface are Data Areas (*DTAARA) and Data Queues (*DTAQ). For more information about the possible journal entries which can be sent, see the Journal management article in the Information Center.>

Additionally, the user can specify that only the after image or both the before and the after images of an object of type *DTAARA be journaled. Before images are necessary to remove journaled changes using the Remove Journaled Changes (RMVJRNCHG) command.

After journaling begins for the object, the user should save the journaled object to preserve its journal attribute information. Also, the object must be saved because, for example, journaled changes cannot be applied to a version of the object that was saved before journaling was in effect.

Note: For other ways to start journaling see the following commands:

• Access Paths - Start Journal Access Path (STRJRNAP)
  
  
• Integrated File System objects - Start Journal (STRJRN)
  
  
• Physical Files - Start Journal Physical File (STRJRNPF)

 

Restrictions

1. The object must not be journaling changes to another journal.
   
   
2. The maximum number of objects that can be associated with one journal is 250,000. This maximum includes objects whose changes are currently being journaled, objects for which journaling was ended while the current receiver was attached, and journal receivers that are or were associated with the journal while the current journal receiver is attached. If the number of objects is larger than this maximum, journaling does not start.
   
   
3. The specified journal cannot be a remote journal.
   
   
4. The specified journal and object must reside in the same Auxiliary Storage Pool (ASP).
   
   
5. For data areas, only local external data area objects may be journaled. The special data areas (*LDA, *GDA, and *PDA) and DDM data areas cannot be journaled.
   
   
6. For data queues, only local data queues are supported. DDM data queues cannot be journaled.

 

Required Parameters

OBJ

Specifies a maximum of 300 qualified object names for which changes are to be journaled.

The name of the object 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.

object-name: Specify the name of the object for which changes are to be journaled.

OBJTYPE

Specifies the object type for which changes are to be journaled.

*DTAARA: Changes for data area objects are to be journaled.

*DTAQ: Changes for data queue objects are to be journaled.

JRN

Specifies the qualified name of the journal that receives the journaled changes.

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 that receives the journaled changes.

 

Optional Parameters

IMAGES

Specifies the kinds of images that are written to the journal receiver for changes to the object.

*AFTER: Only after images are generated for changes to the object.

*BOTH: The system generates both before and after images for changes to the object.

Note: The value *BOTH is only valid for *DTAARA objects.

Example for STRJRNOBJ

STRJRNOBJ  OBJ(DTALIB/MYDTAARA) OBJTYPE(*DTAARA)  JRN(MYLIB/JRNLA)

This command journals all changes to data area MYDTAARA in library DTALIB to journal JRNLA in library MYLIB. Only the after images of updates are written to the journal.

Error messages for STRJRNOBJ

*ESCAPE Messages

CPF6979

Journal &1 in library &2 is unusable.

CPF700A

&1 of &2 objects have started journaling.

CPF705A

Operation failed due to remote journal.

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.

CPF9825

Not authorized to device &1.

CPF9830

Cannot assign library &1.

CPF9873

ASP status is preventing access to object.

CPF9875

Resources exceeded on ASP &1.