Banner
HomeTOCPrevNextGlossSearchHelp

PDF

Table of Contents

Native Service Point 1.0 Release Note


Native Service Point 1.0 Release Note

Native Service Point 1.0 Release Note

This release note provides information about changes to CiscoWorks Blue Native Service Point 1.0 that are not documented in the CiscoWorks Blue Native Service Point Installation and Reference Guide, Software Release 1.0. Use this release note as a supplement to the CiscoWorks Blue Native Service Point Installation and Reference Guide.

Caution Read this release note before you upload Native Service Point software to your mainframe host or use Native Service Point commands. This release note contains information for NetView operators, NetMaster operators, and programmers.

Following are the topics in this release note:


Uploading Native Service Point for NetMaster to an MVS Host

The sample output of the contents of a $NWRUNCX NCL is changed and the correct output is shown below:

>>CHANGE                                                                00010000        
-* NAME        : $NWRUNCM                                   EWR0XX     *00100000
>>TO                                                                    00100100
-* NAME        : $NWRUNCX                                   EWR0XX     *00101000
-*                                                                     *00110000
>>ADD                                                                   00120000
-* Modify DATE : 29-JUN-1995                                           *00231000
-* SHRVARS=(NSPHCOPY,SV32TXT,SYSMSG)                                   *00232000
                                                                       *00233000
>>ADD                                                                   01161000
-* JUL 95       Modified. Add NSPHCOPY to suppress output     H.Liberty*01170000
>>BEFORE                                                                01170100
-* JUN 92       CREATION.                                      B.YUNG  *01171000
                                                                        01210000
>>CHANGE (REQUIRED)                                                     01220000
  &CONTROL UCASE    NOSHRVARS                                           01280000
>>TO                                                                    01280100
  &CONTROL NOUCASE    NOSHRVARS (Need lower case for router)            01280200
                                                                        01280300
>>ADD                                                                   01300000
   &IF .&NSPHCOPY NE .NO &THEN +         -* Modified by HJL             03920000
>>BEFORE                                                                03921000
     &WRITE DATA=EW0019 &WK1                                            03930000
>>ADD                                                                   03940000
   &IF .&NSPHCOPY NE .NO &THEN +         -* Modified by HJL             04190000
>>BEFORE                                                                04191000
      &WRITE DATA=EW0020 &WK             -* WRITE THE HIERARCHY         04200000
                                                                        04201000
>>ADD                                                                   04210000
   &IF .&NSPHCOPY NE .NO &THEN +         -* Modified by HJL             04300000
>>BEFORE                                                                04301000
    &WRITE DATA=EW0020 &WK               -* WRITE THE HIERARCHY         04310000
>>ADD                                                                   04320000
   &IF .&NSPHCOPY NE .NO &THEN +         -* Modified by HJL             04540000
>>BEFORE                                                                04541000
    &WRITE LOG=YES DATA=EWR003 MESSAGE TEXT                             04550000
                                                                        04560000
>>ADD                                                                   04570000
   &IF .&NSPHCOPY NE .NO &THEN +         -* Modified by HJL             04800000
>>BEFORE                                                                04801000
      &WRITE LOG=YES DATA=EWR004 &WK4                                   04810000
                                                                        04811000
>>ADD                                                                   04820000
   &IF .&NSPHCOPY NE .NO &THEN +         -* Modified by HJL             05111000
>>BEFORE                                                                05111100
    &WRITE LOG=YES DATA=EW0018 *END*     -* DISPLAY TERMINATION MSG     05112000
?


Building a List of Routers for NetView

In the procedure for building a list of routers for the NetView version of Native Service Point, access the NSPSINIT CLIST (documented in the manual as NSPSINIT CLIST) and enter the following line for each router you want to access from Native Service Point:

&NSPLSTn = 'SPname [domain] [host name]'

Refer to the CiscoWorks Blue Native Service Installation and Reference Guide for the remainder of the procedure and save the NSPSINIT CLIST.


Building a List of Routers for NetMaster

In the procedure for building a list of routers for the NetMaster version of Native Service Point, access the NSPSINIT NCL (documented in the manual as NSPSINIT CLIST) and enter the following line for each router you want to access from Native Service Point:

&NSPLSTn = 'SPname [domain] [host name]'

Refer to the CiscoWorks Blue Native Service Installation and Reference Guide for the remainder of the procedure and save the NSPSINIT NCL procedure.


Setting Up Automatic Update of Router Status

