DCMT DISPLAY JOURNAL

The DCMT DISPLAY JOURNAL(S) command displays information about a specific disk journal file or all disk journals.
idmscu19
The DCMT DISPLAY JOURNAL(S) command displays information about a specific disk journal file or all disk journals.
This article describes the following information:
2
2
Syntax
Following is an example of the DCMT DISPLAY JOURNAL syntax:
►►─ DCMT ─┬───────────────────┬──────────────────────────────────────────────►           └─ broadcast-parms ─┘  ►─ Display ┬ Journal ┬ journal-file-name ──────────────────────────────┬─┬──►◄             │         └─ FILe journal-file-name ┬──────────────────────┬┘ │             │                                   └ PENding TRAnsactions ┘  │             └─ Journals ──────────────────────────────────────────────────┘
Parameters
Following is a description of the DCMT DISPLAY JOURNAL parameters:
  • broadcast-parms
    Indicates to execute the DCMT command on all or a list of data sharing group members. For more information about broadcasting and
    broadcast-parms
    syntax, see How to Broadcast System Tasks.
    Journal
    Displays information about a specific disk journal file.
    • journal-file-name
      Specifies the name of the disk journal.
    • FILe
      Displays information about a disk journal.
      journal-file-name
      Specifies the name of the disk journal.
      PENding TRAnsactions Outputs information about pending transactions.
  • Journals
    Displays information about all disk journal files.
Usage
The following information is displayed for each journal file:
Field
Value
Disk Journal
Journal file name.
Segno
Segment number of the current journal segment.
Lorbn
Low relative block number of the current journal segment.
Hirbn
High relative block number of the current journal segment.
Nxrbn
Next relative block number of the current journal segment.
Ful
YES -- The journal is full
NO -- The journal is not full
Act
YES -- The journal is active
NO -- The journal is not active
Rcv
YES -- The journal is in use for recovery purposes
NO -- The journal is not in use for recovery purposes
Arch
CD -- DC/UCF is in the condense phase of archiving the journalfile
OF -- DC/UCF is in the offload phase of archiving the journal file
NO -- DC/UCF is not archiving the journal file
Stat
The current status of the file. If an I/O error occurs or if DC/UCF encounters a problem while archiving the file, the system displays a 4-digit error status code.
Dsrbn
The relative block number to which the next dummy segment (DSEG) is written. If the number in this column is higher than the high relative block number, no DSEG records are currently being written.
Dsintv
The DSEG interval (journal fragment interval). This value indicates the number of relative block numbers between DSEG records.
TQL
The transaction level; that is the number of transactions that must be running to defer writing a journal block.
Displaying Pending Transactions of a Disk Journal File
A pending transaction is a transaction that is active and might need the named disk journal if the transaction has to be backed out. Pending transactions prevent the disk journal from reaching an offline status.
If a journal is varied OFFLINE or INACTIVE, or is in a state that does not allow the journal to become active, the status is displayed under the Segno heading.
Examples
The following examples show the output of the DCMT DISPLAY JOURNAL command:
DCMT DISPLAY JOURNALS
      DISPLAY JOURNALS -- Disk Journal  Segno  LoRBN HiRBN NxRBN Ful Act Rcv Arch Stat DsRBN DsINTV Tql SYSJRNL1             4     10  1000   989  NO YES  NO   NO    0  1020      0   0 SYSJRNL2             2     10  1000 *****  NO  NO  NO   NO    0 SYSJRNL3             3     10  1000 *****  NO  NO  NO   NO    0
DCMT DISPLAY JOURNAL FILE journal-file-name PENDING TRANSACTIONS
 DCMT DISPLAY JOURNAL FILE SYSJRNL2 PENDING TRANSACTION Task / LTE   Trans-ID Pri Orig Module   SS/AM    St Stat        Date:Time         57        165 100  LOC LOCKTEST EMPSS01  RW   H 2007-03-16-08.52.45.6079
 
The following examples show the output for DCMT DISPLAY JOURNAL when the journal is varied OFFLINE, OFFLINE PERMANENT, INACTIVE,  and is closed or an open error is received:
DCMT DISPLAY JOURNAL: OFFLINE
Disk Journal Segno LoRBN HiRBN NxRBN Ful Act Rcv Arc Stat DsRBN DsINTV Tql J1JRNL           4     8  5000    16  NO YES  NO  NO   0    215    200   3 J2JRNL OFFLINE
DCMT DISPLAY JOURNAL: OFFLINE PERMANENT
Disk Journal Segno LoRBN HiRBN NxRBN Ful Act Rcv Arc Stat DsRBN DsINTV Tql J1JRNL           4     8  5000    16  NO YES  NO  NO    0   215    200   3 J2JRNL OFFLINE PERM
DCMT DISPLAY JOURNAL: INACTIVE
Disk Journal Segno LoRBN HiRBN NxRBN Ful Act Rcv Arc Stat DsRBN DsINTV Tql J1JRNL           4     8  5000    16  NO YES  NO  NO    0   215    200   3 J2JRNL I/O Error. Journal Inactive 9999
DCMT DISPLAY JOURNAL: INACTIVE
Disk Journal Segno LoRBN HiRBN NxRBN Ful Act Rcv Arc Stat DsRBN DsINTV Tql J1JRNL           4     8  5000    16  NO YES  NO  NO    0   215    200   3 J2JRNL I/O Error. Journal Inactive 0
DCMT DISPLAY JOURNAL: CLOSED
Disk Journal Segno LoRBN HiRBN NxRBN Ful Act Rcv Arc Stat DsRBN DsINTV Tql J1JRNL           4     8  5000    16  NO YES  NO  NO    0   215    200   3 J2JRNL CLOSED
DCMT DISPLAY JOURNAL: OPEN ERROR
Disk Journal Segno LoRBN HiRBN NxRBN Ful Act Rcv Arc Stat DsRBN DsINTV Tql J1JRNL           4     8  5000    16  NO YES  NO  NO    0   215    200   3 J2JRNL Open error