TAA Tools

The Change Owner  from Tape command  provides a 'fix up'  of ownership.
CHGOWNTAP  is designed  for the  case where  object ownership  has been
changed  and you want to  reset the ownership to  the owner that exists
on a save tape.   A listing is produced  with one line for each  object
with  flags  for  those objects  that  were  changed  or could  not  be
changed.     You  must  be  authorized   to  change  ownership  of  the
individual objects.

Authorities granted  to users are  not saved  with the  object and  are
not replaced.

The  command is  helpful in  resetting the  ownership of  objects in  a
user ASP  after a failure in the system ASP.   If the system ASP fails,
the ownership of  user ASP  objects becomes  QDFTOWN.   The backup  and
recovery guide  recommends  changing the  ownership of  each object  in
the user ASP using CHGOBJOWN.  CHGOWNTAP simplifies this task.

A sub tool (CVTTAPSAVD) is English language dependent.

A typical command would be:

             CHGOWNTAP    DEV(TAP01) LIB(xxx)

The tape  would be read  and the save  information converted to  a file
in  QTEMP.  The  QTEMP file would  be read and  the objects checked for
the same  owner.  If  the owner differs,  CHGOBJOWN would be  attempted
to change the object  on the system to the owner name  of the object on
the save media.

A  listing is output with one line  for each object processed and flags
are used  for  those  objects that  were  changed and  where  an  error
occurs.  For example,  an error would occur if the the  object does not
exist, is allocated, or insufficient authorization exists.

An  escape   message  is  sent  if  the   command  could  not  complete

Options exist to  process only  a specific  ASP or  a specific  current
object owner (such  as QDFTOWN).  If  a selection option is  taken, any
objects that are bypassed do not appear on the listing.

CHGOWNTAP escape messages you can monitor for

      TAA9893    Some error occurred.

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

Command parameters                                    *CMD

   DEV           The tape device to be used.

   LIB           The   library  on   tape  (the   tape  label)   to  be
                 converted.     A  specific  library  or  *ALL  may  be

                 If a  specific library  is  named, the  tape which  is
                 mounted  is searched  (beginning at  the current  file
                 sequence  number) for  that library.   If  the library
                 is not on the tape, an error message will occur.

                 An entry  of  *ALL specifies  that  all files  on  the
                 tape  will be  processed.   File  sequence  1 is  used
                 first.    If  a  multi-volume  tape  was written,  the
                 CHGOWNTAP command will  not cause a  request to  mount
                 a subsequent  tape.   It will  end at the  end of  the
                 mounted  tape.   To do  all  files for  a multi-volume
                 save,   you   need   to  mount   each   tape   of  the
                 multi-volume save and use CHGOWNTAP on each tape.

   ENDOPT        The  operation to  be  performed  on the  tape  volume
                 when the tape  has been read.  The  default is *REWIND
                 to rewind the tape.

                 *UNLOAD may be specified to unload the tape.

   ASP           The  ASP of the objects to  be processed.  The default
                 is *ALL.    A value  in  a range  of  1  - 99  may  be
                 entered.   If a specific  ASP is entered,  any objects
                 not in  the ASP are bypassed and  do not appear in the

   CUROBJOWN     The current  owner of  the  objects to  be  processed.
                 The default is *ALL.   A specific name may  be entered
                 such  as  QDFTOWN.   If  a specific  current  owner is
                 entered,  any objects  not owned by  that user profile
                 name are bypassed  and do not  appear in the  listing.


Multi-volume  tape files  are  supported by  using  a unique  CHGOWNTAP
command for each volume.

The sub tool CVTTAPSAVD is English language dependent.


The following TAA Tools must be on your system:

     CVTTAPSAVD      Convert Tape Save Description
     EDTVAR          Edit variable
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message


None, the tool is ready to use.

Objects used by the tool

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

   CHGOWNTAP     *CMD                   TAASEFH       QATTCMD
   TAASEFHC      *PGM       CLP         TAASEFHC      QATTCL
   TAASEFHR      *PGM       RPG         TAASEFHR      QATTRPG

Added to TAA Productivity tools June 1, 2002

Home Page Up to Top