|
|
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:
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.
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.
To turn off the trace of the NSP internal data flow, issue the following command:
nspaid debug offThe 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.
To turn off the tracing of NSP CLISTs, issue the following command:
nspaid ctrace offThe 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:
To turn off the tracing of the entries and exits of NSP routines, issue the following command:
nspaid trflow offIf 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.
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:
nspulistNSP 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. |
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.
| 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. |
| 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. |
This section provides a list of the operator task globals available with NSP:
| 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. |
|
|