TAA Tools

The Change Object Source  command provides a simple method  of changing
the source  information in an object to reflect  the information from a
specified  member.   The  command  is intended  for  the case  where an
object is  created from  temporary source and  you want  the object  to
reflect  the  actual  source.   The  user  must  be authorized  to  the
TAACHGOBJ2 authorization list.

A typical command would be:

             CHGOBJSRC     OBJ(www) OBJTYPE(xxx) +
                             REFSRCFILE(yyy) REFSRCMBR(zzz)

The following information is changed in the object:

        - Source file
        - Source library
        - Source member
        - Source change date
        - User attribute (always set to *CHGOBJSRC)

The  tool uses the  sub tool CHGOBJD2  to change the  object.  CHGOBJD2
uses the QLICOBJD API.

Audit trail

The user attribute  is set to  *CHGOBJSRC to help  identify the  change
that was made.   If the user attribute field is being  used by your own
application  function, you  should not  be  using CHGOBJSRC.   Instead,
you should be using CHGOBJD2 directly.

When CHGOBJSRC  is run,  the TAA  Tool SNDAUDE  is used  internally  to
send  a journal  entry  to  the QAUDJRN  journal  if  it exists.    The
journal code  assigned is U with a  type of CO.  The  first 10 bytes of
the entry will be CHGOBJSRC.

If  the journal  does not exist,  a message is  sent to  QSYSOPR.  This
serves as  an  audit trail  that the  command was  used  to change  the

Command parameters                                    *CMD

   OBJ           The qualified name  of the object to be  changed.  The
                 library  value defaults  to *LIBL.   *CURLIB  may also
                 be used.

   OBJTYPE       The object type to be changed.   It must be of a  type
                 *CMD, *FILE, *MODULE, *PGM, *PNLGRP, or *SRVPGM.

   REFSRCFILE    The qualified  name of  the reference  source file  to
                 be  used.    The  library  value  defaults  to  *LIBL.
                 *CURLIB may also be used.

   REFSRCMBR     The  reference  source  member   to  be  accessed   to
                 retrieve  the  information.    The  default  is  *SAME
                 meaning the member name remains the same.




The following TAA Tools must be on your system:

     CHGOBJD2        Change object description 2
     SNDAUDE         Send audit entry
     SNDCOMPMSG      Send completion message


None, the tool is ready to use.

Objects used by the tool

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

   CHGOBJSRC     *CMD                   TAAOBJU       QATTCMD
   TAAOBJUC      *PGM       CLP         TAAOBJUC      QATTCL

Added to TAA Productivity tools June 1, 1997

Home Page Up to Top