To enable Native Service Point to automatically obtain and provide an updated status of your routers, the domains where they are located, and information of any operators that are logged in to the routers, your programmer needs to add certain commands to the NetView automation table or the NetMaster MSGPROC procedure.

This section provides the correct commands to be used by your programmer.


Editing the NetView Automation Table

If you use NetView, your programmer should complete this procedure to ensure that the latest status about your routers is available to you in Native Service Point.

Step 1 Add the following commands to the NetView automation table:
IF MSGID='IST5901' & TEXT=MESSAGE        
THEN EXEC (CMD(`NSP590E' MESSAGE)) DISPLAY(Y) NETLOG(Y);

Step 2 If the IST5901 message already exists in the automation table, add the following commands before the existing entry your automation table:
IF MSGID='IST5901' & TEXT=MESSAGE        
THEN EXEC (CMD(`NSP590E' MESSAGE)) DISPLAY(Y) NETLOG(Y)
CONTINUE(Y);$

Step 3 Save the updated automation table.


Editing the NetMaster MSGPROC Procedure

If you use NetMaster, your programmer should complete this procedure to ensure that the latest status about your routers is available to you in Native Service Point.

Step 1 Add the following commands to the MSGPROC procedure of the operator who will receive the VTAM messages:
.M#IST590I                                                                    
.M#5D90I                                                              
   &NODE     = &STR &5                     -* SAVE THE NODE Name      
   &NODECONN = &STR &2                     -* GET THE NODE Status     
   NSP590E &NODE &NODECONN                 -* Call Update status      
   &GOTO .LOOP                             -* NEXT MESSAGE

Step 2 If the IST5901 message already exists in the procedure, add the following commands after the label in your MSGPROC procedure.
&NODE     = &STR &5                     -* SAVE THE NODE Name              
&NODECONN = &STR &2                     -* GET THE NODE Status     
NSP590E &NODE &NODECONN                 -* Call Update status 


Editing the NetView Automation Table

If you use NetView, your programmer should complete this procedure to ensure that the latest status about your routers is available to you in Native Service Point.

Step 1 Add the following commands to the NetView automation table:
IF MSGID='IST5901' & TEXT=MESSAGE        
THEN EXEC (CMD(`NSP590E' MESSAGE)) DISPLAY(Y) NETLOG(Y);

Step 2 If the IST5901 message already exists in the automation table, add the following commands before the existing entry your automation table:
IF MSGID='IST5901' & TEXT=MESSAGE        
THEN EXEC (CMD(`NSP590E' MESSAGE)) DISPLAY(Y) NETLOG(Y)
CONTINUE(Y);$

Step 3 Save the updated automation table.


Commands

Table 1 shows the correct commands you use to perform various tasks with Native Service Point.

Table 1 Correct Native Service Point Commands

Command Shown in the Manual Correct Command
rtrhelp nsphelp
rtroper nspoper
rtrcmd nspcmd
rtrrcmd nsprcmd
rtrreset nspreset
rtrmgr nspmgr
rtrsinit nspsinit


Panel Names

Table 2 shows the correct panel names.

Table 2 Correct Native Service Point Panels

Panel Name Shown in the Manual Correct Panel Name
RTRMGR NSPMGR
RTRCMD NSPCMD
RTRHLP NSPHLP


Error Message Numbers

Error messages described as beginning with RTR (for example RTRM001) in the manual have changed. All error messages begin with NSP (for example NSPM001).


Programmer Reference

This section describes changes to the following:


CLIST Names for NetView

This section provides a listing of the correct names for CLISTs available with the Native Service Point software for NetView.

Table 3 provides a description of the correct CLIST names in Native Service Point.

Table 3 Correct CLIST Names

CLIST Name in the Manual Correct CLIST Name Description
RTRCMD NSPCMD Cisco/NetView router CLIST
RTRRCMD NSPRCMD Cisco/NetView remote router CLIST
RTROPER NSPOPER Cisco/NetView operator reset CLIST
RTRMGR NSPMGR Router status display CLIST
RTRSINIT NSPSINIT Router Manager initialization CLIST
RTR590E NSP590E Status automation CLIST
RTRHELP NSPHELP List of all NSP commands


Common GLOBAL Names for NetView

This section provides a listing of the names of the correct common GLOBALs available with the Native Service Point software for NetView.

Table B-1 provides a description of the correct common GLOBALs in Native Service Point.

Table 4 Common GLOBAL Names for NetView

Common Global Names Listed in the Manual Correct Common Global Names

Descriptions



&RTRSINITS &NSPINITS Date and time NSPSINIT was last executed.
&RTRNUM &NSPNUM Number of routers being monitored.
&node &node Router Service Point Name.
&RTR&node = &n = &NSP&node = &n = Index number assigned to the router.
&RTR&n &NSP&n Name of router (&node).
&RTR&n &NSP&n Name of domain that owns the router &node.
&RTH&n &RTH&n Host name defined in the router configuration &node.
&RTS&n &RTS&n Status of router &node.
&RTO&n &RTO&n Name of operator monitoring router &node.


Operator Task GLOBAL Names for NetView

This section provides a listing of the names of the correct operator task GLOBALs available with the Native Service Point software for NetView.

Table 5 provides a description of the the correct common GLOBALs in Native Service Point.

Table 5 Operator Task GLOBAL Names for NetView

Operator Task GLOBALs Listed in the Manual Correct Operator Task GLOBALs

Descriptions



RTRSPN NSPSPN Router being interrogated by operator.
&RTRHNAME &NSPHNAME Host name for router &NSPSPN.
&RTRDM &NSPDM Domain that owns the router &NSPSPN.
&RCMD &NSPCMD Last command sent to router &NSPSPN.
&RTRINDEX &NSPINDEX Number of commands saved for retrieve.
&c = &c= Saved command.
&RTRRCMD&c &NSPRCMD& =&NSPSPN &NSPHNAME &NSPDM &RCMD
&DEBUG &DEBUG Saved value of NSPCMD DEBUG operand.
&CTRACE &CTRACE Saved value(s) of NSPRESET CTRACE operand(s).


Programmer Reference for NetMaster Version

This section contains the following topics:


NCL Names and Jobs for NetMaster

This section provides a listing of NCL names and jobs available with the Native Service Point for NetMaster.

Table 5 shows the NCL descriptions for NetMaster version.

Table 6 Correct Names of NCL Descriptions for NetMaster

CLIST Names Listed in the Manual Correct CLIST Names Descriptions

RTRCMD NSPCMD Cisco/NetMaster router.
RTRHELP NSPHELP Cisco/NetMaster help panel
RTRMGR NSPMGR Router status display NCL.
RTROPER NSPOPER Cisco/NetMaster operator reset NCL.
RTRRESET NSPRESET Cisco/NetMaster messsage retrieval reset.
RTRSINIT NSPSINIT Router Manager initialization NCL.
RTR590E NSP590E Status automation NCL.

Table 6 shows the job descriptions for NetMaster version.

Table 7 Correct Names of Job Descriptions for NetMaster

Jobs Description
PNALLOC Cisco/NetMaster NCL
PNLRESTR Cisco/NetMaster NCL
NSPMSGPR MSGPROC for sample automation job.


Common Variables for NetMaster

This section provides a listing of common variables available with Native Service Point for NetMaster.

Table 8 shows the common variables for NetMaster version.

Table 8 Correct Names of Common Variables for NetMaster

Common Variables Listed in the Manual Correct Operator Variables Description
&000RTRSINIT &000NSPSINIT Date and time the nspsinit command was last executed.
&000RTRNUM &000NSPNUM Number of routers being monitored.
&node &node Router Service Point Name.
&000&node = &n = &000&node = &n = Index number assigned to router &node.
&000RTR&n &000NSP&n Name of router (&node).
&000RTD&n &000RTD&n Name of domain that owns router &node.
&000RTH&n &000RTH&n Host name defined in router &node configuration.
&000RTS&n &000RTS&n Status of router &node.
&000RTO&n &000RTO&n Name of operator monitoring router &node.
&000RTO&n &000RTO&n Saved value of nspcmd debug operand.


Operator Variables for NetMaster

This section provides a listing of operator variables available with Native Service Point for NetMaster.

Table 9 shows the operator variables for NetMaster version.

Table 9 Correct Operator Variables for NetMaster

Operator Variables Listed in the Manual Correct Operator Variables Descriptions

&RTRSPN &NSPSPN Router being interrogated by operator.
&RTRHNAME &NSPHNAME Host name for router.
&RTRDM &NSPDM Domain that owns the router.
&RCMD &RCMD Last command sent to the router.
&RTRINDEX &NSPINDEX Number of commands saved for retrieval.
&c &c Index for saved command.
&RTRRCMD&c &NSPRCMD&c Saved command
&RTRRCMD&c &NSPRCMD&c &NSPSPN &NSPHNAME &NSPDM &RCMD

.

fig_1.gif

HomeTOCPrevNextGlossSearchHelp
-

Copyright 1988-1995 © Cisco Systems Inc.