4.26 canc-cmd

This command halts processing and output of the copy-ext-stats, rept-imt-info, rept-stat-applsock, rept-stat-as, rept-stat-assoc, rept-stat-card, rept-stat-clk, rept-stat-dstn, rept-stat-ls, rept-stat-rte, rept-stat-slk, rept-stat-trbl, rtrv-appl-rtkey, rtrv-as, rtrv-assoc, rtrv-cmd, rtrv-dstn, rtrv-gta, rtrv-gtt, rtrv-lbp, rtrv-log, rtrv-ls, rtrv-map, rtrv-mrn, rtrv-obit, rtrv-rte, rtrv-scr-aftpc, rtrv-scr-blkdpc, rtrv-scr-blkopc, rtrv-scr-cdpa, rtrv-scr-cgpa, rtrv-scr-destfld, rtrv-scr-dpc, rtrv-scr-isup, rtrv-scr-opc, rtrv-scrset, rtrv-scr-sio, rtrv-scr-tt, rtrv-seculog, rtrv-secu-user, rtrv-slk, rtrv-tbl-capacity, rtrv-trbltx, rtrv-uaps, rtrv-vflx-cd, rtrv-vflx-rn, rtrv-vflx-vmsid, commands.

Entering this command without the trm parameter executes the command on the terminal that is running the canc-cmd command. Entering the command with the trm parameter executes the command on the terminal specified by the trm parameter.

Parameters

trm (optional)

The terminal on which the command is to be canceled.

Range:

1 - 40

Example

canc-cmd

canc-cmd:trm=3

Dependencies

The trm parameter cannot be specified in a canc-cmd command that is entered on the same terminal that is running the command that is to be cancelled. The terminal will return an error: system is busy.

The canc-cmd:trm= command requires the Security Administration command class for the terminal and for the user.

The canc-cmd:trm= command requires a Security Administration command class for the terminal.

Notes

The canc-cmd command (without the trm parameter) must be entered on the same terminal that is running the command to be cancelled.

If this command is entered on a terminal that is not running a command, the command completes successfully without returning an error. Likewise, if the canc-cmd:trm= command is entered and there is no command running on the specified terminal, the command completes successfully without returning an error.

When canc-cmd with no parameter is entered, a scroll area message appears to indicate that the command has been cancelled. For example:

Command aborted on terminal 2.

Some output can still appear after the above abort message if output accumulated in the output queue before the command was entered. When a command is cancelled, the cancellation should take no longer than 25 seconds to take effect.

The F9 function key provides the same function as this command without the trm parameter. On a terminal in KSR mode, pressing <CTRL>I also provides the same function.

This command and the F9 function key cannot be used for pure SEAS commands.

If this command is entered to cancel a command other than ones listed, the terminal will accept another command, but output and processing of the current command continue.

When this command is entered, a command status code of AB (command aborted) is logged in the security log as follows:

• When canc-cmd (without the trm parameter) is entered, no entry is logged.
• When canc-cmd:trm= is entered, an entry is logged.
• When canc-cmd (without the trm parameter) is entered as a SEAS flow-thru command, an entry is logged. The canc-cmd:trm= command is not allowed as a SEAS flow-thru command because the canc-cmd:trm= command belongs to the Security Administration Command Class.

For examples of the security log entries, see the rtrv-seculog command.

Output

canc-cmd

    rlghncxa03w 04-07-27 17:00:36 EST  EAGLE 31.6.0
    canc-cmd
    Command entered at terminal #2.

    rlghncxa03w 04-07-27 17:00:36 EST  EAGLE 31.6.0
    Command aborted on terminal 2. 
;