Utilities › TMSPTRS Utility—Maintain Multivolume, Multi-Data Set Chains › Chaining Errors

Chaining Errors

TMSPTRS provides information on any errors with the chaining structures previously described. In most cases, CA 1 online access facilities (CA 1 ISPF or TIQ) of CA 1 allow corrections to be made to the database or three batch utilities can be used:

1. TMSUPDTE updates erroneous fields in Volume records.
2. TMSUDSNB updates erroneous fields in DSNB records or Control Record #2 (TMSCTL#2).
3. TMSAGGR clears and returns invalid used DSNBs to the free chain and constructs new DSNB chains for Volume records.

Additionally, the TMSBINQ utility can be used to provide detailed reporting of erroneous records when online inquiries are not practical.

If TMSPTRS ends with a nonzero condition code, errors are present in the TMC. The four types of chaining errors are:

1. Multivolume Chaining Errors

   Research of errors in multivolume chains involves determining whether:

   1. The volume(s) contains live data and should be part of a multivolume group.
   2. The volume(s) no longer has data which needs to be retained and should be returned to the scratch pool.

   This information can be obtained by displaying Volume record(s) in the TMC, examining system catalog information, dumping the contents of the tape, or a combination of the three.

2. Multi-Data Set Chaining Errors

   Research of errors in multi-data set chains involves determining whether:

   1. The volume(s) contains live secondary data sets and should have a proper chain of DSNBs.
   2. The volume(s) does not have secondary data sets and should be returned to scratch status, or the DSNBs referencing the volume should be cleared and returned to the free chain.

   This information can be obtained by displaying volume and DSNB record(s) in the TMC, examining system catalog information, dumping the contents of the tape, or a combination of the three.

3. Aggregate Chaining Errors
4. Control Record #2/DSNB Free Chain Errors