Function
Terminates the activity of a local or remote basic peripheral.
Format
TERMINATE peripheral description
where the parameter specifies the peripheral whose activity is to be terminated.
Forbidden contexts
NOT OPERATOR
Execution
If the command is issued from a remote console, it may be used only for basic peripheral in its own cluster. If it is issued from the central console it may be used for any local or remote basic peripheral.
Provided that the command can be issued from the issuing console, a check is made that the peripheral is of a basic type (CR, LP, TR, TP, CP) and that there is a request outstanding for the peripheral to be engaged. If these conditions are satisfied, the system request is cancelled: otherwise an error is signalled.
If the request is cancelled, subsequent action depends upon the nature
of the peripheral activity. If the peripheral is being used by an
object program the command has the same effect as the command
CANTDO
ENGAGE UNIT z
where z is the peripheral description and the object program
will be put into a peripheral-failed condition.
If the peripheral is being used by the system the system operation that
is in progress is terminated at the point reached. For example, if an
INPUT or
JOB command is being
implemented, the TERMINATE command will close the file that is being
created. If a
LISTFILE command is being
obeyed, the TERMINATE command will remove the appropriate entry from
the output queue. The message
UNIT z TERMINATED
will be output on the operator's console from which the command is
issued.
Examples
TERMINATE 4
Error Messages
PERIPHERAL z NOT ALLOWED IN THIS COMMAND
UNIT z NOT IN REQUIRED STATE
UNIT z NOT ON THIS INSTALLATION
UNIT z NOT IN CORRECT CLUSTER