Record format: DBD variable segment


The following table describes the DBD variable segment of the transaction log record.

Note

The size of the DBD and DB2 variable segments were increased by 8 bytes for version 5.1 of MainView for IMS Offline. The change provides a new field in the DBD segments, DBTDBVER, for the IMS database version. A new field (TRNDBTSZ) in the fixed segment of the transaction record has the size of the variable segments (see Record-format-fixed-segment). For prior versions, this area was not used and contained binary zeros. Any OEM or user program that processes the variable DBD and DB2 segments of the transaction log records might need to be reassembled or modified to account for the size change or to make use of the DBTDBVER field.

Element label

Element name and description

Format

Length

Offset

Dec

Hex

--

DBD SEGMENT

Database segments are maintained for each DBD referenced in processing this transaction

The maximum number of segments is defined by the DBT parameter in BBPARM.

Group

62

000

000

DBTDBNAM

DATA BASE NAME FROM PCB

Name of the database

If the maximum number of segments is exceeded, an overflow segment is created with OTHERS in this field.

If the Event Collector DBIO data collection parameter is set to IOWAITS, a special segment, ALLDBS, can be created to account for sync point write activity.

Display

8

000

000

DBTDBTYP

DB ORGANIZATION

Code that identifies the type of organization used for this database:

  • X'00'=No organization, used for ALLDBS segment
  • X'44'=Root index
  • X'20'=HDAM
  • X'64'=HDAM plus root index
  • X'10'=HIDAM
  • X'54'=HIDAM plus root index
  • X'74'=HIDAM Index
  • X'08'=HISAM-CASE-2
  • X'04'=HISAM
  • X'02'=HSAM
  • X'01'=SSAM
  • X'05'=SHISAM
  • X'C4=(D) DEDB
  • X'D1'=(J) MSDB, nonrelated, key in segment
  • X'C1'=(A) MSDB, nonrelated, LTERM key
  • X'C3'=(C) MSDB, related, fixed
  • X'C7'=(G) MSDB, related, dynamic
  • X'80'=DB2 trailer format
  • X'81'=MQS trailer format

Binary

1

008

008

DBTFLAG1

FLAG BYTE 1

Special database flag:

  • X'01'=Secondary DBT
  • X'02'=Catch-all DBT
  • X'08'=DDname DBT
  • X'40'=Some DBT CNTRS have overflowed to OTHERS. For OTHERS segments, some count has been lost
  • X'80=DBT overflow has occurred. Another DBT may exist.

Binary

1

009

009

DBTDMBSZ

TOTAL DMB SPACE FOR DATA BASE

Amount of DMB buffer pool space required by this database, expressed in units of 8 bytes

If the database is DEDB with more than 2048 areas, then it is expressed in units of 32 bytes.

Binary

2

010

00A

DBTFLAG2

FLAG BYTE 2

Special database flag:

  • X'01'=Open PCB was done
  • X'04'=HALDB (partitioned database)
  • X'08'=OSAM sequential buffering in effect
  • X'80'=VSAM

Binary

1

012

00C

DBTFLAG3

FLAG BYTE 3

Special database flag:

  • X'02'=DBTSECNO wrapped
  • X'04'=DBTDDNNO wrapped

Binary

1

013

00D

DBTDDNNO

DDN-DBTNO

Chain of pointers for the DD segments for this database

If the X'04' bit in DBTFLAG3 is set, X'100' is added to this value.

Binary

1

014

00E

DBTSECNO

SEC-DBTNO (OVERFLOW)

Overflow pointer to next overflow segment

If the X'02' bit in DBTFLAG3 is set, X'100'is added to this value.

Binary

1

015

00F

The element at this position varies based on the setting of DBTFLAG1:

  • If DBTFLAG1 is not set to X'08', DBTGU and DBTGN
  • If DBTFLAG1 is set to X'08, DBTRIOTM

