Use of the QAJRNCHG file

 

You can use the apply and remove journaled changes output (QAJRNCHG) file to make a record of all the activity that occurs when you perform an apply or remove journaled changes operation.

When you specify to create the output file, the system uses the QAJRNCHG output file in the QSYS library with the format name QJOAPYRM as a model.

The words in parenthesis in the Field column indicate the column heading used in the output file.

See the following commands for the all of the parameters used with this output file:

The following table describes the fields that the output file creates.

Relative offset Field Format Description
Fields defining the header information
1 Command (QJOCMD) Char (10) Indicates if APYJRNCHG, APYJRNCHGX, or RMVJRNCHG was used.
11 Detail option (QJODET) Char (1) Specifies the level of detail that was selected for this output file:

  • A = DETAIL(*ALL) The file contains information about the command and an entry for each object that was applied to, whether it existed when the apply command started or it was created during the apply.

  • E = DETAIL(*ERR) The file contains information about the command and an entry only for each object that was not successfully applied to. If the apply ends early for an object an entry is included for it.
12 System (QJOSYS) Char (8) The name of the system where the apply or remove journaled changes operation was performed.
20 Release (QJOSRL) Char (6) The release of i5/OS that the system performing the apply or remove operation uses.
26 Journal name (QJOJRN) Char (10) The name of the journal.
36 Library name (QJOJLB) Char (10) The name of the library for the journal.
46 ASP device (QJOASP) Char (10) The name of the auxiliary storage pool (ASP) device for the library.
56 Commit boundary (QJOCMT) Char (1) Indicates if a commit boundary was used in the apply or remove operation.

  • Y = CMTBDY(*YES) was specified

  • N = CMTBDY(*NO) was specified
57 Reserved (QJORS1) Char (30) Reserved
Results summary fields
87 Number of objects (QJONOB) Char (10) Total number of objects processed during the apply or remove operation.
97 Total entries (QJONEN) Char (20) Total number of entries processed during the apply or remove operation.
117 Last entry (QJOLST) Char (20) Last entry examined in the apply or remove operation.
137 End partial LUW (QJOLUW) Char (1) At least one transaction was omitted because CMTBYD(*YES) was specified and the ending sequence number was not at a commit boundary.

  • Y = Yes

  • N = No
138 Reserved (QJORS2) Char (20) Reserved
Object apply or remove information
158 Object deleted (QJOOSD) Char (1) Indicates if the object was deleted during the apply or remove operation.

  • Y = Yes

  • N = No
159 Object created (QJOOSC) Char (1) Indicates if the object was created during the apply or remove operation.

  • Y = Yes

  • N = No
160 Early end (QJOOSE) Char (1) Indicates if the apply or remove operation ended early for this object.

  • Y = Yes

  • N = No
161 Change not made (QJOOSU) Char (1) Indicates that a change was found for this object after an early end to the apply operation.

  • Y = Yes

  • N = No
162 End reason code (QJORCD) Hex (1) Reason code for early end. See message MCH4801 for the possible values.
163 End message ID (QJOMID) Char (7) Message identifier associated with an early end to the apply operation.
170 Error condition (QJOENO) Hex (4) Error condition associated with an early end to the apply operation.
174 Partial transactions remain (QJOPTL) Char (1) Changes for partial transactions remain for this object.

  • Y = Yes

  • N = No
175 Partial transactions removed (QJOPTR) Char (1) Indicates whether partial transactions were removed for this object.

  • Y = Yes

  • N = No
176 Reserved (QJORS3) Char (20) Reserved
196 Starting sequence number (QJOSSN) Char (20) Specified starting sequence number for the apply or remove operation.
216 Starting receiver name (QJOSRC) Char (10) The name of the first receiver from which entries were applied or removed.
226 Receiver library (QJOSLB) Char (10) The library for the starting journal receiver.
236 Ending sequence number (QJOESN) Char (20) Specified ending sequence number for the apply or remove operation.
256 Ending receiver name (QJOERC) Char (10) The name of the last or ending receiver from which entries were applied or removed.
266 Library name (QJOERL) Char (10) The library for the ending journal receiver.
276 First entry applied or removed (QJOASN) Char (20) The first entry of the apply or remove operation.
296 Last entry applied or removed (QJOAEN) Char (20) The last entry of the apply or remove operation.
316 Number of entries (QJONUM) Char (20) The number of journal entries that were applied or removed.
336 Partial transaction starting sequence number (QJOBSN) Char (20) Starting sequence number for any partial transactions that were removed. For integrated file system objects, this field is always zero.
356 Partial transaction ending sequence number (QJOBEN) Char (20) Ending sequence number for any partial transactions that were removed. For integrated file system objects and data areas, this field is always zero.
376 Number of partial transaction removed (QJOBNM) Char (20) Count of number of entries removed for partial transactions. For integrated file system objects and data areas, this number is always zero.
396 No entries applied indicator (QJONAIN) Char (1) Indicates why no entries were applied to the object.

  • 1 = The object was created during apply, but did not get journaled or can never be journaled.

  • 2 = The object existed before the apply and was journaled as a result of the apply. However, no entries were applied because it could not be determined that the correct version of the object was on the server at the time of the apply.
397 Reserved (QJORS4) Char (19) Reserved
Object identification information
416 Object type (QJOOTP) Char (10) The type of object.
426 Object name (QJOONM) Char (10) The name of the object.
436 Object library (QJOOLB) Char (10) The object's library.
446 Member name (QJOOMB) Char (10) Member name.
456 FID (QJOOFD) Char (16) The file identifier of an integrated file system object.
472 Path indicator (QJOAPI) Char (1) The absolute or relative path indicator. The possible values for this field are:

  • 0 = The path contains an absolute path name. The Relative directory FID field is hex zeros.

  • 1 =The path contains a relative path name. The Relative directory FID field is valid and can be used to form a complete path name.

This field only applies to integrated file system objects.

473 Relative directory FID (QJORPI) Char (16) The path contains a relative path name. The Relative directory FID field is valid and can be used to form a complete path name. This field only applies to integrated file system objects.
489 Path name CCSID (QJOPCC) Hex (4) The coded character set identifier (CCSID) for the path name. This field only applies to integrated file system objects.
493 Path name region ID (QJOPRE) Char (2) The region or country identifier for national language support. This field only applies to integrated file system objects.
495 Path name language ID (QJOPLN) Char (3) The language identifier national language support. This field only applies to integrated file system objects.
498 Reserved (QJORS5) Char (3) Reserved
501 Path name type (QJOPNT) Hex (4) The possible values for this field are:

  • 0 = The path name is a character string with a one byte delimiter.

  • 2 = The path name is a character string with a two byte delimiter.

This field only applies to integrated file system objects.

505 Path name length (QJOPNL) Hex (4) The length of the path name. This field only applies to integrated file system objects.
509 Path name delimiter (QJOPND) Char (2) The path name delimiter. This field only applies to integrated file system objects.
511 Reserved (QJORS6) Char (8) Reserved
519 Path name (QJOPNM) Char (5000) The path name. The length of this field is variable, depending on the path name. This field only applies to integrated file system objects.

 

Parent topic:

Recovery of journaled objects

Related concepts
Applying journaled changes Removing journaled changes Example: Removing journaled changes