|
|
|
|
|
The remove command places a unit in the manual-out-of-service state.
Synopsis
remove unit number [immed][min_delay][-i][-n]
rem unit number [immed][min_delay][-i][-n]
Description
The remove command is removes a unit from service when its temporary state is idle. It changes the permanent state of the unit to manual-out-of-service (MANOOS). It does not remove a unit that has a temporary state of busy. If a unit must be interrupted immediately or appears to be stuck busy, use the rem unit number immed command.
The parameters for the remove command are described in the following table:
Parameter |
Description |
Comments |
unit |
Identifies the unit |
Choices are channel or card |
number |
Specifies the channel or card number, a range of channel or card numbers in the form m-n, or all (for all the channel or card numbers) |
Card numbers are in the form card#[.port#], where port# is a port of card#. If port# is not given, all ports of the card specified are removed. If no card number or channel number is given, the system displays a syntax message. |
-n |
Disables prompting from the system that asks you whether to wait until a conflict has been resolved (see the -i option below) or to terminate the request to remove |
— |
-i |
Enables secondary command registration |
If diagnostics are being run, this option allows the removing of another card. If -i is used and another maintenance command is being run, the request to remove card is blocked and a message is printed to the screen. If -i is not used and any maintenance command is being run, the request to remove card is blocked and a message is printed to the screen. If the command is permitted to run, a check is made to see if the command is in conflict with another. If a conflict exists and -n is not used, the user is asked whether to wait until the conflict is resolved or to terminate the request. If diagnostics are executing on-line tests and a conflict is detected, the remove card command is blocked. If diagnostics are executing off-line tests and a conflict is detected, the user is asked whether to wait until the conflict is resolved or to terminate the request to remove. |
immed |
Removes a card or channel even if it is in use |
Active calls are likely to be dropped when this option is specified. This option is necessary when the card or channel must be removed from service as soon as possible, and you are willing to terminate any active calls. You may also want to use this option to get control of a channel that is stalled and not providing useful service. |
min_delay |
Use to avoid waiting for channels to be granted |
This option applies to remove chan and remove card requests that are removing network interface channels (for example, T1). This option specifies to minimize the delay in removing channels from service by not waiting for the channel to be granted. This option speeds up execution of the remove command, especially when a large number of channels are currently active. When using this option, you must display the status of the channels with the display card command to determine when they are in the MANOOS state. This option can be used with or without the immed option and improves the response time in either case. |
CAUTION:
Removing a large number of channels from service with the min_delay option may cause momentary load problems on the switch.
To delete out of the command, press Delete. If this does not stop the command, you may need to press CTRL and backslash simultaneously. If, while running remove, you wish to stop the command, a message similar to the following may appear:
At the user's request, administration of the following cmd(s) has been interrupted.
CARD NUMBERS: card numbers
To assure proper operation of the identified card(s), run diagnostics at the earliest opportunity.
When remove is stopped, you should run diagnostics on all cards being administered to ensure they are returned to a fully functional state.
Example
The following example removes card 0 from service.
rem card 0
The following example removes channels 0 through 2 and channel 4 from service.
rem channel 0-2,4
The following example removes all cards from service.
rem card all
