Creating Media

Use the CREATE command of the CDFORMAT program to create media.

Syntax

── CREATE ──<CD-ROM name>──────────────────────────────────────────────►
►─┬────────────────────────────────────────────────────┬───────────────┤
  │     ┌◄────────────────── , ──────────────────┐     │
  └─ [ ─┴─┬─ MCPNATIVE ────────────────────────┬─┴─ ] ─┘
          ├─ JOLIET ───────────────────────────┤
          ├─ CCSVERSION ── = ─┬─<version>──────┤
          │                   ├─ JAPAN ────────┤
          │                   ├─ JAPAN_V24 ────┤
          │                   ├─ TAIWAN ───────┤
          │                   ├─ CHINA ────────┤
          │                   └─ KOREA ────────┤
          ├─ SERIALNO ── = ─┬─<integer>────────┤
          │                 └─<quoted string>──┤
          ├─ DENSITY ── = ─┬─ CD650 ───────────┤
          │                ├─ CD700 ───────────┤
          │                └─ DVD4700 ─────────┤
          ├─ IMAGEFAMILY ── = ──<family name>──┤
          ├─ CDLOADER ─┬───────────────────────┤
          │            └─ " ──<note text>── " ─┤
          ├─ CDCOPIES ── = ──<integer>─────────┤
          ├─ NOBURN ───────────────────────────┤
          └─ SKIPMISSING ──────────────────────┘
         ┌◄───────────────────────── , ─────────────────────────┐
── WITH ─┴─┬─<file name>─┬────────────────┬─┬─────────────────┬─┴──────┤
           │             └─<ON_pack name>─┘ └─<AS_file name>──┤
           │     ┌◄───────────────── , ────────────────┐      │
           └─ [ ─┴─┬─ BYTESTREAM ────────────────────┬─┴─ ]  ─┘
                   ├─ CCSVERSION ── = ─┬─<version>───┤
                   │                   ├─ JAPAN ─────┤
                   │                   ├─ JAPAN_V24 ─┤
                   │                   ├─ TAIWAN ────┤
                   │                   ├─ CHINA ─────┤
                   │                   └─ KOREA ─────┤
                   ├─ PUBLIC ────────────────────────┤
                   └─ PRIVATE ───────────────────────┘

Explanation

<file name>

If the file name specifies a permanent directory or pseudo directory in the MCP file system, a final node consisting of an equal sign is required.

<AS_file name>

If the final node of the corresponding first file name was an equal sign, the final node of the AS file name must also be an equal sign.

MCPNATIVE

If this option is selected, the System Identifier field of the ISO 9660 label is used to record that the CD-ROM is intended for use on Unisys MCP-based systems. Usercodes are permitted in destination file names and are implicitly added to destination file names that do not begin with an asterisk (*) or a usercode. SECURITYTYPE is recorded and is PRIVATE unless the source file was PUBLIC. (PUBLIC or PRIVATE specified in this command overrides the value of the file.) However, SECURITYTYPE is enforced only when the CD-ROM is mounted on an MCP-based system. If the CD-ROM is mounted on another system, all files are accessible. File data is handled as follows:

  • If BYTESTREAM is specified, or the files to be copied are of FILEKIND BACKUPPRINTER, the file is converted to a byte-stream ASCII data file, just as if MCPNATIVE had not been specified.

  • If BYTESTREAM is not specified and the files to be copied are not of FILEKIND BACKUPPRINTER, the record-oriented nature, the FILEKIND, and the EXTMODE of the file are preserved. (These preserved attributes are effective only when the CD-ROM is mounted on an MCP-based system.)

If the MCPNATIVE option is not selected, a generic ISO 9660 CD-ROM is created. All record-oriented files are converted to byte-stream ASCII data files. The text field of each record is extracted, trailing blanks are removed, and CR/LF (carriage return/line feed) is appended. If the source character set (EXTMODE) is some variant of EBCDIC, the data is translated to some form of ASCII. (See the description of CCSVERSION later in this section.) Usercodes are not permitted in destination file names and are not implicitly added to destination file names.

Note: If MCPNATIVE is specified, JOLIET cannot be specified.

JOLIET

