The Retrieve  Save File Description  command retrieves  the information
you  see at  the  top of  a  DSPSAVF display  and returns  one  or more
parameters  to a  CL program.   The  command cannot  be used on  a save
file created by the SAV command.

The typical command would be entered as:

           DCL        &SAVLIB *CHAR LEN(10)
            .
           RTVSAVFD   SAVF(xxx) SAVLIB(&SAVLIB)

If there are no records in  the save file, blanks and zeros  are placed
in the return values.  You can check for just this by specifying:

           DCL        &RECORDS *DEC LEN(10 0)
            .
           RTVSAVFD   SAVF(xxx)
           IF         (&RECORDS *EQ 0) DO /* No records */

The information is accessed by using the QSRLSAVF API.

RTVSAVFD  operates on  save files  where  the objects  were saved  from
libraries  (including SAVSECDTA).   It will  not function on  a save of
IFS objects such as *STMF.

Command parameters                                    *CMD
------------------

   SAVF          The  qualified file  name  of  the  save  file.    The
                 library value  defaults to  *LIBL.   *CURLIB may  also
                 be specified.

   RTNLIB        The library  of the save file.   This must be declared
                 as *CHAR LEN(10).  This  parameter can be useful if  a
                 value of *LIBL  or *CURLIB was  used as the  save file
                 library.

   SAVLIB        The library  that the objects  were saved from.   This
                 must be declared as *CHAR LEN(10).

   ASP           The  ASP of the  library the objects  were saved from.
                 If the ASP number  is greater than 32, the  value will
                 be  returned as  '00' and  the ASPDEVNAM  value should
                 be  used.  This is an  optional parameter that if used
                 must be declared as *CHAR LEN(2).

   ASPDEVNAM     The device  name assigned  to  the ASP.   This  is  an
                 optional parameter  that if used  must be  declared as
                 *CHAR LEN(10).

   RECORDS       The  number of records  in the  save file.   This must
                 be declared as *DEC LEN(10  0).  Records written to  a
                 save file have a length of 528 bytes.

   SAVCMD        The  save command  used  to  save  to the  save  file.
                 This must be declared as *CHAR LEN(10).

   SAVACT10      An  indication of whether  the save occurred  with the
                 SAVWHLACT  parameter.   This  is the  new form  of the
                 parameter  and  will  return  the  values  *LIB,  *NO,
                 *SYNCLIB, SYSDFN,  or *YES.  This must  be declared as
                 *CHAR LEN(10).

   SAVCENT       The  century of  the save.   This must  be declared as
                 *CHAR LEN(1).

   SAVDATE       The date  the  save  file  was written  to  in  YYMMDD
                 format.  This must be declared as *CHAR LEN(6).

   SAVTIME       The  time  the save  file  was  written to  in  HHMMSS
                 format.  This must be declared as *CHAR LEN(6).

   RELLVL        The  release level  the save was  performed to.   This
                 must be declared  as *CHAR  LEN(6).   The value  (e.g.
                 V2R2M0) reflects the TGTRLS parameter of the save.

   DTACPR        Whether the save is  compressed or not.  This  must be
                 declared  as  *CHAR  LEN(1).     A  Y  or  N  will  be
                 returned.

   OBJECTS       The  number of  objects in the  save file.   This must
                 be declared as *DEC LEN(10 0).

   ACCPTHS       The  number of  access  paths  that have  been  saved.
                 This must be declared as *DEC LEN(10 0).

   SRLNBR        The  serial number  of the  system that  performed the
                 save.  This must be declared as *CHAR LEN(8).

   SAVWHLACT     This  is the old  form of the SAVACT10  parameter.  It
                 will  return  the   first  4   bytes  of  the   values
                 described  for SAVACT10.   This  must  be declared  as
                 *CHAR LEN(4).

Restrictions
------------

Because  the command  returns values, it  can only  be entered in  a CL
program.

The command cannot be used on a  save file created by the SAV  command.

Prerequisites
-------------

The following TAA Tools must be on your system:

          CRTUSRSPC     Create user space
          CVTDTS        Convert DTS
          SNDESCMSG     Send escape message
          SNDSTSMSG     Send status message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type        Attribute      Src member    Src file
   ------        ----        ---------      ----------    ----------

   RTVSAVFD      *CMD                       TAASAVK       QATTCMD
   TAASAVKC      *PGM           CLP         TAASAVKC      QATTCL