242 lines
9.9 KiB
HTML
242 lines
9.9 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Start Object Conversion (STROBJCVN)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="STROBJCVN.Top_Of_Page"></a>
|
|
<h2>Start Object Conversion (STROBJCVN)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#STROBJCVN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STROBJCVN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STROBJCVN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STROBJCVN"></a>
|
|
<p>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:
|
|
</p>
|
|
<ul>
|
|
<li>Programs (original program model (OPM) and Integrated Language Environment (ILE))
|
|
</li>
|
|
<li>Service programs
|
|
</li>
|
|
<li>Modules
|
|
</li>
|
|
<li>Database files (physical and logical) on Replacing-a-release upgrade methods.
|
|
</li>
|
|
<li>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.
|
|
</li>
|
|
</ul>
|
|
<p>The user objects that are not converted with this command are automatically converted when they are first used.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Using objects that are not yet converted will have a one-time performance degradation while the conversion operation is performed.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>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.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STROBJCVN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STROBJCVN.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STROBJCVN.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Name</i>, *ALLUSR, *PTY</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STROBJCVN.OBJTYPE"><b>OBJTYPE</b></a></td>
|
|
<td valign="top">Object type</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *FILE, *ALLPGM, *SQL</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STROBJCVN.PTY"><b>PTY</b></a></td>
|
|
<td valign="top">Priority</td>
|
|
<td valign="top">1-99, *ALL</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STROBJCVN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STROBJCVN.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Specifies the user library whose objects are to be converted to the format of the current operating system.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALLUSR</b></dt>
|
|
<dd>All user libraries are converted. All libraries with names that do not begin with the letter Q are converted except for the following:
|
|
<p>
|
|
<pre>
|
|
#CGULIB #DSULIB #SEULIB
|
|
#COBLIB #RPGLIB
|
|
#DFULIB #SDALIB
|
|
</pre>
|
|
</p>
|
|
<p>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:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
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
|
|
</pre>
|
|
</p>
|
|
<ol>
|
|
<li>'xxxxx' is the number of a primary auxiliary storage pool (ASP).
|
|
</li>
|
|
<li>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.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
<dt><b>*PTY</b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specifies the name of the user library whose objects are to be converted.
|
|
<p>
|
|
<b>Note: </b>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.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STROBJCVN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STROBJCVN.OBJTYPE"></a>
|
|
<h3>Object type (OBJTYPE)</h3>
|
|
<p>Specifies which objects in the library should be converted to the format of the current operating system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
<dt><b>*FILE</b></dt>
|
|
<dd>Only database file member objects in the specified library are converted to the format of the current operating system.
|
|
</dd>
|
|
<dt><b>*ALLPGM</b></dt>
|
|
<dd>Only *PGM and *SRVPGM objects in the specified library are converted to the format of the current operating system.
|
|
</dd>
|
|
<dt><b>*SQL</b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STROBJCVN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STROBJCVN.PTY"></a>
|
|
<h3>Priority (PTY)</h3>
|
|
<p>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 <b>Library (LIB)</b> parameter.
|
|
</p>
|
|
<p>The priority for a library can be set with the Plan Object Conversion task of the Upgrade Assistant.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You must specify a value for this parameter if *PTY is specified for the LIB parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>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).
|
|
</dd>
|
|
<dt><b><i>1-99</i></b></dt>
|
|
<dd>Specify the priority number of the libraries whose objects are to be converted to the format of the current operating system.
|
|
<p>
|
|
<b>Note: </b>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.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STROBJCVN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STROBJCVN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Start Conversion of All Objects</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STROBJCVN LIB(LIB1)
|
|
</pre>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
<p><b>Example 2: Start Conversion of SQL Objects</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STROBJCVN LIB(LIB2) OPTION(*SQL)
|
|
</pre>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STROBJCVN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STROBJCVN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPDA972</b></dt>
|
|
<dd>Errors occurred while converting object &1 in library &2 type *&3.
|
|
</dd>
|
|
<dt><b>CPFA960</b></dt>
|
|
<dd>Library &1 is not a user library.
|
|
</dd>
|
|
<dt><b>CPFA972</b></dt>
|
|
<dd>Not all eligible objects in library &1 converted.
|
|
</dd>
|
|
<dt><b>CPFB0C1</b></dt>
|
|
<dd>Not all eligible objects in priority &1 converted.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STROBJCVN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|