SYSIBM.SYSCOPY table

The SYSIBM.SYSCOPY table contains information needed for recovery.

Column name Data type Description Use
DBNAME
CHAR(8)
NOT NULL
Name of the database. G
TSNAME
CHAR(8)
NOT NULL
Name of the target table space or index space. G
DSNUM
INTEGER
NOT NULL
Data set number within the table space. For partitioned table spaces, this value corresponds to the partition number for a single partition copy, or 0 for a copy of an entire partitioned table space or index space. G
ICTYPE
CHAR(1)
NOT NULL
Type of operation:
A
ALTER
B
REBUILD INDEX
C
CREATE
D
CHECK DATA LOG(NO) (no log records for the range are available for RECOVER utility)
E
RECOVER (to current point)
F
COPY FULL YES
I
COPY FULL NO
Start of changeLEnd of change
Start of changeSQL (type of operation)End of change
M
MODIFY RECOVERY utility
P
Start of changeRECOVER TOCOPY, RECOVER TOLOGPOINT, or RECOVER TORBA (to a point in time)End of change
Q
QUIESCE
R
LOAD REPLACE LOG(YES)
S
LOAD REPLACE LOG(NO)
T
TERM UTILITY command
V
REPAIR VERSIONS utility
W
REORG LOG(NO)
X
REORG LOG(YES)
Y
LOAD LOG(NO)
Z
LOAD LOG(YES)
G
 
CHAR(6)
NOT NULL
Not used N
START_RBA
CHAR(6)
NOT NULL
FOR BIT DATA
A 48-bit positive integer that contains the LRSN of a point in the DB2® recovery log. (The LRSN is the RBA in a non-data-sharing environment.)
  • For ICTYPE I or F, the starting point for all updates since the image copy was taken
  • For ICTYPE M, the RBA of the highest deleted SYSCOPY or SYSLGRNX record
  • For ICTYPE P, the point after the log-apply phase of point-in-time recovery
  • For ICTYPE Q, the point after all data sets have been successfully quiesced
  • For ICTYPE R or S, the end of the log before the start of the LOAD utility and before any data is changed
  • For ICTYPE T, the end of the log when the utility is terminated
  • For other values of ICTYPE, the end of the log before the start of the RELOAD phase of the LOAD or REORG utility.
G
FILESEQNO
INTEGER
NOT NULL
Tape file sequence number of the copy. G
DEVTYPE
CHAR(8)
NOT NULL
Device type the copy is on. G
IBMREQD
CHAR(1)
NOT NULL
A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. For all other values, see Release dependency indicators.

The value in this field is not a reliable indicator of release dependencies. RELCREATED should be used instead.

G
DSNAME
CHAR(44)
NOT NULL
For ICTYPE='P' (RECOVER TOCOPY only), ''I'', or 'F', DSNAME contains the data set name. Otherwise, DSNAME contains the name of the database and table space or index space in the form, database-name.space-name, or DSNAME is blank for any row migrated from a release prior to Version 4. G
 
CHAR(6)
NOT NULL
Not used N
SHRLEVEL
CHAR(1)
NOT NULL
SHRLEVEL parameter value on COPY (for ICTYPE F or I only):
C
CHANGE
R
REFERENCE
blank
Does not describe an image copy or was migrated from Version 1 Release 1 of DB2.
G
DSVOLSER
VARCHAR(1784)
NOT NULL
Start of changeOne of the following values:End of changeStart of change
  • If the operation is not an image copy operation that creates a FlashCopy® image copy with consistency (an image copy operation with the FLASHCOPY CONSISTENT option), this value is:
    • A comma-separated list of 6-byte volume serial numbers of the data set, if the data set is not catalogued.
    • Blank if the data set is cataloged.
  • If the operation is an image copy operation that creates a FlashCopy image copy with consistency (an image copy operation with the FLASHCOPY CONSISTENT option), this value is a comma-separated list of values of the following form:
    memberID-ckptrba

    memberID is a 3-digit ID for a member of a data sharing group.

    ckptrba is the 12-byte hexadecimal checkpoint RBA for the member.

