VVDSFIX is an unsupported VSAM utility used to correct problems with catalogs and VVDS entries.

Answer

• • • Description:
      
      VVDSFIX is an unsupported utility provided by IBM to fix catalogs and vvds errors that require bypassing catalog controls. Below is a list of functions that the utility provides. This tool should be used under the advisement of IBM support. Please also reference II14830 for news and current version of the tool.
      
      
      
      Resolution:
      
      BWOFIX BWOFIX blindly goes into a VVR and sets the 3 fuzzy bits to zero.
      
      WTOR format: REPLY n,BWOFIX
      SYSIN format: CMD=BWOFIX;
      
      CATNAME Changes the CATALOG name in the VVRs. If the catalog name is missing, enter the characters "BLANK" as the old name and the new name will be inserted in the VVR or NVRs that don't have a CATNAME.
      
      WTOR format: REPLY n,CATNAME;oldname;newname;
      SYSIN format: CMD=CATNAME;oldname;newname;
      
      CHECK is used to check the VVDS, control information, and each VVR. CHECKX is used to read and check each field for correct contents. A message is issued if any bad data is detected. Bad VVRs can be deleted with IDCAMS or ZAPed with this program. Use the CHECKX form of this command to indicate that you would like VVDSFIX to attempt to correct bad VVRs. Under some circumstances, such as for out of sync space maps, the CHECK command will also repair bad VVRs.
      
      WTOR format: Reply n,CHECK
      SYSIN DD command format: CMD=CHECK;
      
      DEFERD goes blindly goes thru the VVDS and changes all non-VSAM non-GDGs NVRs from deferred to non deferred status. It also updates the BCS record.
      
      WTOR format: REPLY n,DEFERD
      SYSIN format: CMD=DEFERD;
      
      DELBCSR will erase a BCS record. The purpose of this command is to erase a catalog record that has a bad entry name. It will find things such as a special character within the record name that IDCAMS thinks is not allowed and normally prevents the DELETE from working.
      
      For the "ENTER NAME" prompt you can enter a character string, e.g. MY.DATA.SET, or a HEX string, e.g. X'D4E84BC4C1E3C14BE3C5E3. Note that the HEX input does not end with a quote and upper and lower case is checked. You can enter up to 115 characters.
      
      VVDSFIX will go through the BCS and erase ALL catalog records with this name. The search for the name is done with 'KEY GREATER OR EQUAL'. If an exact match is not found and the input is from prompts, you will be prompted to see if the name found is the correct
      name. If input is from SYSIN, VVDSFIX exits without erasing anything.
      
      If a CLUSTER name is given, the DATA and INDEX parts are erased. If a DATA or INDEX name is given, it's specific record and the CLUSTER record are deleted. The associated INDEX or DATA component VVR is not deleted; you will need to specifically delete it
      also. An additional DD card is required, CATDD. Note that once the desired entry is delete, the catalog may need to be closed and reopened to refresh cache data.
      
      WTOR formats:
      REPLY n,DELBCSR;name;
      REPLY n,DELBCSR;X'D1C1C3D2004BC5D5C4 (e.g.JACK .END)
      SYSIN formats:
      CMD=DELBCSR;name;
      CMD=DELBCSR;X'D1C1C3D2004BC5D5C4 (e.g.JACK .END)
      
      DELVVR deletes a VVR from the VVDS via prompts. The program will ask you for the VVR name and the catalog name. You can enter either a cluster name or a component name. If you enter a component name, the 1st VVR matching the description will be erased. If there are multiple VVRs, you will need to repeat the DELVVR command with the same names. If a cluster name is entered, the complete VVDS is searched and every VVR matching that name is erased. Note that the CATALOG name is optional, but providing it will eliminate getting the wrong VVR if there are duplicate VVRs.
      SYSIN DD command format:
      CMD=DELVVR;component name;Y;CO|CL;catalog name;
      CMD=DELVVR;component name;Y;CO|CL;;
      
      
      TIMESTAMP adds timestamp cells to VVR in the VVDS.
      SYSIN DD command format:
      CMD=TIMESTAMP;
      
      
      ZAPVVR is a ZAP function for VVRs. Via prompts, the program will ask you for the VVR name and the catalog name. You need to enter in a component name and optionally a catalog name. Do not enter in a CLUSTER name. You must VER before the REPs can be used.
      Note that the offset in the VER/REP MUST BE a 3 byte value, i.e, REP 00C C1C2 is OK, REP 000C C1C2 will fail.
      Note that there are no spaces between in or between the data, i.e., VER 002 C1C2C3C4 is OK, VER 002 C1C2 C3C4 is bad.
      SYSIN DD command format:
      CMD=ZAP;name;VER 000 0000;REP 000 0000;END;
      CMD=ZAP;RBA=00000000;VER 000 0000;REP 000 0000;END;
      
      
      Use this tool under the advisement of IBM Support. VVDSFIX is not intended to be an alternative to supported utilities such as IDCAMS.
      
      
      NOTE: It is recommended that backups are taken of the VVDS's, Volumes, or Catalogs that are being affected. Furthermore, activity to the affected VVDS's, volumes, or Catalogs should be quiesced as much as possible to avoid concurrent I/O.