TAA Tools
STROBJCVN2      START OBJECT CONVERSION 2              TAAOBLM

The Start  Object Conversion  2 command is  a front  end to  the system
STROBJCVN  command.     STROBJCVN2  provides  an   easier  solution  by
allowing  a list  of named  or generic  libraries and  an omit  list of
libraries.  A listing is  produced instead of messages in the  job log.
Status messages describe which library is being operated on.

You must have *ALLOBJ special authority to use STROBJCVN2.

For an understanding  of the conversion requirements for  V6R1, see the
TAAV6R1 documentation member.

A typical command would be:

             STROBJCVN2   OPTION(*CHECK) LIB(ABC*)

All  libraries with a  generic name of  ABC would be checked  to see if
the objects were properly converted for V6R1.

Use OPTION(*CONVERT) to convert the objects.

The QSYS library is always omitted.

STROBJCVN2 does not support conversion of objects in the IFS.

STROBJCVN2 escape messages you can monitor for
----------------------------------------------

      TAA9891    No objects could be converted.

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

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

   LIB           A list  of  up to  300  libraries or  generic  library
                 names  may  be  entered.   *LIBL  or  *CURLIB  may  be
                 entered.   The  special value  *ALLUSR may  be entered
                 for all user libraries.

   OPTION        The option to be performed.

                 *CONVERT is  the default  to  convert the  objects  if
                 possible.

                 *CHECK may  be specified  to to  determine if  objects
                 need conversion.

   OBJTYPE       The  object  type  to  be  converted.    *ALL  is  the
                 default  for  all  appropriate  objects.    *ALLPGM or
                 *SQL may be specified.

   ASPDEV        The auxiliary storage device  name to be used.   For a
                 complete definition, see the STROBJCVN command.

                 * is the default to mean the job's library list.

                 *ALLAVL may  be specified to mean  all available ASPs.

                 *CURASPGRP  may  be specified  to mean  the  job's ASP
                 group.

                 *SYSBAS may be specified to mean the ASP 1 - 32.

   OMITLIB       A list  of  up to  300  libraries or  generic  library
                 names that should  be omitted.  *NONE  is the default.

                 An omit list may not be entered for LIB(*CURLIB).

                 No check  occurs to see if an  omit library would have
                 been  selected.    For   example,  if  LIB(*LIBL)   is
                 entered with  OMITLIB(ABC) and library  ABC is  not on
                 the library list, no error occurs.

   RTNMSGS       A  *YES/*NO  parameter   for  whether  to  retain  the
                 messages  output  from the  system  command STROBJCVN.
                 Regardless of  the entry, the  messages are  converted
                 to appear on the listing.

                 *NO is the default to delete the system messages.

                 *YES may  be specified to retain  the system messages.

   OUTPUT        How  to  output the  results.    * is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.  The  spooled file is deleted  after it
                 is displayed.

                 If  the  command  is entered  in  batch  or *PRINT  is
                 specified, the spooled  file is  output and  retained.

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

You must have *ALLOBJ special authority to use STROBJCVN2.

STROBJCVN2 does not support conversion of objects in the IFS.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CVTLIBOBJD      Convert library object descriptions
     EXTLST2         Extract list 2
     RTVOBJD2        Retrieve object description 2
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     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
   ------        ----    ---------      ----------    ----------

   STROBJCVN2    *CMD                   TAAOBLM       QATTCMD
   TAAOBLMC      *PGM       CLP         TAAOBLMC      QATTCL
   TAAOBLMR      *PGM       RPG         TAAOBLMR      QATTRPG
					

Added to TAA Productivity tools March 21, 2008


Home Page Up to Top