548 lines
22 KiB
HTML
548 lines
22 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>Add Image Catalog Entry (ADDIMGCLGE)</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="ADDIMGCLGE.Top_Of_Page"></a>
|
||
|
|
<h2>Add Image Catalog Entry (ADDIMGCLGE)</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="#ADDIMGCLGE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ADDIMGCLGE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ADDIMGCLGE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ADDIMGCLGE"></a>
|
||
|
|
<p>The Add Image Catalog Entry (ADDIMGCLGE) command is used to create a virtual image in the image catalog directory (as specified by the <b>Directory (DIR)</b> parameter on the CRTIMGCLG command). If the image is added successfully, the image will be loaded and the image catalog (*IMGCLG) in library QUSRSYS will be updated. Images can be added from the following sources:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>CD or DVD media (by specifying an optical device containing the CD or DVD image to be added). This source is only allowed for optical type image catalogs.
|
||
|
|
</li>
|
||
|
|
<li>An image file located in a directory. The image file can exist in any directory that is accessible through the Copy Object (CPY) command.
|
||
|
|
</li>
|
||
|
|
<li>A new image file by specifying the FROMFILE(*NEW) parameter
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>If an image catalog entry exists with the same index as specified for the <b>Image catalog index (IMGCLGIDX)</b> parameter, one of the following will occur:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>If REPLACE(*NO) is specified, an error message will be issued and the catalog entry in the image catalog will not be replaced.
|
||
|
|
</li>
|
||
|
|
<li>If REPLACE(*YES) is specified, the catalog entry in the image catalog will be replaced.
|
||
|
|
</li>
|
||
|
|
<li>If REPLACE(*INSERT) is specified, the catalog entry in the image catalog will be inserted. If a catalog entry already exists at the index specified, the remaining entries will be incremented by one up to the next available index.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>If the image does not exist in the target directory, the image is copied and the image catalog is updated with information about this image.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
||
|
|
</li>
|
||
|
|
<li>The following authorities are required to add an image catalog entry:
|
||
|
|
<ol>
|
||
|
|
<li>Execute (*EXECUTE) authority to library QUSRSYS.
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE authority to the image catalog.
|
||
|
|
</li>
|
||
|
|
<li>Execute (*X) authority to each directory in the image catalog path name.
|
||
|
|
</li>
|
||
|
|
<li>If adding an image file from physical media, the following additional authorities are required:
|
||
|
|
<ol>
|
||
|
|
<li>*USE authority to the physical device is required.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
<li>If adding an image file from an existing image located in a different directory, the authorities required are the same as those required by the Copy Object (CPY) command.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
<li>Adding from physical CD or DVD media is only supported for optical type image catalogs.
|
||
|
|
</li>
|
||
|
|
<li>This command does not support dependent image catalogs.
|
||
|
|
</li>
|
||
|
|
<li>The following parameters are only valid for tape type image catalogs:
|
||
|
|
<ol>
|
||
|
|
<li>ALCSTG
|
||
|
|
</li>
|
||
|
|
<li>VOLTYP
|
||
|
|
</li>
|
||
|
|
<li>DENSITY
|
||
|
|
</li>
|
||
|
|
<li>NEWOWNID
|
||
|
|
</li>
|
||
|
|
<li>CODE
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>If any of the above parameters are specified for an optical type image catalog, they will be ignored.
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ADDIMGCLGE.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="#ADDIMGCLGE.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="#ADDIMGCLGE.FROMDEV"><b>FROMDEV</b></a></td>
|
||
|
|
<td valign="top">From optical device, or</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.FROMFILE"><b>FROMFILE</b></a></td>
|
||
|
|
<td valign="top">From image file</td>
|
||
|
|
<td valign="top"><i>Path name</i>, *NEW</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.TOFILE"><b>TOFILE</b></a></td>
|
||
|
|
<td valign="top">To image file</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*GEN</u></b>, *FROMFILE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.IMGCLGIDX"><b>IMGCLGIDX</b></a></td>
|
||
|
|
<td valign="top">Image catalog index</td>
|
||
|
|
<td valign="top">1-256, <b><u>*AVAIL</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.REPLACE"><b>REPLACE</b></a></td>
|
||
|
|
<td valign="top">Replace catalog entry</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES, *INSERT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.IMGSIZ"><b>IMGSIZ</b></a></td>
|
||
|
|
<td valign="top">Image size</td>
|
||
|
|
<td valign="top">48-1000000, <b><u>*IMGCLGTYPE</u></b>, *CD650, *DVD2600, *DVD4700</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*GEN</u></b>, *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.ALCSTG"><b>ALCSTG</b></a></td>
|
||
|
|
<td valign="top">Allocate storage size</td>
|
||
|
|
<td valign="top"><b><u>*MIN</u></b>, *IMGSIZ</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.VOLNAM"><b>VOLNAM</b></a></td>
|
||
|
|
<td valign="top">Tape volume name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*GEN</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.VOLTYP"><b>VOLTYP</b></a></td>
|
||
|
|
<td valign="top">Volume type</td>
|
||
|
|
<td valign="top"><b><u>*SL</u></b>, *NL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.DENSITY"><b>DENSITY</b></a></td>
|
||
|
|
<td valign="top">Tape density</td>
|
||
|
|
<td valign="top"><b><u>*VRT256K</u></b>, *VRT240K, *VRT64K, *VRT32K</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDIMGCLGE.NEWOWNID"><b>NEWOWNID</b></a></td>
|
||
|
|
<td valign="top">New owner identifier</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="#ADDIMGCLGE.CODE"><b>CODE</b></a></td>
|
||
|
|
<td valign="top">Code</td>
|
||
|
|
<td valign="top"><b><u>*EBCDIC</u></b>, *ASCII</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ADDIMGCLGE.IMGCLG"></a>
|
||
|
|
<h3>Image catalog (IMGCLG)</h3>
|
||
|
|
<p>Specifies the image catalog that the new entry is to be added to.
|
||
|
|
</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="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.FROMDEV"></a>
|
||
|
|
<h3>From optical device, or (FROMDEV)</h3>
|
||
|
|
<p>Specifies the CD or DVD device from which the optical image is to be copied. For optical type image catalogs, a value must be specified for either the FROMDEV or FROMFILE parameter to identify the optical image file to be copied to the image catalog directory. For tape type image catalogs, the FROMDEV parameter is not allowed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the optical device from which the optical image file is to be copied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.FROMFILE"></a>
|
||
|
|
<h3>From image file (FROMFILE)</h3>
|
||
|
|
<p>Specifies the image file to be copied. For optical type image catalogs, a value must be specified for either the FROMDEV or FROMFILE parameter to identify the optical image file to be copied to the image catalog directory. For tape type image catalogs, a value must be specified on the FROMFILE parameter to identify the tape image file to be copied to the image catalog directory.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NEW</b></dt>
|
||
|
|
<dd>Specifies that a new catalog entry is to be added and an empty image file created.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the optical or tape image file to be added to the image catalog.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.TOFILE"></a>
|
||
|
|
<h3>To image file (TOFILE)</h3>
|
||
|
|
<p>Specifies the name given to the file that will be copied to the target directory.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*GEN</u></b></dt>
|
||
|
|
<dd>The file name will be generated from the source image. This value is not allowed if *NEW is specified on the FROMFILE parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FROMFILE</b></dt>
|
||
|
|
<dd>The file name will be the same name as source image. If the source image is from optical media, the name given to the file will be the volume ID. If the source image is from another directory, the file will be given the same name as that in the source directory.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify up to 255 characters for the name of the optical or tape image file to be added to the image catalog.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.IMGCLGIDX"></a>
|
||
|
|
<h3>Image catalog index (IMGCLGIDX)</h3>
|
||
|
|
<p>Specifies the image catalog index to be assigned to the image being added.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>The image catalog index number assigned to the image will be the first index number available.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-256</i></b></dt>
|
||
|
|
<dd>Specify the image catalog index number to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.REPLACE"></a>
|
||
|
|
<h3>Replace catalog entry (REPLACE)</h3>
|
||
|
|
<p>Specifies the action to take if a catalog entry with the same index number as specified on the IMGCLGIDX parameter already exists in the image catalog.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Specify that the existing catalog entry will not be replaced and an error message will be issued.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Specify that the existing image catalog entry will be replaced.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INSERT</b></dt>
|
||
|
|
<dd>Specify that the catalog entry specified will be added (or inserted if an existing index number already exists). If the image catalog entry is inserted, the remaining catalog entries will be incremented by one up to the next available index number.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.IMGSIZ"></a>
|
||
|
|
<h3>Image size (IMGSIZ)</h3>
|
||
|
|
<p>Specifies the size of the new image file that is to be created.
|
||
|
|
</p>
|
||
|
|
<p>For optical type image catalogs, this parameter indicates the size of the optical image file that is to be created and the amount of system storage to be allocated.
|
||
|
|
</p>
|
||
|
|
<p>For tape type image catalogs, this parameter indicates the maximum size allowed for this tape image file. If ALCSTG(*MIN) is specified, only the amount of storage required to initialize the image file will be allocated. If ALCSTG(*IMGSIZ) is specified, the amount of storage allocated will be the value specified on the IMGSIZ parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*IMGCLGTYPE</u></b></dt>
|
||
|
|
<dd>Specifies that the size of the image file to be created will be determined by the type of image catalog.
|
||
|
|
<p>For optical image catalogs, the size of the image file created will be 650 MB. Optical images created with this size can be written to any standard 650 MB media.
|
||
|
|
</p>
|
||
|
|
<p>For tape type image catalogs, the maximum size of the image file created will be set to 1 gigabyte.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CD650</b></dt>
|
||
|
|
<dd>Specifies the size of the optical image file will be 650 megabytes. Optical images created with this size can be written to any standard 650 MB optical media.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DVD2600</b></dt>
|
||
|
|
<dd>Specifies the size of the optical image file will be 2.6 gigabytes. Optical images created with this size can be written to any 2.6 GB media.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DVD4700</b></dt>
|
||
|
|
<dd>Specifies the size of the optical image file will be 4.7 gigabytes. Optical images created with this size can be written to any 4.7 GB media.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number</i></b></dt>
|
||
|
|
<dd>Specify the number of megabytes for the new image file. For optical image files, the valid range is 48-16000 megabytes. For tape image files, the valid range is 48-1000000 megabytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the text that briefly describes the image being loaded.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*GEN</u></b></dt>
|
||
|
|
<dd>For optical type image catalogs, the text field will be set to the description on the media if it exists, otherwise it will be set to the volume ID of the media. For tape type image catalogs, the text will be generated by the system using the current date and time.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BLANK</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 file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.ALCSTG"></a>
|
||
|
|
<h3>Allocate storage size (ALCSTG)</h3>
|
||
|
|
<p>Specifies for tape image files, whether to allocate the entire amount of storage specified on the <b>Image size (IMGSIZ)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MIN</u></b></dt>
|
||
|
|
<dd>Specify to only allocate storage required to initialize the tape image file at the time of the create.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMGSIZ</b></dt>
|
||
|
|
<dd>Specify to allocate the entire amount of storage specified on the <b>Image size (IMGSIZ)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.VOLNAM"></a>
|
||
|
|
<h3>Tape volume name (VOLNAM)</h3>
|
||
|
|
<p>Specifies the volume name for this virtual tape volume.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*GEN</u></b></dt>
|
||
|
|
<dd>The volume name will be generated by the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify up to a 6 character volume name used to identify this virtual tape volume. The volume name must contain only alphanumeric characters (A through Z, $, #, @, and 0 through 9), and cannot have a prefix or contain blanks. If the virtual tape volume is being created as a standard labeled tape, the volume name will also be used as the volume identifier in the tape volume label. Each volume name in the catalog must be unique.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.VOLTYP"></a>
|
||
|
|
<h3>Volume type (VOLTYP)</h3>
|
||
|
|
<p>Specifies the type of volume for this virtual tape volume.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SL</u></b></dt>
|
||
|
|
<dd>Specify the type of volume is a standard labeled tape volume.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NL</b></dt>
|
||
|
|
<dd>Specify the type of volume is a non-labeled tape volume.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.DENSITY"></a>
|
||
|
|
<h3>Tape density (DENSITY)</h3>
|
||
|
|
<p>Specifies the density for this virtual tape volume.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*VRT256K</u></b></dt>
|
||
|
|
<dd>The format of the volume is *VRT256K. It is used to write data to a virtual volume using a maximum data block size of 256KB. Volumes written using this format can only be duplicated to tape devices that support a maximum block size of 256KB or greater.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*VRT240K</b></dt>
|
||
|
|
<dd>The format of the volume is *VRT240K. It is used to write data to a virtual volume using a maximum data block size of 240KB. Volumes written using this format can only be duplicated to tape devices that support a maximum block size of 240KB or greater.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*VRT64K</b></dt>
|
||
|
|
<dd>The format of the volume is *VRT64K. It is used to write data to a virtual volume using a maximum data block size of 64KB. Volumes written using this format can only be duplicated to tape devices that support a maximum block size of 64KB or greater.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*VRT32K</b></dt>
|
||
|
|
<dd>The format of the volume is *VRT32K. It is used to write data to a virtual volume using a maximum data block size of 32KB. Volumes written using this format can be duplicated to all supported tape devices.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.NEWOWNID"></a>
|
||
|
|
<h3>New owner identifier (NEWOWNID)</h3>
|
||
|
|
<p>Specifies the identifier of the tape owner for this virtual tape volume. This parameter is only used for a volume type of *SL.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No identifier will be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify no more than 14 characters that identify the owner of the virtual tape volume. If fewer than 14 characters are specified, the field is left-justified and padded on the right with blanks.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDIMGCLGE.CODE"></a>
|
||
|
|
<h3>Code (CODE)</h3>
|
||
|
|
<p>Specifies the character code in which the volume label is written. All data that is not save data written after the label must be in the same code. Codes cannot be intermixed on a tape that is not a save tape. This parameter is only used for a volume type of *SL.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*EBCDIC</u></b></dt>
|
||
|
|
<dd>The volume label is written in EBCDIC and is an IBM standard label; all additional data must also be written in EBCDIC.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASCII</b></dt>
|
||
|
|
<dd>The volume label is written in ASCII and is an ANSI standard label; all additional data must also be written in ASCII.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDIMGCLGE.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Adding an Image Catalog Entry from CD/DVD Media</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDIMGCLGE IMGCLG(MYCLG) FROMDEV(OPT01)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command adds the optical image in device <b>OPT01</b> to the image catalog directory and updates catalog <b>MYCLG</b>. The image catalog directory is the directory specified for the <b>Directory (DIR)</b> parameter of the CRTIMGCLG command.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Adding an Image Catalog Entry from a Directory</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDIMGCLGE IMGCLG(MYCLG) FROMFILE('/MyDir/MyFile.img')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command adds the image file <b>/MyDir/Myfile.img</b> to the image catalog directory /MyNewDir and updates catalog MYCLG. The image catalog directory is the directory specified for the <b>Directory (DIR)</b> parameter of the CRTIMGCLG command.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Inserting an Image Catalog Entry</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDIMGCLGE IMGCLG(MYCLG) FROMDEV(OPT01) REPLACE(*INSERT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command adds the optical image in device <b>OPT01</b> to the image catalog directory and, if a catalog entry exists at the specified index, will insert the entry in the catalog and increment the remaining entries up to the next available index. The image catalog directory is the directory specified for the <b>Directory (DIR)</b> parameter of the CRTIMGCLG command.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Adding a New Optical Type Image Catalog Entry</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDIMGCLGE IMGCLG(MYCLG) FROMFILE(*NEW) TOFILE(MYFILE)
|
||
|
|
IMGSIZ(*CD650)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command adds new optical image file <b>MYFILE</b> to the image catalog directory with a size of 650 megabytes. The image catalog directory is the directory specified for the <b>Directory (DIR)</b> parameter of the CRTIMGCLG command.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Adding a New Tape Type Image Catalog Entry</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDIMGCLGE IMGCLG(TAPECLG) FROMFILE(*NEW) TOFILE(TAP001)
|
||
|
|
IMGSIZ(*IMGCLGTYPE) ALCSTG(*MIN) VOLNAM(MYVOL)
|
||
|
|
VOLTYP(*SL) DENSITY(*VRT256K) NEWOWNID(MYNAME)
|
||
|
|
CODE(*EBCDIC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command adds new image file <b>TAP001</b> with a volume name of <b>MYVOL</b> to the target directory with the default maximum allowed size of 1000 megabytes. Only storage required to create and initialize the virtual volume will be allocated at the time of the create. The target directory is the directory specified for the <b>Directory (DIR)</b> parameter of the CRTIMGCLG command.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Adding a New Tape Type Image Catalog Entry with Allocation.</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDIMGCLGE IMGCLG(TAPECLG) FROMFILE(*NEW) TOFILE(TAP002)
|
||
|
|
IMGSIZ(5000) ALCSTG(*IMGSIZ)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command adds new image file <b>TAP002</b> to the target directory with a maximum size of 5000 megabytes. All 5000 megabytes of storage will be allocated for this image file when it is created. The target directory is the directory specified for the <b>Directory (DIR)</b> parameter of the CRTIMGCLG command.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 7: Adding an Image Catalog Entry from the Image Catalog Directory</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDIMGCLGE IMGCLG(MYCLG) FROMFILE('/MyClgDir/MyFile.img')
|
||
|
|
TOFILE(*FROMFILE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command updates the image catalog MYCLG with information about image file <b>MyFile.img</b>.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDIMGCLGE.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPFBC28</b></dt>
|
||
|
|
<dd>Image catalog entry not added to image catalog &1.
|
||
|
|
</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="#ADDIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|