363 lines
13 KiB
HTML
363 lines
13 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>Create Image Catalog (CRTIMGCLG)</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="CRTIMGCLG.Top_Of_Page"></a>
|
|
<h2>Create Image Catalog (CRTIMGCLG)</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="#CRTIMGCLG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTIMGCLG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTIMGCLG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTIMGCLG"></a>
|
|
<p>The Create Image Catalog (CRTIMGCLG) command is used to create an image catalog object (*IMGCLG) in library QUSRSYS and associate the image catalog with a target directory. An image catalog can be associated with a virtual optical or virtual tape device.
|
|
</p>
|
|
<p>An image catalog contains information about images that have been added to the image catalog using the Add Image Catalog Entry (ADDIMGCLGE) command. The image catalog contains the following information:
|
|
</p>
|
|
<dl>
|
|
<dt><b>Directory name</b></dt>
|
|
<dd>The directory where the image files will reside.
|
|
</dd>
|
|
<dt><b>Device name</b></dt>
|
|
<dd>The device name of the virtual device associated with the image catalog.
|
|
</dd>
|
|
<dt><b>Catalog Status</b></dt>
|
|
<dd>The current status of the image catalog and its association with a virtual device.
|
|
</dd>
|
|
</dl>
|
|
<p>The image catalog contains the following information for each entry:
|
|
</p>
|
|
<dl>
|
|
<dt><b>Image file name</b></dt>
|
|
<dd>The name of the image file.
|
|
</dd>
|
|
<dt><b>Volume identifier or name</b></dt>
|
|
<dd>The formatted name of the optical or tape volume that image file represents.
|
|
</dd>
|
|
<dt><b>Index number</b></dt>
|
|
<dd>The order of this image within the image catalog.
|
|
</dd>
|
|
<dt><b>Image file status</b></dt>
|
|
<dd>The status of the image within the virtual device.
|
|
</dd>
|
|
<dt><b>Text</b></dt>
|
|
<dd>A short description of the image.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>The following authorities are required to create an image catalog:
|
|
<ol>
|
|
<li>Read (*READ) and Add (*ADD) authority to library QUSRSYS.
|
|
</li>
|
|
<li>Execute (*X) authority to each directory in the image catalog path name.
|
|
</li>
|
|
<li>If the REFIMGCLG parameter is specified, the following additional authorities are required:
|
|
<ol>
|
|
<li>*USE authority to the reference image catalog.
|
|
</li>
|
|
<li>*EXECUTE authority to library QUSRSYS.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>A directory can only be associated with a single image catalog.
|
|
</li>
|
|
<li>If DIR(*REFIMGCLG) is specified, the catalog defined by the REFIMGCLG parameter must not be in ready status.
|
|
</li>
|
|
<li>The following file-systems are supported for the image catalog directory:
|
|
<ol>
|
|
<li>"root" (/)
|
|
</li>
|
|
<li>QOpenSys
|
|
</li>
|
|
<li>User_defined file systems (UDFSs) that support *TYPE2 files.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTIMGCLG.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="#CRTIMGCLG.IMGCLG"><b>IMGCLG</b></a></td>
|
|
<td valign="top">Image catalog</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTIMGCLG.DIR"><b>DIR</b></a></td>
|
|
<td valign="top">Directory</td>
|
|
<td valign="top"><i>Path name</i>, *REFIMGCLG</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTIMGCLG.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Image catalog type</td>
|
|
<td valign="top"><b><u>*OPT</u></b>, *TAP</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTIMGCLG.CRTDIR"><b>CRTDIR</b></a></td>
|
|
<td valign="top">Create directory</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTIMGCLG.REFIMGCLG"><b>REFIMGCLG</b></a></td>
|
|
<td valign="top">Reference image catalog</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTIMGCLG.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTIMGCLG.AUT"><b>AUT</b></a></td>
|
|
<td valign="top">Authority</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*EXCLUDE</u></b>, *LIBCRTAUT, *CHANGE, *ALL, *USE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTIMGCLG.IMGCLG"></a>
|
|
<h3>Image catalog (IMGCLG)</h3>
|
|
<p>Specifies the image catalog to be created.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the image catalog.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTIMGCLG.DIR"></a>
|
|
<h3>Directory (DIR)</h3>
|
|
<p>Specifies the directory to be associated with this image catalog.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Specify the path name of the directory for the image catalog. If symbolic links exist in the path name, the links will be resolved and the absolute path will be used.
|
|
</dd>
|
|
<dt><b>*REFIMGCLG</b></dt>
|
|
<dd>Specify the name of another image catalog as a reference for the new image catalog.
|
|
<p>
|
|
<b>Note: </b>The requirements for catalogs created using the *REFIMGCLG parameter are complex with respect to the limitations and supported uses. For details see the Storage solutions topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTIMGCLG.TYPE"></a>
|
|
<h3>Image catalog type (TYPE)</h3>
|
|
<p>Specifies the type of image catalog to create.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OPT</u></b></dt>
|
|
<dd>Specifies to create an optical type image catalog. Only optical image catalog entries are allowed in this type of catalog.
|
|
</dd>
|
|
<dt><b>*TAP</b></dt>
|
|
<dd>Specifies to create a tape type image catalog. Only tape image catalog entries are allowed in this type of catalog.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTIMGCLG.CRTDIR"></a>
|
|
<h3>Create directory (CRTDIR)</h3>
|
|
<p>Specifies whether the directory (DIR parameter) should be created if it doesn't exist.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The directory will be created if it does not exist. The created directory will have the following default authorities:
|
|
<p>
|
|
<pre>
|
|
Data Object Authorities
|
|
User Authority Exist Mgt Alter Ref
|
|
*PUBLIC *EXCLUDE
|
|
Owner *RWX X X X X
|
|
</pre>
|
|
</p>
|
|
<p>For all other attributes, the defaults as provided on the CRTDIR command are chosen.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The directory will not be created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTIMGCLG.REFIMGCLG"></a>
|
|
<h3>Reference image catalog (REFIMGCLG)</h3>
|
|
<p>Specifies the name of the image catalog as a reference for the new image catalog. The new dependent image catalog will contain the image catalog entries that exist in the reference image catalog at the time the dependent image catalog is created. Any additional changes to the reference image catalog will not be reflected in the dependent image catalog.
|
|
</p>
|
|
<p>This parameter is valid only when DIR(*REFIMGCLG) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the reference image catalog.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTIMGCLG.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the image catalog being created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>The text description will be blank.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify up to 50 characters of text for this image catalog.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTIMGCLG.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EXCLUDE</u></b></dt>
|
|
<dd>The user cannot access the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*LIBCRTAUT</b></dt>
|
|
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CHANGE</b></dt>
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*USE</b></dt>
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTIMGCLG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Creating an Image Catalog</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTIMGCLG IMGCLG(MYCLG) DIR('/MyDir')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates optical type image catalog <b>MYCLG</b> in library QUSRSYS and associates directory <b>/Mydir</b> with it.
|
|
</p>
|
|
<p><b>Example 2: Creating an Image Catalog Using a Reference Image Catalog</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTIMGCLG IMGCLG(MYCLG) DIR(*REFIMGCLG) REFIMGCLG(MYCLG2)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates optical type image catalog <b>MYCLG</b>, based on image catalog <b>MYCLG2</b> in library QUSRSYS and associates the directory specified in image catalog <b>MYCLG2</b> with it.
|
|
</p>
|
|
<p><b>Example 3: Creating a Tape Type Image Catalog</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTIMGCLG IMGCLG(TAPECLG) DIR('/TapeDir') TYPE(*TAP)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates tape type image catalog <b>TAPECLG</b> in library QUSRSYS and associates directory <b>/TapeDir</b> with it.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTIMGCLG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFBC02</b></dt>
|
|
<dd>Image catalog &1 was not created in library &2.
|
|
</dd>
|
|
<dt><b>CPFBC45</b></dt>
|
|
<dd>Image catalog &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|