Perform a logical comparison between two ISO-9660 CDROMs or disc images.

Format

$ LJK/CDROM COMPARE file-1 file-2

or

LJKCÑ COMPARE file-1 file-2

restrictions

• You must have read access to the ISO-9660 CDROMs or disc images.
• If either of the parameters is a device rather than a file image, it must be mounted foreign.

Parameters

file-1

Name of the first ISO-9660 CDROM or disc image to be compared.

file-2

Name of the second ISO-9660 CDROM or disc image to be compared.

Description

Perform a logical comparison between two ISO-9660 CDROMs or disc images.

Qualifiers

/DATA

/NODATA (D)

Specifies that the contents of individual files on the two ISO-9660 CDROMs or disc images are compared in addition to the metadata.

This qualifier can cause a considerable increase in the time required for execution of the COMPARE command, particularly if one or both of the ISO-9660 CDROMs or disc images specified are CDROM or DVD drives, since they have slow seek times compared to magnetic disks.

/SHOW=DEBUG

DETAILS

MULTIPLE_ERRORS (D)

PROGRESS (D)

SUMMARY (D)

Specifies what information should be displayed during the command.

• DEBUG
  Display extremely detailed information suitable for submitting a bug report.
• DETAILS
  Display detailed information suitable for analyzing a problem.
• MULTIPLE_ERRORS
  Display even those errors that were encountered on a previous file.
• PROGRESS
  Display indications of progress in processing the command.
• SUMMARY
  Display a summary of major results of the command.

Example

$ LJK/CDROM COMPARE DKA400: TEST.DAT
      

Compare the Volume on DKA100: (currently mounted /FOREIGN) to the volume image in file TEST.DAT of the current default directory.

$ LJK/CDROM COMPARE TEST.DAT/DATA TEST.DIT
      

Compare the volume images in files TEST.DAT and TEST.DIT including the data within individual files.

Create (and name for use within LJK/CDROM) a Hierarchy to be used on the Volumes to be written.

Format

LJKCÑ CREATE HIERARCHY hierarchy-name

restrictions

• This command is only effective from the subsystem prompt (LJKCÑ).

Parameters

hierarchy-name

Name of the Hierarchy to be created.

Description

Create (and name for use within LJK/CDROM) a Hierarchy to be used on the Volumes to be written.

Qualifiers

/ABSTRACT_FILE=d- or d1-characters

Specifies the Abstract File Identifier for this Hierarchy on each Volume in the Volume Group being written.

This field is interpreted as the File Identifier for a file in the Root Directory of each Volume being created. The field must follow the syntax rules for a File Identifier in this Hierarchy and must represent a file that exists in that Directory. The File Name must have a maximum length of 8 and the File Name Extension must have a maximum length of 3.

/APPLICATION=a- or a1-characters

Specifies the Application Identifier for this Hierarchy on each Volume in the Volume Group being written.

If this field starts with the character underscore (_), the rest of the field is interpreted as the File Identifier for a file in the Root Directory of each Volume being created. That remainder of the field after the underscore must follow the syntax rules for a File Identifier in this Hierarchy and must represent a file that exists in that Directory. The File Name must have a maximum length of 8 and the File Name Extension must have a maximum length of 3.

/APPUSE=input-filespec

Specifies a file containing data that is to be included in the Application Use field for this Hierarchy on each Volume in the Volume Group being written.

/BIBLIOGRAPHIC_FILE=d- or d1-characters

Specifies the Bibiographic File Identifier for this Hierarchy on each Volume in the Volume Group being written.

This field is interpreted as the File Identifier for a file in the Root Directory of each Volume being created. The field must follow the syntax rules for a File Identifier in this Hierarchy and must represent a file that exists in that Directory. The File Name must have a maximum length of 8 and the File Name Extension must have a maximum length of 3.

/CHARACTER_SET=name

Specifies the Character Set for this Hierarchy.

/COPYRIGHT_FILE=d- or d1-characters

Specifies the Copyright File Identifier for this Hierarchy on each Volume in the Volume Group being written.

This field is interpreted as the File Identifier for a file in the Root Directory of each Volume being created. The field must follow the syntax rules for a File Identifier in this Hierarchy and must represent a file that exists in that Directory. The File Name must have a maximum length of 8 and the File Name Extension must have a maximum length of 3.

/CREATION=date-time

Specifies the Volume Creation Date and Time for this Hierarchy on each Volume in the Volume Group being written.

