Verifying Media Database Integrity

This chapter includes the following topics:

OverviewLink copied to clipboard

Inconsistencies in the Media Database may result from conversion of corrupted data in the existing tape management system’s database, or from a system crash, utility abend, and so on.

To check the integrity of the Media Database, run Control-M/Tape utility CTTIDB. This utility produces warning messages if inconsistencies are detected in the Media Database. Once Control-M/Tape is operational at your site, the CTTIDB utility is normally run as part of the Control-M/Tape New Day procedure to verify Media Database integrity.

Examples of inconsistencies are:

  • errors in the links that connect multi-volume data sets (normally a result of conversion)

  • active volumes that do not contain data sets

  • scratch volumes that contain active data sets

  • inconsistencies in the Media Database can be corrected through the Control-M/Tape Inquire/Update screen (TI), or through Media Database update the CTTMUP utility

Sample CTTIDB OutputLink copied to clipboard

Figure 7 shows a sample output for the CTTIDB utility. The messages are issued in pairs. The first message (CTTnnnE) identifies the type of error detected. The second message (CTT999I) identifies the data set or volume record in error. This section provides a detailed explanation for each message in this sample and suggestions for how to resolve the problems they describe.

Figure 7 Sample Messages

CopyCopied to clipboard
 CTT988E RBA 000101: VOLUME WITH NO DATASETS 
 CTT999I V PRD002 SEQ:002 FIRST:PRD001 PREV:PRD001 NEXT:PRD003
 CTT990E RBA 000108: VOLSNUM (002) DIFFERS FROM # OF VOLUME RECORDS FOUND (001)
 CTT999I D DSN.PRM04                                    PRM004 001
 CTT983E RBA 000200: VOL: HIS001 CHAIN ERROR: INVALID PREV/NEXT POINTERS
 CTT999I V HIS001 SEQ:001 FIRST:HIS001             NEXT:HIS002
 CTT983E RBA 000201: VOL: HIS002 CHAIN ERROR: INVALID PREV/NEXT POINTERS
 CTT999I V HIS002 SEQ:002 FIRST:HIS001
 CTT983E RBA 000205: VOL: DBA003 CHAIN ERROR: VOLUME OUT OF SEQUENCE
 CTT999I V DBA003 SEQ:005 FIRST:DBA001 PREV:DBA002 NEXT:DBA004
 CTT987E RBA 000208: ACTIVEDS (006) DIFFERS FROM # OF DSN RECORDS FOUND (003)
 CTT999I V MF0001 SEQ:000
 CTT984E RBA 000303: KEY NOT FOUND. RECTYPE: D, MISSING KEY: L
 CTT999I D DSN.L0006                                    L00006 001

Problem 1 – Active Volume With no Data SetsLink copied to clipboard

CopyCopied to clipboard
CTT988E RBA 000101: VOLUME WITH NO DATASETS
CTT999IV PRD002 SEQ:002 FIRST:PRD001 PREV:PRD001 NEXT:PRD003

An active volume (PRD002) containing no data sets was detected.

ProcedureLink copied to clipboard

