A Summary of the Process

• A WFL COPY statement which specifies a destination KIND of CD, and specifies a HOSTNAME will invoke COPYWRITE as in Example 3.
• COPYWRITE copies the A-Series files, converting them to Windows format if necessary, and then creates an A-Series disk file containing the CD-ROM volume archive.
• COPYWRITE can automatically transfer the CD-ROM volume archive to a TCP/IP host, using FTP binary transfer, as in Example 5, or call a user written WFL as in Example 6, or the volume archive can be transferred in some other way.
• The host to which the volume archive is transferred is where the CD volume can be burned. The volume archive must be transferred as a binary image. The size of the volume archive is always a multiple of 2048 bytes, the ISO9660 sector size.
• The CD-ROM volume archive is burned onto blank CD media using CDR software.
• The CD may be mounted on the target system.
• A COPY to NULL on the A-Series, or COPYWRITE for NT may be used to verify LIBRARY/MAINTENANCE CD volumes.

Creating a LIBRARY/MAINTENANCE CD-ROM Volume Archive

• In Example 3, the destination volume KIND is CD, and the HOSTNAME attribute is set. This invokes COPYWRITE, and creates by default a UNISYS LIBRARY/MAINTENANCE CD volume archive.
• The A-Series disk file containing the CD volume archive is given the same name as the destination volume name specified in the COPY statement.
• The file is created on the family of the COPY task.
• The volume name of the CD, stored in the CD image, and which appears as the family name of the CD when it is mounted, is the name of the destination volume specified in the COPY statement.
• The title of the CD volume archive can be set by setting the TITLE attribute of a file which is label equated to the WFL COPY statement, and which has an INTNAME the same as the destination volume name (See Example 28).
• This is the default action where no label equations are applied to the COPY statement.

Creating an ISO9660 Volume Archive for a WINDOWS System

• The WINDOWSNT shortcut and the WINDOWS95 shortcut can be used to create an ISO9660 volume, suitable for a Windows system. These intrinsic transforms select A-Series source files only, and translate them to ASCII with variable length records, separated by CR and LF. See Example 5.
• The difference between them is that the WINDOWS95 shortcut changes the name of each destination file by appending '.TXT'. This reduces the incidence of synonyms between directory names and file names. On the A-Series a file called A and a file called A/B can exist. The 'A' is both a file and a directory. However, on Windows, this is not allowed. Therefore when COPYWRITE attempts to add either a file, or a directory, and either a file or a directory with the same name already exists, the source file is rejected. If every file has '.TXT' appended, then file names will not clash with directory names. A site can develop their own rules for avoiding this problem, by developing a custom transform, if this is not suitable.
• A custom transform may be required to resolve other issues, such as illegal ISO9660 file names or where an A-Series name is 17 characters, and a suffix is to be added.
• The shortcuts internally set LABEL = STANDARD FILEKIND = TEXTDATA, and link to an internal transform function.

Creating an ISO9660 Volume Archive for an A-Series

• The ASERIES shortcut can be used to create a native A-Series ISO9660 volume.
• An Extended Record Attribute (XAR) is applied to each file to record some of the A-Series file attributes, such as FILEKIND and MAXRECSIZE. The data in the file remains in the INTMODE of the source file. The files are RECORD STREAM files, and they can be read directly by system software, such as Compilers, by label equation. See Example 9.
• An ODT PD - command will show the FILEKIND attribute, and an LFILES or FLEX attribute report will show the physical file structure.
• A CD-ROM archive volume such as this can be mounted and viewed on another operating system, however, the A-Series attributes will be ignored, and if the INTMODE is not ASCII, utilities such as NotePad will not be useful.
• COPYWRITE can copy the files from such a CD archive volume, and recreate the original file structure.
• The shortcut internally sets LABEL = STANDARD FILEKIND = TEXTDATA and links to an internal transform function, which applies the Extended Record Attributes.

Creating a hybrid LIBRARY/MAINTENANCE and JOLIET Volume Archive