End of change
G
TIMESTAMP
TIMESTAMP
NOT NULL WITH
DEFAULT
The date and time when the row was inserted. For the COPYTOCOPY utility, this value is the date and time when the row was inserted for the primary local site or primary recovery site copy. For an EXCHANGE DATA statement, this is the time that the statement is run. G
ICBACKUP
CHAR(2)
NOT NULL WITH
DEFAULT
Specifies the type of image copy contained in the data set:
blank
LOCALSITE primary copy (first data set named with COPYDDN)
Start of changeFCEnd of change
Start of changeFlashCopy copyEnd of change
LB
LOCALSITE backup copy (second data set named with COPYDDN)
RP
RECOVERYSITE primary copy (first data set named with RECOVERYDDN)
RB
RECOVERYSITE backup copy (second data set named with RECOVERYDDN)
G
ICUNIT
CHAR(1)
NOT NULL WITH
DEFAULT
Indicates the media that the image copy data set is stored on:
D
DASD
T
Tape
blank
Medium is neither tape nor DASD, the image copy is from a DB2 release prior to Version 2 Release 3, or ICTYPE is not 'I' or 'F'.
G
STYPE
CHAR(1)
NOT NULL WITH
DEFAULT
When ICTYPE=A, the values are:
A
A partition was added or inserted to a table.
Start of changeBEnd of change
Start of changeThe MEMBER CLUSTER value was changed.End of change
C
A column was added to a table and an index in different commit scopes.
Start of changeDEnd of change
Start of changeEither the DSSIZE attribute of the table space was altered or the default value of a column of a table was altered.End of change
E
The data set numbers of a base table and its associated clone table are exchanged.
Start of changeFEnd of change
Start of changeThe page size attribute of the table space or index was altered.End of change
G
An index was regenerated
Start of changeHEnd of change
Start of changeThe table was altered to hash organization, the size of the hash space was changed, or the hash organization was dropped. The value of the TTYPE column indicates the action taken.End of change
Start of changeIEnd of change
Start of changeThe inline length attribute of the LOB column was altered by REORG.End of change
L
The logging attribute of the table space was altered to LOGGED.
Start of changeMEnd of change
Start of changeThe MAXPARTITIONS attribute of the table space was altered.End of change
N
An index was altered to not padded
O
The logging attribute of the table space was altered to NOT LOGGED.
P
An index was altered to padded
R
A table was altered to rotate partitions.
Start of changeSEnd of change
Start of changeThe SEGSIZE attribute of the table space was altered.End of change
Start of changeUEnd of change
Start of changeAn ALTER TABLE ALTER COLUMN DROP DEFAULT statement was executed on a column that was previously added with an ALTER TABLE ADD COLUMN statement. End of change
V
A column in a table was altered for a numeric data type change and the column is in an index.
Start of changeYEnd of change
Start of changeAn index was altered to COPY YESEnd of change
G
STYPE (continued)  
When ICTYPE=A, the values are (continued):
Z
A column that is in the key of an index that was versioned prior to DB2 Version 8 was altered.
When ICTYPE=C, the values are:
L
The logging attribute of the table space was LOGGED.
O
The logging attribute of the table space was NOT LOGGED.
Start of changeWhen ICTYPE=E, the values are:
B
RECOVER utility with the BACKOUT keyword.
blank
RECOVER utility without the BACKOUT keyword.
End of change
When ICTYPE=F, the values are:
C
DFSMS concurrent copy ("I" instance of the table space)
J
DFSMS concurrent copy ("J" instance of the table space)
Start of changeNEnd of change
Start of changeA FlashCopy copy is not consistent.End of change
Start of changeQEnd of change
Start of changeSequential copy is consistentEnd of change
 