Determine what caused the message by examining the record for the volume mentioned in the message (PRD002), as follows:

  1. In the Inquire/Update entry panel (TI), type the VOLSER of the volume mentioned in the message.

  2. Set DISPLAY TYPE toV

  3. Press ENTER.

    • The Media Database list is displayed.

      Figure 8 Media Database List

      CopyCopied to clipboard
       DATABASE LIST < V / V  > --------------------------------------------------(TI)
       COMMAND ===>                                                    SCROLL===> CRSR

        O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

          PRD002*      002 3490       08/08/00              0001          Active      

        ====== >>>>>>>>>>>>>>>  NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
      • The asterisk following the VOLSER indicates that volume PRD002 is part of a multi-volume chain.

  4. Specify OptionG (Group) to display the other volumes in the multi-volume chain:

    Figure 9 Media Database List After 4

    CopyCopied to clipboard
     DATABASE LIST < V / V  > --------------------------------------------------(TI)
     COMMAND ===>                                                    SCROLL===> CRSR

      O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

      G PRD002*      002 3490       08/08/00              0001          Active      

      ====== >>>>>>>>>>>>>>>  NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
  5. Specify OptionS (Data set list) to the left of the volumes in the chain:

    Figure 10 Media Database List After 5

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR

    O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

      PRD002*      002 3490        08/08/00             0001          Active      

    S  PRD001*     001 3490        08/08/00             0001          Active      

    S  PRD002*     002 3490        08/08/00             0001          Active      

    S  PRD003*     003 3490        08/08/00             0001          Active      

       

    ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
    • The data sets on the volumes in the chain are displayed

      Data set DSN.PRD01 is not listed in the Data Set list (S) for volumes PRD002 and PRD003 that are part of the multi-volume chain containing this data set. This indicates an error.

  6. Specify OptionA for data set record DSN.PRD01, and for volume records for PRD002 and PRD003.

    Figure 11 Media Database List After 6

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR

    O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

       PRD002*      002 3490       08/08/00              0001          Active      

        PRD001*      001 3490       08/08/00              0001          Active      

    A   DSN.PRD01                                         0001        Active      

    A  PRD002*     002 3490       08/08/00              0001          Active      

    A  PRD003*     003 3490       08/08/00              0001          Active      

    ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST    <<<<<<<<<<<<<<< ======

    Figure 12 shows the additional information for the DSN.PRD01 data set that is added to the screen. Note that the # of Volumes field is 000. This is the error that caused the messages that are being investigated.

    Figure 12 List Showing Additional Information for Data Set DSN.PRD01

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

         DSN.PRD01                                         0001        Active      

         GENERAL INFORMATION:                                                      

         Sequence #:     0001                    # of Volumes:   000               

         Rec Format:     F                       Rec Length:     00080             

         Block Size:     00080                   Block Count:    00048             

         Comp Size:      07953KB-001%            Tape Format:    256TRACK-IDRC     

         Uncomp Size:    00001KB                                                   

         Use Count:      00001                   EXCP Count:     00352             

         Modified:                               By User:        N74AUP2           

         Job Account:                                                              

         RETENTION INFORMATION:                                                    

         Source:         RULES                                                     

         Retention:      CATALOG                                                   

         CREATION INFORMATION:                                                     

         Date:           08/08/00                Time:           03:42             

         Job Name:       JOB1                    Step Name:      STEP1             

         PGM Name:       PGM1                    DD Name:        DDNAME1           

         UCB Addr:       0480                    CPU ID:                           

         Created By:                             JCL EXPDT:                        

         SMS MGMTCLS:                                                              

        ----------------------------- END OF RECORD --------------------------------

    Figure 13 shows additional information for volume record PRD002.

    Figure 13 List Showing Additional Information for Volume Record PRD002

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR

    O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

        PRD002*     002            08/08/00              0001          Active       

         GENERAL INFORMATION:                                                       

         Media Desc:     CARTRIDGE               Unit Name:      3490               

         SL-Name:        PRD002                  Pool Name:      $$NOPOOL           

         Location:       MAINLIB                 Owner:          N74                

         Description:    PROD CARTS              Vendor Name:    IBM                

         Label Type:     NL                      Tape Format:    256TRACK-IDRC      

         Capacity Used:  00014MB 007%            Ret-Dataset:    0001               

         Data Uncomp:    00052MB                 Physical vol:                      

         Use Count:      00001                   EXCP Count:     00352              

         Last Access:                            By Job:                            

         Last Modified:  08/08/00                By User:        N74AUP2            

         Move Date:                              Return Date:                       

         Check-In Date:  08/08/00                Clean Date:                        

         Scratch Date:                           Last Label:     0001               

         Tape Library:                           Stk Group:                         

         MULTI-VOLUME:                                                              

         Volume Seq:     002                     First Volume:   PRD001             

         Next Volume:    PRD003                  Prev Volume:    PRD001             

The MULTI-VOLUME data indicates that this volume is the second in the chain and that the next volume in the chain is PRD003. In addition, because the data set spans to the third volume, the file count for this volume is 0001, and the last label is 0001. This is correct.

ResolutionLink copied to clipboard

Use the DSNUPD function of the CTTMUP utility to update data set record DSN.PRD01 with the correct number of volumes (VOLSNUM=3) and use the GRPBIX function to correct the index pointers for the multi-volume chain.

Figure 14 Sample JCL for the DSNUPD and GRPBIX Functions

