Real PROCEDURE FetchTapeDirectory(TapeTitle,TapeUnit,Names,nNames); 
 Value TapeTitle;                                                       
 File Names;                                                            
 Pointer TapeTitle;                                                     
 Real TapeUnit,nNames;
  Library CopyWrite;                    

If GoodFate(1) is returned,

• The Names file contains the directory entries.
• nNames is the number of directory entries returned. If nNames is 3, then record 0..2 of the Names file contain the directory entries.
• The LASTRECORD of the Names file contains an information record, with this layout,
  Word[0] - # of Words in the Information Record
  Word[1] - SERIALNO (EBCDIC Spaces for CD)
  Word[2] - LABELKIND (0 for CD)
  Word[3] - DENSITY (0 for CD)
  Word[4] - CREATIONDATE
  Word[5] - SAVEFACTOR (0 for CD)
  Word[6] - KIND (DISK or CD for CD Images)
  Word[7] - Image Title in Display Form, terminated by "."
• Each directory entry record of the Names file has this layout,
  Byte [0] - <standard form file name>
  Byte[255] - <key length byte><key>
  Byte[511] - <VerifyKey Result Word>

This call is passed to the MCP, which uses the TapeTitle to locate a mounted Library/Maintenance Tape.

This call is passed to the MCP, which uses the TapeTitle to locate a mounted CDROM family.

This call is passed to the MCP, which uses the TapeUnit to locate either a mounted Tape or CD.

COPYWRITE tries to open the file with KIND=CDROM, and if that fails, it then tries with KIND=DISK. The FILEKIND of the file is used to determine the type of file (PROMBURNERDATA for CDROM Images, or WRAPPEDDATA or CONTAINERDATA for Wrapped files, and LIBMAINTDIRECTORY for Library/Maintenance Directory files).

COPYWRITE sets the TITLE and then tries to open a file with KIND=CDROM, and then KIND=DISK. If the file is opened and the selected partition exists, the file names are converted to A-Series file titles.

The TapeUnit is used to locate a mounted CDROM. The TapeTitle is used to select the partition. If the partition exists, the file names are converted to
A-Series file titles.

COPYWRITE searches the CDROM units for a mounted CD with a matching family name. If it finds the family, and the partition exists, the file names are converted to A-Series file titles.

Real PROCEDURE FetchTapeHeaders(TapeName,Directory,Tape_Info,F_Proc);
Array TapeName[*], Directory[*], Tape_Info[*];
 Boolean PROCEDURE F_Proc(Hdr, Misc);
  Array Hdr[*], Misc[*];
   FORMAL; 
 Library CopyWrite; 

See the Documentation in MCP System Interfaces Programming Reference Manual.

This section documents the additions to the MCP interface.

MiscLenX = 0#, % Total and Fixed Length of MISC Array
MiscTotLenF = [39:20]#,
MiscFixLenF = [19:20]#,
MiscFlagX = 1#, % Options Bits and Validity Flag
MiscValidF = [47:8]#,
MiscOptionsF = [39:40]#,
MiscFNoX = 2#, % File # on Tape
MiscSerX = 3#, % SerialNo of Tape
MiscFamX = 4#, % Origin (3 Words)
MiscHVerX = 7#, % Header Version on Tape
MiscFixLen = (MiscHVerX + 1)#;

This call is passed to the MCP, which uses the <unit number> to locate either a mounted Tape or CD.

This call is passed to the MCP, which uses the TapeName to locate a Tape Volume.

This call is passed to the MCP, which uses the TapeName to locat a CDROM Family.

The standard form <image title> is used to find a CD Image(PROMBURNERDATA), Wrapped Container(CONTAINERDATA or WRAPPEDDATA) or LIBMAINTDIRECTORY, on DISK.

The standard form <image title> is used to find a CD Image file(PROMBURNERDATA) , Wrapped Container(CONTAINERDATA or WRAPPEDDATA) or LIBMAINTDIRECTORY, on a CDROM.

The standard form <image title> is used to find a CD Image(PROMBURNERDATA), Wrapped Container(CONTAINERDATA or WRAPPEDDATA) or LIBMAINTDIRECTORY, using a file with KIND = DONTCARE.