{arcane}This key is actually a red segment key that stores some tape information (such as the reel number, default format, capabilities, and label information) and has TAPEKEY as its segment keeper.

TAPEKEYF(kt ==> x'72b')

TAPEKEYF(kt+5;SB,M,AC ==> kt+5;,,,,CO)

CO(0,(n*6,reel) ==>c;TAPEKEY,NODEKEY)

A Tapekey factory call to get a tapekey. If the extended jump is not used, the reel id is not filled in. This is used for reel switching. REEL is a string of characters that is a multiple of 6 characters. Each 6 characters represents a reel id. There must be no more than 2400 characters in the request.

Return codes

c = 0 ok

c = 1 SB not prompt

c = 2 SB has insufficient space

c = 3 reel not multiple of 6 characters

c = 4 too many reels

AC specifies an account that will be billed for use of the tape.

The designated tape reel will be mounted on an available drive. If none is available at the moment, the mount will be refused. If the tape is in use the mount will be refused.

The label is verified . If the tape is an unlabelled tape, the checksum of the first block is verified. Any tape may have its label overwritten by a Make Unlabelled operation. Any unlabelled tape that is written on at load point has its checksum updated.

Return codes

c = 0 the tape is mounted

c = 1 no drives available

c = 2 tape is in use

c = 3 mount refused by operator

c = 6 tape already mounted

AC specifies an account that will be billed for use of the tape.

The designated tape reel will be mounted on an available drive. If none is available at the moment, the mount will be refused. If the tape is in use the mount will be refused.

The label is verified. If the tape is an unlabelled tape, the checksum of the first block is verified. Any tape may have its label overwritten by a Make Unlabelled operation. Any unlabelled tape that is written on at load point has its checksum updated.

Return codes

c = 0 the tape is mounted

c = 1 no drives available

c = 2 tape is in use

c = 3 mount refused by operator

c = 6 the tape is already mounted

The tape is dismounted and the drive is freed.

Return codes

c = 0 done

c = 1 Tape not mounted

The next reel in a multivolume tape is mounted. The current reel is dismounted.

Return codes

c = 0 done

c = 1 tape not mounted

c = 2 no next reel

Extended jump protocol is used because the TAPEKEY cannot accept a string on its first call. TAPEKEY(kt+5 ==> kt+5;,,,CO) CO(4,(1,F^V^U)(2,BLKSIZE)(2,LRECL)(1,DEN); ==> c)

The default format (Record format
FIXED/VARIABLE/UNFORMATTTED, block length, and record length) is set. For labelled tapes these values are overridden by the values in the tape label (for input) or by values specified on the OPEN of files for output. For unlabelled tapes, these values may be overridden at OPEN.

BLKSIZE is between 0 and 32769. LRECL is between 0 and 4097. DEN is one of the following values; 2,3,4,5 where 2 means 800 bpi,3 means 1600 bpi,4 means 6250 and 5 means (future density).

Return codes

c = 0 done

c = 1 not allowed

c = 2 length not 5 or 6 bytes

c = 3 recfm not F or V or U

c = 4 lrecl not 0<<4097

c = 5 blocksize not 0<<32769

c = 6 density specification is invalid

Extended jump protocol is used because the TAPEKEY cannot accept a string on its first call. If no string is to be passed then the extended jump need not be used and the string is assumed to be one byte of zero.

A new key is generated. It may have more restricted rights than the key it comes from. The key may be rescinded (kt+4). The capability mask is a 1 byte mask with each bit representing a restriction of rights.

Mask

x'04' disallow privileged operations {verify label, mount unverified}.

x'08' disallow make unlabelled operation.

x'10' disallow release tape operation. {This restriction is always present in any key that is a descendant of the key obtained from the tape librarian key}.

x'20' disallow set format operation.

x'40' disallow write operation.

x'80' disallow read operation.

Return codes
c = 0 done

c = 1 bad mask {more than 1 byte}

c = 2 cannot copy key {tape is mounted}

The same operation as TAPEKEY(0) except that the label is not verified. This is restricted to librarian functions (under control of the access rights of the tape).

The same operation as TAPEKEY(1) except that the label is not verified. This is restricted to librarian functions (under control of the access rights of the tape).

The reels from the offered tapekey are added to this tapekey. The offered tapekey is destroyed. This must be done with the key obtained from the librarian (the master key) to avoid having a reel be both the first volume in a set and part of a string of secondary reels of another set.

Return codes

c = 0 done

c = 1 offered key is not a tape key

c = 2 offered tapekey is not the master

c = 3 this tapekey is not the master

c = 4 tapekeys do not have the same label type

c = 5 tapekeys are the same

The key from the factory is unrestricted. This key is used by the Manager to write labels on tapes or to read the first block on the tape. The key is restricted before it is given to the user.

Return codes

c = 0 done

A privileged operation that sets the tape format. Used after a restoration of the tape library so that the operators do not have to mount each tape after each Big Bang.

Extended jump protocol is used.

The string is written on the operators console. Only the first 60 bytes is actually sent. Note that extended jump protocol is used because the TAPEKEY does not have storage unless it needs it.

AC is an account key that will be credited for the value of the tape.

Return Codes

c = 0 complete, tape released to library.

c = 1 complete, tape not release to library (no release rights).