• The LIBMAINTJOLIET shortcut may be used to create a hybrid LIBRARY/MAINTENANCE and JOLIET archive volume, suitable for use on Windows 95/98, or Windows NT with CopyWrite for NT.
• The files are registered twice in the CD-ROM archive volume. They exist in the LIBRARY/MAINTENANCE file system, and are accessible on the A-Series as LIBRARY/MAINTENANCE files. The source files are selected, and translated to ASCII, with records separated by CR and LF, and stored in the JOLIET partition, and can be accessed by Windows 95/98.
• The files on the JOLIET partition can be accessed on Windows NT using the COPYWRITE for NT utility.
• This format is used by METALOGIC for software distribution.
• The shortcut internally sets LABEL = OMITTEDEOF FILEKIND = TEXTDATA, and links to an internal transform function.

Creating a hybrid ISO9660 and JOLIET Volume Archive

• The ASERIESJOLIET shortcut may be used to create a hybrid ISO9660 and JOLIET archive volume, suitable for use natively on the A-Series, Windows 95/98 and Windows NT.
• The source files are copied to the ISO9660 partition with Extended Record Attributes. They are then copied to the JOLIET partition in ASCII with record separated by CR and LF.
• The A-Series MCP can see only the ISO9660 partition. Windows 95/98 and Windows NT, ignore the ISO9660 partition, and mount the JOLIET file system.
• On the A-Series, COPYWRITE can see all the partitions, and can be used to copy files from any of them.
• COPYWRITE for NT can see all the partitions, and can be sued to copy files from any of them.
• A site can customise a transform to create a hybrid CD-ROM archive volume.
• This shortcut internally sets LABEL = OMITTED FILEKIND = TEXTDATA, and links to an internal transform function.

Creating a customized hybrid Volume Archive

• There are a limited combination of hybrid volume types which can be created, but an unlimited number of transformations that can be applied to the data.
• The transform function is provided with the A-Series Disk File Header of the source file. The Tape Directory and the Disk File Headers are only written to the LIBRARY/MAINTENANCE partition.
• The hybrid combinations are selected by the LABEL attribute, and determine how many times the files copied are reprocessed and presented to the transform.
• If the LABEL attribute is not specified, then a LIBRARY/MAINTENANCE volume is created. A transform function can be specified with a LIBRARY/MAINTENANCE CD-ROM archive volume. It is called when the CD-ROM volume image is opened and when it is closed. It cannot be used for file selection.
• If the LABEL is STANDARD, then the records of the files being copied are handed to the transform as they are received from LIBRARY/MAINTENANCE. They are processed only once, and the result is an ISO9660 volume. A LIBRARY/MAINTENANCE file system is not created.
• If the LABEL is OMITTEDEOF, then the files being copied are stored in the LIBRARY/MAINTENANCE file system on the CD-ROM volume archive, and then the files are reread by COPYWRITE, and the records are presented to the transform, and stored in the JOLIET file system. The transform may elect to ignore files, and may modify the data being stored.
• If the LABEL is OMITTED, then the records of the files being copied are presented to the transform, where they can be modified, and stored in the ISO9660 partition. The transform can apply an A-Series Extended Record Attribute, or reject the file. After this, the files are reread by COPYWRITE, and presented to the transform a second time, where the transform can do it's business, and then the files are stored in the JOLIET partition. The transform is told what the file system is that is being processed. This option stores the files copied, as they are received from LIBRARY/MAINTENANCE in a temporary volume, and then reprocesses then for each of the other file systems, so it can be a long process and may require large quantities of disk.
• The intrinsic transforms are maintained within the COPYWRITE/LIBRARY source. They have the same interface as external transform functions.
• An ISO9660 Extended Attribute Record Format CD is an ISO9660 Data Format CD with Extended Attribute Records applied to some or all of the files. The Extended Attribute Record is recognized by the MCP (because the system identifier is 'UNISYS A SERIES') and ignored by other operating systems. The Extended Record Attributes may be set by a transform function. When a logical file on the CD-ROM is opened by a program on the A-Series, the attributes FILEKIND, MAXRECSIZE and MINRECSIZE, SECURITYTYPE, EXTMODE, CREATIONTIMESTAMP and ALTERTIMESTAMP are set from the Extended Record Attributes.