Start Object Conversion (STROBJCVN)

The Start Object Conversion (STROBJCVN) command converts user objects from the format used in a previous version, release, and modification level of the operating system to the format required for use in the current operating system. The following objects are converted with this command:

Programs (original program model (OPM) and Integrated Language Environment (ILE))
Service programs
Modules
Database files (physical and logical) on Replacing-a-release upgrade methods.
Objects that may contain SQL statements (programs, service programs, or SQL package (*SQLPKG) objects) as well as program and service program objects that are used to implement an external stored procedure. Only the stored SQL statement information is converted to the current operating system format.

The user objects that are not converted with this command are automatically converted when they are first used.

Note: Using objects that are not yet converted will have a one-time performance degradation while the conversion operation is performed.

Restrictions:

Programs, service programs, and modules must have all observable creation data to be converted. Unobservable creation data cannot be used by this command. Conversion of stored SQL statement information does not require observable creation data.

Keyword	Description	Choices	Notes
LIB	Library	Name, ALLUSR, PTY	Required, Positional 1
OBJTYPE	Object type	ALL, FILE, ALLPGM, SQL	Optional, Positional 2
PTY	Priority	1-99, *ALL	Optional, Positional 3

Library (LIB)

Specifies the user library whose objects are to be converted to the format of the current operating system.

This is a required parameter.

*ALLUSR

All user libraries are converted. All libraries with names that do not begin with the letter Q are converted except for the following:

#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 converted:

QDSNX       QRCLxxxxx   QUSRIJS     QUSRVxRxMx
QGPL        QSRVAGT     QUSRINFSKR
QGPL38      QSYS2       QUSRNOTES
QMGTC       QSYS2xxxxx  QUSROND
QMGTC2      QS36F       QUSRPOSGS
QMPGDATA    QUSER38     QUSRPOSSA
QMQMDATA    QUSRADSM    QUSRPYMSVR
QMQMPROC    QUSRBRM     QUSRRDARS
QPFRDATA    QUSRDIRCL   QUSRSYS
QRCL        QUSRDIRDB   QUSRVI

'xxxxx' is the number of a primary auxiliary storage pool (ASP).
A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.

*PTY

Convert the set of libraries at the priority specified in the PTY parameter. The object conversion priority for a library can be set using the Plan Object Conversion task.

name

Specifies the name of the user library whose objects are to be converted.

Note: Although only one library can be specified on this command, repeated calls of this command in a CL program can be used to convert a set of user libraries.

Object type (OBJTYPE)

Specifies which objects in the library should be converted to the format of the current operating system.

*ALL: All *PGM, *SRVPGM, *MODULE, and database files in the specified library are converted to the format of the current operating system. In addition, the stored SQL information in all *PGM, *SRVPGM, and *SQLPKG objects that contain SQL statements, as well as *PGM and *SRVPGM objects that are used to implement external stored procedures, is converted to the format of the current operating system.
*FILE: Only database file member objects in the specified library are converted to the format of the current operating system.
*ALLPGM: Only *PGM and *SRVPGM objects in the specified library are converted to the format of the current operating system.
*SQL: The stored SQL information in all *PGM, *SRVPGM, and *SQLPKG objects that contain SQL statements, as well as *PGM and *SRVPGM objects that are used to implement external stored procedures, is converted to the format of the current operating system.

Priority (PTY)

Specifies the priority of libraries to be converted to the format of the current operating system. The priority groups are set on the source system during upgrade preparation. This parameter is valid only when *PTY is specified for the Library (LIB) parameter.

The priority for a library can be set with the Plan Object Conversion task of the Upgrade Assistant.

Note: You must specify a value for this parameter if *PTY is specified for the LIB parameter.

*ALL: All user libraries are converted to the format of the current operating system. Specifying this value with LIB(*PTY) is the same as specifying LIB(*ALLUSR).
1-99: Specify the priority number of the libraries whose objects are to be converted to the format of the current operating system.
Note: Although only one priority can be specified on this command, repeated calls of this command in a CL program can be used to convert multiple sets of libraries with different priority numbers.

Examples

Example 1: Start Conversion of All Objects

STROBJCVN   LIB(LIB1)

This command converts all OPM and ILE programs, service programs, modules, and physical and logical database files contained in the LIB1 user library to the format of the current operating system.

In addition, the stored SQL information in all *PGM, *SRVPGM, and *SQLPKG objects that contain SQL statements, as well as *PGM and *SRVPGM objects that are used to implement external stored procedures, is converted to the format of the current operating system.

Example 2: Start Conversion of SQL Objects

STROBJCVN   LIB(LIB2)  OPTION(*SQL)

This command converts the stored SQL information in all *PGM, *SRVPGM, and *SQLPKG objects in library LIB2 that contain SQL statements, as well as *PGM and *SRVPGM objects in library LIB2 that are used to implement external stored procedures, to the format of the current operating system.