Change Optical Attributes (CHGOPTA)

The Change Optical Attributes (CHGOPTA) command changes the optical configuration that affects all jobs using the optical file system.

Parameters

Keyword Description Choices Notes
CPYATR Copy attributes *SAME, *YES, *NO Optional, Positional 1
HLDFATR Held file attribute *SAME, *YES, *NO Optional
ALWVRNT Allow variant characters *SAME, *YES, *NO Optional
EXTMEDFMT Support extended media formats *SAME, *YES, *NO Optional

Copy attributes (CPYATR)

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.

Note: This parameter is ignored when copying or moving files within the optical file system and is not valid for LAN-attached optical libraries.

*SAME
The CPYATR value does not change if it was previously set. Otherwise, *YES is used.
*YES
The file attributes, including any user-defined extended attributes, are copied. This is the default value when the operating system is shipped.
*NO
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.

--------------- 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.                         -
-                                             -
-----------------------------------------------

Held file attribute (HLDFATR)

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.

*SAME
The HLDFATR value does not change if it was previously set. Otherwise, *YES is used.
*YES
Held optical file support is enabled for the optical file system.
*NO
Held optical file support is disabled for the optical file system.

Allow variant characters (ALWVRNT)

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.

*SAME
The ALWVRNT value does not change if it was previously set. Otherwise, *NO is used.
*YES
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.
*NO
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.

Support extended media formats (EXTMEDFMT)

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.

*SAME
The EXTMEDFMT value does not change if it was previously set. Otherwise, *NO is used.
*YES
Extended format support is enabled for the optical file system.
*NO
Basic format support is enabled for the optical file system.

Examples

CHGOPTA   CPYATR(*NO)

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.

Error messages

None