   Q U E R Y V S   -  Platform: MVS/TSO


This program is a HILMAS program to display features of a VSAM file.


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

QUERYVS.OBJ              executable for MVS/TSO mainframe, in obj form
QUERYVS.HIL              Hilmas source of this file 
README.TXT               this help file 
LINKEDIT.JCL             job example to install QUERYVS
QUERY.REX                a REXX clist example to use QUERYVS in =3.4 file list

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 QUERYVS.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 TSO users (i.e. in  //JOBLIB ) or a linklist library
  (in this case, you must refresh linklist with F LLA,REFRESH command)

- SEND REXX example program QUERY.REX (with ASCII CRLF ) in CLIST MVS library,  
  with this command:

      SEND QUERY.REX 'SYS1.EXEC.SOURCE(QUERY)' ASCII CRLF

  (change library and clist names to fit your needs)



Program instruction:

   This program open in input the specified file, then use Hilmas macros (i.e.
SHOWCB VSAM macro) to collect and display VSAM features.

   To run QueryVS program thru QUERY clist, write in a ISPF/TSO session,
in command line:

       TSO QUERY 'physical.file.name'

or, in ISPF =3.4 phisical file list, write 'QUERY' left to a chosen file name.

REXX clist, if file is a VSAM file, allocate it and recall QUERYVS to display
its features.