When this option is selected, a Joliet format CD-ROM is created. The Joliet format has two directory structures:

  • Standard ISO 9660 directory

    The standard ISO 9660 directory structure follows ISO 9660 restrictions on file identifier length and character set. The CDFORMAT program stores 8.3 aliases in the standard ISO 9660 directory structure.

  • Joliet directory

    The Joliet directory allows file identifiers up to 64 characters and allows all characters except the asterisk, forward slash, colon, semicolon, question mark, and backslash.

    The CDFORMAT program stores fully internationalized file identifiers in the Joliet directory structure, using the NX/Services mapping between the MCP file name and the PC file identifier. The mapping is based on the SYSOPS CCSVERSION and (when SYSOPS CCSVERSION ASERIESNATIVE) SYSOPS HOSTCCS. See CCSVERSION below for a description of the effect of HOSTCCS.

    Note: If JOLIET is specified, MCPNATIVE cannot be specified.

CCSVERSION

Indicates the proper internationalization of the translation to be used when the text of a record-oriented EBCDIC file is translated to a byte-stream ASCII file. The overall value and the file-specific value specified in this option override the default, in that order.

The default is the system-wide value established by SYSOPS CCSVERSION and (when SYSOPS CCSVERSION is ASERIESNATIVE) SYSOPS HOSTCCS.

When SYSOPS CCSVERSION is ASERIESNATIVE, the following values of HOSTCCS enable the specified support.

HOSTCCS

Local

EBCDICUTL

TAIWAN

EBCDICGB2312

CHINA

EBCDICKSC5601

KOREA

JAPANEBCDICJBIS8

JAPAN

Note: The file-specific value is unused and ignored if MCPNATIVE is specified but BYTESTREAM is not.

SERIALNO

Causes the specified serial number to be added to the label on the CD. That serial number then appears in the PER CD display when the CD is mounted, and can be specified on file open to resolve situations where multiple CDs have the same name.

SERIALNO can be specified only when MCPNATIVE is specified, because the serial number is stored in the “Application Use” area of the ISO 9660 label. The MCP will assumes that “Application Use” contains a serial number only when the “System Identifier” field indicates that the CD is a MCPNATIVE CD.

When MCP-environment programs read files from ISO 9660 CDs:

  • If SERIALNO is not specified for the source file, a source CD is used regardless of whether it has a serial number or not.

  • If SERIALNO is specified for the source file, a source CD will be used only if it has a serial number and that serial number matches the specified value.

IMAGEFAMILY

Indicates the family on which the CD-ROM image is to be placed. (The default is based on the FAMILY specification under which the program is run.) This family must have enough free space for the entire CD-ROM image. If a CD-R disc is to be burned, contention for this family must be low enough that data can flow continuously to the CD-R drive.

DENSITY

DENSITY = CD650 causes the CDFORMAT program to use up to 650 MB of CD data capacity. If more than 650 MB of CD data capacity is required, a 700-MB CD media must be used.

DENSITY = CD700 causes the CDFORMAT program to use up to 700 MB of CD data capacity. If more than 650 MB of CD data capacity is required, a DVD-R or DVD+R media must be used.

DENSITY = DVD4700 causes the CDFORMAT program to burn the data to a DVD-R or DVD+R media, and use up to the full data capacity of the DVD.

CDLOADER

Indicates that the CD-R disc is to be burned on a CD-R drive in a CD jukebox. This option works only if a CD jukebox with at least one CD-R drive is connected and properly configured. CD jukebox support is available as a customer engineering request (CER).

If present, the <note text> is parsed into sections delimited by vertical bar characters. The first section, if not empty, indicates the name of the Word file to be used to print a label on the top surface of the CD. (The Word file must be on the PC controlling the CD jukebox.) The remaining sections provide the data for the User Info fields in the Merge, done when the label is printed.

CDCOPIES

Specifies the number of CD-R discs to be burned. The default is one.

NOBURN

Specifies that a CD-R disc is not to be burned. Instead, a file containing the CD-ROM image and named CDROMIMAGE/<cd-rom name> is created.

The NOBURN option is useful if a CD-R drive mounted on a PC is available. FTP or NX/Services could be used to copy the image file to the PC, where a CD-R disc could be burned, if suitable software exists on the PC for burning this type of image. Unisys does not supply or support any software for this purpose.

SKIPMISSING

Missing files will be skipped, with a warning message. Without this option, a missing file causes fatal error.

BYTESTREAM

PUBLIC

PRIVATE

See “MCPNATIVE”. These options are ignored if MCPNATIVE is not specified.

Alternative Syntax

── FILE ──<file name>──────────────────────────────────────────────────┤

Explanation

Specifies a file which is to be read to obtain a CREATE command as previously specified.

The entire file is read. However, only the text portion of each record, as inferred from FILEKIND, is used.