GETTAPE - ask for a tape from GCOS.

Usage:

B:
   status = gettape(filecode, reel [, density, tracks]);

C:
   int gettape(const char *filecode, const char *reel,
               [int density, int tracks] );

Where:

filecode

is a pointer to a string of the form "fc*XX", where "XX" is the file code to be used.

reel

is a pointer to a string whose first five characters give the requested reel number.

density

is a code defining what density the requested drive must be capable of handling. Manifests for the density codes are defined in "b/manif/tapeden". If not specified, a value of DEN_ANY will be used. DEN_ANY indicates you will accept any available drive.

tracks

is 7 or 9 indicating whether you want a 7 or a 9 track drive. The default is 9.

status

GETTAPE returns a zero status if a tape drive was successfully allocated.

Description:

GETTAPE may be used to attach a tape handler to your job via MME GEMORE. It will only work in batch.

A mount message is always typed by GCOS. GETTAPE does not return until the operator has mounted the tape.

The "density" argument is used to specify what density the drive must be capable of handling. It is your responsibility to set the drive to the desired density.

Notes:

The use of this function must be justified. Operators have been known to get upset at the owner of a job that comes in and suddenly requests a tape mount without prior warning.

See Also:

"b/manif/tapeden" has manifests for the tape density codes.

Copyright © 1996, Thinkage Ltd.