Table of Contents

Servicing and Troubleshooting

Servicing and Troubleshooting

This appendix provides procedural and reference information that you can use to determine and resolve problems that you may be experiencing using NSP.

This appendix includes information on the following:

Tracing NSP Data

Sometimes a problem cannot be traced to a specific source. NSP provides three trace utility commands that you can use to isolate problems that NSP may be experiencing. The three utilities provided and their functions are:

Trace Utility Function
nspaid debug Traces the internal data flow of NSP.
nspaid ctrace Traces the internal commands being processed by NSP.
nspaid trflow Traces the entries and exits of issued commands.

The trace facilities that you enable using the nspaid command affect only the operator ID under which you issue the command. The following sections provide examples of the output received when operating NSP using the any of the trace utilities.

Tracing the NSP Internal Data Flow

The NSP Internal Data Flow utility traces the internal data flow of the processes occurring in NSP.

To turn on the NSP Internal Data Flow utility:

Step 1 At the command prompt on the Command Entry panel, type nspaid and press Enter. The Native Service Point Service Aids panel is displayed.

Step 2 At the prompt, type:

The following is an example of the data that is returned to the Command Entry panel when you have turned on the NSP debug trace facility. The example provided is the internal tracing of the data flow that occurs when an operator has issued the nspcmda command.

Figure D-1: Return Data with NSP Debug Utility On

To turn off the trace of the NSP internal data flow, issue the following command:

nspaid debug off

Tracing CLISTs

The NSP CLIST Trace utility traces different NSP CLIST elements depending on the keyword you specify when turning on the trace utility.

Specify To
nspaid ctrace all Trace the execution of all NSP CLISTs.
nspaid ctrace all_nnn Trace the execution of only the CLIST nnn, where nnn is the number of the CLIST you want to trace.
nspaid ctrace err Trace only CLIST errors.
nspaid ctrace cmd Trace the commands issued from a CLIST.
nspaid ctrace off Turn off CLIST tracing.

The following is an example of the type of data that is returned to the Command Entry panel console as NSP CLISTs are executed when the nspaid ctrace all command has been issued.

Figure D-2: Return Data with NSP Ctrace Utility Set to ALL

To turn off the tracing of NSP CLISTs, issue the following command:

nspaid ctrace off

Tracing Routine Entries and Exits

The NSP Flow Trace utility traces the entries and exits of all the NSP routines issued by an NSP operator.

The following is an example of the type of data that is returned to the Command Entry panel as NSP routines are processed when the nspaid trflow on command has been issued:

Figure D-3: Return Data with NSP Trflow Utility On

To turn off the tracing of the entries and exits of NSP routines, issue the following command:

nspaid trflow off

Turning Off Tracing

If you have enabled all of the NSP trace utilities (debug, ctrace, and trflow), you can turn off each utility individually, or you can issue a command that turns off all tracing. For information on turning off a trace utility individually, see the command provided in the appropriate trace utility section.

To turn off all NSP trace utilities running, type nspaid off and press Enter.

Viewing NSP Users

The NSP User List utility enables you to view a list of all users defined to NSP. The NSP user list that includes the name of each user (if the name is specified in their profile), user ID, and their NSP user authority level.

To view a list of all the users defined to NSP, issue the following command:


Restoring the NSP Base Administrator Profile

NSP provides a backup NSP administrator profile that can be used by a system administrator to recreate an NSP administrator profile if all existing NSP administrator profiles are accidentally deleted. If all NSP administrator profiles are deleted, there is not an NSP user capable of modifying the NSP management environment and assigning user authority levels for NSP users.

If the base NSP administrator profile is deleted:

Step 1 Add an NSPADMIN operator to SOLVE:Netmaster.

Step 2 Log on to SOLVE:Netmaster as the NSPADMIN operator.

Step 3 Create several NSP administrator profiles as described in the "Defining Operator Profiles" section in the "Installing and Configuring Native Service Point" chapter to ensure that there will be additional NSP administrator level profiles available for backups if needed.

Caution This backup procedure can be performed only one time. Please ensure that several administrator level profiles are created to serve as backups in case this situation ever occurs again.

NSP Common Globals

This following two tables provide a list of the common globals used for the NSP management environment and the common globals used by NSP to monitor a specific router.

:colon:Common Globals for the NSP Environment
Common Global Description
NSPINITS When NSP was initialized.
NSPAPPL NSP application status.
NSPINITM Interfaces being monitored.
NSPMGR Autotask managing NSP.
NSPOPNUM Additional autotasks managing NSP.
NSPMINTV Router monitoring interval.
NSPMINTVI Interface monitoring interval.
NSPNTHPU Router CPU performance threshold.
NSPMTHMU Router memory level threshold.
NSPMOPER NSP security indicator.
NSPRTRHDB Router database values.
NSPINTHDB Interface database values.
NSPRIFHDB SNA View RIF database values.
NSPCONHDB Router configuration database values.
NSPNVM Number of routers being managed by NSP.

:colon:Common Globals used by NSP to Monitor a Router
Common Global Description
NSPspname Index pointer to the router information.
NSP&n Router service point name.
RTA&n When router became active.
RTB&n Router busy with operator.
RTC&n Configuration status/control.
RTD&n Domain in which router is located.
RTE&n Router description.
RTF&n Last failure or alert generated for or by a router.
RTG&n Operation groups to which the router belongs.
RTH&n Router host name (IP name).
RTI&n Router IP address.
RTL&n Last related alert.
RTM&n The NSP autotask managing the router.
RTO&n Operator enabled to the router.
RTO&n Pointer to performance history.
RTS&n Current NSP to router status.
RTX&n Extended status indicators.

NSP Task Globals

This section provides a list of the operator task globals available with NSP:

:colon:NSP Task Globals
Task Global Description
DEBUG Saved values of the NSPAID DEBUG.
CTRACE Saved value(s) of the NSPAID CTRACE operand(s).
TRFLOW Saved value(s) of the NSPAID TRFLOW.

Copyright 1989-1997 © Cisco Systems Inc.