   E X E C I O V S -  Platform: MVS/TSO


   This utility is a REXX interface to use VSAM files in REXX programs.
Is similar to EXECIO, but instead of sequential files, can manage
VSAM files.


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

EXECIOVS.OBJ             executable for MVS/TSO mainframe, in obj form
EXECIOVS.HIL             Hilmas source of this file
MAN_ENG.TXT              Manual of this utility in English
MAN_ITA.TXT              Manual of this utility in Italian
README.TXT               this help file 
LINKEDIT.JCL             job example to install EXECIOVS
VSAMUTIL.REX             a REXX clist example to use EXECIOVS 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 EXECIOVS.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 VSAMUTIL.REX (with ASCII CRLF) in CLIST MVS library,
  with this command:

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

  (change library and clist names to fit your needs)



Program instruction:

   You must read the manual MAN_ENG.TXT for details to use of EXECIOVS.
For a REXX Demo of this routine, try VSAMUTIL.

   To run VSAMUTIL, write in a ISPF/TSO session, in command line:

       TSO VSAMUTIL 'physical.file.name'

or, in ISPF =3.4 phisical file list, write 'VSAMUTIL' left to a chosen file name.
VSAMUTIL, if file is a VSAM file, allocate it and recall EXECIOVS to manage
its records.

This menu is displayed:

     +------------------------------------------------------------+
     |  Write what to do with file VSAM  :                        |
     |                                                            |
     |      1 - BROWSE - View some records                        |
     |      2 - ADD    - Add a record (only ESDS or KSDS)         |
     |      3 - UPDATE - Update a record  (only KSDS)             |
     |      4 - DELETE - Delete a record  (only KSDS or RRDS)     |
     |          (ENTER to exit)                                   |
     |                                                            |
     |                                                            |

and, if you answer for example, 1, program display this requests:

     |                                                            |
     |     Write initial key for a KSDS BROWSE in the form:       |
     |        '....' o X'....' (in exadecimal)                    |
     |     Write initial record number for a RRDS BROWSE          |
     |     ENTER for start of file (mandatory for ESDS)           |
     |                                                            |

and then:

     |                                                            |
     |     Write number of record to view (ENTER for 20 records)  |
     |                                                            |

and finally the program display on the screen the requested number
of records of your VSAM file.