STYPE (continued)  
When ICTYPE=F, the values are (continued):
Start of changeREnd of change
Start of changeLOAD REPLACE(YES)End of change
S
LOAD REPLACE(NO)
Start of changeTEnd of change
Start of changeFlashCopy copy is consistent.End of change
Start of changeUEnd of change
Start of changeSequential copy is not consistentEnd of change
V
ALTER INDEX NOT PADDED
W
REORG LOG(NO)
X
REORG LOG(YES)
blank
DB2 image copy
Start of changeWhen ICTYPE=L, the value is:
M
Mass DELETE, TRUNCATE TABLE, DROP TABLE, or ALTER TABLE ROTATE PARTITION. The LOWDSNUM column contains the table OBID of the affected table.
End of change
The MERGECOPY utility, when used to merge an embedded copy with subsequent incremental copies, also produces a record that contains ICTYPE=F and the STYPE of the original image copy (R, S, W, or X).

When ICTYPE = M and the MODIFY RECOVERY utility was executed to delete SYSCOPY and/or SYSLGRNX records, the value is R.

When ICTYPE=O, the values are:
B
A table space or partition that was in reordered row format was recovered to a point in time when it was in basic row format.
R
A table space or partition was converted to reordered row format as a result of REORG or LOAD REPLACE.
When ICTYPE=P, the values are:
Start of changeBEnd of change
Start of changeRECOVER with the BACKOUT YES option.End of change
C
RECOVER without using LOGONLY with consistency.
Start of changeJEnd of change
Start of changeRECOVER using LOGONLY without consistency and using the ENFORCE NO option.End of change
Start of changeKEnd of change
Start of changeRECOVER without using LOGONLY or the BACKOUT YES and the ENFORCE NO options. End of change
L
RECOVER using LOGONLY without consistency.
M
RECOVER using LOGONLY with consistency.
blank
RECOVER without using LOGONLY without consistency.

When ICTYPE=Q and option WRITE(YES) is in effect when the quiesce point is taken, the value is W.

When ICTYPE=R or S, the values are:
A
Resetting REORG pending status
T
First materializing the default value for a row change timestamp column
When ICTYPE=T, this field indicates which COPY utility was terminated by the TERM UTILITY command or the START DATABASE command with the ACCESS(FORCE) option. The values are:
F
COPY FULL YES
 
STYPE (continued)  
When ICTYPE=T, the values are (continued):
I
COPY FULL NO
When ICTYPE=W or X, the values are:
A
Resetting REORG pending status or REBALANCE
T
First materializing the default value for a row change timestamp column

For other values of ICTYPE, the value is blank.

 
PIT_RBA
CHAR(6)
NOT NULL WITH
DEFAULT
FOR BIT DATA
The meaning of the value depends on the value of the ICTYPE column:
ICTYPE='P'
The LRSN for the point in the DB2 log. (The LRSN is the RBA in a non-data-sharing environment) The value indicates the stop location of a point-in-time recovery.

If a record contains ICTYPE='P' and PIT_RBA=X'000000000000', the copy pending status is active and a full image copy is required. If such a record is encountered during fallback processing of RECOVER, the recover job fails, and a point-in-time recovery is required. PIT_RBA can be zero if the point-in-time recovery is completed by the fall-back processing of RECOVER, or if ICTYPE=P from a prior release of DB2.

ICTYPE='F' or 'I' and SHRLEVEL='C'
The current RBA or LRSN that corresponds to the point in the DB2 log when the SHRLEVEL CHANGE copy completes.
Start of changeICTYPE='F', SHRLEVEL='R' or 'C', and ICBACKUP='FC'End of change
Start of changeThe RBA or LRSN that corresponds to the point in the DB2 log when the FlashCopy completes.End of change
Start of changeCTYPE='F' and SHRLEVEL 'R' or 'C', STYPE= 'T', 'N', 'Q', or 'U' End of change
Start of changeThe RBA or LRSN that corresponds to the point in the DB2 log when the FlashCopy completes.End of change
Start of changeICTYPE='M'End of change
Start of changeThe RBA/LRSN for the end of the log when the utility completes.End of change

For other all other ICTYPE values, this field contains X'000000000000'.

