|
In addition to using the ISM panel interface, you can perform many of the ISM functions using ISM commands. This appendix lists the ISM commands that you can issue. This appendix also provides a syntax description (if applicable) and notes on using each command.
To get help for an ISM command, issue the following where command is the ISM command for which you want to view help:
command ?
fpm | Focal Point Management application. Corresponds to the * FPM main menu option, which displays the status of remote NetView domain resources. |
mgr | Primary Router Management application. Corresponds to the * MGR main menu option, which displays the status of the routers being managed by ISM. |
cmd | Router command interface from which you can connect to and issue commands directly to a router and receive responses. Corresponds to the * CMD main menu option. |
idis | Cisco Router Interface Status List application from which you can display the status of a type of interface enabled in the routers on your network. Corresponds to the * IDIS main menu option. |
dspu | DSPU Monitoring Operation application. Corresponds to the * DSPU main menu option. |
cmcc | Cisco Mainframe Channel Connections Monitoring Operation application. Corresponds to the * CMCC main menu option. |
sna | SNA Session Monitoring application. Corresponds to the * SNA main menu option. |
user | User Profile application. Corresponds to the * USER main menu option to create or modify an operator profile. |
setup | ISM Router Management Setup application. Corresponds to the * SETUP main menu option to define or modify the ISM management environment. |
log | ISM Event Log. Corresponds to the * LOG main menu option. |
help | ISM Command Help. Corresponds to the * HELP main menu option to obtain a description of the ISM commands that you can issue to Cisco routers. |
Any ISM user can issue this command.
Before initializing ISM (ISMMGR task) for the first time, issue the ism command from a NetView command line to access the ISM main menu. Once on the ISM main menu, select the * SETUP option. This starts the ISM setup facility from which you configure the ISM management environment. Configuring the ISM management environment includes selecting the ISM applications that you want to use, specifying monitoring intervals and threshold setting, and select the types of interfaces that you want to monitor.
Once you have configured the ISM management environment and have initialized ISM, issue the ism command from a NetView command line to display the ISM main menu.
Help is available for the commands that are listed on the ISM main menu by either positioning the cursor on a command line and pressing F1, or by entering the command followed by a space and question mark from the action prompt.
The following command displays the ISM main menu panel:
ism
debug {on | off} | Traces internal data flow. |
ctrace {all | all_nnn | err | cmd} | Traces internal commands. The following traces can be performed:
|
trflow {on | off} | Traces routine entries and exits issued by an operator. |
off | Turns off all tracing that has been turned on. |
Any ISM user can issue this command.
The traces initiated by this command affect only the operator under which the ismaid command is issued. With the ismaid command you can enable or disable an internal trace function. Use the ismaid debug on command to trace the data flow in routines that process data from RUNCMDs. Use the ismaid trflow on command to trace the entry and exit of the routines that you are issuing.
Issuing ismaid displays the help panel for the NSPAID facility.
Issuing the ismaid debug on command yields the following message:
NSP1129I NSPAID DEBUG set to >YES < NSPAID
Use the ismcmd command to connect to a router and issue commands in a full-screen interactive mode.
ismcmd [SPname]SPname | Service point name (1 to 8 characters) of the router. |
Any ISM user can issue this command.
The panel interface equivalent of issuing the ismcmd command is to select a router on the Router Status panel, press F10, and select Option 1 from the popup menu.
When you issue the ismcmd command and specify the service point name of a router, the connection to the router is established and the Router Command Interface panel is displayed. If you issue the ismcmd command without specifying a router's service point name, you must type the service point name in the Service Point Name field on the Router Command Interface panel and press Enter to establish the connection with the router. The service point name of the router last connected to is displayed. Once the connection has been established, you can issue any commands to the router you specified that you would normally issue in a Telnet session. If you are an enabled ISM user, you can use the ismcmd command to access a specific router, edit the router configuration, and view router command syntax.
The following command establishes a connection with a router with the service point name coloma:
ismcmd coloma
This command has no keywords or arguments.
All ISM users can issue this command.
The Cisco ISM Commands for NetView panel lists the help panels that are available for ISM. To access a specific help panel, type the number representing the panel at the Action prompt and press Enter.
You can also get help for a command by typing the command, a space, and then a question mark and pressing Enter.
The following command requests help for the ismcmd command:
ismcmd ?
msg_id | Message identification number. |
All ISM users can issue this command.
You can specify the full message identification number, or just the numeric portion of the message with the ismhmsg command to obtain help about a particular ISM message.
You can also position the cursor on a message and press F1 to obtain help about that error message.
You can use either of the following commands to request help for the ISM1001I message:
ismhmsg ism1001I
ismhmsg 1001
interface_type | Type of interface for which you want to display a list. Valid values are A (Async), M (ATM), C (Channel), E (Ethernet), D (FastEthernet), F (FDDI), H (HSSI), B (ISDN), L (Loopback), S (Serial), T (Token Ring), and U (Tunnel). |
SPname | (Optional) Service point name (1 to 8 characters) of the router for which you want to view a list of configured interfaces by type. |
All ISM users can issue this command.
If you issue the ismidis command without specifying a service point name, all interfaces configured in the routers on your network that match the interface type you specify are displayed.
Issuing the ismidis command and specifying a service point name displays all the interfaces configured in a router that match the type you specify.
The following command displays a list of Token Ring interfaces configured in a router with the service point name atlanta:
ismidis t atlanta
Use the ismiinit command to initialize a specific group of interfaces.
ismiinit interface_type [init | reset]interface_type | Type of interfaces that you want to reinitialize.Valid values are A (Async), M (ATM), C (Channel), E (Ethernet), D (FastEthernet), F (FDDI), H (HSSI), B (ISDN), L (Loopback), S (Serial), T (Token Ring), and U (Tunnel). |
init | Clears all ISM interface data from storage for that interface and reinitializes that interface type. |
reset | Clears all ISM interface data from storage and terminates the interface monitoring of that interface type. |
All ISM users can issue this command.
Normally, ISM automatically executes the ismiinit command upon startup. However, you can manually issue the command at anytime to reinitialize a group of interfaces. When you issue the ismiinit command, ISM reads the VSAM records for the specific group type and builds a table in storage that contains all of the interfaces.
If you have already issued the ismiinit command, and issue the ismiinit command again without specifying init or reset, an error message is displayed requesting that you specify an interface type.
The following command clears all ISM Ethernet interface data and restarts ISM:
ismiinit e init
Use the ismistat command to collect all information about the interfaces configured in a router
ismistat SPname [only]SPname | Service point name (1 to 8 characters) of the router. |
only | Interface status to be updated. |
All ISM users can issue this command.
The ismistat command is normally issued by the NSPRMON3 and NSPIMON3 routines. To update the statuses of the interfaces configured in a router, issue the ismistat command with the only keyword specified. To collect and update interface statistics, issue the ismistat command without the only keyword specified.
The following command updates the status of the interfaces configured in router with the service point name atlanta:
ismistat atlanta only
This command has no keywords or arguments.
All ISM users can issue this command.
The ismmgr command displays the current status of routers if at least one of the following conditions is true:
The color in which the service point name of a router displays on the Router Status panel indicates the status of that router. You can clear all the ISM variables displayed on the Router Status panel by issuing the ismmgr command and specifying reset.
The following command displays the Router Status panel:
ismmgr
SPname | Service point name (1 to 8 characters) of the router. |
op_id | Operator ID of the operator associated with the router. |
Only ISM users that have an enabled authority level can issue this command.
The panel interface equivalent of issuing the ismopera command is to select the operator's ID on the Router Status Extended panel and press F9.
Use the ismopera command in the following situations:
The following command resets a session between a router with the service point name atlanta and an operator with the ID CE6:
ismopera atlanta ce6
Use the ismreset command to clear commands you issued previously that were saved for your recall.
ismresetThis command has no keywords or arguments.
All ISM users can issue this command.
You cannot issue the ismreset command from an ISM command line. In NetView, you can enter this command from any Network Communications Control Facility (NCCF) panel command line.
The commands you enter in a router configuration are retained until you log out from NetView or until you issue the ismreset command.The primary purpose of the ismreset command is to clear these router commands that have been saved for your recall.
The following example clears commands that you previously issued:
ismreset
Use the ismsetup command to define or change the setup parameters for ISM.
ismsetupThis command has no keywords or arguments.
All ISM users can issue this command, but only ISM users defined as administrators can change the setup options.
The panel interface equivalent of issuing the ismsetup command is to select the * SETUP option on the ISM main menu panel.
Only ISM users defined as ISM administrators can modify the ISM setup parameters.
If you are authorized to make changes to the ISM setup, press F4 on the ISM Router Management Setup panel.
To display the ISM Router Management Setup panel, type the following command:
ismsetup
op_id | Operator ID of the operator whose profile you want to access. Omit if you are creating or modifying your own profile. |
all | Shows all of the operator profiles defined to ISM, and allows you to modify the profile settings in an interactive full-screen mode. |
All ISM users can issue this command, but only ISM users defined as administrators can define authority levels or delete a profile.
The panel interface equivalent to issuing the ismuser command is to select the * USER option on the ISM main menu.
Only ISM administrators can perform the following tasks:
You can issue the ismusers command to show all of the operator profiles in the same full-screen panel that is displayed using the ismuser all command.
The following command is what an ISM administrator would issue to create a ISM profile for an operator whose ID is CE6:
ismuser ce6
This command has no keywords or arguments.
All ISM users can issue this command, but only ISM users defined as administrators can define authority levels or delete a profile.
Only ISM administrators can perform the following tasks:
If you are authorized to make changes to the ISM operator profiles, press F4 on the ISM Authorized Users panel.
To display all of the operator profiles that are defined to ISM and update profile options on the ISM Authorized Users panel, type the following command:
ismusers
This command has no keywords or arguments.
All ISM users can issue this command.
The ismvars command displays values of common globals used by ISM. It does not show the common globals used for each router or interface.
The ismvars command also displays a description of each variable.
The following example displays the common globals of the ISM management environment:
ismvars
|