191 lines
8.2 KiB
HTML
191 lines
8.2 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>Change Optical Attributes (CHGOPTA)</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="CHGOPTA.Top_Of_Page"></a>
|
||
|
|
<h2>Change Optical Attributes (CHGOPTA)</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="#CHGOPTA.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGOPTA.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGOPTA.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGOPTA"></a>
|
||
|
|
<p>The Change Optical Attributes (CHGOPTA) command changes the optical configuration that affects all jobs using the optical file system.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGOPTA.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="#CHGOPTA.CPYATR"><b>CPYATR</b></a></td>
|
||
|
|
<td valign="top">Copy attributes</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOPTA.HLDFATR"><b>HLDFATR</b></a></td>
|
||
|
|
<td valign="top">Held file attribute</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOPTA.ALWVRNT"><b>ALWVRNT</b></a></td>
|
||
|
|
<td valign="top">Allow variant characters</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOPTA.EXTMEDFMT"><b>EXTMEDFMT</b></a></td>
|
||
|
|
<td valign="top">Support extended media formats</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGOPTA.CPYATR"></a>
|
||
|
|
<h3>Copy attributes (CPYATR)</h3>
|
||
|
|
<p>Specifies whether to copy the file attributes of the source file when copying or moving files between the QDLS and the QOPT file systems using the HFS copy or move stream file APIs.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is ignored when copying or moving files within the optical file system and is not valid for LAN-attached optical libraries.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The CPYATR value does not change if it was previously set. Otherwise, *YES is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The file attributes, including any user-defined extended attributes, are copied. This is the default value when the operating system is shipped.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The file attributes are not copied. The file that is copied or moved is created with default file attributes, even if the file already exists and replace was specified on the QHFCPYSF request.
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
--------------- Performance Tip ---------------
|
||
|
|
- -
|
||
|
|
- This value should be set to *NO when -
|
||
|
|
- applications do not require the file -
|
||
|
|
- attributes to be maintained when copying -
|
||
|
|
- between the QOPT and QDLS file systems. -
|
||
|
|
- Using this option improves the performance -
|
||
|
|
- of move and copy operations and reduces the -
|
||
|
|
- optical storage requirements when writing -
|
||
|
|
- to an optical disk. -
|
||
|
|
- -
|
||
|
|
-----------------------------------------------
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOPTA.HLDFATR"></a>
|
||
|
|
<h3>Held file attribute (HLDFATR)</h3>
|
||
|
|
<p>Specifies whether held optical file support is enabled or disabled for the /QOPT file system. When held optical file support is disabled it is up to the user to ensure that correct recovery procedures are followed when there is a close file error condition. Refer to the Optical Support, SC41-4310 book for a further explanation of held optical files.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The HLDFATR value does not change if it was previously set. Otherwise, *YES is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Held optical file support is enabled for the optical file system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Held optical file support is disabled for the optical file system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOPTA.ALWVRNT"></a>
|
||
|
|
<h3>Allow variant characters (ALWVRNT)</h3>
|
||
|
|
<p>Indicates whether or not variant characters can be specified for path names when accessing files on optical volumes in Universal Disk Format (UDF) through the Hierarchical File System (HFS) interfaces. This parameter does not affect access to optical volumes formatted in High Performance Optical File System (HPOFS) or ISO9660 formats. It also has no affect on integrated file system interfaces for all optical media formats.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The ALWVRNT value does not change if it was previously set. Otherwise, *NO is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Indicates that variant characters are allowed for path names when accessing UDF volumes through HFS. Refer to the Optical Support, SC41-4310 book for a further explanation of which characters are allowed. When this value is specified there is no guarantee that path names will interchange correctly if accessed from another operating system. There is also no guarantee that path names will be consistent between the HFS and integrated file system interfaces.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Indicates that variant characters are not allowed for path names when accessing UDF volumes through HFS. Path names through the HFS interfaces are restricted to the following invariant characters: A-Z 0-9 + = % & ( ) , _ - . : ;. Use this value to better enable correct interchange of path names if the media is accessed from another operating system. This will also improve path name consistency between the HFS and integrated file system interfaces.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOPTA.EXTMEDFMT"></a>
|
||
|
|
<h3>Support extended media formats (EXTMEDFMT)</h3>
|
||
|
|
<p>Indicates which media format to use when a media is added to an optical device. Some media have an extended format. For instance, a UDF-Bridge Disk has ISO9660 as the basic format and Universal Disk Format (UDF) as the extended format. This parameter will let the user choose which format is to be used when a media is added to a device.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The EXTMEDFMT value does not change if it was previously set. Otherwise, *NO is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Extended format support is enabled for the optical file system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Basic format support is enabled for the optical file system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGOPTA.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOPTA CPYATR(*NO)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the optical cross-file system copy attribute value so file attributes are not copied when files are copied or moved between the QDLS and QOPT file systems in either direction using the HFS copy or move stream file APIs.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGOPTA.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOPTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|