/DATA_PREPARER=a- or a1-characters

Specifies the Data Preparer Identifier for this Hierarchy on each Volume in the Volume Group being written.

If this field starts with the character underscore (_), the rest of the field is interpreted as the File Identifier for a file in the Root Directory of each Volume being created. That remainder of the field after the underscore must follow the syntax rules for a File Identifier in this Hierarchy and must represent a file that exists in that Directory. The File Name must have a maximum length of 8 and the File Name Extension must have a maximum length of 3.

/EFFECTIVE=date-time

Specifies the Volume Effective Date and Time for this Hierarchy on each Volume in the Volume Group being written.

/EXPIRATION=date-time

Specifies the Volume Expiration Date and Time for this Hierarchy on each Volume in the Volume Group being written.

/LOGICAL_BLOCK_SIZE=value

Specifies an alternate Logical Block Size to the standard 2048 bytes with which Hierarchies are created. The Logical Block Size must be the same for all the Hierarchies on a Volume.

/POSIX=IEEE_P1282 (D)

RRIP_1_09

Specifies the POSIX Rock Ridge version to be used in this Hierarchy. If no value is specified for the /POSIX qualifier, IEEE_P1282 is used. If the /POSIX qualifier is not specified, no Rock Ridge format will be used. Using a Rock Ridge format does consume extra space on the Volume.

/MODIFICATION=date-time

Specifies the Volume Modification Date and Time for this Hierarchy on each Volume in the Volume Group being written.

/PUBLISHER=a- or a1-characters

Specifies the Publisher Identifier for this Hierarchy on each Volume in the Volume Group being written.

If this field starts with the character underscore (_), the rest of the field is interpreted as the File Identifier for a file in the Root Directory of each Volume being created. That remainder of the field after the underscore must follow the syntax rules for a File Identifier in this Hierarchy and must represent a file that exists in that Directory. The File Name must have a maximum length of 8 and the File Name Extension must have a maximum length of 3.

/SET_IDENTIFIER=string

Specifies the Volume Set Identifier for this Hierarchy on each Volume in the new Volume Set being created. This qualifier should not be specified when the command LINK GROUP has previously been given, since the Volume Set Identifier in that case must come from the prior Volume Group.

The default value for this qualifier is the current VMS date-time with punctuation removed and truncated to 13 characters, for example: "09SEP20021234".

For those using the VMS Hobbyist license, an identification number will be appended to the specified (or defaulted) Volume Set Identifier.

/SETSIZE=maximum

Specifies the maximum number of Volumes that can be included in the Volume Set, including both those being created now and any used to create previous Volume Groups within the Volume Set. If the files specified with the commands LINK GROUP, ADD and WRITE exceed the capacity of this number of Volumes, an error message will be displayed before any output data is written.

The ISO-9660 specification limits the maximum Volume Set Size to 65535.

/SPACE=logical-block-count

