   V T O C V I E W  -  Platform: MVS batch


   An utility to do display the content of a disk VTOC (that is every
type of DSCB record contained in a VTOC)


   In this distribution file (VTOCVIEW.ZIP) there is:

VTOCVIEW.OBJ            executable for MVS mainframe, in obj form
VTOCVIEW.HIL            Hilmas source of this file
README.TXT              this help file 
LINKEDIT.JCL            job example to install VTOCVIEW
VTOCVIEW.JCL            job example to use VTOCVIEW


OBJ installation:

- Create in MVS a sequential file, for example 'MYUSER.PROGRAM.OBJ'
  with RECFM=FB and LRECL=80, for example of 1 cylinder.

- SEND obj module from PC to MVS in this file in BINARY form, with your 
  3270 emulation; the most important thing is a binary transfer (therefore 
  without ASCII CRLF) in a file with record length of 80 bytes.
  Use this PC command (in a PC with IBM/PCOMM 4.1 3270 emulation installed):

     SEND VTOCVIEW.OBJ 'MYUSER.PROGRAM.OBJ'

- Prepare a Job to Linkedit transferred obj in a load library (possibily
  in Linklist): use LINKEDIT.JCL as example: fit this JCL to your needs
  changing library names

- Submit linkedit job to create load module; output library must be a
  load library used by your JCLs (i.e. in //JOBLIB ) or a linklist library
  (in this case, you must refresh linklist with F LLA,REFRESH command)



Program instruction:

  This program is similar to IBM utilities to view VTOC contents; see
VTOCVIEW.JCL example to run this utility; note that in this Jcl you must
set a DD to point to a disk you want view:

     //VTOCDD   DD UNIT=3390,VOL=SER=volname,DISP=SHR

were 'volname' is the Volume Name of your disk; VTOCDD is fixed.
If you run it without parameters in PARM=, only a brief summary is printed;
if you add some parameters you can obtain a print or a dump of DSCBs
(that is VTOC records) you want.
This is the list of parameters, that must be divided by a comma or semicolon.

    FORMAT= : Extract DSCB of the specified format; format can be from
              0 to 6; 0 format are not visible (with this utility), 1
              format are the most interesting because contains entryes
              of files
    DUMP    : view a dump (in hexadecimal) of DSCB records; is automatically
              setted if you view DSCB not Format 1
    NOH     : Remove header and page skip
    FULL    : view every DSCB in dump format
    DATE    : Add a date in a Format 1 listing (if you want mantain a
              history of your disk)
    PAGELEN=n : Page length  (default = 58)
    /VOLUME : don't write volume name (only for Format 1 listing)
    ONLY=   : Name selection of Dataset name in Format 1 listing:
              every qualifier can contain a star (*), a full name or a
              name followed or preceeded by a star, for example:
              Correct:   SYST*.PROCEDUR.*
                         SYS1.*OCEDUR.FIL*
                         *.PRO*.F*
              Wrong:     SYST.*OCE*.FILE
                         SYS1.PRO*RE.FILE