G
GROUP_MEMBER
CHAR(8)
NOT NULL WITH
DEFAULT
The DB2 data sharing member name of the DB2 subsystem that performed the operation. This column is blank if the DB2 subsystem was not in a DB2 data sharing environment at the time the operation was performed. G
OTYPE
CHAR(1)
NOT NULL WITH
DEFAULT 'T'
Type of object that the recovery information is for:
I
Index space
T
Table space
G
LOWDSNUM
INTEGER
NOT NULL WITH
DEFAULT
Partition number of the lowest partition in the range for SYSCOPY records created for REORG and LOAD REPLACE for resetting a REORG pending status. Version number of an index for SYSCOPY records created for a COPY (ICTYPE=F) of an index space (OTYPE=I). (An index is versioned when a VARCHAR column in the index key is lengthened.) When ICTYPE = F or I, DSNUM = 0 and OTYPE is not equal to I, LOWDSNUM = 1. G
HIGHDSNUM
INTEGER
NOT NULL WITH
DEFAULT
Partition number of the highest partition in the range. This column is valid only for SYSCOPY records created for REORG and LOAD REPLACE for resetting REORG pending status.When ICTYPE = F or I, DSNUM = 0 and OTYPE is not equal to I, HIGHDSNUM is the number of the highest partition that is copied. G
COPYPAGESF
FLOAT(8)
NOT NULL WITH
DEFAULT -1
Number of pages written to the copy data set. For inline copies, this number might include pages appearing more than once in the copy data set. G
NPAGESF
FLOAT(8)
NOT NULL WITH
DEFAULT -1
The number of pages in the table space or index at the time of COPY. This number might include pre-formatted pages that are not actually copied.

Start of changeWhen ICTYPE=A, SYTPE=H, and TTYPE=S or D, this column contains the previous HASHDATAPAGES value. When ICTYPE=A, SYTPE=H, and TTYPE=A this column contains zero.End of change

G
CPAGESF
FLOAT(8)
NOT NULL WITH
DEFAULT -1
Start of changeTotal number of changed pages since last copy. End of change G
JOBNAME
CHAR(8)
NOT NULL WITH
DEFAULT
Job name of the utility. G
AUTHID
CHAR(8)
NOT NULL WITH
DEFAULT
Authorization ID of the utility. G
OLDEST_VERSION
SMALLINT
NOT NULL WITH
DEFAULT
When ICTYPE= B, F, I, S, W, or X, the version number of the oldest format of data for an object.

For other values of ICTYPE, the value is -1.

Start of changeThe default value of this column is 0.End of change

G
LOGICAL_PART
INTEGER
NOT NULL WITH
DEFAULT
Logical partition number. G
LOGGED
CHAR(1)
NOT NULL WITH
DEFAULT
Indicates the logging attribute of the table space at the time the SYSCOPY record is written:
  • Y — indicates that the logging attribute of the table space is LOGGED
  • N — indicates that the logging attribute of the table spaces is NOT LOGGED
  • blank — indicates that the row was inserted prior to DB2 9 or is not specified. For non-LOB table spaces or an index space, blank indicates that the logging attribute is LOGGED.
G
TTYPE
CHAR(8)
NOT NULL WITH
DEFAULT
Start of changeWhen ICTYPE=A and STYPE=B, this column indicates if the previous value for the MEMBER CLUSTER attribute is being used:
Y
The previous member cluster attribute of the table space is being used.
N
The previous member cluster attribute of the table space is not being used.
End of change

Start of changeWhen ICTYPE=A and STYPE=D, this column contains the previous DSSIZE attribute value for the table space in units of G, M, or K when the DSSIZE attribute is altered. This column is blank if the default value of a column of a table was altered.End of change

Start of changeWhen ICTYPE=A and STYPE=F, this column indicates the previous page size attribute value for the table space in units of K.End of change