CopyCopied to clipboard
//I600INDB JOB  ,IOA600,MSGCLASS=X,CLASS=A
//*  THIS JOB UPDATES THE MDB ACCORDING TO USER'S INPUT
//CTTMUP  EXEC CTTMUP
//SYSIN    DD *
TYPERUN    MODE=NORMAL
DSNUPD     DSVOLSER=PRD001,DSLABEL=1,DSNAME=DSN.PRD01,VOLSNUM=3
GRPBIX     VOLSER=PRD001
/*
//

Problem 2 – Incorrect Number of Volumes Containing a Data SetLink copied to clipboard

CopyCopied to clipboard
CTT990E RBA 000108: VOLSNUM (002) DIFFERS FROM # OF VOLUME RECORDS FOUND(001)
CTT999I D DSN.PRM04                           PRM004  001

Data set record DSN.PRM04 indicates that the data set spans two volumes, but only one volume was found containing this data set.

ProcedureLink copied to clipboard

  1. In the Inquire/Update entry panel (TI), enter the DSNAME of the problem data set.

  2. Set DISPLAY TYPE toD.

  3. Press Enter.

    • The Media Database list is displayed.

      Figure 15 Media Database List

      CopyCopied to clipboard
      DATABASE LIST < D / D  > --------------------------------------------------(TI)
      COMMAND ===>                                                    SCROLL===> CRSR

      O ---DATASET NAME-----------------------------   VOLSER  RETENTION  STATUS    

        DSN.PRM04                                      PRM004  08/08/00   Active    

      ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======

          Specify option S (Volume list) to the left of the dataset name.

      DATABASE LIST < D / D  > --------------------------------------------------(TI)

          COMMAND ===>                                                    SCROLL===> CRSR

      O ---DATASET NAME-----------------------------   VOLSER  RETENTION  STATUS    

          S DSN.PRM04                                  PRM004  08/08/00   Active    

      ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======

      The list of volumes containing this data set is added to the display, as shown in Figure 16. Only one volume is displayed for data set DSN.PRM04, indicating that this is not a multi-volume data set. In addition, there is no asterisk to the right of the volser field, which means that this volume is not part of a multi-volume chain.

      Figure 16 List of Volumes Containing the Data Set

      CopyCopied to clipboard
      DATABASE LIST < D / D  > --------------------------------------------------(TI)
      COMMAND ===>                                                    SCROLL===> CRSR

      O ---DATASET NAME-----------------------------   VOLSER  RETENTION  STATUS    

          A DSN.PRM04                                  PRM004  08/08/00   Active    

      A  PRM004                                Files: 0001

       ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
  4. Specify OptionA (Additional Information) for both the data set and the volume containing it.

    The additional information is added to the display. The following screen contains the additional information for data set DSN.PRM04. Note that the # of Volumes field contains a value of 002. This is an error.

    Figure 17 List Showing Additional Information for Data Set DSN.PRM04

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

        DSN.PRM04                                         0001        Active      

        GENERAL INFORMATION:                                                      

        Sequence #:     0001                    # of Volumes:   002               

        Rec Format:     FB                      Rec Length:     00080             

        Block Size:     00080                   Block Count:    00048             

        Compsize:       *                       Tape Format:    256TRACK-IDRC     

        Uncomp Size:    *                                                         

        Use Count:      00001                   EXCP Count:     00121             

        Modified:       08/08/00                By User:        N74AUP2           

        Job Account:                                                              

        Stk Group:                                                                

        RETENTION INFORMATION:                                                    

        Source:         RULES                                                     

        Retention:      CATALOG                                                   

        CREATION INFORMATION:                                                     

        Date:           07/07/00                Time:           06:12             

        Job Name:       JOB2                    Step Name:      STEP2             

        PGM Name:       PGM2                    DD Name:        DDNAME2           

        UCB Addr:       0481                    CPU ID:         ESA1              

        Created By:     M72                     JCL EXPDT:                        

        SMS MGMTCLS:                                                              

    Figure 18 shows additional information on volume PRM004.

    Figure 18 List Showing Additional Information for Volume PRM004

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

       PRM004           3490        08/08/01             0001          Active      

         GENERAL INFORMATION:                                                      

         Media Desc:     CARTRIDGE               Unit Name:      3490              

         SL-Name:        PRM004                  Pool Name:      $$NOPOOL          

         Location:       MAINLIB                 Owner:          N74               

         Description:    CARTRIDGE               Vendor Name:    IBM               

         Label Type:     SL                      Tape Format:    256TRACK          

         Capacity Used:  000014MB 007%           Ret-Dataset:    0001              

         Data Uncomp:    000052MB                Physical vol:                     

         Use Count:      00000                   EXCP Count:     00243             

         Last Access:                            By Job:                           

         Last Modified:  08/08/00                By User:                          

         Move Date:                              Return Date:                      

         Check-In Date:  08/08/00                Clean Date:                       

         Scratch Date:                           Last Label:     0001              

         Tape Library:                           Stk Group:                        

    No MULTI-VOLUME data exists for this volume. In addition, because the data set spans to the third volume, the file count for this volume is 0001, and the last label is 0001.

ResolutionLink copied to clipboard

  1. Run the CTTRPT utility to determine if there is another volume record that refers to this volume in the PREVVOL or FIRSTVOL field. Figure 19 shows a sample JCL for activation of CTTRPT for this search:

    Figure 19 Sample JCL for CTTRPT Activation

    CopyCopied to clipboard
    //REPORT1 JOB ,CTT,CLASS=A,MSGCLASS=X
    //CTTRPT  EXEC CTTRPT,REGION=32M

    //SYSIN    DD  *

     EXTRACT   PATH=VOLUME/FIRSTDS

     INCLUDE   FIRSTVOL=PRM004

     INCLUDE   PREVVOL=PRM004

     REPORT    NAME=GENERAL,PAGESIZE=63,LINESIZE=256,MARGINS=1-256

     FIELDS    VOLSER,DSNAME

     SORTBY    VOLSER
  2. If no such volume is located, it indicates that the data set record is in error.

    Use the DSNUPD function of the CTTMUP utility to update data set record DSN.PRM04 with the correct number of volumes (VOLSNUM=1). It is not necessary to rebuild the index pointers for this multi-volume chain after resolving this problem.

Problem 3 – Volume Chain ErrorLink copied to clipboard

CopyCopied to clipboard
CTT983E RBA 000200: VOL: HIS001 CHAIN ERROR: INVALID PREV/NEXT POINTERS
CTT999I V HIS001 SEQ:001 FIRST:HIS001             NEXT:HIS002
CTT983E RBA 000201: VOL: HIS002 CHAIN ERROR: INVALID PREV/NEXT POINTERS
CTT999I V HIS002 SEQ:002 FIRST:HIS001

An error was detected in a multi-volume chain. The values for the PREVVOL and/or NEXTVOL fields are missing or invalid. Determine which of the pointers are wrong or missing. The volume records need to be updated with the correct PREVVOL and NEXTVOL information. The index pointers for this multi-volume chain only need to be rebuilt if the data set is not listed for each volume in the chain.

In this example, the Inquire/Update screen (TI), indicates that the volumes are part of a multi-volume chain for data set, DSN.HIS01, but the Additional Information screen (A) for volume HIS002 indicates that the Prev Volume pointer is missing.

ProcedureLink copied to clipboard

  1. In the Inquire/Update entry panel (TI), enter the VOLSER of the volume in question.

  2. Set DISPLAY TYPE toV.

  3. Press Enter.

    The Media Database list is displayed.

  4. Specify OptionG (Group) to the left of the problem volume (HIS001) to display the volumes in the multi-volume chain.

    The volume HIS002 is not followed by an asterisk, indicating that it is not part of a multi-volume chain. This is an error

  5. Specify OptionA (Additional Information) for volumes HIS001 and HIS002.

    Figure 20 List of Volumes in the Multi-Volume Chain

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
     COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

     A HIS001*      001            12/12/00              0001          Active      

        HIS001*     001            12/12/00              0001          Active      

         DSN.HIS01  002                                    0001        Active      

     A  HIS002                     12/12/00              0001          Active      

         DSN.HIS01                                         0001        Active      

     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
  6. Press Enter.

    Additional information for volume record HIS001 is displayed.

    Figure 21 List Showing Additional Information for Volume Record HIS001

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)

     COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

       HIS001*     001             12/12/00             0001          Active       

         GENERAL INFORMATION:                                                      

         Media Desc:     CARTRIDGE               Unit Name:      3490              

         SL-Name:        HIS001                  Pool Name:      $$NOPOOL          

         Location:       MAINLIB                 Owner:          N74               

         Description:    CARTRIDGE               Vendor Name:    IBM               

         Label Type:     SL                      Tape Format:    256TRACK          

         Capacity Used:  00000MB 000%            Ret-Dataset:    0001              

         Data Uncomp:    00000MB                 Physical vol:                     

         Use Count:      00000                   EXCP Count:     00000             

         Last Access:                            By Job:                           

         Last Modified:  08/08/00                By User:        N74AUP2           

         Move Date:                              Return Date:                      

         Check-In Date:  08/08/00                Clean Date:                       

         Scratch Date:                           Last Label:     0001              

         Tape Library:                           Stk Group:                        

         MULTI-VOLUME:                                                             

         Volume Seq:     001                     First Volume:   HIS001            

         Next Volume:    HIS002                  Prev Volume:

    HIS002 is specified as the NextVolume in the MULTI-VOLUME data at the bottom of this screen.

    Figure 22 shows additional information for volume HIS002.

    Figure 22 List Showing Additional Information for Volume HIS002

  7. CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
     COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

        HIS002                     12/12/00              0001          Active      

         GENERAL INFORMATION:                                                      

         Media Desc:     CARTRIDGE               Unit Name:      3490              

         SL-Name:        HIS002                  Pool Name:      $$NOPOOL          

         Location:       MAINLIB                 Owner:          N74               

         Description:    CARTRIDGE               Vendor Name:    IBM               

         Label Type:     SL                      Tape Format:    256TRACK          

         Capacity Used:  00000MB 000             Ret-Dataset:    0001              

         Data Uncomp:    00000MB                 Physical vol:                     

         Use Count:      00000                   EXCP Count:     00000             

         Last Access:                            By Job:                           

         Last Modified:  08/08/00                By User:        N74AUP2           

         Move Date:                              Return Date:                      

         Check-In Date:  08/08/00                Clean Date:                       

         Scratch Date:                           Last Label:     0001              

         Tape Library:                           Stk Group:                        

         MULTI-VOLUME:                                                             

         Volume Seq:     002                     First Volume:   HIS001            

          Next Volume:                            Prev Volume:                     

The Prev Volume field is blank. This is an error.

ResolutionLink copied to clipboard

Use the VOLUPD function of the CTTMUP utility to update the PREVVOL pointer in the volume record, HIS002.

Figure 23 Sample JCL for the VOLUPD Function

CopyCopied to clipboard
//I600INDB JOB  ,IOA600,MSGCLASS=X,CLASS=A                             
//*  THIS JOB UPDATES THE MDB ACCORDING TO USER'S INPUT                
//CTTMUP  EXEC CTTMUP                                                  
//SYSIN    DD *                                                        
TYPERUN    MODE=NORMAL                                                 
VOLUPD     VOLSER=HIS002,PREVVOL=HIS001
/*                                                                     
//

Problem 4 – Volume Chain Sequence ErrorLink copied to clipboard

CopyCopied to clipboard
CTT983E RBA 000205: VOL: DBA003 CHAIN ERROR: VOLUME OUT OF SEQUENCE
CTT999I V DBA003 SEQ:005 FIRST:DBA001 PREV:DBA002 NEXT:DBA004

Volume record DBA003 that is part of a multi-volume chain has an invalid volume sequence number. Volume sequence numbers in a multi-volume chain must be consecutive. The volume record needs to be updated with the correct VOLSEQ data.

ProcedureLink copied to clipboard

  1. In the Inquire/Update entry panel (TI), enter the VOLSER of the volume in question.

  2. Set DISPLAY TYPE toV.

  3. Press Enter.

    The Media Database list is displayed.

  4. Specify OptionG (Group) to the left of the problem volume (DBA003), and specify OptionA (Additional Information) for this volume.

    The volumes in the multi-volume chain are displayed. Note that VOLSEQ number 005 is indicated for volume DBA0003.

    Figure 24 List of Volumes in the Muti-Volume Chain

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
     COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

        DBA003*     005            12/12/00              0001          Active      

         GENERAL INFORMATION:                                                      

         Media Desc:     CARTRIDGE               Unit Name:      3490              

         SL-Name:        DBA003                  Pool Name:      $$NOPOOL          

         Location:       MAINLIB                 Owner:          N74               

         Description:    CARTRIDGE               Vendor Name:    IBM               

         Label Type:     SL                      Tape Format:    256TRACK          

         Capacity Used:  00000MB 000%            Ret-Dataset:    0001              

         Data uncomp:    00000MB                 Physical vol:                     

         Use Count:      00000                   EXCP Count:     00000             

         Last Access:                            By Job:                           

         Last Modified:  08/08/00                By User:        N74AUP2           

         Move Date:                              Return Date:                      

         Check-In Date:  08/08/00                Clean Date:                       

         Scratch Date:                           Last Label:     0001              

         Tape Library:                           Stk Group:                        

         MULTI-VOLUME:                                                             

         Volume Seq:     005                     First Volume:   DBA001            

         Next Volume:    DBA004                  Prev Volume:    DBA002            

        ----------------------------- END OF RECORD --------------------------------

    The following screen shows the additional information fields for volume DBA003.

    Figure 25 List of Additional Information for Volume DBA003

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
     COMMAND ===>                                                    SCROLL===> CRSR

     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----

       DBA003*      005            12/12/00              0001          Active      

        DBA001*     001            12/12/00              0001          Active      

        DBA002*     002            12/12/00              0001          Active      

     A  DBA003*     005            12/12/00              0001          Active      

        DBA004*     004            12/12/00              0001          Active      

     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< =====

    In the MULTI-VOLUME data at the bottom of the screen, DBA002 is indicated as the previous volume in the multi-volume chain, and DBA004 is indicated as the next volume. Because the previous screen showed that these volumes (DBA002 and DBA004) have volume sequence numbers of 002 and 004 respectively, it is apparent that the correct volume sequence number for volume DBA003 is 003.

ResolutionLink copied to clipboard

Use the VOLUPD function of the CTTMUP utility to set the correct sequence number (VOLSEQ=3).

Figure 26 Sample JCL for the VOLUPD Function

CopyCopied to clipboard
//I600INDB JOB  ,IOA600,MSGCLASS=X,CLASS=A                             
//*  THIS JOB UPDATES THE MDB ACCORDING TO USER'S INPUT                
//CTTMUP  EXEC CTTMUP                                                   
//SYSIN    DD *                                                        
TYPERUN    MODE=NORMAL                                                 
VOLUPD     VOLSER=DBA003,VOLSEQ=3
/*                                                                     
//

Problem 5 – Incorrect Number of Active Data Sets on a VolumeLink copied to clipboard

CopyCopied to clipboard
CTT987E RBA 000208: ACTIVEDS (006) DIFFERS FROM # OF DSN RECORDS FOUND            (003)
CTT999I V MF0001 SEQ:000

A logical error was detected in a volume record. Volume record field ACTIVEDS specifies the number of active data sets on the volume. This field must contain the same number of data sets as the CTTIDB utility found on the volume.

Use the Inquire/Update screen (TI) to verify the correct number of data sets on the volume and update the ACTIVEDS field in the volume record. In this example, the Inquire/Update screen indicates that volume MF0001 contains three data sets but the FILES field indicated that the volume has six files.

ProcedureLink copied to clipboard

  1. In the Inquire/Update entry panel, enter the VOLSER of the volume in question.

  2. Set DISPLAY TYPE toV.

  3. Press Enter.

    The Media Database list is displayed.

  4. Specify OptionS (Dataset List) to the left of the problem volume (DBA003).

    The data sets stored on the volume are displayed.

    Figure 27 List of Data Sets Stored on the Volume

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI) 
    COMMAND ===>                                                    SCROLL===> CRSR
     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----
       MF0001                       12/12/00             0006          Active      
        D.MF1#1                                            0001        Active      
        D.MF1#2                                            0002        Active      
        D.MF1#3                                            0003        Active      
     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======

    Although only three data sets are stored on this volume, the volume record indicates that there are six.

ResolutionLink copied to clipboard

  1. Specify OptionU (Update) for volume MF0001.

    Figure 28 List Showing Volume Update Panel

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR
     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----
     U MF0001                       12/12/00             0006          Active      
        D.MF1#1                                            0001        Active      
        D.MF1#2                                            0002        Active      
        D.MF1#3                                            0003        Active      
     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
    The Volume Update panel is displayed.
    VOLUME UPDATE PANEL                          (TI.UV)
     COMMAND ===>                                                    SCROLL===> CRSR
     -------------------------------------------------------------------------------
     ¼ VOLSER       MF0001                             STATUS      Act-Out          
         ¼ GENERAL INFORMATION:                                                     
         ¼ SL-NAME      MF0001                             OWNER       N74         
         ¼ MEDIA TYPE   3490                               MEDIA DESC  CARTRIDGE   
         ¼ DESCRIPTION  CARTRIDGE                          VENDOR NAME IBM         
         ¼ STK GROUP                                                               
         ¼ RETENTION & LOCATION INFORMATION:                                       
         ¼ RETENTION    DATE         121200                RET-DATASET 001         
         ¼ LOCATION     MAINLIB                            MOVE DATE   090900      
         ¼ CHECKIN DATE 080800                             RETURN DATE             
         ¼ TAPE LIBRARY                                                            
         ¼ USAGE INFORMATION:                                                      
         ¼ ACTIVE DS#   0006                               LAST LABEL  0006        
         ¼ CAPACITY USD 00000 (MB) 000%                    EXCP COUNT  00000       
         ¼ DATA UNCOMP  00000 (MB)                                                 
     ¼ LAST ACCESS  080800                             BY JOB      JOB5            
         ¼ CLEAN COUNT  00000                              CLEAN DATE              
         ¼ USER INFORMATION:                                                       
         ¼ USER FIELD                                                              
  2. Correct the value in fields ACTIVE DS# and LAST LABEL and return to the data set list.

  3. Press (PF03/PF15) to save the update and to exit the Volume Update panel.

    A confirmation window is displayed. Note that 006 is still specified for the FILES field.

    Figure 29 Volume Update Confirmation Window

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
    COMMAND ===>                                                    SCROLL===> CRSR
     O VOLSER    VOLS        +-----------------------+  FILES LOCATION ---STATUS----
     U MF0001         <----- |   CONFIRM Y   (Y/N)   |   0006          Active      
        D.MF1#1              +-----------------------+     0001        Active      
        D.MF1#2                                            0002        Active      
        D.MF1#3                                            0003        Active      
     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
  4. Enter Y to confirm the change.

    After confirmation, the FILES specification is updated.

    Figure 30 Files Specification Update Window

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI)
     COMMAND ===>                                                    SCROLL===> CRSR
     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----
       MF0001           3490        12/12/00             0003          Act-Out     
        D.MF1#1                                            0001        Active      
        D.MF1#2                                            0002        Active      
        D.MF1#3                                            0003        Active      
     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======

Problem 6 – Missing Index KeyLink copied to clipboard

CopyCopied to clipboard
CTT984E RBA 000303: KEY NOT FOUND. RECTYPE: D, MISSING KEY: L
CTT999I D DSN.L0006                                    L00006 001

A data set record with no L-type index record (key) was detected. Use the Inquire/Update screen (TI) to verify the data set and volume.

The data set record for data set DSN.L0006 indicates that it is stored on volume L00006, but the data set list for this volume does not list the data set (although it does indicate the number of files is equal to 0001)..

ProcedureLink copied to clipboard

  1. In the Inquire/Update entry panel, enter the DSNAME of the problem data set (DSN.L0006).

  2. Set DISPLAY TYPE toD.

  3. Press Enter.

    The Media Database list is displayed.

    Figure 31 Media Database List

    CopyCopied to clipboard
    DATABASE LIST < D / D  > --------------------------------------------------(TI) 
    COMMAND ===>                                                    SCROLL===> CRSR O 
    ---DATASET NAME-----------------------------   VOLSER  RETENTION  STATUS    
       DSN.L0006                                      L00006  CATALOG    Active    
        L00006                                Files: 0001
     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
  4. Specify OptionS (Volume list) to the left of the problem data set.

    The problem volume is displayed.

  5. Return to the Inquire/Update screen (TI) and specify the volser and display typeV.

    The volume information for volser L00006 is displayed.

    Figure 32 List of Volume Information for Volser L00006

    CopyCopied to clipboard
    DATABASE LIST < V / V  > --------------------------------------------------(TI) 
    COMMAND ===>                                                    SCROLL===> CRSR
     O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----
       L00006           3490        12/12/00             0001          Active      
     ====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
  6. Specify OptionS (Dataset list) to the left of the problem volume.

    No data sets are listed for this volume. This is due to the index problem under examination.

ResolutionLink copied to clipboard

Use the CTTMUP utility to rebuild the index pointers for VOLSER=L00006 and the relevant data set records.

Figure 33 Sample JCL for the CTTMUP Utility

CopyCopied to clipboard
//I600INDB JOB  ,IOA600,MSGCLASS=X,CLASS=A                             
//*  THIS JOB UPDATES THE MDB ACCORDING TO USER'S INPUT                
//CTTMUP  EXEC CTTMUP                                                  
//SYSIN    DD *                                                        
TYPERUN    MODE=NORMAL                                                 
VOLBIX     VOLSER=L00001
/*   
//