| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Analyze Object Conversion (ANZOBJCVN) command collects or reports information for user-created objects on the system. It can be used to plan the conversion of user objects to a new release of i5/OS operating system.
The following types of objects in libraries are analyzed and reported by this command:
The following types of objects in directories are analyzed and reported by this command:
In addition, this command will determine the total number of spooled files on each auxiliary storage pool (ASP) that need to be converted and the estimated time to perform this conversion. This collection can be turned on or off with Check spooled files (SPLFILE) parameter.
The following information is collected or reported for each object:
Note: All the references to conversion time in the Object Summary and Object Detail reports do not include time for case mapping conversions because it is done automatically by the operating system.
Note: In most cases, the objects analyzed by ANZOBJCVN can be converted by Start Object Conversion (STROBJCVN) command or on first touch of the system after a software upgrade. However, STROBJCVN will not convert the directories to support the new Unicode characters and casing rules since this conversion is automatically done by the operating system. Also STROBJCVN will not convert spooled database members because this conversion is automatically done based on the existence of the QSPL/QSPLDFRCVN data area. The default is to convert spooled files during IPL for all the spooled files stored in the system auxiliary storage pool (ASP) and all basic user ASPs or during the vary on of an independent ASP for spooled files stored in a primary or secondary ASP if the QSPL/QSPLDFRCVN data area does not exist after ASP.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| OPTION | Option | *COLLECT, *REPORT | Required, Positional 1 |
| RPTTYPE | Type of report | Single values: *ALL Other values (up to 4 repetitions): *LIBSUM, *LIBDTL, *OBJSUM, *OBJDTL |
Optional |
| LIB | Libraries to analyze | Generic name, name, *ALLUSR, *NONE | Optional |
| ASPDEV | ASP device | Name, *, *ALLAVL, *CURASPGRP, *SYSBAS | Optional |
| SPLFILE | Check spooled files | *YES, *NO | Optional |
| OBJ | Object | Path name, *NONE | Optional |
| SUBTREE | Directory subtree | *ALL, *NONE | Optional |
| TGTRLS | Target release | Character value, V6R1M0 | Optional |
| Top |
Specifies whether you want to collect information or generate reports using the collected information.
This is a required parameter.
| Top |
Specifies the types of object reports to generate. The reports are written to the printer file QPIZARPT.
If *COLLECT is specified for the Option (OPTION) parameter, specification of this parameter is ignored.
Single values
Other values (up to 4 repetitions)
| Top |
Specifies the libraries to be analyzed.
If *REPORT is specified for the Option (OPTION) parameter, specification of this parameter is ignored.
#CGULIB #DSULIB #SEULIB #COBLIB #RPGLIB #DFULIB #SDALIB
Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered user libraries and are also analyzed:
QDSNX QRCLxxxxx QUSRDIRDB QUSRVI QGPL QSRVAGT QUSRIJS QUSRVxRxMx QGPL38 QSYS2 QUSRINFSKR QMGTC QSYS2xxxxx QUSRNOTES QMGTC2 QS36F QUSROND QMPGDATA QUSER38 QUSRPOSGS QMQMDATA QUSRADSM QUSRPOSSA QMQMPROC QUSRBRM QUSRPYMSVR QPFRDATA QUSRDIRCF QUSRRDARS QRCL QUSRDIRCL QUSRSYS
| Top |
Specifies the auxiliary storage pool (ASP) device where storage is allocated for the library and spooled files to be analyzed. If the library is in an ASP that is not part of the thread's library name space, this parameter must be specified to ensure the correct library is analyzed.
Note: This parameter does not apply for the objects specified in the OBJ parameter since the independent ASP name is part of the path name of the object.
If *REPORT is specified for the Option (OPTION) parameter, specification of this parameter is ignored.
Specify the name of the primary or secondary ASP device to be searched. The primary or secondary ASP must have been activated (by varying on the ASP device) and have a status of 'Available'. The system ASP (ASP 1) and defined basic user ASPs (ASPs 2-32) will not be searched.
| Top |
Specifies whether to analyze the total number of spooled files on each auxiliary storage pool (ASP) that need to be converted and the estimated time to perform this conversion.
Additionally, one cannot specify LIB(*NONE) if SPLFILE(*YES) is specified.
Note: The ASP device selected (ASPDEV) affects the collection of spooled files.
| Top |
Specifies the path name of the object, or a pattern to match the name, of the objects to be analyzed.
If *REPORT is specified for the Option (OPTION) parameter, specification of this parameter is ignored.
The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes.
For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
Note: If the last component in the path name is a symbolic link, the symbolic link object is analyzed, but the object pointed to by the symbolic link is not analyzed.
| Top |
Specifies whether or not to analyze the objects within the subtree if the object specified by the Object (OBJ) parameter is a directory.
If *REPORT is specified for the Option (OPTION) parameter, specification of this parameter is ignored.
Note: Pattern matching from the OBJ parameter only applies to the first level objects. If the first level object is a directory, the pattern matching does not apply to its contents or the contents of its subdirectories.
Once the command has begun processing a specific directory subtree, the objects which will be found and processed may be affected by operations that update the organization of objects within the specified directory tree. This includes, but is not limited to, the following:
In order to process the directory subtree, the system code may increase the process-scoped maximum number of file descriptors that can be opened during processing. This is done so that the command is not likely to fail due to a lack of descriptors. This process-scoped maximum value is not reset when the command completes.
| Top |
Specifies the release to which the data and programs will be migrated. This information is used to determine the specific analysis to be performed. This is dependent on the release where the command is being run.
If *REPORT is specified for the Option (OPTION) parameter, specification of this parameter is ignored.
| Top |
Example 1: Collect Library Information
ANZOBJCVN OPTION(*COLLECT)
This command will collect object conversion information for all objects in all user libraries in the system auxiliary storage pool (ASP), all configured basic user ASPs, and all independent ASPs that are varied on and have a status of 'Available'. If the library is in an ASP that is not part of the thread's library name space, parameter ASPDEV must be specified to ensure the desired library is analyzed. No information is collected for directories.
Example 2: Generate Library Information Reports
ANZOBJCVN OPTION(*REPORT) RPTTYPE(*LIBSUM *LIBDTL)
This command will report previously collected library information. The library summary and library detail reports will be generated.
Example 3: Collect Object Information from Directories
ANZOBJCVN OPTION(*COLLECT) LIB(*NONE)
OBJ('/MYDIR/MYDOCS') SUBTREE(*ALL)
This command will collect object conversion information for the /MYDIR/MYDOCS directory, its contents as well as the contents of all of its subdirectories will be analyzed. No information is collected for objects in libraries.
Example 4: Generate Object Detailed Report
ANZOBJCVN OPTION(*REPORT) RPTTYPE(*OBJDTL)
This command will report previously collected object information for directories. The object details report will be generated.
Example 5: Collect Library Information and Directory Information
ANZOBJCVN OPTION(*COLLECT) LIB(MYLIB) SPLFILE(*NO)
OBJ('/MYDIR') SUBTREE(*ALL)
This command will collect object conversion information for the MYLIB library and for /MYDIR directory, its contents as well as the contents of all of its subdirectories will be analyzed. No spool database members information will be collected.
| Top |
*ESCAPE Messages
| Top |