Start of changeWhen ICTYPE=A and STYPE=H this column indicates a change that was applied to the hash organization of the table:Start of change
A
Hash organization was added. The record is written when the hash space is materialized at REORG.
D
Hash organization was dropped. The record is written immediately when the ALTER statement is issued.
S
The size of the hash space was changed. The value of the NAPGESF column contains the previous HASHDATAPAGES value. The record is written when the hash space is materialized at REORG.
End of change End of change
G
TTYPE (continued)  
Start of changeWhen ICTYPE=A and STYPE=I, this column indicates that the inline length of a LOB column was altered:
D
Indicates that REORG decremented the inline length of the LOB column
I
Indicates that REORG incremented the inline length of the LOB column
End of change
Start of changeWhen ICTYPE=A and STYPE=M, this column indicates either the previous value of the MAXPARTITIONS attribute for the table space or the type of table space conversion that was performed on the table space.
I
The table space was converted from a single-table simple table space to a partition-by-growth universal table space.
n
The previous value of the MAXPARTITIONS attribute for the table space.
S
The table space was converted from single-table segmented table space to a partition-by-growth universal table space.
End of change
 
TTYPE (continued)  
Start of changeWhen ICTYPE=A and STYPE=S, this column indicates either the previous value of the SEGSIZE attribute for the table space or the type of table space conversion that was performed on the table space.
n
The previous value of the SEGSIZE attribute for the table space.
P
The table space was converted from a partitioned table space to a range-partitioned universal table space.
End of change
When ICTYPE=E, this column indicates if the full recovery reset the object:
blank
The full recovery reset the object
N
The full recovery did not reset the object

Start of changeWhen ICTYPE=F and OTYPE=I, TTYPE of S indicates that the directory pages for the index image copy are at the front of each partition and are indicated with a 'V' or '8'. End of change

Start of changeWhen ICTYPE=F and STYPE=N, Q, T, or U, this column indicates the utility that made the FlashCopy:
C
COPY
D
CHECK DATA
L
LOAD
P
REPAIR
R
REORG TABLESPACE
S
REORG INDEX
T
COPYTOCOPY
End of change
Start of changeWhen ICTYPE=I, this column provides information about the system pages:
N
Indicates that no system pages are in this incremental image copy.
blank
Indicates that system pages are in this incremental image copy.
End of change

Start of changeWhen ICTYPE=P, R, S, W, X, this column provides additional diagnostic information:End of change

BRF
Indicates that the row format is the basic row format.
BRF I
Indicates that the row format is the basic row format, and the FORMAT INTERNAL option was specified.
 
TTYPE (cont)  
When ICTYPE=P, R, S, W, X, this column provides additional diagnostic information (continued):
Start of changeFEnd of change
Start of changeIndicates that the REORG utility was run with the FASTSWITCH YES option.End of change
RRF I
Indicates that the row format is the reordered row format, and the FORMAT INTERNAL option was specified.
Start of changeSEnd of change
Start of changeIndicates that the REORG utility was run with the FASTSWITCH NO option.End of change
When ICTYPE=M and STYPE=R, this column indicates whether the MODIFY RECOVERY utility deleted rows from SYSIBM.SYSLGRNX.
blank
MODIFY RECOVERY deleted rows from SYSIBM.SYSLGRNX.
N
MODIFY RECOVERY did not delete rows from SYSIBM.SYSLGRNX.

When ICTYPE=T, TTYPE of B indicates that a broken page was detected during copy.

Start of changeWhen ICTYPE=W or X and STYPE=H, this column indicates the prior value of HASHDATAPAGES.End of change

When ICTYPE=Y or Z, this column indicates whether the object was loaded when the FORMAT INTERNAL option was specified.

blank
Indicates that the FORMAT INTERNAL option was not specified during LOAD.
I
Indicates that the FORMAT INTERNAL option was specified during LOAD.
 
INSTANCE
SMALLINT
NOT NULL WITH
DEFAULT 1
When STYPE = E and ICTYPE = A, INSTANCE indicates the data set instance number of a base object after an EXCHANGE statement completes. The value of the INSTANCE column for the last data exchange will match the value of the INSTANCE column for the SYSIBM.SYSTABLESPACE table.

For an image copy, INSTANCE indicates the instance number of the current base objects (table and index).

G
RELCREATED
CHAR(1)
NOT NULL WITH
DEFAULT
The release of DB2 that is used to create the object. Blank if created prior to Version 9. See Release dependency indicators for all other values. G