Back To LeighWeb Mainframe Utilities Page

 SCRATCH searches the MVS CATALOG for tape volumes for datasets of a given
 "dsnqual" or high-level qualifier and creates a TMS UPDATE FORM automatically.

 Note: the above statement means that un-cataloged tape volumes are not found,
 and sometimes catalog entries can remain even when the underlying volume has
 been re-used.  A $TINFO utility run against that catalog entry in 3.4 can
 reveal whether or not this has happend.  TMS utilities must be used to identify
 un-cataloged tape volumes which are not yet scratched.

 In keeping with UNIPAC's tape standards, in addition to looking for tape
 volumes beginning with a certain "dsnqual", it also looks for datasets
 beginning T.dsnqual and T.OFF.dsnqual.

 If you do not specify a "dsnqual" when invoking SCRATCH, it will look for your
 TSO id as the "dsnqual".

 Once SCRATCH has created the TMS UPDATE FORM, you are taken into an edit on the
 file containing the form.  Since SCRATCH does not know which tapes you really
 want to scratch, you must DELETE ANY TAPES ON THE LIST THAT YOU WANT TO KEEP!

 Once you've pared down the list of tape datasets, you can save the dataset
 (type SAVE on the command line and press ENTER), and print it off (an easy way
 to do this is to type PRINTIT on the command line and press ENTER).

 Per UNIPAC procedures, you must sign the form and your supervisor must sign the
 form.  Since the form already contains distribution routing information, you
 can just drop your signed form in a distribution bin and that's that!

 To invoke SCRATCH, simply type:

 tso scratch

 on the command line and press ENTER.

 If you want to specify a specific dsnqual, simply type:
                              +-------------------------------------+
 tso scratch dsnqual(?????)   ³where "?????" might be something like³
                              ³"TST2B" or "TST28"                   ³
                              +-------------------------------------+
 on the command line and press ENTER.