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