* EXECIOVS DOC * ----------------------------------------------- 20/02/93

                  Documentation of Program EXECIOVS

---------------------------------------------------------------- Rel. 1.0



    Program EXECIOVS is a VSAM/REXX interface: is similar to "EXECIO", 
 but instead of sequential files, can manage VSAM file, in 
 READ / BROWSE / WRITE / UPDATE.



                         D E S C R I P T I O N


    Complete syntax of command EXECIOVS is:

                  +        +
           +   +  ! DISKR  !
 EXECIOVS  ! n !  ! DISKW  ! ddname [ key ] [([V] STEM array. [FINIS]]
           ! * !  ! DISKU  !
           +   +  ! DISKD  !
                  + DISKWU +


 n = numbers of records to process;
 * = process all file from actual pointer to end, if file is in read
     access (DISKR) otherwise, if it is in update, in var.0 must be
     specified number of record to write or update

 DISKR = read access,
 DISKW = write access,
 DISKU = update access,
 DISKD = delete 1 record,
 DISKWU= write or update,   indifferently


 ddname is logical name by which VSAM file is accessed; this implies
        that before command EXECIOVS file must be allocated;
        for example:

            ALLOC FILE(ddname) DATA('name.phisical.file') SHR


 Parameter after ddname is optional and is used to seek the first
 record of I/O; default is first record of the file.
   KEY for KSDS, must be between quotes (') otherwise is implied that
       name is a REXX variable containing the key;
       can be omitted for DISKW, DISKU or DISKWU; is mandatory
       for DISKD; can be partial for DISKR: in this case '*'
       mean that are read all records with this partial key.

   NUM.REC. for RRDS, must be a number, otherwise is implied that
       name is a REXX variable containing the record number;
   RBA      for ESDS, must be a number, otherwise is implied that
       name is a REXX variable containing the RBA

 V     is optional and mean that the file have variable length records
       (default is fixed record length) and that, for DISKW and DISKWU
       written record length is contained in REXX variable.
 FINIS is optional (and dummy parameter), because file is always closed
       at program end (and is always opened at start)
 STEM var. is REXX array (stem) in which program put read records or
       get records to write in VSAM file.



