<archive cd volume attribute list>

── ( ─┬─────────────┬─┬─ CD ────┬──────────────────────────────────────►
      └─ KIND ── = ─┘ └─ CDROM ─┘
  ┌◄────────────────────────────────────────────────┐
►─┴─ , ─┬─ CDCOPIES ── = ──<integer expression>───┬─┴─ ) ──────────────┤
        ├─ DENSITY ── = ──<cd density>────────────┤
        ├─ ENCRYPT ── = ─┬─ NO ───────────────────┤
        │                ├─ AES256 ───────────────┤
        │                ├─ AESGCM ───────────────┤
        │                └─ TDES ─────────────────┤
        ├─ ENCRYPTVERSION ── = ─┬─ V1 ────────────┤
        │                       └─ V2 ────────────┤
        ├─ OFFSITE ─┬─────────────────────────────┤
        │           └─<Boolean expression>────────┤
        ├─ PACKETWRITE ─┬─────────────────────────┤
        │               └─<Boolean expression>────┤
        ├─ SAVEFACTOR ── = ──<integer expression>─┤
        └─ SERIALNO ── = ──<serial number>────────┘

Explanation

You can specify the following attributes for the archive tape volume attribute list:

CDCOPIES

The CDCOPIES value specifies how many duplicate CD-ROM volumes should be created. A value of 2 indicates one original and one duplicate. A value of 3 indicates one original and two duplicates. Do not get CDCOPIES mixed up with the extra CD-ROM volumes the archive process creates when the files it is copying overflows the first volume. The archive process creates duplicates of each overflow volume according to the value of CDCOPIES.

DENSITY

The DENSITY value identifies the size of the CD image that needs to be created and burnt on to the CD or DVD media. Refer to the section on DENSITY in the File Attributes Programming Reference Manual for the allowable values.

ENCRYPT

Specifies that library maintenance encrypt the data it writes to the specified destination CD. The following three encryption algorithms are provided:

To use AESGCM, Media Encryption Version 2 is required.

You cannot specify ENCRYPT for a source CD. Library maintenance automatically decrypts data when reading from an encrypted CD, so you can use a simple COPY statement to copy files from an encrypted CD:

COPY ... files ... FROM <CD name>;

ENCRYPTVERSION

Specifies the Media Encryption Version to be used. This overrides the value of the SYSOPS LMDEFENCRYPT version.

MULTIVOLUME

If you specify the MULTIVOLUME attribute, the WFL compiler issues a syntax error. The archive system automatically sets the MULTIVOLUME attribute.

OFFSITE

If you set the OFFSITE attribute to TRUE, the system marks the backup records it creates as referring to an offsite volume. During an archive restore, the system does not use volumes marked as offsite unless there are no better alternatives.

PACKETWRITE

The PACKETWRITE attribute determines whether the archive process writes the CD‑ROM volumes in track-at-once mode or packet mode. Track-at-once mode (the default) is more efficient, and the resulting CD-ROM volumes can be read by CD-ROM and CD-R units. Packet mode avoids possible buffer underrun I/O errors during the write process and so is safer, but packet mode CD-ROM volumes can be read only by CD-R units.

The MCP enables the buffer underrun prevention feature on CD-RW drives that support it. With this feature enabled, these drives resume writing after a buffer empty condition. Thus, buffer underrun does not occur in track-at-once mode, and there is no need to use the packet mode.

SAVEFACTOR

The SAVEFACTOR attribute indicates the expiration date of the CD-ROM volume in terms of the number of days past the creation date. The default value for archive CD‑ROM volumes is 30 days.

When an ARCHIVE backup, ARCHIVE ROLLOUT, or ARCHIVE MERGE request makes a backup copy of a file that already has 4 backup copies, the system replaces the backup copy that has the earliest expiration date. If the expiration dates are the same, the system replaces the backup copy that has the earliest creation date.

SERIALNO

You can optionally specify one serial number. The system uses that serial number for each of the CD-ROM volumes it creates during the backup process. If you do not specify a serial number the system gives the output CD-ROM volumes a serial number of the form YYMMDD, where the first two digits indicate the year, the next to digits indicate the month, and the last two digits indicate the day of the month.