TAA Tools
SAVOWNOBJ       SAVE OWNED OBJECTS                     TAASAWG

The Saved  Owned  Objects command  saves objects  owned  by a  specific
user from a  named library.  A list of object types  may be named.  You
must  have  *SAVSYS special  authority to  use SAVOWNOBJ.   There  is a
limit of 300 objects that may be saved.

A typical command would be:

             SAVOWNOBJ   LIB(ABC) OWNER(TOM) DEV(TAP01) CLEAR(*ALL)

The objects owned by  TOM in the ABC  library would be saved to  TAP01.
The  default is  to  run the  CHKSAVRST  command with  ERRORSONLY(*YES)
after  the  save  occurs  to  provide  a  simple  review  of any  error
conditions.

A limit of 300 objects may be saved.

Attempting to save the same  name of an object  (such as a *FILE and  a
*PGM) is  prevented For example, if  you need to save  multiple objects
named ABC, multiple SAVOWNOBJ commands would be required.

SAVOWNOBJ escape messages you can monitor for
---------------------------------------------

      CPF2123    No objects exist of the type named
      TAA9894    No objects are owned by the specified user

Escape messages from based on functions will be re-sent.

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

   LIB           The library containing the objects to be saved.

   OWNER         The owner of the objects to be saved.

   DEV           The  device where  the save  should  occur to.   *SAVF
                 must be specified if a save file is to be used.

   VOL           The tape  volume  to  be checked.    *MOUNTED  is  the
                 default to  mean the volume  that is currently  on the
                 device.

                 A specific volume ID may be entered.

                 If  the device  specified is  a media  library device,
                 then  the  volume  specified should  be  the cartridge
                 identifier to be mounted and used.

   OBJ           The name or generic  name of the objects to  be saved.
                 The  default  is  *ALL  for  all object  names  to  be
                 considered.

   OBJTYPE       A  list of up  to 100 object  types to be  saved.  The
                 default is *ALL for all  object types.  For a list  of
                 the object types, use the command prompter.

   SEQNBR        The  sequence number  to  start  the save  operations.
                 The default  is 1.  A specific  sequence number may be
                 entered  in   a   range   of  1-99999.      For   more
                 information,  see the  same  parameter on  the  SAVLIB
                 command.

   ENDOPT        The  end operation  for the  device.   The  default is
                 *REWIND.   *LEAVE  or *UNLOAD  may also  be specified.
                 For more information,  see the  same parameter on  the
                 SAVLIB command.

                 If multiple  SAVOBJ commands are required  to write to
                 a  tape device,  *LEAVE is  specified for each.   When
                 the command  is  complete,  CHKTAP is  used  with  the
                 ENDOPT value specified.

   CLEAR         Whether to  clear the  files on  the volume  beginning
                 at  the  sequence  number  described.    *NONE is  the
                 default meaning  no active  data is  cleared.   If  an
                 active file  is encountered,  an inquiry message  will
                 result.

                 *ALL   may   be   specified   to  clear   all   files.
                 Expiration dates will not be considered.

                 The  following values  are the same  as various SAVxxx
                 commands.    For   more  information,  see   the  same
                 parameter on the SAVLIB command.

                 *AFTER may  be specified to clear all  files after the
                 first  volume.   An inquiry  message occurs  if active
                 files exist on the first volume.

                 *REPLACE may  be  specified  to clear  all  files  the
                 same as *ALL.

   SAVF          If  DEV(*SAVF)  is  specified, a  save  file  must  be
                 named.   The library  defaults to *LIBL.   *CURLIB may
                 also be specified.

   EXPDATE       The expiration date to be  used for the output  media.
                 The  default is  *DAY3  which means  3  days from  the
                 current date.

                 *PERM may be entered to make the file permanent.

                 The  special values *DAY1,  *DAY2 ...   *DAY60  may be
                 entered  to cause an  expiration date of 1,  2 ...  60
                 days from today.

                 A specific  date entered  in  job format  may also  be
                 used.

   DTACPR        Whether to  use data compress.  The  values are passed
                 thru   to  the  SAVLIB   command.     For  a  complete
                 understanding  of  the   parameter,  see  the   SAVLIB
                 command.

                 The default is *YES to compress the data.

                 *NO  may  be  specified  so   the  data  will  not  be
                 compressed.

                 *LOW may be specified to compress to a low degree.

                 *MEDIUM  may  be  specified to  compress  to  a medium
                 degree.

                 *HIGH may be specified to  compress to a high  degree.

   COMPACT       Whether to  use compaction as  the output  is written.
                 The   default  is  *DEV   meaning  to  use   any  data
                 compression offered by the device.

                 *NO  may  also be  specified.   For  more information,
                 see the same parameter on the SAVLIB command.

   TGTRLS        The target  release  to be  used for  the  save.   The
                 default  is *CURRENT  for  the current  release.   For
                 the other options, use the command prompter.

   UPDHST        A  *YES/*NO  option  for whether  to  update  the save
                 history information for  each object  saved.  *YES  is
                 the default.

                 *NO may  be specified to  bypass updating of  the save
                 history.

   CHKSAVRST     A  *YES/*NO option for  should the  TAA Tool CHKSAVRST
                 command be run.  The  default is *YES.  The  CHKSAVRST
                 command  will  produce  a  spooled  file  of  the  S/R
                 messages which have occurred during the job.

   ERRORSONLY    A  *YES/*NO option  for should  the  CHKSAVRST command
                 ERRORSONLY  option  be  used.   *YES  is  the default.
                 The default is designed  to further 'net out' the  job
                 log.   The printed  listing will essentially  take the
                 library  completion  message information  and  print a
                 summary.  If  any objects were  not saved, the  detail
                 message  will  appear  in  the job  log  if  the  *YES
                 option   is   taken.     The  entry   is   ignored  if
                 CHKSAVRST(*NO) is specified.

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

You must have *SAVSYS special authority to use SAVOWNOBJ.

Since SAVOBJ  is  used internally  within  SAVOWNOBJ, a  limit  of  300
objects may be saved.

Attempting to save  the same name of an  object (such as a *FILE  and a
*PGM) is prevented

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

The following TAA Tools must be on your system:

     ADDDAT          Add date
     CHKDAT          Check date
     CHKOBJ3         Check object 3
     CHKSAVRST       Check save/restore
     EDTVAR          Edit variable
     EXTLST2         Extract list 2
     RSNLSTMSG       Resend last message
     RTVSPCAUT       Retrieve special authority
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log 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
   ------        ----    ---------      ----------    ----------

   SAVOWNOBJ     *CMD                   TAASAWG       QATTCMD
   TAASAWGC      *PGM       CLP         TAASAWGC      QATTCL
					

Added to TAA Productivity tools June 30, 2007


Home Page Up to Top