tcl.t-det Verb: Access/Tape Commands

tcl.t-det

Command tcl.t-det Verb: Access/Tape Commands
Applicable release versions: AP, R83
Category Tape Commands (36)
Description detaches the tape from the current process, or from another process.

If no device.number is specified then the currently attached tape device is detached (on AP 6.1 and greater, all devices currently attached to this process would be detached).

On AP/Unix systems, this command detaches the tape from the current port, so that other processes, other Unix users, or other Pick virtual machines may use it.

On AP 6.1 and greater, the device.number must be specified or all tape devices attached to this port are detached.

On AP/Unix systems, the "u" option has to send a Unix signal to the process which owns the tape to force it to close the device. This is done through the 'trap' mechanism (see the TCL command 'trap'). The default trap for this signal is the TCL command 't-det'. If the System Administrator disables this trap, or uses another command (like displaying a message to ask the user to detach the tape instead of taking the tape forcefully), the command fails with the message "The tape is not available for use now". The "z" option works only if the owner is the transaction logger.
Syntax t-det {device.number} {(option}
Options u Detaches the tape unit from any port except the Spooler, which detaches automatically at the end of each job. This requires a sys2 privilege level. On AP 6.1 and greater, the device.number must be specified or all tape devices are detached.

z Unconditionally detaches the tape, except if the tape is attached to the transaction logger.
Example
Purpose
Related tcl.t-status
tape.handling.verbs
tcl.trap
port.number
tcl.t-select
tcl.t-stat
transaction.logger
tcl.t-det.link