Specifies the number of logical blocks on the output Volume. When the output Volume is a volume image file, this is the size with which it will be created (taking into account the difference in size between Logical Blocks and VMS blocks.

The maximum number of Logical Blocks that can be specified is the number that would result 2**31 (about 2 billion) VMS blocks.

/SYSTEM=character-list

Specifies the System Identifier that is to be included in this Hierarchy, identifying the system which is able to act on the System Area (Logical Sectors 0-15) of the created Volume.

Generally this qualifier should be omitted.

/VOLUME=volume-name-list

Specifies the list of Identifiers to be used as the Volume Identifier in this Hierarchy on successive Volumes of the Volume Group being written in this session.

If a single name is provided for the list and it contains an asterisk (*), the asterisk will be replaced by the Volume Sequence Number in each Volume Identifier as it is written.

If a single name is provided for the list and it contains no asterisk (*), that name will be used intact for the Volume Identifier in this Hierarchy on each Volume of the current Volume Group. There is no requirement in ISO-9660 that the Volume Identifier of various Volumes differ from one another.

Example

LJKCÑ CREATE HIERARCHY SPECIAL/VOLUME=(ONE,TWO)
      

Create a Hierarchy which will use "ONE" as the Volume Identifier of the first Volume created and "TWO" as the Volume Identifier for all subsequent Volumes created.

LJKCÑ CREATE HIERARCHY MY_NAME/VOLUME=(DISC*)
      

Create a Hierarchy which will use "DISCnnn" as the Volume Identifier of Volume nnn of the Volume Set, where nnn is a variable width decimal representation.

Define the characters than can be used for Directory Identifiers, File Identifiers and other metadata within one or more Hierarchies.

Format

LJKCÑ DEFINE CHARACTER_SET -

character-set-name

restrictions

• This command is only effective from the subsystem prompt (LJKCÑ).

Parameters

character-set-name

Name used within LJK/CDROM for the Character Sets.

Description

Define the characters than can be used for Directory Identifiers, File Identifiers and other metadata within one or more Hierarchies.

The need to use the DEFINE CHARACTER_SET command is reduced by the fact that LJK/CDROM already provides the following six built-in Character Sets:

• LJK$ISO9660 - A-Z, digits and underscore
• LJK$MICROSOFT_L1 - Microsoft characters, 8.3 File Identifiers, Files cannot span Volumes
• LJK$MICROSOFT_L2 - Microsoft characters, Files cannot span Volumes
• LJK$MICROSOFT_L3 - Microsoft characters
• LJK$VMS - A-Z, digits, underscore, dollar sign and dash
• LJK$VMS_EXTENDED - ODS-5 characters (i.e., all 8-bit characters but "*" and "?")

The primary Hierarchy will always use the LJK$ISO9660 Character Set.

The DEFINE CHARACTER_SET command establishes a connection between the escape strings value to be recorded on the Volume and the characters that will be accepted on ADD and READ commands. LJK/CDROM does not check the legality of the characters specified against the escape strings specified based on the ISO-2022 standard; that is left to the user.

LJK/CDROM does check to ensure that the characters specified by the /A1_CHARACTERS and /D1_CHARACTERS are restricted to the G0 and G1 ranges (i.e., not having decimal values 0-31 or 128-159) as specified by ISO-9660 and ISO-2022.

Qualifiers

/ESCAPE_STRINGS=character-list

Specify ISO-2022 G0 and optionally G1 graphic characters sets that form the C-Characters set available for Directory Identifiers, File Identifiers and other metadata.

/A1_CHARACTERS=character-list

Specify which of the C-Characters can be used for metadata other than File Identifiers and Directory Identifiers.

If no /A1_CHARACTERS qualifier is specified, the A1-Characters set will be the A-Characters set of A-Z (uppercase only), digits, underscore, space and the characters "!"%&'()*+,-./:;<=>?@".

/D1_CHARACTERS=character-list

Specify which of the C-Characters can be used for File Identifier and Directory Identifier metadata.

If no /D1_CHARACTERS qualifier is specified, the D1-Characters set will be the D-Characters of A-Z (uppercase only), digits and underscore.

Example

LJKCÑ DEFINE CHARACTER_SET MY_CHARS/D1_CHARACTERS=0123456789
      

Define a Character Set where File Identifiers and Directory Identifiers can only contain digits (along with the required SEPARATOR 1 (.) and SEPARATOR 2 (;) for a File Identifier.

Exit from the LJK/CDROM subsystem back to the VMS command language.

Format

LJKCÑ EXIT

restrictions

None.

Parameters

None.

Description

Exit from the LJK/CDROM subsystem back to the VMS command language.

Qualifiers

None.

Example

LJKCÑ EXIT
      

Exit from the LJK/CDROM subsystem back to the VMS command language.

Displays information to assist in using the command interface.

Format

$ HELP LJK/CDROM [keyword...]

or

$ LJK/CDROM HELP [keyword...]

or

LJKCÑ HELP [keyword...]

restrictions

None.

Parameters

keyword...

Specifies one or more keywords that refer to topics (typically commands) in the system help library for LJK/CDROM.

If you use an asterisk in place of any keyword, the HELP command displays all information available at the level the asterisk replaces. For example, LJK/CDROM HELP VERIFY * displays all the subtopics under the topic VERIFY.

If you use an ellipsis immediately after any keyword, HELP displays all the information on the specified topic and all subtopics of that topic. For example, LJK/CDROM HELP VERIFY... displays information on the VERIFY topic as well as any information on all the subtopics under VERIFY.

You can use percent signs and asterisks in the keyword as wildcard characters.

As with other uses of the VMS HELP facility, you can give additional keywords to get further detail after the Topic? prompt.

prompts

Description

Display information to assist in using the command interface to LJK/CDROM.

Qualifiers

None.

Example

$ LJK/CDROM HELP VERIFY/TOLERATE
      

Display information about the /TOLERATE qualifier to the command VERIFY.

$ LJK/CDROM HELP VERIFY *
      

Display information about all subtopics for the VERIFY command.