The bytes at this position vary based on the setting of DBTFLAG1:

  • If DBTFLAG1 is not set to X'08', the bytes represent the following information:
    • GET UNIQUE COUNT

      The first two bytes are the number of times a GET UNIQUE was requested in processing the transaction

    • GET NEXT COUNT

      The second two bytes are the number of times a GET NEXT was requested in processing this transaction

  • If DBTFLAG1 is set to X'08', the bytes represent:
    • READ I/O TIME FOR DD

      Total read I/O time for the transaction

Binary

4

016

010

The element at this position varies based on the setting of DBTFLAG1:

  • If DBTFLAG1 is not set to X'08, DBTISRT and DBTDLET
  • If DBTFLAG1 is set to X'08, DBTWIOTM

The bytes at this position vary based on the setting of DBTFLAG1:

  • If DBTFLAG1 is not set to X'08', the bytes represent the following information:
    • INSERT COUNT

      The first two bytes are the number of times an insert was requested in processing the transaction

    • DELETE COUNT

      The second two bytes are the number of times a delete was requested in processing this transaction

  • If DBTFLAG1 is set to X'08', the bytes represent:
    • WRITE I/O TIME FOR DD

      Total write I/O time for the transaction

Binary

4

020

014

DBTREPL

REPLACE COUNT

Number of times a replace was requested in processing this transaction

Binary

2

024

018

DBTOTHER

OTHER COUNT

Number of system service calls issued against this database by the transaction

Binary

2

026

01A

DBTKEYR

KEY READ COUNT

Number of reads issued to the key sequence data area in satisfying the DL/I requests

Binary

2

028

01C

DBTKEYW

KEY WRITE COUNT

Number of writes issued to the key sequence data area in satisfying the DL/I requests

Binary

2

030

01E

DBTNKEYR

NONKEY READ COUNT

Number of reads issued to the OSAM or entry sequence data area in satisfying the DL/I requests

Binary

2

032

020

DBTNKEYW

NONKEY WRITE COUNT

Number of writes issued to the OSAM or entry sequence data area in satisfying the DL/I requests

Binary

2

034

022

The element at this position varies based on the setting of BHTO:

  • If BHTO is not set to NO, DBTNOI
  • If BHTO is set to NO, DBTBFSTK

The bytes at this position vary based on the setting of BHTO:

  • If BHTO is not set to NO, the bytes represent the following information:
    • REQUESTS ALREADY IN BUFFER

      Number of times the requested data was found in the I/O buffer

  • If BHTO is set to NO, the bytes represent the following information:
    • BUFFER STEAL WRITE (KEY)

      Number of key buffer steal writes

Binary

2

036

024

The element at this position varies based on the setting of BHTO:

  • If BHTO is not set to NO, DBTNOO
  • If BHTO is set to NO, DBTBFSTN

The bytes at this position vary based on the setting of BHTO:

  • If BHTO is not set to NO, the bytes represent the following information:
    • ALTERS OF ALREADY ALTERED BUFFER

      Number of alters to an already altered buffer

  • If BHTO is set to NO, the bytes represent the following information:
    • BUFFER STEAL WRITE (NONKEY)

      Number of non-key buffer steal writes

Binary

2

038

026

DBTCTLIO

NO OF I/O IN CTL RGN

Number of I/Os that occurred under a serialized IMS task (in the control region or DLISAS region) instead of under the dependent region task

Binary

2

040

028

DBTFWX

FULL WORD COUNTER INDEX

If a counter overflow occurred, this element is the index to the counter affected (hexadecimal offset of the elements in the DBD variable segment that overflowed into the overflow fullword counter at decimal offset 054)

Binary

2

042

02A

DBTFWC

FULL WORD COUNTER

If a counter overflow occurred, this fullword is used to hold this larger value

Binary

4

044

02C

DBTDBVER

DBTDBVER

IMS database version number

Binary

4

48

030

--

RESERVED

Binary

4

52

034



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*