home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / disk1.exe / ASGUID.TXT next >
Text File  |  1994-04-13  |  127KB  |  3,356 lines
  1.         NETWARE MANAGEMENT AGENT FOR NETVIEW ADMINISTRATION GUIDE
  2.              Table of Contents
  3.  
  4. Who Should Read This Guide
  5. Content Overview
  6. Conventions 
  7.   Typographic Conventions 
  8.   Terminology
  9. Additional Reading
  10.  
  11. CHAPTER 1  About NMA for NetView
  12. What Is NMA for NetView?. . . . . . . . . . . . . .     1-1
  13. What Is New in Version 1.3B . . . . . . . . . . .       1-2
  14. NMA for NetView Features. . . . . . . . . . . . .       1-3
  15. Alert Generation. . . . . . . . . . . . . . . . .       1-3
  16. RUNCMD Processing . . . . . . . . . . . . . . . .       1-4
  17.   Server Query RUNCMDs. . . . . . . . . . . . . . . . . 1-4
  18.   Server Control RUNCMDs. . . . . . . . . . . . . . . . 1-5
  19.   RUNCMD Security . . . . . . . . . . . . . . . . . .   1-6
  20.   RUNCMD Filtering. . . . . . . . . . . . . . . . .     1-6
  21. Host Communications Options . . . . . . . . . . . .     1-7 
  22. Direct Host Communications. . . . . . . . . . . .       1-7
  23. Collection Point Communications . . . . . . . . .       1-7
  24. Advantages of Collection Point Communications . .       1-8
  25. Alert Flow Control. . . . . . . . . . . . . . . .       1-8
  26. Support for the Open NetView Interface. . . . . . . . . 1-8
  27.  
  28. CHAPTER 2  Installing and Upgrading NMA for NetView
  29. Overview 
  30. Preparing NMA for NetView Installation Directories
  31. Choosing a Connection Topology
  32.     Topologies That Support Direct Host Communications
  33.   Example 1
  34.   Example 2
  35.     A Topology That Supports Collection Point Communications
  36. Setting Up the Required Server Hardware and Software
  37.     Required Hardware
  38.     Required Software
  39. Preparing the NetWare Server
  40.     Enabling Bindery Emulation
  41.     Loading and Configuring Btrieve
  42.     Loading and Binding the LAN Adapter
  43.   Loading for Direct Host Communications
  44.   Loading and Binding for Collection Point Server Communications
  45.   AUTOEXEC.NCF Examples 
  46.  
  47. Installing or Upgrading the NMA for NetView Software
  48. Preparing the Host
  49.     PU Type 2.0 Definition in VTAM
  50.     NetWare for SAA
  51.     Connection to the Token Ring LAN
  52.     Host Communications Link to the Collection Point Server
  53.     Installation of NetView Code Points for NetWare
  54.  
  55. CHAPTER 3  Configuring, Loading and Unloading NMA for NetView
  56. Starting NVCONFIG . . . . . . . . . . . . . . . . . . . . . . 3-1
  57. Configuring NMA for NetView . . . . . . . . . . . . . . . . . 3-2
  58.     Configuring for Direct Host Communications. . . . . . . . 3-3
  59.   Parameter Descriptions for the 
  60.     Token Ring to Host Form . . . . . . . . . . . . . . 3-6
  61.     Configuring for NetView Collection Point Communications . 3-8
  62. Enabling and Disabling Features . . . . . . . . . . . . . . . 3-10
  63. Loading NMA for NetView . . . . . . . . . . . . . . . . . . . 3-11
  64. Unloading NMA for NetView . . . . . . . . . . . . . . . . . . 3-11
  65. Administering NMA for NetView Remotely. . . . . . . . . . . . 3-12
  66. Configuring Alert Flow Control. . . . . . . . . . . . . . . . 3-12
  67.     How Alert Flow Control Works. . . . . . . . . . . . . . . 3-12
  68.     Editing the NVCMDS.DB File for Alert Flow Control . . . . 3-13
  69. Checking for Failed LOAD or UNLOAD RUNCMDs. . . . . . . . . . 3-14
  70. Removing the NMA for NetView Software . . . . . . . . . . . . 3-15
  71.  
  72. APPENDIX A      Installing Code Points for NetWare
  73. Do You Need to Install? . . . . . . . . . . . . . . . . . . . A-1
  74. Installation Overview . . . . . . . . . . . . . . . . . . . . A-1
  75. Preparing for File Transfer (VM and MVS Installations). . . . A-2
  76. Installing NetView Code Points in VM Systems. . . . . . . . . A-3
  77. Installing NetView Code Points in MVS Systems . . . . . . . . A-5
  78.  
  79. APPENDIX B      Using NetView RUNCMD Filtering
  80. How RUNCMD Filtering Works. . . . . . . . . . . . . . . . . . B-1
  81. Editing the Sample RUNCMD Filter File . . . . . . . . . . . . B-2
  82. Creating a RUNCMD Filter File . . . . . . . . . . . . . . . . B-3
  83. Enabling RUNCMD Filtering . . . . . . . . . . . . . . . . . . B-4
  84. RUNCMD Tables . . . . . . . . . . . . . . . . . . . . . . . . B-4
  85.  
  86. TRADEMARKS
  87. Novell, the N Design, NetWare, and Btrieve are registered trademarks
  88. and Internetwork Packet Exchange, IPX, NE2000, NetWare 3270 LAN
  89. Workstation, NetWare Directory Services, NetWare Loadable Module, NLM,
  90. ODI, and Transaction Tracking System are trademarks of Novell, Inc.
  91.  
  92. Attachmate is a registered trademark of Attachmate Corporation.
  93. CompuServe is a registered trademark of CompuServe Incorporated.
  94. PostScript is a registered trademark of Adobe Systems Incorporated.
  95. 80386 and 80486 are trademarks of Intel Corporation.
  96. IBM, NetView, and PS/2 are registered trademarks and SAA and VTAM are
  97. trademarks of International Business Machines Corporation.
  98. NET/MASTER is a registered trademark of Systems Center.
  99.  
  100. This guide describes
  101. o  NetWare(R) Management Agent for NetView* 1.3B
  102. o  How to install NMA for NetView 1.3B
  103. o  How to use NMA for NetView 1.3B
  104.  
  105. WHO SHOULD READ THIS GUIDE
  106. Read this guide if you want to:
  107. o  Learn about NMA for NetView and its features
  108. o  Learn about the new features in NMA for NetView 1.3B
  109. o  Install NMA for NetView 1.3B
  110. o  Configure or reconfigure NMA for NetView
  111. o  Load or unload NMA for NetView
  112. o  Remove NMA for NetView from a NetWare server
  113.  
  114. CONTENT OVERVIEW
  115. Chapter 1, "About NMA for NetView," describes NMA for NetView,
  116. introduces the new features in NMA for NetView 1.3B, and describes
  117. the complete set of features provided by NMA for NetView 1.3B.
  118.  
  119. Chapter 2, "Installing and Updating NMA for NetView," provides a
  120. procedure for setting up a NetWare server to run NMA for NetView.
  121. This chapter includes instructions for preparing the host for
  122. communications with NMA for NetView.
  123. Chapter 3, "Configuring, Loading, and Unloading NMA for NetView," 
  124. provides separate procedures for tasks you may want to perform after
  125. you complete the installation procedure in Chapter 2. This chapter
  126. includes instructions for configuring, loading, or unloading NMA for
  127. NetView.
  128.  
  129. Appendix A, "Installing NetView Code Points for NetWare," provides
  130. the procedure for installing NetView code points for NetWare. This
  131. procedure may not be required for your installation. Be sure to
  132. read the section entitled "Do You Need to Install?" in Appendix A.
  133. Appendix B, "Using NetWare RUNCMD Filtering," provides the procedure
  134. for disabling or filtering out selected RUNCMDs sent from the NetView
  135. operator to the server running NMA for NetView.
  136.                       
  137. CONVENTIONS
  138. This guide uses a variety of typographical conventions and special
  139. terminology.
  140.  
  141. Typographic Conventions
  142. -----------------------
  143. This document uses the following conventions.
  144.  
  145. <Words in angle brackets> 
  146.      Angle bracketed words indicate names of variables.
  147.          For example:
  148.            o  Press <Enter> to display the menu.
  149.            o  The format is 
  150.           
  151.          LOAD NLM NLMNAME=<name> ARGS="<argument>"
  152.   
  153. [Words in square brackets]      
  154.   Square bracketed words indicate optional characters or variables.  
  155.      For example:   QUERY FILE RIGHTS [Username=<uname>]
  156.  
  157. greater than (>)      
  158.   When the greater than symbol precedes a command,the symbol indicates
  159.   that you must enter the command from the DOS prompt. 
  160.      For example:   >server
  161.  
  162. colon (:)             
  163.   When a colon precedes a command, the colon indicates that you must
  164.   enter the command from the system console prompt, which is a colon. 
  165.      For example:
  166.  
  167.            :load install
  168.  
  169. UPPERCASE             
  170.   Words appearing in UPPERCASE are file or path names. 
  171.      For example:
  172.  
  173.            DISK1.ZIP
  174. Terminology
  175. -----------
  176. This guide uses the following terms:
  177.  
  178. Select: Use the cursor keys to highlight the item and press <Enter>.
  179.  
  180. Enter:  Type the indicated text and press <Enter>.
  181.            For example:  Enter load nvinstal
  182.  
  183. NOTE:   When this term precedes a paragraph, the paragraph points out
  184.         an item that may be of interest but is not vital to the
  185.         operation of the product or to your safety.
  186.  
  187. SUGGESTION:   When this term precedes a paragraph, the paragraph
  188.               provides hints, tips, or helpful information that may be
  189.               useful, but not critical.
  190.  
  191. IMPORTANT: When this term precedes a paragraph, the paragraph provides
  192.            important information that you should read. This term is
  193.            also used to highlight key concepts and facts.
  194.  
  195. WARNING:   When this term precedes a paragraph, the paragraph calls
  196.            attention to a situation in which a critical or
  197.            irreversible error can be made.
  198.  
  199. NetWare v3.1x:   This term refers to versions of NetWare later than
  200.                  NetWare v3.10 or earlier than NetWare 4.0,       
  201.            For example, NetWare v3.11 or v3.12.
  202.  
  203. NetWare 4.x:  This term refers to NetWare 4.0 or later.
  204.  
  205. ADDITIONAL READING
  206. The publications described in this section provide additional
  207. information on products used with NMA for NetView.
  208.  
  209. o  NetWare Reference Guide for NetView Operators
  210.  
  211.    The NetWare Reference Guide for NetView Operators describes the
  212.    alert messages and NetWare command set provided by NMA for
  213.    NetView 1.3B and NetWare for SAA* 1.3B.
  214.  
  215.    This guide is provided in electronic form with NMA for NetView
  216.    on NetWire(TM). A printed version of this guide (part
  217.    number 100-001242-004) ships with NMA for NetView 1.3B.
  218.  
  219. o  NetWare for SAA v1.3 Rev. B Administration Guide
  220.  
  221.    The NetWare for SAA 1.3 Rev. B Administration Guide (part 
  222.    number 100-001166-003) describes the NetView support features 
  223.    in NetWare for SAA v1.3 Rev. B.
  224.  
  225. o  NetView Operation Primer (SC30-3363) from IBM
  226.  
  227. o  The Btrieve(R) Installation and Operation manual for your
  228.    version of NetWare
  229.                   CHAPTER 1  About NMA for NetView
  230.  
  231. This chapter describes
  232.  
  233. o  NetWare Management Agent (NMA) for NetView
  234.  
  235. o  The new features in NMA for NetView v1.3B
  236.  
  237. o  The complete NMA for NetView feature set
  238.  
  239. IMPORTANT:  NMA for NetView and NetWare for SAA provide similar
  240. support for NetView. Do not install NMA for NetView and NetWare
  241. for SAA in the same NetWare server.
  242.  
  243. NOTE:  NMA for NetView and NetWare for SAA servers are designed
  244. to support the NetView network management program from IBM*. These
  245. NetWare products will support any other network management
  246. program that is 100 percent compatible with NetView. The NET/MASTER*
  247. network management program from Sterling Software is an example of a
  248. program that is designed to be compatible with NetView.
  249.  
  250.  
  251. WHAT IS NMA FOR NETVIEW?
  252.  
  253. NMA for NetView is a NetWare Loadable Module(TM)(NLM(TM)) that
  254. enables NetWare v3.1x and 4.x servers to participate in NetView 
  255. network management. 
  256.  
  257. NetView is an IBM network management program that runs in the
  258. Virtual Machine (VM) and Multiple Virtual Storage (MVS) host
  259. environments. NetView is designed to be an enterprise-wide
  260. network management tool. IBM publishes specifications that
  261. describe how network product vendors can design products to
  262. communicate with NetView.
  263.  
  264. Throughout this guide, a NetWare server that is running NMA
  265. for NetView is called an NMA for NetView server. The NMA for
  266. NetView server uses the following connections:
  267.  
  268. o  A connection to a NetWare local area network (LAN), which
  269.    connects to  workstations that use the file and print services
  270.    provided by NetWare.
  271.  
  272. o  A connection that leads to a host computer that is running
  273.    NetView
  274.  
  275. The connection and communications between the workstations and
  276. the NetWare server. NMA for NetView provides for two types of 
  277. connections between NMA for NetView and the NetView host computer. 
  278. The physical connection between NMA for NetView and the NetView 
  279. host is described later in this chapter.
  280.  
  281.                                                               1-1
  282. NMA for NetView exchanges three types of messages with NetView:
  283.  
  284. o  Alerts
  285.  
  286. o  RUNCMDs
  287.  
  288. o  RUNCMD responses
  289.  
  290. Alerts are messages that are sent from NMA for NetView to
  291. NetView. NMA for NetView translates selected NetWare server error
  292. and status messages into alerts.
  293.  
  294. RUNCMDs are messages that are sent from NetView to the NMA for
  295. NetView server. NMA for NetView enables NetView to send commands
  296. that request NetWare server information or control some NetWare
  297. server features.
  298.  
  299. RUNCMD responses are messages that are sent to NetView after a
  300. RUNCMD message has been processed. RUNCMD response messages
  301. contain information about the server or about the result of a
  302. server command.
  303.  
  304. IMPORTANT:  The messages that travel between NMA for NetView and
  305. the NetView host relate to the operation of the NetWare 
  306. server. NMA for NetView does not monitor, report, or control the
  307. status of the NetWare LAN or NetWare LAN workstations. NMA for
  308. NetView does not respond to maintenance statistic requests from
  309. an IBM host.
  310.  
  311. NetView operators use a terminal, or NetView console, to connect 
  312. to the NetView program on the host. From the terminal, the NetView 
  313. operator can view alert messages, send RUNCMD messages, and view 
  314. RUNCMD response messages. For more information on NetView operation, 
  315. see the NetView Operation Primer (SC30-3363) from IBM.
  316.  
  317. NOTE:  Third-party 3270 terminal emulation products, such as the 
  318. NetWare 3270 LAN Workstation(TM) by Attachmate*, enable NetWare 
  319. LAN workstations to emulate IBM terminals. NMA for NetView enables
  320. NetView communications between LAN workstations and the host.
  321.  
  322.  
  323. WHAT IS NEW IN VERSION 1.3B?
  324.  
  325. NMA for NetView 1.3B provides the following new features:
  326.  
  327. o  Support for NetWare 4.0-or-later servers and support for 
  328.    additional RUNCMDs that apply to the NetWare 4.0-or-later
  329.    server.
  330.  
  331. o  Security enabling and disabling.
  332.  
  333. o  RUNCMD and alert enabling and disabling.
  334.  
  335. o  Alert flow control in servers with direct host connections.
  336.  
  337. These features are described with the complete set of NMA for
  338. NetView features in the next section.
  339.                                                               1-2
  340.  
  341. NMA FOR NETVIEW FEATURES
  342.  
  343. The principal features of NMA for NetView are
  344.  
  345. o  Alert generation
  346.  
  347. o  RUNCMD processing
  348.  
  349. o  RUNCMD security
  350.  
  351. o  RUNCMD filtering
  352.  
  353. o  Host communication options
  354.  
  355.    -  Direct host communications
  356.    -  Collection point communications
  357.  
  358. o  Alert flow control
  359.  
  360. o  Support for the Open NetView Interface
  361.  
  362.  
  363. Alert Generation
  364. ----------------
  365.  
  366. NMA for NetView generate alerts for the following server
  367. processes:
  368.  
  369. o  Token ring adapters and drivers
  370.  
  371. o  Logical link control (LLC) protocol components of token ring
  372.    drivers
  373.  
  374. o  The NetWare operating system and component services
  375.  
  376. NOTE:  The alerts for token ring adapters, drivers, and protocol 
  377. components apply to the token ring components in the NMA for
  378. NetView server. NMA for NetView does not generate alerts for
  379. similar conditions in NetWare LAN workstations.
  380.  
  381. These NetView alert messages are listed in the NetWare Reference
  382. Guide for NetView Operators. (For information on how to get this
  383. guide, see "Obtaining the Software and the Manuals" in
  384. Chapter 2.) Each message description in the NetWare Reference
  385. Guide for NetView Operators includes the NetView alert, a
  386. description of the alert cause, a suggested action, and the
  387. NetWare message (if one exists) that would appear on the server
  388. console.
  389.  
  390.                                                              1-3
  391. SUGGESTION:  If the NetView operator contacts you for help with
  392. an alert message, ask the operator to look it up in the NetWare
  393. Reference Guide for NetView Operators. If the operator still
  394. needs help, ask the operator to tell you the NetWare message that
  395. corresponds to the alert message.
  396.  
  397. Because of differences between NetView and NetWare, the NetWare
  398. message is always different from the corresponding NetView
  399. message. (NetWare messages are described in the System Messages
  400. manuals for your version of NetWare.)
  401.  
  402.  
  403. RUNCMD Processing
  404. -----------------
  405.  
  406. If the RUNCMD processing feature is enabled, NMA for NetView 
  407. processes two types of RUNCMDs:
  408.  
  409. o  Server query commands
  410.  
  411. o  Server control commands
  412.  
  413. NMA for NetView allows you to control command processing with
  414. the following features:
  415.  
  416. o  RUNCMD security
  417.  
  418. o  RUNCMD filtering
  419.  
  420. This section describes the actions these commands produce and the
  421. control features you can use.  For detailed information on each 
  422. RUNCMD and its syntax, see the NetWare Reference Guide for NetView 
  423. Operators.
  424.  
  425.  
  426. Server Query RUNCMDs
  427.  
  428. Server query RUNCMDs request information about server resources.
  429. These commands allow the NetView operator to query for
  430.  
  431. o  Server information such as the number of volumes on a server,
  432.    the server's login status, and the server's internetwork
  433.    address
  434.    
  435. o  Volume information such as the space allowed for a user, and
  436.    the space used by a user
  437.    
  438. o  Directory information such as the space allowed for a
  439.    directory, and a user's rights to the directory
  440.    
  441. o  File information
  442.  
  443. o  A user's usage of a volume and the remaining space allowed to
  444.    the user
  445.  
  446. o  The version numbers of the Sequenced Packet Exchange (SPX) and
  447.    Internetwork Packet Exchange(TM) (IPX(TM)) protocols
  448.                                                               1-4
  449. o  The configuration of the SPX protocol
  450.  
  451. o  The status of the Transaction Tracking System(TM) (TTS)
  452.  
  453. o  Information on most (not all) server settings that can be set
  454.    with NetWare SET command parameters
  455.  
  456.  
  457. Server Control Commands
  458.  
  459. Server control commands allow a NetView operator to
  460.  
  461. o  Enable or disable server login, shut down a server, and
  462.    broadcast a message to server users
  463.    
  464. o  Set server date and time
  465.  
  466. o  Set the volume space allowed to a user and remove a user
  467.    from a volume
  468.  
  469. o  Set the space allowed to a directory; add or remove a
  470.    directory trustee; and set the owner, creation date, and
  471.    creation time for a directory
  472.    
  473. o  Add and remove file trustees and set the file owner, the
  474.    creation date and time, the update date and time, the access
  475.    date, and the archive date and time
  476.  
  477. o  Enable or disable the Transaction Tracking System (TTS)
  478.  
  479. o  Load and unload an NLM
  480.  
  481. o  Set most (not all) server control parameters that can also be
  482.    set at the server console with the NetWare SET command
  483.  
  484.  
  485.  
  486.  
  487.                                                               1-5
  488. RUNCMD Security
  489. ---------------
  490. NMA for NetView provides an optional RUNCMD security feature for
  491. controlling NetView RUNCMD processing.  If security is enabled,
  492. NMA for NetView checks each RUNCMD for a valid NetWare user ID with
  493. the appropriate status (see Table 1-1).
  494.  
  495. Table 1-1
  496. NetView RUNCMD Processing
  497. ---------------------------------------------------------------
  498. Server Command Type         NetWare User ID Status Required for
  499.                             Processing
  500. --------------------------------------------------------------
  501. Query                       File server console operator or
  502.                             supervisor on target NetWare v3.1x
  503.                             servers.
  504.  
  505.                             Console operator status or security
  506.                             equivalence to the file server object
  507.                             on target NetWare 4.x servers.
  508.  
  509.  
  510. Control                     Supervisor rights on target NetWare
  511.                             v3.1x servers.
  512.  
  513.                             Security equivalence to the file server 
  514.                             object on target NetWare 4.x servers.
  515. -----------------------------------------------------------------
  516.  
  517. When a command message does not include an acceptable NetWare user ID,
  518.  
  519. NetWare rejects the command and sends the following message to
  520. NetWare:
  521.  
  522. Invalid operator <name>
  523.  
  524. When this message appears on the NetView console the <name> variable
  525. displays the user ID that was rejected.
  526.  
  527. NOTE:  When RUNCMD security is enabled, the SUPERVISOR user ID is 
  528. not an acceptable user ID for issuing RUNCMDs.  NMA for NetView
  529. rejects RUNCMDs issued by the SUPERVISOR ID.
  530.  
  531. RUNCMD Filtering
  532. ----------------
  533. The RUNCMD filtering feature allows you to disable NetWare
  534. processing of select commands that may be sent by NetView
  535. operators.  You can disable any number of RUNCMDs by listing
  536. them in a file that NMA for NetView reads when loading.
  537.  
  538. When a NetView operator sends a command that has been disabled by
  539. RUNCMD filtering, NMA for NetView returns the following message
  540. to NetView:
  541.  
  542. Cannot access this NetView Runcmd
  543.  
  544. For more information, see Appendix B, "Using NetView RUNCMD 
  545. Filtering."
  546.                                                               1-6
  547. Host Communications Options
  548. ---------------------------
  549.  
  550. NMA for NetView provides two options for communicating with the
  551. host computer:
  552.  
  553. o  Direct host communications over a token ring LAN
  554.  
  555. o  Collection point communications via a NetWare for SAA server
  556.  
  557.  
  558. Direct Host Communications
  559.  
  560. When using the direct host communications option, the NMA for
  561. NetView server must connect to a token ring LAN. The host
  562. computer must also connect, either directly or indirectly, to the
  563. same token ring LAN.
  564.  
  565. Indirect connections are supported by a variety of host
  566. communications equipment, such as an IBM 3174 Attachment.
  567.  
  568. Alerts and RUNCMD responses from the NMA for NetView server
  569. travel over the token ring LAN to the host. RUNCMDs from NetView
  570. travel over the token ring LAN to the NMA for NetView server.
  571.  
  572.  
  573. Collection Point Communications
  574.  
  575. When using the collection point communications option, NMA for
  576. NetView indirectly connects to the host computer through a
  577. NetWare for SAA server. In this system configuration, the NetWare
  578. for SAA server is called a collection point server.
  579.  
  580. When operating as a collection point server, the NetWare for SAA
  581. server uses the following connections:
  582.  
  583. o  A connection via the NetWare LAN to the NMA for NetView server
  584.  
  585. o  A token ring, Synchronous Data Link Control (SDLC), 
  586.    Qualified Logical Link Control (QLLC), or Ethernet 
  587.    connection to the host computer running NetView
  588.  
  589. When NMA for NetView is ready to send an alert, it sends the
  590. alert over the NetWare LAN to the collection point server. The
  591. collection point server forwards the alert to NetView.
  592.  
  593. When NetView is ready to send a RUNCMD to an NMA for NetView
  594. server, it sends the RUNCMD to the collection point server. The
  595. collection point server forwards the RUNCMD over the NetWare LAN
  596. to the NMA for NetView server. RUNCMD response messages from NMA
  597. for NetView follow the same communications path as do alert 
  598. messages.
  599.  
  600.  
  601.  
  602.  
  603.                                                               1-7
  604. Advantages of Collection Point Communications
  605.  
  606. The collection point server option on the NetWare for SAA server and
  607. the collection point communications option on any downstream NMA for
  608. NetView server can reduce the cost of NetView management in NetWare 
  609. LANs with multiple servers.  If your NetWare LAN does not use token
  610. ring cabling, for example, the collection point server option can
  611. eliminate the cost of a token ring adapter for each NMA for NetView
  612. server.
  613.  
  614. The collection point server option also reduces the number of host
  615. connections required by NetWare servers.  The host must allocate a
  616. physical unit (PU) for each NMA for NetView or NetWare for SAA server
  617. that is configured for direct host communications.
  618. NetView messages flow over a session between the PU and the system
  619. services control point (SSCP) host component. Servers that are
  620. configured for collection point communications use the SSCP-PU session
  621. allocated to the collection point server; they do not require an
  622. additional PU assignment.
  623.  
  624. Alert Flow Control
  625. ------------------
  626. You can insert parameters into the NVCMDS.DB file to configure NMA for
  627. NetView to monitor and control the flow of NetView alerts to the
  628. NetView console.  If the rate exceeds a high-water mark over a given
  629. time interval, alerts are discarded until the rate slows to the
  630. low-water mark.  You can define the high and low water marks and the
  631. time interval in the NVCMDS.DB file.
  632.  
  633. See "Configuring Alert Flow Control" in Chapter 3.
  634.  
  635. Support for the Open NetView Interface
  636. --------------------------------------
  637. NMA for NetView can provide a connection between NetView and other
  638. applications that conform to the NetWare Open NetView interface.  When
  639. an application uses the Open NetView interface, a server running NMA
  640. for NetView can
  641.  
  642. o  Receive alerts from the application and forward them to NetView
  643.  
  644. o  Receive commands from NetView and forward them to the application
  645.  
  646. For more information on the NetView support provided by an
  647. application, refer to the documentation supplied with the
  648. application.
  649.  
  650.                                                               1-8 CHAPTER 2
  651. Installing or Upgrading NMA for NetView
  652.      
  653. OVERVIEW
  654. Installation of NMA for NetView consists of the following tasks:
  655. o  Choose a connection topology (see this chapter)
  656. o  Set up the required server hardware and software (see this chapter)
  657. o  Prepare the NetWare 3.1x or 4.x server (see this chapter)
  658. o  Install the NMA for NetView software (see this chapter)
  659. o  Prepare the host for NMA for NetView (see this chapter)
  660. o  Configure NMA for NetView (see Chapter 3)
  661.  
  662. CHOOSING A CONNECTION TOPOLOGY
  663. Before you set up the NMA for NetView server, you must choose the host
  664. communications option you will use. The host communications options
  665. are:
  666.  
  667. o  Direct host communications
  668. o  Collection point server communications
  669.  
  670. The host communications options are described in Chapter 1 under "Host
  671. Communications Options."
  672.  
  673. After you choose the host communications option, you need to choose
  674. the topology for your connection.  The topology you choose determines
  675. the hardware and software you need to install.
  676.  
  677. There are many ways to assemble a NetWare network for NetView
  678. management.  This section describes some sample topologies that
  679. support the NMA for NetView host communications options.
  680.                         
  681. Topologies That Support Direct Host Communications
  682. --------------------------------------------------
  683. This section describes two examples of topologies that support direct
  684. host communications.
  685.  
  686. Example 1
  687. In this example, the NMA for NetView server is connected to two
  688. separate LANs:
  689.  
  690. o  One token ring LAN connects the NMA for NetView server, either
  691. directly or indirectly, to the NetView host.  Indirect connections are
  692. supported by a variety of host communications equipment, such as an
  693. IBM 3174 Attachment.
  694.    
  695. o  The other LAN connects to both NMA for NetView and the workstations
  696. that use the file and print services of NetWare.
  697.    
  698. In this example, the NMA for NetView server requires:
  699. o  An IBM 16/4 or 16/4/A Token Ring adapter for communications with
  700. the host LAN
  701.    
  702. o  Cabling from the token ring adapter to the host LAN
  703.  
  704. o  A network adapter for the workstation LAN
  705.  
  706. o  Cabling from the NMA for NetView server to the workstation LAN
  707.  
  708. Each cabling connection should provide a path (via cables, bridges,
  709. routers, and gateways) to the respective communications target, either
  710. the host LAN or the NetWare LAN.
  711. Example 2
  712. In this example, the NMA for NetView server is connected to one token
  713. ring LAN.  The same token ring LAN connects to:
  714.  
  715. o  The NetView host.  (Indirect connections are supported by a variety
  716. of host communications equipment, such as an IBM 3174 Attachment.)
  717.    
  718. o  The workstations that use the file and print services of NetWare.
  719.  
  720. When using this topology, NMA for NetView requires an IBM 16/4 or
  721. 16/4/A Token Ring adapter and cabling from the NMA for NetView server
  722. to the host LAN. The cabling connection should provide a path (via
  723. cables, bridges, routers, and gateways) to the host LAN and all
  724. NetWare workstations.
  725.  
  726. A Topology That Supports Collection Point Communications
  727. --------------------------------------------------------
  728. When using the collection point communications option, NMA for NetView
  729. indirectly connects to the host computer through a NetWare for SAA
  730. server. In this system configuration, the NetWare for SAA server is
  731. called a collection point server.
  732.  
  733. When operating as a collection point server, the NetWare for SAA
  734. server uses the following connections:
  735. o  A connection via the NetWare LAN to the NMA for NetView server
  736.  
  737. o  A token ring, SDLC, QLLC, or Ethernet connection to the host's
  738.    communications equipment
  739.  
  740. In this topology, the NMA for NetView server connects to a single
  741. network through one network adapter. The NMA for NetView server uses
  742. the same adapter and network to communicate with the collection point
  743. server and the NetWare workstations. 
  744.  
  745. This topology requires one network adapter and one network connection.
  746. The network connection should provide paths (via cables, bridges,
  747. routers, and gateways) to the collection point server and the NetWare
  748. workstations.
  749.  
  750. SUGGESTION:  If you are adding NMA for NetView to an operating NetWare
  751. v3.1x server and you plan to use a collection point server topology,
  752. you can use the server's existing network adapter-you do not need to
  753. install an additional adapter.  As is required for a new server in
  754. this topology, the network connection must provide a path to the
  755. collection point server. 
  756.  
  757. SETTING UP THE REQUIRED SERVER HARDWARE AND SOFTWARE
  758.  
  759. NMA for NetView requires certain hardware and software.
  760.  
  761. Required Hardware
  762. -----------------
  763. NMA for NetView requires the following hardware:
  764. o  A personal computer that uses a 386 or 486 microprocessor.
  765.  
  766. o  One or more network adapters. (See "Choosing a Connection Topology"
  767.  
  768. earlier in this chapter.)
  769.  
  770. o  Cabling between all network adapters and the appropriate network.
  771. (See "Choosing a Connection Topology" earlier in this chapter.)
  772.    
  773. o  Sufficient random access memory (RAM) to support your version of
  774.    NetWare and NMA for NetView.
  775.      - For NetWare v3.1x a minimum of 6 MB RAM is required: 2 MB for
  776.      NMA for NetView and a minimum of 4 MB for NetWare v3.1x.
  777.  
  778.      - For NetWare 4.x a minimum 10 MB of RAM is required: 2 MB for
  779.      NMA for NetView and a minimum 8 MB for NetWare 4.x.
  780.    
  781. Refer to the manuals for each hardware product for installation
  782. instructions.
  783.  
  784. IMPORTANT:  Record the option settings of all jumpers and switches on
  785. each network adapter. If the board has a network address or serial
  786. number, record these items also.  When using two or more adapters for
  787. the same type of cabling system, be sure to note the adapter connected
  788. to each network.
  789.  
  790. SUGGESTION:  If you are adding a network adapter to an operating
  791. server, you must bring down the server and turn off the power.  To
  792. minimize the interruption to file server users, consider waiting until
  793. the file server is idle or is scheduled for routine maintenance.
  794.  
  795. Required Software
  796. -----------------
  797. NMA for NetView requires the following software:
  798. o NMA for NetView 1.3B. (this software)
  799.  
  800. o NetWare v3.1x or NetWare 4.x, which includes:
  801.  
  802.   - Clib (CLIB.NLM) to support the library of C functions.
  803.  
  804.   - Btrieve v6.0 or later (BTRIEVE.NLM).  This product manages the
  805.   database that holds your NMA for NetView configuration parameters.
  806.  
  807. NOTE: If Btrieve v6.10 or later is absent from your server, or if you
  808. have an earlier version installed, NMA for NetView automatically
  809. installs the correct version during the installation procedure.
  810.  
  811. o Network drivers to support each installed network adapter.  (Some
  812. drivers are provided with NetWare v3.1x.)
  813.  
  814. Refer to the manuals for each software product for installation
  815. instructions.
  816.  
  817. IMPORTANT: Record the option settings of all jumpers and switches on
  818. each network adapter.  If the board has a network address or serial
  819. number, record these items also.  When using two or more adapters for
  820. the same type of cabling system, be sure to note the adapter connected
  821. to each network.
  822.  
  823. SUGGESTION:  If you are adding a network adapter to an operating
  824. server, you must bring down the server and turn off the power.
  825. To minimize the interruption to file server users, consider waiting
  826. until the file server is idle or scheduled for routine maintenance.
  827.  
  828. PREPARING THE NETWARE SERVER
  829. Because all other software components must be loaded before you can
  830. run NMA for NetView, Novell recommends that you automate their loading
  831. by inserting the appropriate statements in your server's AUTOEXEC.NCF
  832. file.
  833. Prepare the NetWare v3.1x or 4.x server for the installation and
  834. operation of NMA for NetView as follows:
  835. 1. If you have not already done so, install NetWare.
  836.   
  837. For instructions on installing and starting NetWare, refer to the
  838. installation and upgrade manual for your version of NetWare.
  839.  
  840. 2. Start the server.
  841. For instructions on downing or restarting NetWare, see the NetWare
  842. DOWN and SERVER command descriptions in the system administration or
  843. supervising manual for your version of NetWare.
  844.  
  845. 3. Start the NetWare INSTALL utility and select the option to edit the
  846. AUTOEXEC.NCF file.
  847.  
  848. For instructions on editing the AUTOEXEC.NCF file, see the
  849. instructions on the INSTALL utility in the system administration or
  850. supervising manual for your version of NetWare.
  851.  
  852. 4. If you are using NetWare 4.0 or later, edit the AUTOEXEC.NCF file
  853. to enable bindery emulation.
  854.  
  855.     Insert the line:
  856.         set bindery context=[ou=<org_unit>.] o=<organization>
  857.  
  858. For more information on setting the bindery context, see "Enabling
  859. Bindery Emulation" in this chapter.
  860.  
  861. IMPORTANT: Insert this line only if you are using NetWare 4.0 or
  862. later!
  863.  
  864. 5.  Edit the AUTOEXEC.NCF file to load the CLIB.NLM and load and
  865. configure Btrieve.
  866.  
  867.     Insert the following lines:
  868.         load clib
  869.         load btrieve -P=4096 -F=20 -H=60 -L=20 -C -U=1
  870.  
  871. For more information on Btrieve and its parameters, see "Loading and
  872. Configuring Btrieve" in this chapter.
  873.  
  874. 6.  Edit the AUTOEXEC.NCF file to load and configure the communication
  875. protocol NLMs.
  876.  
  877. o If setting up a server for direct host communications, insert a line
  878. similar to the following to load the token ring adapter:
  879.  
  880.   load token port=a20 int=2 node=12345678 name=<logical_adapter_name>
  881.  
  882.   For more information, see "Loading for Direct Host Communications"
  883.   in this chapter.
  884.  
  885. o If setting up a server for "collection point communications," insert
  886. lines similar to the following to load and bind the server's LAN
  887. adapter:
  888.   load <lan_driver>
  889.   bind ipx to <lan_driver>
  890.  
  891. For more information, see "Loading and Binding for Collection Point
  892. Server Communications" in this chapter.
  893.  
  894.   SUGGESTION:  See "AUTOEXEC.NCF Examples," later in this chapter, for
  895.   examples of AUTOEXEC.NCF edits that support NMA for NetView.
  896.  
  897. 7. (Optional) If you want to, edit the AUTOEXEC.NCF file to load NMA
  898. for NetView automatically when you start the server.
  899.  
  900. Insert the following line in a location after the command lines
  901. described in Steps 4, 5, and 6:    load NMANV
  902.  
  903. 8.  Restart the server.
  904.  
  905. After completing the above edits, but before installing NMA for
  906. NetView, restart the server with the settings you specified in this
  907. procedure.  Then see "Preparing the Host," later in this chapter.
  908.  
  909. The rest of this section provides additional information on the steps
  910. to prepare the server.
  911.  
  912. Enabling Bindery Emulation
  913. --------------------------
  914. If you are running NetWare 4.0 or later, you must make sure bindery
  915. emulation is enabled for the server on which you have NMA for NetView
  916. installed.  Enter the following command or make sure it exists in the
  917. server's AUTOEXEC.NCF file:
  918.  
  919.  set bindery context=[ou=<org_unit>.] o=<organization>
  920.  
  921. Replace <org_unit> with the organizational unit (if any) to which this
  922. server is assigned in NetWare Directory Services(TM).  You can specify
  923. several levels of organizational units.
  924.  
  925. Replace <organization> with whatever organization name has been
  926. assigned in NetWare Directory Services.
  927.  
  928. The following example sets the bindery context for a server in
  929. SNAGROUP container object.
  930.  
  931.  set bindery context=ou=snagroup.ou=sunnyvale.o=megabrite
  932.  
  933. For more information on setting bindery emulation on NetWare 4.x
  934. servers, see the NetWare 4.x manual, "Supervising the Network."
  935.  
  936. Loading and Configuring Btrieve
  937. -------------------------------
  938. You must edit the AUTOEXEC.NCF file to load and configure Btrieve
  939. before you can install or operate NMA for NetView.  NetWare Btrieve
  940. is a database management system that manages you NMA for NetView
  941. configuration parameters.
  942.  
  943. First, insert the command to load the CLIB.NLM.  Btrieve requires this
  944. NLM to be loaded.
  945.  
  946. Next, enter the command to load Btrieve along with required
  947. configuration parameters.
  948.  
  949. Table 2-2 lists the Btrieve configuration parameters and the settings
  950. that NMA for NetView requires.
  951.  
  952. If you have changed the default settings in Btrieve, you may need to
  953. reconfigure Btrieve to support NMA for NetView. 
  954.  
  955. Table 2-2
  956. Btrieve Configuration Settings for NMA for NetView
  957. ----------------------------------------------------------------
  958. Btrieve Parameter                  LOAD Command        Suggested
  959.                                    Line Option         Value
  960. --------------------------------------------------------------
  961. Number of open files                    -F                20
  962.  
  963. Number of handles                       -H                60
  964.  
  965. Number of locks                         -L                20
  966.  
  967. Number of transactions                  -T
  968.  
  969. Number of files per transaction         -N
  970.  
  971. Largest compressed record size          -U                 1
  972.  
  973. Largest record size                     -D
  974.  
  975. Largest page size                       -P              4096
  976.  
  977. Number of sessions                      -S
  978.  
  979. Create files as transactional           -I
  980.  
  981. Logging of selected files               -A
  982. -----------------------------------------------------------------
  983.  
  984. The following two commands entered in the AUTOEXEC.NCF file support,
  985. load, and configure Btrieve to support NMA for NetView:
  986.   load clib
  987.   load btrieve -P=4096 -F=20 -H=60 -L=20 -C -U=1
  988.  
  989. Loading and Binding the LAN Adapter
  990. -----------------------------------
  991. If you plan to configure NMA for NetView for direct host
  992. communications, edit AUTOEXEC.NCF to load an adapter driver for the
  993. adapter through which you communicate with the host. 
  994.  
  995. If you plan to configure NMA for NetView for collection point
  996. communications, edit AUTOEXEC.NCF to load the LAN adapter driver and
  997. bind the driver to a communication protocol.
  998.     
  999.                           
  1000. Loading for Direct Host Communications
  1001. When NMA for NetView is configured for direct host communications, you
  1002. must use a token ring adapter and adapter driver for host
  1003. communications.  Because NMA for NetView uses its own SNA protocol
  1004. stack to communicate with the host, you do not have to bind the
  1005. adapter driver to a protocol.
  1006.  
  1007. IMPORTANT: If you plan to use the same adapter for host and
  1008. workstation communications, you must bind the adapter driver to a
  1009. communication protocol.
  1010.  
  1011. The TOKEN.LAN adapter driver is supplied with NetWare.  To load and
  1012. configure the TOKEN.LAN adapter driver, enter a command in your
  1013. AUTOEXEC.NCF file that is similar to the following:
  1014.  
  1015.  load token port=a20 int=2 node=12345678 name=<logical_adapter_name>
  1016. Set the adapter configuration parameters as follows:
  1017.  
  1018. o PORT. Set the port parameter to A20 if it is the primary adapter;
  1019. use A24 for the alternate adapter. (Refer to the manual that came with
  1020. the token ring adapter for information on adapter switch settings.)
  1021.  
  1022. o INT. Enter the interrupt number used by the token ring adapter. 
  1023. If you do not know what interrupt the adapter uses, refer to the
  1024. manual for the adapter.
  1025.  
  1026. o NODE. "Node" refers to the address of the server's token ring
  1027. adapter that communicates with the host. Enter the last eight digits
  1028. of the adapter's locally administered address, which is defined by the
  1029. LAN or system administrator.
  1030.  
  1031. o NAME.  This parameter specifies the name for the token ring LAN
  1032. adapter.  The logical name can be up to 16 alphanumeric and/or special
  1033. characters.  You will use this name later to configure the Logical
  1034. Adapter Name field in NVCONFIG.
  1035.  
  1036. Loading and Binding for Collection Point Server Communications
  1037. --------------------------------------------------------------
  1038. When NMA for NetView is configured for collection point server 
  1039. communications, you must load a LAN adapter driver and bind it to a
  1040. communication protocol.  The type of adapter and communication
  1041. protocol you use depends on the network through which you will connect
  1042. to the collection point server.
  1043.  
  1044. The following command list is an example of the commands required to
  1045. load an NE2000(TM) adapter driver and bind it to IPX:
  1046.   load ne2000
  1047.   bind ipx to ne2000
  1048.  
  1049. For information on binding a LAN adapter driver to IPX, see NetWare
  1050. Version 3.11 Installation, NetWare 3.12 Installation and Upgrade, or
  1051. the NetWare 4.x manual Installation and Upgrade.
  1052.  
  1053. NOTE: If you are installing NMA for NetView onto a NetWare v3.11
  1054. server, the INSTALL program automatically upgrades your LAN adapter
  1055. drivers if it detects that your current drivers are too old to support
  1056. NMA for NetView. 
  1057.  
  1058. AUTOEXEC.NCF Examples
  1059. ---------------------
  1060. This section contains examples of commands entered in AUTOEXEC.NCF
  1061. files to prepare the NetWare server to support NMA for NetView.
  1062.  
  1063. Example for Direct Host Communications
  1064. --------------------------------------
  1065. The following command list is an example of the commands required to
  1066. prepare a NetWare server for direct communications between NMA for
  1067. NetView and the host:
  1068.  
  1069.  bindery context=ou=hostsrv.ou=legal.o=megabrite
  1070.  load clib
  1071.  load btrieve -P=4096 -F=20 -H=60 -L=20 -C -U=1
  1072.  load token port=a20 int=2 node=12345678 name=<logical_adapter_name>
  1073.  
  1074. When configured for direct host communications, NMA for NetView uses
  1075. its own Systems Network Architecture (SNA) protocol stack to
  1076. communicate with the host.  No additional communication protocol NLMs
  1077. are required for host communications.
  1078.  
  1079. The LOAD TOKEN command loads the token ring driver for the LAN
  1080. adapter.  The NAME=<logical_adapter_name> parameter specifies the name
  1081. for the token ring LAN adapter.  The procedure for loading for direct
  1082. host communications is described in "Loading for Direct Host
  1083. Communications" earlier in this chapter.
  1084.  
  1085. NOTE: The NetWare server requires additional communication protocol
  1086. NLMs for workstation communications.  This section describes only the
  1087. requirements for NMA for NetView.
  1088.  
  1089. Example for Collection Point Communications
  1090. -------------------------------------------
  1091. The following command list is an example of the commands required to
  1092. prepare a NetWare server for communications with a collection point
  1093. server:
  1094.   bindery context=ou=hostsrv.ou=legal.o=megabrite
  1095.   load clib
  1096.   load btrieve -P=4096 -F=20 -H=60 -L=20 -C -U=1
  1097.   load <lan_driver>
  1098.   bind <protocol> to <lan_driver>
  1099.  
  1100. When configured for collection point communications, NMA for NetView
  1101. uses an SPX connection to communicate with the collection point
  1102. server.  The communications path may be direct, or it may require
  1103. intermediate communications devices such as bridges or routers.
  1104.  
  1105. The LOAD <lan_driver> and BIND commands load the driver for the LAN
  1106. adapter and bind it to the communication protocol.  The procedure to
  1107. load and bind collection point communications is described in "Loading
  1108. and Binding for Collection Point Server Communications" earlier in
  1109. this chapter.
  1110.  
  1111. INSTALLING OR UPGRADING THE NMA FOR NETVIEW SOFTWARE
  1112. This section describes how to install the NMA for NetView software or
  1113. upgrade it from version 1.3 to 1.3B.
  1114.  
  1115. Upgrading from NMA for NetView v1.3 to 1.3B is the same as installing.
  1116.  
  1117. The installation procedure automatically upgrades your software also. 
  1118. In addition, if you have upgraded from NetWare v3.1x to NetWare 4.x,
  1119. the installation procedure automatically installs the files to make
  1120. NMA for NetView compatible.
  1121.  
  1122. IMPORTANT:  If NetWare for SAA is installed in the NetWare server, do
  1123. not install the NMA for NetView software. NetWare for SAA provides
  1124. NetView network management support, which is similar to NMA for
  1125. NetView.
  1126.  
  1127. To install the NMA for NetView software:
  1128. 1.  If the server is not running, start the server and all
  1129. prerequisite NLMs and drivers.
  1130.     
  1131. "Preparing the NetWare Server" earlier in this chapter describes which
  1132. NLMs and drivers must be running.
  1133.  
  1134. 2.  If a version of NMA for NetView earler than 1.3 is installed,
  1135. remove that version of the software.
  1136.  
  1137.     IMPORTANT:  Do not use the NetWare INSTALL utility to remove
  1138.     versions of NMA for NetView earlier than v1.3. You must remove
  1139.     earlier versions of NMA for NetView with the same version of
  1140.     NVINSTAL that was used to install that version of NMA for
  1141.     NetView.
  1142.     
  1143.     For instructions on removing previous versions of NMA for
  1144.     NetView, see the documentation for that version of NMA for
  1145.     NetView.
  1146.     
  1147. 3. Start the NetWare INSTALL utility. 
  1148. Enter         :load install
  1149.  
  1150. o If you are running NetWare v3.1x, the INSTALL utility displays the
  1151. Installation Options menu.
  1152.  
  1153. o If you are running NetWare 4.0 or later, the INSTALL utility
  1154. displays the Select an Installation Method menu.
  1155. Select "Maintenance/Selective Install" from the Select an Installation
  1156. Method menu.  The INSTALL utility then displays the Installation
  1157. Options menu.
  1158.  
  1159. 5. Select Product Options from the Installation Options menu.
  1160.  
  1161. 6. When the Currently Installed Products window appears, press
  1162. <Insert>.
  1163.  
  1164. The "Enter drive..." dialog box appears, prompting you to specify the
  1165. location of your NMA for NetView Installation files.
  1166.  
  1167. 7. Specify where the installation files are located.
  1168.  
  1169. o If you inserted the "NMA for NetView 1.3B, Disk 1" in the server's
  1170. drive A:, press <Enter>; otherwise, type the letter of the drive where
  1171. you inserted the diskette and press <Enter>.
  1172.  
  1173. o If you copied the installation files to an installation directory in
  1174. the DOS partition of your server's hard disk or in a network drive,
  1175. enter the path to that directory.
  1176. For example:  >c:\disk1
  1177.  
  1178. IMPORTANT: You must specify DISK1 at the end of the above directory
  1179. path to continue the installation.
  1180.  
  1181. 8. When the Install displayed product? window appears, select the
  1182. option to Install on this server.
  1183.  
  1184. 9. Follow the prompts until all the required files are installed on
  1185. the server.
  1186.  
  1187. After installation is complete, the NMA for NetView item appears
  1188. highlighted in the Currently Installed Products window.
  1189.  
  1190. 10. Run NVCONFIG to configure NMA for NetView before running NMA for
  1191. NetView.
  1192.  
  1193. o  If you want to run NVCONFIG immediately, highlight the NMA for
  1194. NetView option in the Currently Installed Products and press <Enter>.
  1195.        
  1196.        The NMA for NetView Communications Options menu appears.
  1197.        Configure the software as described in "Configuring NMA 
  1198.        for NetView" in Chapter 3.
  1199. o  If you are not ready to configure the software, you can exit the
  1200. NetWare INSTALL program and restart the program when you are ready to
  1201. configure.  To exit the program, press <Esc>.
  1202.  
  1203. PREPARING THE HOST
  1204. NMA for NetView requires certain hardware and software at the host
  1205. computer.  As shown in Table 2-3, these host requirements vary
  1206. according to the NMA for NetView communications option in use.
  1207.  
  1208. Table 2-3
  1209. Connection Requirements
  1210. -----------------------------------------------------------------
  1211. Components                      Direct Host      Collection Point
  1212.                                 Communications   Communications
  1213. -----------------------------------------------------------------
  1214. NetView software                Required         Required
  1215. on the host
  1216.  
  1217. PU Type 2.0 definition          Required         Not applicable
  1218. in VTAM on the host
  1219.  
  1220. Token ring LAN connection       Required         Not applicable
  1221. between the host and the
  1222. NMA for NetView server
  1223.  
  1224. NetWare for SAA  on             Not applicable   Required
  1225. collection point server
  1226.  
  1227. Host communications             Not applicable   Required
  1228. link to the
  1229. collection point server
  1230.  
  1231. NetView code points             If installed     If installed
  1232. for NetWare on the host         NetView is 2.1   NetView is 2.1
  1233.                                 or earlier       or earlier
  1234. -------------------------------------------------------------
  1235.  
  1236. The following sections describe each of the host components that may
  1237. be required.
  1238.  
  1239. NetView Software
  1240. ----------------
  1241. The NetView software is required to receive the NetWare alert messages
  1242. and send commands to NetWare servers.  The host systems programmer is
  1243. responsible for installing NetView.
  1244.  
  1245. PU Type 2.0 Definition in VTAM
  1246. ------------------------------
  1247. If you are configuring NMA for NetView for direct host communications,
  1248. the host must allocate a physical unit (PU) for the NMA for NetView
  1249. server.  NetView messages flow over a session between the PU and the
  1250. system services control point (SSCP) host component.
  1251.  
  1252. NOTE:  Servers that are configured for collection point communications
  1253. use the SSCP-PU session allocated to the collection point server. 
  1254. When using the collection point communications option, the NMA for
  1255. NetView server does not require a PU definition.
  1256.  
  1257. You are responsible for telling the host systems programmer what type
  1258. of PU definition you need.  Because some NMA for NetView configuration
  1259. parameters must be set to match certain host parameters, you must ask
  1260. the host systems programmer for the host configuration parameter
  1261. settings.
  1262.  
  1263. To request a PU and get the host configuration parameters, you need to
  1264. do the following:
  1265.  
  1266. 1.  Photocopy Table 3-1 in Chapter 3.
  1267. The host communications parameters in Table 3-1 are the NMA for
  1268. NetView parameters that must be set to match parameters at the host.
  1269.     
  1270. 2.  Contact the host systems programmer and request a PU definition
  1271. for your NMA for NetView server.
  1272.     
  1273. Table 2-4 lists three types of host communication equipment and the PU
  1274. definition required for each type.  The host systems programmer should
  1275. be able to tell you what type of communication equipment is processing
  1276. your connection. 
  1277.     
  1278. Table 2-4
  1279. PU Type Definitions for Host Communication Equipment 
  1280. ----------------------------------------------------
  1281. Communication Equipment              PU Definition
  1282. -----------------------------------------------------------
  1283. 937x attachment and 37xx             Switched token ring PU
  1284. attachment                           Type 2.0
  1285.     
  1286. 3174 controller                      Nonswitched PU Type 2.0
  1287. -----------------------------------------------------------
  1288. NOTE:  NMA for NetView requires no LU definitions.
  1289.  
  1290. Example 2-1 is a sample PU definition for a 937x attachment.
  1291. This sample is provided to assist the host systems programmer in
  1292. allocating a PU definition for NMA for NetView.
  1293.  
  1294. Example 2-1
  1295. Sample PU Definition for a 937x Attachment
  1296. __________________________________________
  1297.     
  1298.     NMA4NV VBUILD TYPE=SWNET
  1299.     ***************************************
  1300.     * TOKEN RING PU 2.0 FOR NMA for NETVIEW
  1301.     ****************************************
  1302.     PT12345 PU ADDR=04,                                        X
  1303.            IDBLK=017
  1304.            IDNUM=12345
  1305.            LANSW=YES
  1306.            MAXDATA=1033
  1307.            PUTYPE=2
  1308.            ISTATUS=ACTIVE
  1309.     ________________________________________________________
  1310.       
  1311. 3.  Ask the host systems programmer for the host communications
  1312. parameters for your NMA for NetView server.
  1313.  
  1314. Table 2-5 lists the NMA for NetView configuration parameters that must
  1315. match settings on the host communications equipment.
  1316. The first column lists the parameter names as they appear in NVCONFIG.
  1317. Columns 2 through 4 list the corresponding host parameters for three
  1318. types of host communications equipment.
  1319.   
  1320. Table 2-5
  1321. NVCONFIG Parameters That Must Match Host Parameters
  1322. ---------------------------------------------------
  1323. NVCONFIG     937x Attachment  37xx Attachment   3174 Controller
  1324. Parameter    Parameter        Parameter         Parameter
  1325. Name         Location         Location          Location
  1326. ---------------------------------------------------------
  1327. Peripheral   CPNAME state-    Not applicable    Not applicable
  1328. Node Con-    ment (if any)
  1329. trol Point   in the switched
  1330. Name         PU definition
  1331.  
  1332. Token Ring   MACADDR          Token interface   Statments 900
  1333. Destination  definition       card (TIC)        and 940 in the 
  1334. Node         in the PORT      address (LOCADD=  Customization 
  1335. Address      statement        <value>)in the    Panels
  1336.              Network Control 
  1337.              Program (NCP)
  1338.              definition
  1339. --------------------------------------------------------
  1340. Token Ring   Not applicable   Enter 4 for       Configuration
  1341. Destination                   this parameter.   question 900 in
  1342. Service                                         the 3174
  1343. Access                                          Customization
  1344. Point (SAP)                                     Panels
  1345.  
  1346. Token Ring    SAPADDR          Enter 4 for       Statement 940
  1347. Service       definition       this parameter.   in the
  1348. Access        in the PORT                        Customization
  1349. Point (SAP)   statement                          Panels
  1350.  
  1351. Block ID         IDBLK statement   IDBLK statement   Not applicable;
  1352. in the switched  in the switched   entry required
  1353. PU definition    PU definition
  1354.  
  1355. PUID for     IDNUM statement  IDNUM statement   Not applicable;
  1356. Token Ring   in the switched  in the switched   no entry
  1357. Connection   PU definition    PU definition     required
  1358.  
  1359. -------------------------------------------------------
  1360. Record the host systems parameters as follows:
  1361.  
  1362. 3a.  Locate the column in Table 2-5 for the host communications
  1363. equipment your host connection will use.
  1364.     
  1365. 3b.  Ask the host systems programmer for the values of the parameters
  1366. in that column.
  1367.  
  1368. 3c.  Write down the host communications parameters on the
  1369. photocopy of Table 3-1.
  1370.      
  1371. 4.  Save the photocopy of Table 3-1 so that you have the host
  1372. configuration information when you configure NMA for NetView.
  1373. (Configuration instructions appear under "Configuring NMA for NetView"
  1374. in Chapter 3.)
  1375.     
  1376. NetWare for SAA
  1377. ---------------
  1378. When NMA for NetView is configured for collection point
  1379. communications, you must install NetWare for SAA in the collection
  1380. point server.  To configure NetWare for SAA for host communications,
  1381. see the NetWare for SAA 1.3B Administration Guide.
  1382. Connection to the Token Ring LAN
  1383. --------------------------------
  1384. When NMA for NetView is configured for direct host communications,
  1385. the host must be connected to the token ring LAN.  The host systems
  1386. programmer should be responsible for this task.
  1387.  
  1388. Host Communications Link to the Collection Point Server
  1389. -------------------------------------------------------
  1390. When NMA for NetView is configured for collection point
  1391. communications, the collection point server (NetWare for SAA)
  1392. requires a token ring, Ethernet, SDLC, or QLLC connection to the
  1393. host's communications equipment.  For more information on establishing
  1394. a host communications link to the collection point server, see the
  1395. NetWare for SAA 1.3 Rev. B Administration Guide.
  1396.  
  1397. Installation of NetView Code Points for NetWare
  1398. -----------------------------------------------
  1399. The code points allow NetView to display additional information about
  1400. alerts that are received from NMA for NetView.  These code points are
  1401. provided with NMA for NetView and with NetView Version 2.1.
  1402.  
  1403. You may not need to install the code points for NetWare.  If you are
  1404. using NetView Version 2.1, or later, the code points are included with
  1405. NetView and do not have to be installed.
  1406.  
  1407. If you are using an earlier version of NetView, the code points for
  1408. NetWare must be installed once.  You and the host systems programmer
  1409. must install the code points if the NetWare code points have never
  1410. been installed. Installation is not required if the code points for
  1411. NetWare have been installed for any other NMA for NetView 1.3 or later
  1412. server or NetWare for SAA 1.3 or later server. 
  1413.  
  1414. For additional information on code points and their installation, see
  1415. Appendix A.
  1416. CHAPTER 3  Configuring, Loading, and Unloading NMA for NetView
  1417.  
  1418. This chapter describes the following procedures that you can use
  1419. after you install NMA for NetView: 
  1420.  
  1421. o  Start the NVCONFIG installation utility
  1422.  
  1423. o  Use NVCONFIG to configure or reconfigure the NMA for NetView
  1424.    software
  1425.  
  1426. o  Use NVCONFIG to enable or disable NetView alarm generation,  
  1427.    RUNCMD processing, or RUNCMD security
  1428.  
  1429. o  Load NMA for NetView
  1430.  
  1431. o  Unload NMA for NetView
  1432.  
  1433. o  Administer NMA for NetView remotely
  1434.  
  1435. o  Configure alert flow control in servers with direct host
  1436.    connections
  1437.  
  1438. o  Check for failed LOAD or UNLOAD RUNCMDs
  1439.  
  1440. o  Remove the NMA for NetView software
  1441.  
  1442. These are independent procedures--not subdivisions of a long
  1443. procedure. 
  1444.  
  1445.  
  1446. STARTING NVCONFIG
  1447.  
  1448. To start NVCONFIG:
  1449.  
  1450. 1.  If the server is not running, start the server and all    
  1451.     prerequisite NLMs and drivers.
  1452.  
  1453.     "Preparing the NetWare Server" in Chapter 2 identifies
  1454.     the NLMs and drivers that must be running.
  1455.  
  1456. 2.  If NMA for NetView is running on your server, unload the    
  1457.     program as described later in this chapter under "Unloading
  1458.     NMA for NetView."
  1459.  
  1460. 3.  Enter the following command:
  1461.  
  1462.     :load nvconfig
  1463.  
  1464.     The server loads NVCONFIG from the SYS:SYSTEM directory; then
  1465.     NVCONFIG displays the Available Topics Menu, which includes the 
  1466.     following options:
  1467.  
  1468.     Communications Options
  1469.     NetView Management
  1470.  
  1471.                                                               3-1
  1472. 4.  Do one of the following:
  1473.     
  1474.     o  Select Communications Options to configure NMA for NetView
  1475.        for direct host or collection point server connections.  
  1476.        If you select this option, NVCONFIG displays the Communications
  1477.        Options menu.  See "Configuring NMA for NetView" later
  1478.        in this chapter.
  1479.  
  1480.     o  Select NetView Management to enable or disable forwarding
  1481.        alerts to the NetView console, processing NetView RUNCMDs,
  1482.        and enforcing RUNCMD security.  If you select this option,
  1483.        NVCONFIG displays the NetView Management menu.  See 
  1484.        "Enabling and Disabling Features," later in this chapter.
  1485.  
  1486.  
  1487. CONFIGURING NMA FOR NETVIEW
  1488.  
  1489. You must configure the NMA for NetView software before loading 
  1490. NMA for NetView. Later, if you want to change the configuration, 
  1491. you can reconfigure NMA for NetView. This section describes how 
  1492. to configure or reconfigure the NMA for NetView software.
  1493.  
  1494. IMPORTANT: Before you can configure NMA for NetView, you must have 
  1495. installed the software as described in Chapter 2.
  1496.  
  1497. You can configure the software for
  1498.  
  1499. o  Direct host communications
  1500. o  Collection point server communications
  1501.  
  1502. IMPORTANT: Although NMA for NetView allows you to configure the 
  1503. software for either communications option, your installation may 
  1504. not support both options. Each communications option requires 
  1505. specific hardware components and proper NetWare preparation. 
  1506. Configure NMA for NetView to use the option you planned to use 
  1507. when you followed the instructions in Chapter 2. 
  1508.  
  1509. If you want to configure NMA for NetView to use the other 
  1510. communications option, review the instructions in Chapter 2 to 
  1511. see what changes may be required to support the other communications 
  1512. option.
  1513.  
  1514. 1.  After starting NVCONFIG, select Communications Options in 
  1515.     the Available Topics menu.  
  1516.     
  1517.     NVCONFIG displays the Communications Options menu, which 
  1518.     includes the following items:
  1519.  
  1520.     NetView Host
  1521.     NetView Collection Point
  1522.  
  1523.     The currently active option, either the NetView Host or
  1524.     NetView Collection Point, is marked by an asterisk.
  1525.  
  1526.  
  1527.  
  1528.  
  1529.                                                               3-2
  1530. 2.  Select the type of communications you want to configure.
  1531.  
  1532.     o  To configure for direct host communications, select 
  1533.        NetView Host. NVCONFIG displays the Token Ring Connection 
  1534.        to Host menu. See the following section, "Configuring for 
  1535.        Direct Host Communications" later in this chapter for more 
  1536.        information on configuring direct host connections.
  1537.  
  1538.     o  To configure for collection point server communications, 
  1539.        select NetView Collection Point. NVCONFIG displays the 
  1540.        Connection to Collection Point box. See "Configuring for 
  1541.        NetView Collection Point Communications" later in this  
  1542.        chapter for more information on configuring collection 
  1543.        point server connections.
  1544.  
  1545.  
  1546. Configuring for Direct Host Communications
  1547. ------------------------------------------
  1548.  
  1549. When using the direct host communications option, the NMA for
  1550. NetView server connects to the host through a token ring LAN.
  1551.  
  1552. To configure NMA for NetView for direct host communications, use
  1553. the following procedure:
  1554.  
  1555. 1.  Photocopy Table 3-1; then write down the configuration       
  1556.     parameters you want to use on the photocopy.
  1557.  
  1558.     IMPORTANT:  If you photocopied Table 3-1 as part of the      
  1559.     procedure for requesting a PU definition, continue to use the 
  1560.     photocopy you created. 
  1561.  
  1562.     Table 3-1 divides the configuration parameters into host    
  1563.     communication parameters and server and LAN configuration    
  1564.     parameters.
  1565.  
  1566.     1a.  Ask your host systems programmer for the values for the
  1567.          host communication parameters.
  1568.  
  1569.          You should get this information when you request a PU   
  1570.          definition for the server. Table 2-5 provides additional
  1571.          information that can help the host systems programmer   
  1572.          locate the host communication parameters for you.
  1573.     
  1574.     1b.  Define the server and LAN configuration parameters.
  1575.  
  1576.          Some of the server and LAN configuration parameters     
  1577.          control server operation; other parameters are labels
  1578.          that identify the server and LAN in messages exchanged
  1579.          with NetView.
  1580.  
  1581.          Descriptions for the configuration parameters appear under
  1582.          "Parameter Descriptions for the Token Ring to Host Form" 
  1583.          later in this chapter.
  1584.  
  1585.                                                               3-3
  1586.     Table 3-1
  1587.     Configuration Parameters for Direct Host Communications
  1588.     ---------------------------------------------------------------
  1589.     Host Communication                Status         Value
  1590.     Parameters
  1591.     ---------------------------------------------------------------
  1592.     Token Ring Destination            Required       ____________
  1593.     Node Address
  1594.  
  1595.     Token Destination Ring            Required       ____________
  1596.     Service Access Point (SAP)
  1597.  
  1598.     Block ID                          Required for   ____________
  1599.                                       937x and 37xx
  1600.                                       Attachments
  1601.  
  1602.     PUID for Token Ring               Required for   ____________
  1603.     Connection                        937x and 37xx
  1604.                                       Attachments
  1605.  
  1606.     ---------------------------------------------------------------
  1607.     Server and LAN                    Status         Value
  1608.     Communication Parameters
  1609.     ---------------------------------------------------------------
  1610.  
  1611.     Peripheral Node Control           Optional       ____________
  1612.     Point (PCNP) Name
  1613.  
  1614.     Token Ring Adapter Type           Required       ____________
  1615.  
  1616.     Logical Adapter Name              Required       ____________
  1617.  
  1618.     Token Ring Service Access         Required       ____________
  1619.     (SAP)
  1620.  
  1621.     Maximum Frame Size to             Required       ____________
  1622.     Transmit Inbound
  1623.     ---------------------------------------------------------------
  1624.  
  1625. 2.  If NVCONFIG is not running, start NVCONFIG as described under
  1626.     "Starting NVCONFIG" at the beginning of this chapter and select
  1627.     Communications Options.
  1628.  
  1629.     IMPORTANT:  Novell recommends that you unload NMA for NetView
  1630.     before starting NVCONFIG. Configuration changes do not take
  1631.     affect until the next time NMA for NetView is loaded.
  1632.  
  1633. 3.  When NVCONFIG displays the Communications Options menu, use the
  1634.     arrow keys to select NetView Host; then press <Enter>.
  1635.  
  1636.     The Token Ring Connection to Host configuration form
  1637.     appears, which includes the following items:
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.                                                               3-4
  1644.     Peripheral Node Control Point Name
  1645.     Token Ring Destination Node Address
  1646.     Token Ring Destination Service Access Point
  1647.     Token Ring Service Access Point
  1648.     Token Ring Adapter Type
  1649.     Block ID
  1650.     PUID for Token Ring Connection
  1651.     Maximum Frame Size to Transmit Inbound
  1652.     Logical Adapter Name
  1653.  
  1654. 4.  Edit the host communication parameters.
  1655.  
  1656.     Use the arrow keys to select a parameter, then press <Enter>
  1657.     to edit the parameter. For some parameters, NVCONFIG displays
  1658.     a cursor; for others it displays a menu. When NVCONFIG displays
  1659.     a cursor, use the keyboard keys to edit the current value. When
  1660.     NVCONFIG displays a menu, use the arrow keys to select the new
  1661.     value; then press <Enter>.
  1662.  
  1663.     See "Parameter Descriptions for the Token Ring Connection to
  1664.     Host Form," for more more information on each parameter.
  1665.  
  1666. 5.  When all host communication parameters are set, press <Esc> to
  1667.     exit the Token Ring Connection to Host form.
  1668.  
  1669.     If you changed any of the configuration options, the program
  1670.     displays a confirmation box that prompts you to save your    
  1671.     changes.
  1672.  
  1673. 6.  In the Save Changes confirmation box, use the arrow keys to
  1674.     select Yes; then press <Enter>.
  1675.  
  1676.     NVCONFIG configures NMA for NetView for direct host
  1677.     communications, saves the configuration parameters, and 
  1678.     displays a message that confirms that your changes were saved.
  1679.  
  1680. 7.  Press <Esc> to clear the confirmation message.
  1681.  
  1682. 8.  Press <Esc> again to exit the Communications Options menu and
  1683.     NVCONFIG.
  1684.  
  1685.     IMPORTANT:  Exit NVCONFIG before loading NMA for NetView.
  1686.  
  1687. The configuration process is now complete. For instructions on
  1688. loading NMA for NetView, see "Loading NMA for NetView" later in
  1689. this chapter.
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.                                                               3-5
  1696. Parameter Descriptions for
  1697. the Token Ring Connection to Host Form
  1698.  
  1699. The Token Ring Connections to Host form lists nine configuration 
  1700. parameters that you can adjust. Some of these parameters must be 
  1701. set before NMA for NetView can operate; other parameters are 
  1702. optional. The rest of this section describes the configuration 
  1703. parameters for direct host communications.
  1704.  
  1705. o  Block ID.  The block ID must be set to match the corresponding
  1706.    value at the host. This hexadecimal number identifies the 
  1707.    device type of the remote communication equipment.
  1708.  
  1709.    The number entered in this field must be three digits long.  
  1710.    To specify a value less than three digits, supply leading 
  1711.    zeros.
  1712.  
  1713.    -  When the NMA for Netview server communicates with the host 
  1714.       through a 937x or 37xx attachment, the Block ID parameter 
  1715.       must match the value that follows the IDBLK= statement in 
  1716.       the switched PU definition. 
  1717.       
  1718.    -  When the server communicates through a 3174 controller, the 
  1719.       Block ID parameter is ignored; therefore, no entry is 
  1720.       required.
  1721.  
  1722. o  Logical Adapter Name.  Set this parameter to match the adapter
  1723.    that is entered into the AUTOEXEC.NCF file.  This name must 
  1724.    match the AUTOEXEC.NCF file's adapter name.  The logical 
  1725.    adapter name can be up to 16 alphanumeric and/or special 
  1726.    characters.
  1727.  
  1728. o  Maximum Frame Size to Transmit Inbound.  This parameter sets 
  1729.    the frame size for transmissions from NMA for NetView to the 
  1730.    host. Press <Enter> to display a window with the following 
  1731.    items:
  1732.  
  1733.    265
  1734.    521
  1735.    1033
  1736.    2042
  1737.    4015
  1738.  
  1739.    When configuring NMA for NetView, be sure to set the Maximum 
  1740.    Frame Size to Transmit Inbound parameter to 521 or larger. If 
  1741.    this parameter is set to a smaller size, the NetView host 
  1742.    operator may not receive replies to commands.
  1743.    
  1744.    IMPORTANT:  When NMA for NetView is configured for collection 
  1745.    point communications and the NetView operator reports lost 
  1746.    command replies, check the setting of the Maximum Frame Size 
  1747.    to Transmit Inbound parameter on the collection point server. 
  1748.    The collection point server's Maximum Frame Size to Transmit 
  1749.    Inbound parameter controls NetView communications for the 
  1750.    NMA for NetView server.
  1751.  
  1752.                                                               3-6
  1753.    IMPORTANT:  If you change the maximum frame size to transmit
  1754.    inbound to 2042 bytes, you must configure your system to
  1755.    accommodate this setting. Do so by modifying the event control
  1756.    block (ECB) size in your system's STARTUP.NCF file as follows:
  1757.  
  1758.    Set maximum physical receive packet size = 2298
  1759.  
  1760. o  Peripheral Node Control Point Name.  The peripheral node 
  1761.    control point (PCNP) name is an optional entry.  In Systems 
  1762.    Network Architecture (SNA) terms, the NetWare server is 
  1763.    connected to the host as a peripheral node.  A peripheral 
  1764.    node contains a software entity called a control point, which 
  1765.    controls the resources of the SNA peripheral node.
  1766.  
  1767.    If you enter a PNCP name, NMA for NetView sends the PNCP 
  1768.    name to NetView in each alert.  If you you do not enter a 
  1769.    PNCP name, NMA for NetView sends the default value, CPNAME.
  1770.  
  1771. o  PUID for Token Ring Connection.  The PU ID must be set to 
  1772.    match the corresponding PU ID at the host.
  1773.  
  1774.    -  When the NMA for Netview server communicates with the 
  1775.       host through a 937x or 37xx attachment, the PUID 
  1776.       parameter must match the value that follows the IDNUM= 
  1777.       statement in the switched PU definition.  
  1778.    
  1779.    -  When the server communicates through a 3174 controller, 
  1780.       the PUID parameter is ignored; therefore, no entry is 
  1781.       required.
  1782.  
  1783. o  Token Ring Adapter Type.  In this field, specify the type 
  1784.    of adapter your server is using for the host connection.  
  1785.    Press <Enter> to display your two choices:
  1786.  
  1787.    Primary
  1788.    Alternate
  1789.  
  1790.    -  Select Primary if the token ring adapter type switch (on 
  1791.       the adapter) has been set to PRIMARY. 
  1792.       
  1793.    -  Select Alternate if the adapter type switch has been set 
  1794.       to ALTERNATE. (Refer to the token ring adapter manual for 
  1795.       information on switch settings.)
  1796.  
  1797.                                                               3-7
  1798. o  Token Ring Destination Node Address.  The token ring address 
  1799.    must be set to match the address of the host's token ring 
  1800.    connection. Table 3-1 lists the host communication parameters 
  1801.    that your host systems programmer should provide. Table 2-5 
  1802.    in Chapter 2 provides additional information that the host 
  1803.    systems programmer can use to locate the correct values.
  1804.  
  1805.  
  1806. o  Token Ring Destination Service Access Point.  This is the
  1807.    two-digit SAP number for the host.
  1808.  
  1809.    Set this parameter to match the SAP ID of the host's token 
  1810.    ring connection.  Table 3-1 lists the communication parameters 
  1811.    that your host systems programmer should provide.  Table 2-5 
  1812.    in Chapter 2 provides additional information that the host 
  1813.    systems programmer can use to locate the correct value.
  1814.  
  1815.  
  1816. o  Token Ring Service Access Point.  This is the two-digit SAP
  1817.    number for the server.
  1818.  
  1819.    Set this parameter to match the SAP ID of the host's token 
  1820.    ring connection. Table 3-1 lists the communication parameters 
  1821.    that your host systems programmer should provide. Table 2-5 
  1822.    in Chapter 2 provides additional information that the host 
  1823.    systems programmer can use to locate the correct value.
  1824.  
  1825.  
  1826. Configuring for NetView Collection Point Communications
  1827. -------------------------------------------------------
  1828.  
  1829. When configured for collection point communications, NMA for
  1830. NetView indirectly connects to the host computer through a NetWare
  1831. for SAA server. In this system configuration, the NetWare for SAA
  1832. server is called a collection point server.
  1833.  
  1834. IMPORTANT:  When NMA for NetView is configured for collection point
  1835. communications and the NetView operator reports lost command
  1836. replies, check the setting of the Maximum Frame Size to Transmit
  1837. Inbound parameter on the collection point server. The collection
  1838. point server's Maximum Frame Size to Transmit Inbound parameter
  1839. controls NetView communications for the NMA for NetView server.
  1840.  
  1841. When NMA for NetView is configured for collection point server
  1842. communications, the collection point server provides the
  1843. following information in all forwarded messages:
  1844.  
  1845. o  The PCNP name assigned to the collection point server
  1846.  
  1847. o  The model number of the collection point server
  1848.  
  1849. o  The serial number of the collection point server
  1850.  
  1851.  
  1852.                   
  1853.                                                               3-8
  1854. For information on setting these parameters within NetWare for SAA,
  1855. see the NetWare for SAA 1.3 Rev. B Administration Guide.
  1856.  
  1857. To configure NMA for NetView for NetView collection point
  1858. communications, use the following procedure:
  1859.  
  1860. 1.  If NVCONFIG is not running, start NVCONFIG as described in
  1861.     "Starting NVCONFIG" at the beginning of this chapter and
  1862.     select Communications Options.
  1863.  
  1864.     IMPORTANT:  Novell recommends that you unload NMA for NetView
  1865.     before starting NVCONFIG. Configuration changes do not take
  1866.     affect until the next time NMA for NetView is loaded.
  1867.  
  1868. 2.  When NVCONFIG displays the Communications Options menu, use the
  1869.     arrow keys to select NetView Collection Point; then press
  1870.     <Enter>.
  1871.  
  1872.     NVCONFIG displays the Connection to Collection Point dialog
  1873.     box, which prompts you to enter the collection point server
  1874.     name.
  1875.  
  1876. 3.  Enter the collection point server name.
  1877.  
  1878.     The value you enter must match the server name that was
  1879.     entered when the collection point server was started. The
  1880.     collection point server you name must be running NetWare for
  1881.     SAA v1.3 or later and must be configured to support NetView
  1882.     collection point communications.
  1883.  
  1884.     IMPORTANT:  When changing the configuration from direct host
  1885.     communications to collection point server communications, you
  1886.     must edit the collection point server name. If you do not edit
  1887.     the name, NVCONFIG does not prompt you to save the
  1888.     configuration and NMA remains configured for direct host
  1889.     communications.
  1890.  
  1891. 4.  Press <Esc> to exit the Connection to Collection Point
  1892.     dialog box.
  1893.  
  1894.     If you changed any of the configuration options, the program
  1895.     displays a confirmation box that prompts you to save your
  1896.     changes.  If you do not want to save changes to the
  1897.     configuration, select No, and press <Enter>.
  1898.  
  1899. 5.  In the Save Changes confirmation box, use the arrow keys to
  1900.     select Yes; then press <Enter>.
  1901.  
  1902.     NVCONFIG configures NMA for NetView for collection point server
  1903.     communications, saves the collection point server name, and  
  1904.     displays a message that confirms that your changes are saved.
  1905.  
  1906. 6.  Press <Esc> to clear the confirmation message.
  1907.  
  1908.  
  1909.                                                               3-9
  1910. 7.  Press <Esc> again to exit the Configuration Options menu and
  1911.     NVCONFIG.
  1912.  
  1913. The configuration process is now complete; NMA for NetView is ready
  1914. for loading.
  1915.  
  1916. IMPORTANT:  You must exit NVCONFIG before loading NMA for NetView.
  1917.  
  1918. For instructions on loading NMA for NetView, see "Loading NMA for
  1919. NetView" later in this chapter. Instructions for automating the
  1920. startup procedure appear under "Preparing the NetWare Server" in
  1921. Chapter 2.
  1922.  
  1923.  
  1924. ENABLING AND DISABLING FEATURES
  1925.  
  1926. You can use the NetView Management menu to enable or disable 
  1927. the NMA for NetView Alert forwarding, RUNCMD processing, or 
  1928. RUNCMD Security features.
  1929.  
  1930. 1.  Select the NetView Management option in the Available Topics 
  1931.     menu.
  1932.  
  1933.     NVCONFIG displays the NetView Management menu, which includes
  1934.     the following items: 
  1935.     
  1936.     Generate Alerts         Yes/No
  1937.     Process RunCmds         Yes/No
  1938.     NetView Security        Yes/No
  1939.  
  1940. 2.  Select an option (Generate Alerts, Process Rumds, or NetView 
  1941.     Security); then type Y to enable the option or N to disable 
  1942.     the option.
  1943.  
  1944.     Use these options as follows:
  1945.  
  1946.     o  Generate Alerts: Use this option to enable or disable the 
  1947.        generation of NetView alerts by this server.
  1948.  
  1949.     o  Process RunCmds: Use this option to enable or disable 
  1950.        processing of NetView RUNCMDs addressed to this server.
  1951.  
  1952.     o  NetView Security: Use this option to control RUNCMD 
  1953.        processing by the server when the Process RunCmds option 
  1954.        is enabled. If the NetView Security option is enabled, 
  1955.        all NetView RUNCMDs must contain a valid NetWare server 
  1956.        user ID with appropriate privileges:
  1957.  
  1958.        -  Supervisor-equivalent privileges or server console 
  1959.           operator status on a NetWare v3.1x server 
  1960.  
  1961.        -  Security equivalence to the file server object or server 
  1962.           console operator status on a NetWare 4.x server 
  1963.  
  1964.  
  1965.                                                               3-10
  1966.        The SUPERVISOR user ID is not valid. If a command does 
  1967.        not contain a valid server user ID, the command is not 
  1968.        processed and a message is returned to NetView.
  1969.  
  1970.        If the NetView Security option is disabled, the server 
  1971.        processes all NetView RUNCMDs addressed to the server and 
  1972.        ignores any user ID included within RUNCMDs.
  1973.  
  1974.  
  1975. LOADING NMA FOR NETVIEW
  1976.  
  1977. The process of starting the NMA for NetView software is called
  1978. loading. Before loading NMA for NetView, you must install and
  1979. configure NMA for NetView. Chapter 2 describes how to install NMA
  1980. for NetView; configuration instructions appear under "Configuring
  1981. NMA for NetView" earlier in this chapter.
  1982.  
  1983. IMPORTANT:  Every time you load NMA for NetView, you must first
  1984. execute a series of commands. These commands are identified in
  1985. "Preparing the NetWare Server," in Chapter 2.
  1986.  
  1987. To load NMA for NetView, enter the following command:
  1988.  
  1989. :load nmanv
  1990.  
  1991. IMPORTANT:  Novell recommends that you automate the loading process
  1992. for NMA for NetView by loading the software from the AUTOEXEC.NCF
  1993. file. For more information on the AUTOEXEC.NCF file, see
  1994. "Preparing the NetWare Server" in Chapter 2.
  1995.  
  1996.  
  1997. UNLOADING NMA FOR NETVIEW
  1998.  
  1999. Unload NMA for NetView when you want to
  2000.  
  2001. o  Change the configuration of NMA for NetView 
  2002.  
  2003. o  Remove the NMA for NetView software
  2004.  
  2005. To unload NMA for NetView from the NetWare server, enter the
  2006. following command:
  2007.  
  2008. :nvdown
  2009.  
  2010. NetWare displays a message informing you that NMANV.NLM has been
  2011. unloaded.
  2012.  
  2013.                                                               3-11
  2014. ADMINISTERING NMA FOR NETVIEW REMOTELY
  2015.  
  2016. You can set up the server with NMA for NetView installed to
  2017. support the NetWare RCONSOLE utility.  With RCONSOLE you can
  2018. load, unload, and configure NMA for NetView remotely from a
  2019. workstation as follows:
  2020.  
  2021. 1.  Make sure that the REMOTE and RSPX NLMs are loaded on the
  2022.     server installed with NMA for NetView.
  2023.  
  2024. 2.  From your network workstation, log in as SUPERVISOR to the
  2025.     directory on the local network server containing the remote
  2026.     network files (usually SYS:SYSTEM).
  2027.  
  2028. 3.  Start the RCONSOLE utility, and select the server installed
  2029.     with NMA for NetView.
  2030.  
  2031. 4.  When the system console prompt appears on your workstation
  2032.     screen, load or unload NMA for NetView or start NVCONFIG as
  2033.     if you were sitting at the server console.
  2034.  
  2035. See the information on RCONSOLE in the NetWare v3.1x System
  2036. Administration Guide or the NetWare 4.x manual, Supervising
  2037. the Network for more information on running RCONSOLE.
  2038.  
  2039.  
  2040. CONFIGURING ALERT FLOW CONTROL 
  2041.  
  2042. On NMA for NetView servers configured for direct host connections, 
  2043. you can configure NMA for NetView to limit the number of alerts 
  2044. that it and downstream workstations forward to the NetView host 
  2045. over a specified period of time.
  2046.  
  2047. How Alert Flow Control Works
  2048. ----------------------------
  2049.  
  2050. If the number of NetView alerts generated by or forwarded to the 
  2051. NMA for NetView server over a specified number of minutes exceeds 
  2052. its high-water mark, NMA for NetView stops forwarding alerts to 
  2053. the NetView host. NMA for NetView then sends one of the following 
  2054. alerts to the NetView host:
  2055.  
  2056.   File Server Error Limit Reached: Server Configuration
  2057.  
  2058. or
  2059.  
  2060.   Configurable Capacity Limit Reached: Server configuration 
  2061.  
  2062. Once the number of alerts reaches or drops below a low-water mark 
  2063. during the specified number of minutes, NMA for NetView resumes 
  2064. alert forwarding to the NetView host.
  2065.  
  2066. IMPORTANT: NMA for NetView supports alert flow control only from 
  2067. NMA for NetView servers with direct host connections. It does not 
  2068. support alert flow control from end point servers.
  2069.                                                               3-12
  2070. Editing the NVCMDS.DB File for Alert Flow Control
  2071. -------------------------------------------------
  2072.  
  2073. To implement alert flow control, locate and edit the NVCMDS.DB 
  2074. ASCII file on the NMA for NetView server. Insert configuration 
  2075. parameters that control the flow of alerts to the NetView host 
  2076. from an NMA for NetView server configured for direct host 
  2077. communications. 
  2078.  
  2079. 1.  Locate the NVCMDS.DB file.
  2080.  
  2081.     If you have not already copied NVCMDS.DB to the 
  2082.     SYS:\SYSTEM\COMMEXEC directory on the server running 
  2083.     NMA for NetView, you will find it on the NMA for NetView 1.3B, 
  2084.     Disk 3 diskette in the DATABASE directory.
  2085.  
  2086. 2.  Using a text editor, open the NVCMDS.DB file on the NMA for 
  2087.     NetView server.
  2088.  
  2089.     Make sure the text editor is configured not to insert 
  2090.     formatting or other non-ASCII characters.
  2091.  
  2092. 3.  Insert the following lines:
  2093.  
  2094.       @CONFIG ALERT THRESHOLDINTERVAL <minutes>
  2095.       @CONFIG ALERT HIGHWATERMARK <hwalerts> 
  2096.       @CONFIG ALERT LOWWATERMARK <lwalerts> 
  2097.  
  2098.     Replace <minutes> with a specified period of time, in minutes, 
  2099.     that you want the number of NetView alerts to be measured over. 
  2100.     The default value is 100. 
  2101.  
  2102.     Replace <hwalerts> with the maximum number of NetView alerts 
  2103.     allowed in the THRESHOLDINTERVAL time period. If this number 
  2104.     is exceeded, NMA for NetView stops forwarding alerts to the 
  2105.     NetView host. The default value is 1000. 
  2106.  
  2107.     Replace <lwalerts> with the number of alerts at which to 
  2108.     resume alert forwarding to the NetView console. NMA for 
  2109.     NetView will resume forwarding alerts once the number of 
  2110.     alerts in the period of time specified by THRESHOLDINTERVAL 
  2111.     drops to or below this number. The default value is 100. 
  2112.  
  2113.     NOTE: The NVCMDS.DB file may contain both RUNCMD-filtering 
  2114.     statements (described in Appendix B, "Using NetView RUNCMD 
  2115.     Filtering") and NetView support configuration parameters. 
  2116.     The RUNCMD-filtering statements and configuration parameters 
  2117.     need not appear in any special order.
  2118.  
  2119. 4.  Copy NVCMDS.DB to the SYS:\SYSTEM\COMMEXEC directory.
  2120.  
  2121.     After you finish your edit, make sure your edited NVCMDS.DB 
  2122.     file is located in the SYS:\SYSTEM\COMMEXEC directory of the 
  2123.     NMA for NetView server you want to configure.
  2124.  
  2125. 5.  Restart NMA for NetView.
  2126.                                                               3-13
  2127. Example
  2128.  
  2129. The following lines were inserted into NVCMDS.DB on an NMA for 
  2130. NetView server configured for direct host communications to stop 
  2131. forwarding alerts to the NetView host if it generates or receives 
  2132. more than 500 alerts per five-minute interval. NMA for NetView 
  2133. will not resume forwarding alerts to the NetView host until the 
  2134. rate of incoming and generated alerts drops to or below 50 per 
  2135. five-minute interval.
  2136.  
  2137.   @CONFIG ALERT THRESHOLDINTERVAL 5 
  2138.   @CONFIG ALERT HIGHWATERMARK 500 
  2139.   @CONFIG ALERT LOWWATERMARK 50
  2140.  
  2141. NOTE: This solution limits the flow of NetView alerts from any 
  2142. specific NetWare server with direct host connection, and from all 
  2143. end point servers. However, this solution does not limit the 
  2144. collective flow of NetView alerts from all NetWare servers, since 
  2145. each server independently detects and reports LAN errors (such 
  2146. as token ring beaconing). You can use other methods to limit the 
  2147. collective flow. For example, in the case of token ring beaconing, 
  2148. you can use Novell's token ring drivers to minimize problems 
  2149. because these drivers do not report duplicate alerts to network 
  2150. management modules.
  2151.  
  2152.  
  2153. CHECKING FOR FAILED LOAD OR UNLOAD RUNCMDS
  2154.  
  2155. If you send a LOAD NLM or UNLOAD NLM RUNCMD from the NetView 
  2156. console, and the RUNCMD fails, NMA for NetView does not return a 
  2157. failure message to NetView.
  2158.  
  2159. Instead, NMA for NetView generates an NMA Load Module screen at 
  2160. the NMA for NetView server and displays either an error message 
  2161. or a prompt for missing parameters.
  2162.  
  2163. o  If, for example, you issue a LOAD NLM RUNCMD with an incomplete 
  2164.    set of parameters from the NetView console, NMA for NetView 
  2165.    does not execute your LOAD command. Instead it generates the 
  2166.    NMA Load Module screen at the NMA for NetView server with a 
  2167.    prompt for the missing parameters.
  2168.  
  2169. o  If you issue an UNLOAD NLM RUNCMD that fails because other 
  2170.    NLMs may have to be unloaded before it, NMA for NetView 
  2171.    generates the NMA Load Module screen with an error message.
  2172.  
  2173. If you suspect a LOAD NLM or UNLOAD NLM RUNCMD failed, do the 
  2174. following:
  2175.  
  2176. 1.  Go the the NMA for NetView server and press <Ctrl+Esc> to 
  2177.     list the available control screens. 
  2178.  
  2179.     If a LOAD or UNLOAD NLM RUNCMD issued from the NetView 
  2180.     console has failed, you will see an option for the 
  2181.     NMA Load Module screen. 
  2182.  
  2183.                                                               3-14
  2184. 2.  Select the NMA Load Module option to see the error message 
  2185.     or prompt.
  2186.  
  2187.     NOTE: The NMA Load Module screen is present on the server 
  2188.     only if the LOAD or UNLOAD RUNCMD has failed.
  2189.  
  2190.  
  2191. REMOVING THE NMA FOR NETVIEW SOFTWARE
  2192.  
  2193. To remove NMA for NetView v1.3 or later, use the NetWare INSTALL 
  2194. utility.  When removing the software, the NetWare INSTALL utility 
  2195. deletes the NMA for NetView files from the server's SYS:SYSTEM 
  2196. directory and deletes entries from the internal NetWare bindery.
  2197.  
  2198. IMPORTANT:  To remove a previous version of NMA for NetView,
  2199. follow the removal directions that came with that version.  Do
  2200. not use the NetWare INSTALL utility to remove versions of NMA for
  2201. NetView previous to v1.3.
  2202.  
  2203.  
  2204. 1.  Start the NetWare INSTALL utility. By entering
  2205.  
  2206.     :load install
  2207.  
  2208. 2.  Select Product Options from the Installation Options menu.
  2209.  
  2210. 3.  Use the arrow keys to select NMA for NetView from the 
  2211.     Currently Installed Products listing.
  2212.  
  2213. 4.  Press <Delete>.
  2214.  
  2215. 5.  When the Uninstall NMANV prompt appears, select Yes to confirm
  2216.     the removal of NMA for NetView.
  2217.  
  2218.  
  2219.  
  2220.                                                               3-15
  2221.  
  2222.           APPENDIX A  Installing Code Points for NetWare
  2223.  
  2224.  
  2225. The code points allow NetView to display additional information
  2226. about alerts that are received from NMA for NetView. This appendix
  2227. describes
  2228.  
  2229. o  How to determine whether you need to install NetView code points
  2230.  
  2231. o  An overview of the installation procedure
  2232.  
  2233. o  How to install NetView code points on a Virtual Machine (VM)  
  2234.    system
  2235.  
  2236. o  How to install NetView code points on an Multiple Virtual
  2237.    Storage (MVS) system
  2238.  
  2239.  
  2240. DO YOU NEED TO INSTALL?
  2241.  
  2242. Beginning with NetView v2.1, all versions of NetView contain all
  2243. the code points required to display NetWare alerts. Contact a
  2244. NetView operator or your systems programmer and ask for the version
  2245. number of NetView. If the host is running NetView v2.1 or later,
  2246. you do not need to install code points.
  2247.  
  2248. If the host is running an older version of NetView (before v2.1),
  2249. you might need to install additional code points as described later
  2250. in this appendix. You do not need to install the code points if the
  2251. code points for NMA for NetView v1.2 or NetWare for SAA v1.2 are
  2252. already installed on the NetView host. Once the code points are
  2253. installed for one NetWare for SAA v1.2-and-later server, the
  2254. installed code points support all NetWare for SAA v1.2-and-later
  2255. servers.
  2256.  
  2257.  
  2258. INSTALLATION OVERVIEW
  2259.  
  2260. This section provides a general overview of the installation
  2261. process. Detailed procedures for the VM and MVS host systems appear
  2262. later in this appendix.
  2263.  
  2264. The installation procedure in this chapter requires the following
  2265. hardware and software components:
  2266.  
  2267. o  NetView software installed at the NetView host.
  2268.  
  2269. o  NetWare for SAA or an equivalent product that enables
  2270.    communications and file transfers between a LAN workstation
  2271.    PC and the host computer installed and loaded on the server.
  2272.  
  2273. o  3270 terminal emulation software with file transfer capabilities
  2274.    installed on a LAN workstation (such as, the NetWare 3270 LAN
  2275.    Workstation for DOS by Attachmate).
  2276.    
  2277.                                                               A-1
  2278. o  A cabling connection between NetWare for SAA and the NetView
  2279.    host.
  2280.  
  2281. o  A cabling connection between NetWare for SAA and the PC that is
  2282.    running the 3270 terminal emulation software.
  2283.  
  2284. To install the code point messages, you must perform the following
  2285. tasks:
  2286.  
  2287. o  Task 1. Prepare to transfer files to the host:
  2288.  
  2289.    -  Install NetWare for SAA (or a product with similar features)
  2290.       so that you can access the host from a workstation on the
  2291.       NetWare LAN.
  2292.  
  2293.    -  Using 3270 terminal emulation software with file transfer
  2294.       capabilities, establish a host session from the LAN workstation
  2295.       and access the NetView RUN disk.
  2296.  
  2297. o  Task 2. Install the code point messages:
  2298.  
  2299.     -  Using the 3270 terminal emulation software on the LAN 
  2300.        Workstation, transfer the code point files from the 
  2301.        NMA for NetView 1.3B, Disk 3 diskette to the NetView 
  2302.        RUN disk.
  2303.  
  2304.     -  Using the NetWare 3270 emulation software on a LAN 
  2305.        workstation, compile the code point files.
  2306.  
  2307.     -  Using a NetView console or NetView on the LAN workstation
  2308.        running the 3270 emulation software, edit the NetView 
  2309.        startup command file.
  2310.  
  2311.     -  Using a NetView console or NetView on the LAN workstation
  2312.        running the 3270 emulation software, restart NetView and 
  2313.        set the NetView recording and viewing filters.
  2314.  
  2315. Detailed instructions for these tasks appear in the following
  2316. sections.
  2317.  
  2318.  
  2319. PREPARING FOR FILE TRANSFER (VM AND MVS INSTALLATIONS)
  2320.  
  2321. To prepare for transferring code point files to the host, follow
  2322. these steps:
  2323.  
  2324. 1.  Install NetWare for SAA (or a product with similar features)
  2325.     in a NetWare server so that you can access the host from a 
  2326.     workstation on the NetWare LAN.
  2327.  
  2328. 2.  Locate the code point files on NMA for NetView 1.3B, 
  2329.     Disk 3.
  2330.  
  2331.     The files that you need are located in the CP directory on
  2332.     this diskette.  Instructions for creating this diskette appear
  2333.     under "Preparing the Installation Diskettes" in Chapter 2.
  2334.  
  2335.                                                               A-2
  2336. 3.  On a LAN workstation, start up a 3270 emulation package
  2337.     with file transfer software capabilities.
  2338.  
  2339. 4.  Establish a host session on the workstation.
  2340.  
  2341.     You must use a workstation with a 3.5-inch floppy diskette
  2342.     drive.  To establish the host session, you can use NetWare
  2343.     for SAA on the server and 3270 terminal emulation software 
  2344.     with file transfer capability on the workstation
  2345.  
  2346.     For additional information on using your 3270 terminal 
  2347.     emulation software and on transferring files, consult
  2348.     the documentation for the products you are using.
  2349.  
  2350.  
  2351. INSTALLING NETVIEW CODE POINTS IN VM SYSTEMS
  2352.  
  2353. Before starting the procedures in this section, complete the
  2354. procedures in the preceding section, "Preparing for File Transfer
  2355. (VM and MVS Installations)."
  2356.  
  2357. IMPORTANT:  The following procedure is based on recommendations in
  2358. the NetView Customization Guide (IBM publication SC31-6016). Novell
  2359. recommends that you review the information on creating user-defined
  2360. generic code points before attempting to install the code points. 
  2361.  
  2362. To continue installing the NetView code points, complete the
  2363. following steps:
  2364.  
  2365. 1.  While running a host session from a LAN workstation running 
  2366.     3270 terminal emulation software, log on to MAINT.
  2367.     
  2368.     If you do not know how to log on to MAINT, contact your host
  2369.     systems programmer.
  2370.  
  2371. 2.  Access the NetView RUN disk by entering the following command:
  2372.  
  2373.       ACCESS 334 A
  2374.  
  2375. 3.  Using file transfer software on the workstation, transfer 
  2376.     the code point files to the NetView RUN disk.
  2377.     
  2378.     When transferring the files, use the ASCII, CRLF, and fixed
  2379.     record format options. If you are using the SEND.EXE program,
  2380.     for example, enter the following at the DOS prompt (>):
  2381.  
  2382.       SEND BNJ81UTB.NCC BNJ81UTB NCCFLST A (ASCII CRLF RECFM F
  2383.  
  2384.       SEND BNJ82UTB.NCC BNJ82UTB NCCFLST A (ASCII CRLF RECFM F 
  2385.  
  2386.       SEND BNJ92UTB.NCC BNJ92UTB NCCFLST A (ASCII CRLF RECFM F
  2387.  
  2388.       SEND BNJ93UTB.NCC BNJ93UTB NCCFLST A (ASCII CRLF RECFM F
  2389.                                                               A-3
  2390.       SEND BNJ94UTB.NCC BNJ94UTB NCCFLST A (ASCII CRLF RECFM F
  2391.  
  2392.       SEND BNJ95UTB.NCC BNJ95UTB NCCFLST A (ASCII CRLF RECFM F
  2393.  
  2394.       SEND BNJ96UTB.NCC BNJ96UTB NCCFLST A (ASCII CRLF RECFM F
  2395.  
  2396. 4.  While running a host session from the workstation under
  2397.     3270 emulation, compile the transferred files on the host 
  2398.     by entering
  2399.  
  2400.      CNMSVM07 NUMBER=81 NETLNK=NOVELL
  2401.  
  2402.      CNMSVM07 NUMBER=82 NETLNK=NOVELL
  2403.  
  2404.      CNMSVM07 NUMBER=92 NETLNK=NOVELL
  2405.  
  2406.      CNMSVM07 NUMBER=93 NETLNK=NOVELL
  2407.  
  2408.      CNMSVM07 NUMBER=94 NETLNK=NOVELL
  2409.  
  2410.      CNMSVM07 NUMBER=95 NETLNK=NOVELL
  2411.  
  2412.      CNMSVM07 NUMBER=96 NETLNK=NOVELL
  2413.  
  2414. 5.  While running a host session from the workstation under 3270 
  2415.     emulation, open the NetView startup command file for editing 
  2416.     by entering the following command:
  2417.  
  2418.      XEDIT NETSTRT GCS 
  2419.  
  2420. 6.  Within the NetView startup file, locate the GLOBAL command
  2421.     and insert the word NOVELL immediately after the word LOADLIB.
  2422.  
  2423.     This step includes the Novell library in the list of NetView
  2424.     libraries that are loaded at startup. The modified GLOBAL
  2425.     command will look like the following:
  2426.  
  2427.     `GLOBAL LOADLIB NOVELL PROPMX USER NCCF STATMON NLDM NPDA' 
  2428.  
  2429. 7.  Log on to a NetView console and shut down NetView by entering
  2430.     the following NetView command:
  2431.  
  2432.      CLOSE IMMED
  2433.  
  2434.     WARNING:  This command brings down NetView.  To avoid
  2435.     untimely interruption of NetView services, consider
  2436.     performing this step during a scheduled maintenance period.
  2437.  
  2438. 8.  When NetView has completed shutdown, log on to the NetView
  2439.     virtual machine.  Then start up NetView by entering the
  2440.     following VM command:
  2441.  
  2442.      CP IPL GCS
  2443.  
  2444.  
  2445.  
  2446.                                                               A-4
  2447. 9.  While NetView is starting up, check the startup messages to
  2448.     make sure that they include
  2449.  
  2450.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ92UTB IS AVAILABLE 
  2451.  
  2452.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ93UTB IS AVAILABLE 
  2453.  
  2454.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ94UTB IS AVAILABLE 
  2455.  
  2456.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ95UTB IS AVAILABLE 
  2457.  
  2458.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ96UTB IS AVAILABLE 
  2459.  
  2460.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ81UTB IS AVAILABLE 
  2461.  
  2462.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ82UTB IS AVAILABLE 
  2463.  
  2464.     The preceding messages indicate that the code point files for
  2465.     NetWare are available. If these messages are directed to
  2466.     another console, they will not appear.
  2467.  
  2468. 10. Disconnect from the NetView virtual machine by entering the
  2469.     following command:
  2470.  
  2471.      #CP DISC 
  2472.  
  2473. 11. Log on to NetView. When NetView main menu appears, select NPDA
  2474.     (Network Problem Determination Application) by entering
  2475.  
  2476.      NPDA
  2477.  
  2478. 12. From the NetView NPDA prompt, set the NetView recording and
  2479.     viewing filters by entering the following NetView commands:
  2480.  
  2481.      srf arec pass e paff
  2482.      srf arec pass e temp
  2483.      srf arec pass e impd
  2484.      svf pass e paff
  2485.      svf pass e temp
  2486.      svf pass e impd
  2487.  
  2488.     NOTE:  To display NetWare messages, the recording and viewing
  2489.     filters must be set each time NetView is started. To simplify
  2490.     NetView startup, enter these commands in a CLIST file.
  2491.  
  2492.  
  2493. INSTALLING NETVIEW CODE POINTS IN MVS SYSTEMS
  2494.  
  2495. Before starting the procedures in this section, complete the
  2496. procedures in "Preparing for File Transfer (VM and MVS
  2497. Installations)" earlier in this appendix.
  2498.  
  2499. IMPORTANT:  The following procedure is based on recommendations in
  2500. the NetView Customization Guide (IBM publication SC31-6016). Novell
  2501. recommends that you review the information on creating user-defined
  2502. generic code points before attempting to install the code points. 
  2503.  
  2504.                                                               A-5
  2505. To continue installing the NetView code points, follow these steps:
  2506.  
  2507. 1.  While running a host session from the workstation running 
  2508.     3270 terminal emulation software, log on with a Time Sharing
  2509.     Option (TSO) user ID that has sufficient access rights to 
  2510.     create or update a system data set such as SYS1.xxxx.
  2511.  
  2512. 2.  Using this 3270 terminal emulation host session and the
  2513.     Interactive System Productivity Facility (ISPF), allocate a
  2514.     partitioned data set (PDS) to contain the code point files.
  2515.  
  2516.     Give the data set a name like SYS2.NTVW.CODE.POINTS. Make sure
  2517.     to set the allocation parameters to the following values: 
  2518.  
  2519.     o  LRECL = 80 
  2520.  
  2521.     o  RECFM = FB 
  2522.  
  2523.     o  Directory blocks should be 5 
  2524.  
  2525.     o  Primary allocation should be at least one cylinder--or the
  2526.        equivalent in fixed-block architecture (FBA) blocks
  2527.  
  2528.     o  Secondary allocation should be at least one cylinder or the
  2529.        equivalent in FBA blocks
  2530.  
  2531. 3.  Exit ISPF by entering
  2532.  
  2533.      =X 
  2534.  
  2535. 4.  Using the file transfer software on the workstation running  
  2536.     3270 terminal emulation software, transfer the INSTALL.JCL 
  2537.     file and the code point files to the host.
  2538.  
  2539.     When transferring the files, use the ASCII and CRLF options.
  2540.     If you are using the SEND.EXE program, for example, enter
  2541.     the following at the DOS prompt (>):
  2542.  
  2543.      SEND BNJ92UTB.NCC 
  2544.       'SYS2.NTVW.CODE.POINTS(BNJ92UTB)'
  2545.        ASCII CRLF 
  2546.  
  2547.      SEND BNJ93UTB.NCC 
  2548.       'SYS2.NTVW.CODE.POINTS(BNJ93UTB)'
  2549.        ASCII CRLF 
  2550.  
  2551.      SEND BNJ94UTB.NCC 
  2552.       'SYS2.NTVW.CODE.POINTS(BNJ94UTB)'
  2553.        ASCII CRLF 
  2554.  
  2555.      SEND BNJ95UTB.NCC 
  2556.       'SYS2.NTVW.CODE.POINTS(BNJ95UTB)'
  2557.        ASCII CRLF 
  2558.  
  2559.      SEND BNJ96UTB.NCC 
  2560.       'SYS2.NTVW.CODE.POINTS(BNJ96UTB)'
  2561.        ASCII CRLF 
  2562.                                                               A-6
  2563.      SEND BNJ81UTB.NCC 
  2564.       'SYS2.NTVW.CODE.POINTS(BNJ81UTB)'
  2565.        ASCII CRLF 
  2566.  
  2567.      SEND BNJ82UTB.NCC 
  2568.       'SYS2.NTVW.CODE.POINTS(BNJ82UTB)'
  2569.        ASCII CRLF 
  2570.  
  2571.      SEND INSTALL.JCL 
  2572.       'SYS2.NTVW.CODE.POINTS(INSTALL)'
  2573.        ASCII CRLF 
  2574.  
  2575. 5.  From a host terminal or a NetWare 3270 LAN Workstation host
  2576.     session and the ISPF editor, open the member
  2577.  
  2578.     'SYS2.NTVW.CODE.POINTS(INSTALL)'
  2579.  
  2580. 6.  Follow the directions inside the job control language (JCL)
  2581.     listing. These instructions appear under the label
  2582.  
  2583.     TO EXECUTE THIS JCL:
  2584.  
  2585.     Refer to Example A-1 at the end of this appendix for a sample
  2586.     JCL listing for a code point installation.
  2587.  
  2588.     For additional information on using listings similar to this
  2589.     sample, refer to the Network Program Products Samples book
  2590.     (SC30-3352) from IBM.
  2591.  
  2592. 7.  Submit the job. 
  2593.  
  2594.     After successful completion of this job, the code points load
  2595.     library member should be installed correctly. 
  2596.  
  2597. 8.  Log on to a NetView console and shut down NetView by entering
  2598.     the following NetView command:
  2599.  
  2600.      CLOSE IMMED 
  2601.  
  2602.     WARNING:  This command brings down NetView. To avoid untimely
  2603.     interruption of NetView services, consider performing this step
  2604.     during a scheduled system maintenance period.
  2605.  
  2606. 9.  At the primary MVS operator console, start NetView by entering
  2607.     the following command:
  2608.  
  2609.      S CNMPROC
  2610.  
  2611. 10. While NetView is starting up, check the startup messages to
  2612.     make sure that they include
  2613.  
  2614.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ92UTB IS AVAILABLE 
  2615.  
  2616.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ93UTB IS AVAILABLE 
  2617.      
  2618.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ94UTB IS AVAILABLE 
  2619.  
  2620.                                                               A-7
  2621.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ95UTB IS AVAILABLE 
  2622.  
  2623.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ96UTB IS AVAILABLE 
  2624.  
  2625.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ81UTB IS AVAILABLE 
  2626.  
  2627.      BNJ090I NETVIEW USER CODE POINT TABLE BNJ82UTB IS AVAILABLE 
  2628.  
  2629.     The preceding messages indicate that the code point files for
  2630.     NetWare are available. If these messages are directed to
  2631.     another console, they will not appear.
  2632.  
  2633. 11. Log on to NetView. When the NetView main menu appears, select
  2634.     NPDA (Network Problem Determination Application) by entering
  2635.  
  2636.      NPDA
  2637.  
  2638. 12. From NPDA prompt, set the NetView recording and viewing filters 
  2639.     by entering the following NetView commands:
  2640.  
  2641.      srf arec pass e paff
  2642.      srf arec pass e temp
  2643.      srf arec pass e impd
  2644.      svf pass e paff
  2645.      svf pass e temp
  2646.      svf pass e impd
  2647.  
  2648.     NOTE:  To display NetWare messages, the recording and viewing
  2649.     filters must be set each time NetView is started. To simplify
  2650.     NetView startup, enter these commands in a CLIST file.
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.                                                               A-8
  2665. Example A-1
  2666. Code Points Installation JCL
  2667. _________________________________________________________________
  2668. //        JOB
  2669. //
  2670. *****************************************************************
  2671. //*                                                             *
  2672. //*DESCRIPTION: PARSE, ASSEMBLE, AND LINKEDIT USER DEFINED CODE *
  2673. //*             POINT TABLES.                                   *
  2674. //*                                                             *
  2675. //*  NOTE ===>  THIS JCL ASSUMES:                               *
  2676. //*                                                             *
  2677. //*   1)  THE CODE POINT SOURCE IS CONTAINED IN A               *
  2678. //*       SINGLE LIBRARY                                        * 
  2679. //*   2)  THE MEMBER NAMES ARE FORMATED ASD AAABBCCC            *
  2680. //*       WHERE AAA = BNJ                                       *
  2681. //*             BB  = CODE POINT TABLE NUMBER                   *
  2682. //*             CCC = UTB (MODIFIABLE BY SYMBOLIC               *
  2683. //*                        VARIABLE "NAME")                     *
  2684. //*                                                             *
  2685. //*  TO EXECUTE THIS JCL:                                       *
  2686. //*   1.)  PUT YOUR OWN JOB CARD ON THE JOB                     *
  2687. //*   2.)  MODIFY SYMBOLIC VARIABLE "NETLNK" TO POINT TO THE    *
  2688. //*        NETVIEW LOAD LIBRARY YOU WANT THE CODE POINTS        *
  2689. //*        LINKED INTO                                          *
  2690. //*   3.)  MODIFY SYMBOLIC VARIABLE "USERLIB" TO POINT TO THE   *
  2691. //*        SOURCE LIBRARY NAME CONTAINING THE CODE POINTS.      *
  2692. //*                                                             *
  2693. //***************************************************************
  2694. //CNMUSER PROC    NUMBER=,
  2695. //        NAME=UTB,
  2696. //        NETLNK='CNM.USERLNK',    ** USER CODE POINT LIBRARY
  2697. //        REG=1,                   ** REGION SIZE IN MEG
  2698. //        SOUTA='*',               ** DEFAULT PRINTED OUTPUT CLASS
  2699. //        UNIT=SYSDA,              ** DEVICE TYPE FOR DASD
  2700. //        USERLIB='SYS2.NTVW.CODE.POINTS', ** CODE POINTS SOURCE
  2701. //        PS=3,                    ** PRIMARY CYLINDER ALLOCATION
  2702. //        SS=1                     ** SECONDARY CYLINDER ALLOCATION
  2703. //
  2704. *****************************************************************
  2705. //*  VERIFY USER TABLE INPUT
  2706. //
  2707. //***************************************************************
  2708. //PARSE    EXEC   PGM=BNJUSTBL,REGION=®.M,
  2709. //            PARM='&NUMBER'
  2710. //STEPLIB  DD DSN=SYS1.NPDALIB,DISP=SHR
  2711. //INTABLE  DD DSN=&USERLIB(BNJ&NUMBER&NAME),DISP=SHR
  2712. //OUTTABLE DD DSN=&&OUTDCB,DISP=(NEW,PASS),UNIT=&UNIT,
  2713. //            SPACE=(CYL,(&PS,&SS)),
  2714. //            DCB=(DSORG=PS,LRECL=80,BLKSIZE=3120,RECFM=FB)
  2715. //SYSPRINT DD SYSOUT=&SOUTA
  2716. //SYSUDUMP DD DUMMY
  2717. //SYSUT1   DD UNIT=&UNIT,SPACE=(CYL,(&PS,&SS))
  2718. *****************************************************************
  2719.  
  2720.                                                               A-9
  2721. Example A-1 (continued)
  2722. Code Points Installation JCL
  2723. _________________________________________________________________
  2724. //
  2725. //*  ASSEMBLE STEP
  2726. //
  2727. *****************************************************************
  2728. //ASM     EXEC PGM=IFOX00,PARM='LOAD,NODECK,OBJECT',
  2729. //             REGION=®.M,COND=(4,LT)
  2730. //SYSPRINT  DD SYSOUT=&SOUTA
  2731. //SYSLIB    DD DSNAME=SYS1.MACLIB,DISP=SHR
  2732. //SYSUT1    DD UNIT=&UNIT,SPACE=(CYL,(1,1))
  2733. //SYSUT2    DD UNIT=&UNIT,SPACE=(CYL,(1,1))
  2734. //SYSUT3    DD UNIT=&UNIT,SPACE=(CYL,(1,1))
  2735. //SYSGO     DD DSNAME=&&SYSGO,DISP=(NEW,PASS),UNIT=&UNIT,
  2736. //       SPACE=(CYL,(&PS,&SS)),
  2737. //       DCB=(DSORG=PS,LRECL=80,BLKSIZE=3120,RECFM=FB)
  2738. //SYSIN    DD DSN=*.PARSE.OUTTABLE,
  2739. //         DISP=(OLD,DELETE)
  2740. //
  2741. *****************************************************************
  2742. //*  LINKEDIT STEP
  2743. //
  2744. *****************************************************************
  2745. //LINK    EXEC PGM=IEWL,
  2746. //             PARM='XREF,LET,LIST,SIZE=(512K,128K),NCAL,REUS',
  2747. //             REGION=®.M,COND=(4,LT)
  2748. //SYSPRINT  DD SYSOUT=&SOUTA
  2749. //SYSUT1    DD SPACE=(CYL,(1,1)),DISP=(NEW,PASS),UNIT=&UNIT
  2750. //SYSLMOD  DD DSN=&NETLNK(BNJ&NUMBER&NAME),
  2751. //         DISP=SHR
  2752. //SYSLIN   DD DSNAME=&&SYSGO,DISP=(OLD,DELETE)
  2753. //         PEND
  2754. //STEP1    EXEC PROC=CNMUSER,NUMBER=92
  2755. //STEP2    EXEC PROC=CNMUSER,NUMBER=93
  2756. //STEP3    EXEC PROC=CNMUSER,NUMBER=94
  2757. //STEP4    EXEC PROC=CNMUSER,NUMBER=95
  2758. //STEP5    EXEC PROC=CNMUSER,NUMBER=96
  2759. //STEP6    EXEC PROC=CNMUSER,NUMBER=81
  2760. //STEP7    EXEC PROC=CNMUSER,NUMBER=82
  2761. _________________________________________________________________
  2762.                                                              A-10
  2763.  
  2764.   APPENDIX B:  Using NetView RUNCMD Filtering
  2765.  
  2766. The NetView RUNCMD filtering feature allows you to disable
  2767. NetWare processing of select RUNCMDs that may be sent by
  2768. NetView operators.  NetView RUNCMD filtering is an extension of
  2769. the NetView support features described in Chapter 1.
  2770.  
  2771. To prepare for RUNCMD filtering, you need to edit the sample
  2772. RUNCMD filter file or create a new RUNCMD filter file.  To
  2773. enable the RUNCMD filtering feature, you need to install the
  2774. RUNCMD filter file and restart NMA for NetView.
  2775.  
  2776. IMPORTANT:  If a RUNCMD filter file is not installed on an NMA
  2777. for NetView server, or if NMA for NetView is not restarted after 
  2778. the RUNCMD filter file is installed, NMA for NetView processes 
  2779. all NetView RUNCMDs that conform to the RUNCMD security requirements.
  2780.  
  2781. This appendix describes how RUNCMD filtering works and how to
  2782.  
  2783. o  Edit the sample RUNCMD filter file
  2784.  
  2785. o  Create a new RUNCMD filter file
  2786.  
  2787. o  Enable RUNCMD filtering
  2788.  
  2789. This appendix also lists the RUNCMDs that NetView operators can 
  2790. send to NetWare servers.
  2791.  
  2792. HOW RUNCMD FILTERING WORKS
  2793.  
  2794. After RUNCMD filtering is enabled, NMA for NetView may apply the
  2795. following two levels of security to each NetView RUNCMD it
  2796. receives.
  2797.  
  2798. o  NMA for NetView first examines the user ID in the NetView
  2799.    RUNCMD.  If the user ID has the proper status, NMA for
  2800.    NetView continues to process the RUNCMD.
  2801.  
  2802. o  NMA for NetView checks its internal table to see if the
  2803.    RUNCMD is disabled by RUNCMD filtering.  If the RUNCMD
  2804.    is not disabled, NMA for NetView processes the RUNCMD.
  2805.  
  2806. When a NetView operator sends a RUNCMD that has been disabled
  2807. by RUNCMD filtering, NMA for NetView responds as follows:
  2808.  
  2809. o  If the RUNCMD does not include an attribute parameter, or if
  2810.    it includes a single attribute parameter that has been
  2811.    disabled, NMA for NetView rejects the RUNCMD and sends the
  2812.    following message to the NetView operator:
  2813.  
  2814.     Cannot execute this NetView Runcmd
  2815.  
  2816. o  If the RUNCMD includes multiple attribute parameters of
  2817.    which some are enabled and some are disabled, NMA for NetView
  2818.    processes all enabled parameters and ignores all disabled
  2819.    parameters.
  2820.  
  2821.                           B-1
  2822. EDITING THE SAMPLE RUNCMD FILTER FILE
  2823.  
  2824. The sample RUNCMD filter file is an ASCII text file that lists
  2825. all the RUNCMDs NetView operators can send to NetWare servers.
  2826. Initially, this file does not disable NetWare processing for any
  2827. RUNCMDs.  You can edit this file to disable processing for any
  2828. or all RUNCMDs.
  2829.  
  2830. To edit the filter file, use the following procedure:
  2831.  
  2832. 1.  Use a text editor or a word processor to open the file named
  2833.     NVCMDS.DB.
  2834.  
  2835.     This file is on NMA for NetView 1.3B, Disk 3 in the DATABASE 
  2836.     directory.  This file is not automatically copied to the 
  2837.     server during the installation process.
  2838.  
  2839.     IMPORTANT:  The text editor for word processor must be capable
  2840.     of editing an ASCII text file.  Do not use programs that embed
  2841.     control characters into saved files for special effects such
  2842.     as bold and underline.
  2843.  
  2844.     Example B-1 lists some of the statements from the sample
  2845.     RUNCMD filter file.
  2846.  
  2847. Example B-1
  2848. Sample RUNCMD
  2849. Filter File Entries
  2850. -----------------------------------------------------------------
  2851. rem             The NetView Run Command Filtering File
  2852. ...
  2853. ;QUERY          SPX          VERSION
  2854. ;QUERY          SPX          CONFIG
  2855. ;QUERY          SPX          VERSION
  2856.  
  2857. -----------------------------------------------------------------
  2858.  
  2859.     The statements in the RUNCMD filter file conform to the
  2860.     following rules:
  2861.  
  2862.     o  Each line in the file is a separate statement.
  2863.  
  2864.     o  RUNCMD statements disable a RUNCMD and must contain two
  2865.        or three parameters in the form:
  2866.  
  2867.        <action> <resource> <attribute_parameter>
  2868.  
  2869.        In the third line of Example B-1, <action> is QUERY,
  2870.        <resource> is SPX, and <attribute_parameter> is VERSION.
  2871.        The action parameter defines the function to be performed,
  2872.        and the resource parameter defines the resource affected
  2873.        by the action. The attribute parameter defines the resource
  2874.        attribute the RUNCMD affects.
  2875.  
  2876.        The action and resource parameters are required.  When a
  2877.        RUNCMD has one or more attribute parameters, you must
  2878.        enter one attribute parameter.
  2879.                           B-2
  2880.        The parameters for all RUNCMDs are listed in "RUNCMD
  2881.        Tables" later in this appendix. 
  2882.  
  2883.     o  Each RUNCMD statement can disable one attribute parameter
  2884.        for a RUNCMD.  If a RUNCMD has multiple attribute
  2885.        parameters, you must enter a separate RUNCMD statement
  2886.        for each attribute parameter you want to disable.
  2887.  
  2888.     o  The letters in each statement may be entered in uppercase
  2889.        or lowercase.  For example, REM is equivalent to rem, Rem,
  2890.        and ReM.
  2891.  
  2892.     o  When a statement begins with REM or a semicolon (;), the
  2893.        statement is a comment.  NMA for NetView ignores comments.
  2894.        Comments affect the RUNCMD statements as follows:
  2895.  
  2896.        When a RUNCMD statement is preceded by REM or a semicolon,
  2897.        the statement is ignored and the RUNCMD remains enabled.
  2898.  
  2899.        When a RUNCMD statement is not preceded by REM or a
  2900.        semicolon, the RUNCMD is disabled.
  2901.  
  2902.     o  RUNCMD parameters may be separated by space or tab
  2903.        characters.
  2904.  
  2905. 2.  Disable each RUNCMD you want to disable by removing any
  2906.     comment characters (REM or semicolon) at the beginning of
  2907.     the RUNCMD statement.
  2908.  
  2909. 3.  If you want to enable a disabled RUNCMD, make the RUNCMD
  2910.     statement a comment (using REM or a semicolon) or delete the
  2911.     RUNCMD statement.
  2912.  
  2913. 4.  Save the ASCII file.
  2914.  
  2915.     IMPORTANT:  The ASCII file must be named NVCMDS.DB.
  2916.  
  2917.  
  2918. CREATING A RUNCMD FILTER FILE
  2919.  
  2920. A RUNCMD filter file is an ASCII text file that lists all the
  2921. RUNCMDs you want to disable.
  2922.  
  2923. To create a RUNCMD filter file, use the following procedure:
  2924.  
  2925. 1.  Use a text editor or a word processor to create a new file
  2926.     named NVCMDS.DB.
  2927.  
  2928.     IMPORTANT:  The text editor or word processor must be capable
  2929.     of editing an ASCII text file.  Do not use programs that
  2930.     embed control characters into saved files for special effects
  2931.     such as bold and underline.
  2932.  
  2933.  
  2934.                           B-3
  2935. 2.  In the ASCII file, add RUNCMD and comment statements.
  2936.  
  2937.     The RUNCMD and comment statements operate as described in
  2938.     Step 1 of the preceding section, "Editing the Sample RUNCMD
  2939.     Filter File."
  2940.  
  2941. 3.  Save the ASCII file.
  2942.  
  2943.     IMPORTANT:  The ASCII file must be named NVCMDS.DB.
  2944.  
  2945.  
  2946. ENABLING RUNCMD FILTERING
  2947.  
  2948. To enable RUNCMD filtering, edit or create a RUNCMD filter file,
  2949. and then use the following procedure:
  2950.  
  2951. 1.  Place a copy of the NVCMDS.DB RUNCMD filter file in the
  2952.     server's SYS:\SYSTEM\COMMEXEC directory.
  2953.  
  2954. 2.  Restart NMA for NetView.
  2955.  
  2956.     During initialization, NMA for NetView examines each line of
  2957.     the RUNCMD filter file.  Comment lines are ignored. Valid
  2958.     entries are registered in an internal table within NMA for
  2959.     NetView. If a RUNCMD line contains an error, NMA for NetView 
  2960.     displays the following message on the NetWare system console:
  2961.  
  2962.      Invalid NetView RunCmd entry: xxxxxxxxxxxxxx <CR><LF>
  2963.  
  2964.     IMPORTANT:  Invalid entries are ignored.  Invalid entries do 
  2965.     not disable the RUNCMD you intend to disable.
  2966.  
  2967.  
  2968. RUNCMD TABLES
  2969.  
  2970. The tables in this section list RUNCMDs that the NetView
  2971. operator can send to NetWare.  Table B-1 lists these RUNCMDs
  2972. according to the action they perform.  Table B-2 lists RUNCMDs
  2973. according to the resource upon which an action is performed.
  2974.  
  2975. For more information on the listed RUNCMDs, see Chapter 3 of
  2976. the NetWare Reference Guide for NetView Operators.
  2977.  
  2978. IMPORTANT:  The RUNCMDs in the following tables include all
  2979. parameters that the NetView operator can send to NetWare.  When
  2980. you enter a RUNCMD statement in a RUNCMD filter file, enter only
  2981. the action, resource, and attribute parameter.  When you enter an
  2982. attribute parameter, do not include the equal symbol (=) or any
  2983. characters enclosed in brackets (< >) that appear in these tables.
  2984.  
  2985. WARNING:  The UserName parameter in the following RUNCMDs does
  2986. not support group names.
  2987.  
  2988. When the phrase (NetWare 4.x) appears in the Action column, the 
  2989. command and all its parameters can be used only with servers 
  2990. that run NetWare 4.0 and later.  These commands do not work with 
  2991. NetWare 3.1x servers.
  2992.                           B-4
  2993. Table B-1
  2994. NetWare RUNCMDs Sorted by Action
  2995. ------------------------------------------------------------------
  2996. Action      Resource      Attribute       Resource       Command
  2997.           Parameter       Qualifier      Qualifier
  2998. ------------------------------------------------------------------
  2999. Add         Directory     Trustee         Path=<path>    UserName=
  3000.                      <uname>
  3001.                      Rights=
  3002.                      [A][C][E][F]
  3003.                      [M][R][S][W]
  3004.   
  3005. Add         File          Trustee         Path=<path>    UserName=
  3006.                      <uname>
  3007.                      Rights=
  3008.                      [A][C][E][F]
  3009.                      [M][R][S][W]
  3010.   
  3011. Add         Volume        Trustee         VolName=       UserName=
  3012.                 <vname>        <uname>
  3013.                      Rights=
  3014.                      [A][C][E][F]
  3015.                      [M][R][S][W]
  3016.  
  3017. Broadcast   Server                                       Msg=
  3018.                      "<message>"
  3019.                      UserName=
  3020.                      <uname>
  3021.   
  3022. Disable     Server        Login
  3023.  
  3024. Disable     TTS
  3025.  
  3026. Down        Server                                       [Opts=
  3027.                      [0][1]]
  3028.   
  3029. Enable      Server        Login
  3030.  
  3031. Enable      TTS
  3032.  
  3033. Get         Server        Parm=
  3034. (NetWare                  "<parameter>"
  3035.  4.x)
  3036.  
  3037. Load        NLM           NLMName=<name>                 [Args=
  3038.                      "<argument>"]
  3039.   
  3040. Query       Directory                     Path=<path>
  3041.  
  3042.  
  3043. Query       Directory     Rights          Path=<path>    UserName=
  3044.                      <uname>
  3045.     
  3046. Query       Directory     SpaceAllowed    Path=<path>
  3047.  
  3048.                           B-5
  3049. Table B-1 (continued)
  3050. NetWare RUNCMDs Sorted by Action
  3051. ------------------------------------------------------------------
  3052. Action      Resource      Attribute       Resource       Command
  3053.           Parameter       Qualifier      Qualifier
  3054. ------------------------------------------------------------------
  3055.  
  3056. Query       File                          Path=<path>    [UserName=
  3057.                      <uname>]
  3058.                           
  3059.  
  3060. Query       File          Rights          Path=<path>    UserName=
  3061.                      <uname>
  3062.  
  3063.  
  3064. Query       IPX           Version
  3065.  
  3066. Query       Server
  3067.  
  3068. Query       Server        Date
  3069.           Time
  3070.  
  3071. Query       Server        InternetAddr
  3072.  
  3073. Query       Server        LoginStatus
  3074.  
  3075. Query       Server        NumOfVols
  3076.  
  3077. Query       Server        Volumes
  3078.  
  3079. Query       SPX           Config
  3080.  
  3081. Query       SPX           Version
  3082.  
  3083. Query       TTS           Status
  3084.  
  3085. Query       User          DiskSpaceLeft   UserName=      VolName=
  3086.                 <uname>        <vname>
  3087.   
  3088. Query       User          DiskUsage       UserName=      VolName=
  3089.                 <uname>        <vname>
  3090.   
  3091. Query       Volume                        VolName=
  3092.                 <vname>
  3093.    
  3094. Query       Volume        DiskUsage       VolName=       UserName=
  3095.                 <vname>        <uname>
  3096.     
  3097. Query       Volume        USpaceAllowed   VolName=       UserName=
  3098.                 <vname>        <uname>
  3099.   
  3100. Remove      Directory     Trustee         Path=<path>    UserName=
  3101.                      <uname>
  3102.   
  3103. Remove      File          Trustee         Path=<path>    UserName=
  3104.                      <uname>
  3105.                           
  3106.                           B-6
  3107. Table B-1 (continued)
  3108. NetWare RUNCMDs Sorted by Action
  3109. ------------------------------------------------------------------
  3110. Action      Resource      Attribute       Resource       Command
  3111.           Parameter       Qualifier      Qualifier
  3112. ------------------------------------------------------------------
  3113. Remove      Volume        Trustee         VolName=       UserName=
  3114.                 <vname>        <uname>
  3115.                           
  3116. Set         Directory     CDate=<date>    Path=<path>
  3117.           CTime=<time>
  3118.           Owner=<name>
  3119.  
  3120. Set         Directory     SpaceAllowed    Path=<path>
  3121.                =<space>
  3122.   
  3123. Set         File          ADate=<date>    Path=<path>
  3124.           ArDate=<date>
  3125.           ArTime=<time>
  3126.           CDate=<date>
  3127.           CTime=<time>
  3128.           Owner=<date>
  3129.           UDate=<date>
  3130.           UTime=<time>
  3131.  
  3132. Set         Server        Date=<date>
  3133.           Time=<time>
  3134.  
  3135. Set         Server        Parm=           Value=
  3136. (NetWare                  "<parameter>"   <value>
  3137.  4.x)
  3138.  
  3139. Set         Volume        USpaceAllowed=  VolName=       UserName=
  3140.           <space>         <vname>        <uname>
  3141.     
  3142. Set         Volume        NoRestriction   VolName=       UserName=
  3143.                 <vname>        <uname>
  3144.  
  3145. UnLoad      NLM           NLMName=<name>
  3146.  
  3147.                           B-7
  3148. Table B-2
  3149. NetWare RUNCMDs Sorted by Resource
  3150. ------------------------------------------------------------------
  3151. Action      Resource      Attribute       Resource       Command
  3152.           Parameter       Qualifier      Qualifier
  3153. ------------------------------------------------------------------
  3154. Add         Directory     Trustee         Path=<path>    UserName=
  3155.                      <uname>
  3156.                      Rights=
  3157.  
  3158. Query       Directory     Path=<path>
  3159.  
  3160. Query       Directory     Rights          Path=<path>    UserName=
  3161.                      <uname>
  3162.    
  3163.  
  3164. Query       Directory     SpaceAllowed    Path=<path>
  3165.                        
  3166. Remove      Directory     Trustee         Path=<path>    UserName=
  3167.                      <uname>
  3168.       
  3169. Set         Directory     CDate=<date>    Path=<path>
  3170.           CTime=<time>
  3171.           Owner=<name>
  3172.  
  3173. Set         Directory     SpaceAllowed    Path=<path>
  3174.           =<space>
  3175.  
  3176. Add         File          Trustee         Path=<path>    UserName=
  3177.                      <uname>
  3178.                      Rights=
  3179.                      [A][C][E][F]
  3180.                      [M][R][S][W]
  3181.   
  3182. Query       File                          Path=<path>    [UserName=
  3183.                      <uname>]
  3184.  
  3185. Query       File          Rights          Path=<path>    UserName=
  3186.                      <uname>
  3187.  
  3188. Remove      File          Trustee         Path=<path>    UserName=
  3189.                      <uname>
  3190.  
  3191. Set         File          ADate=<date>    Path=<path>
  3192.           ArDate=<date>
  3193.           ArTime=<time>
  3194.           CDate=<date>
  3195.           CTime=<time>
  3196.           Owner=<name>
  3197.           UDate=<date>
  3198.           UTime=<time>
  3199.  
  3200.                           
  3201.                           
  3202.                           
  3203.                           B-8
  3204. Table B-2 (continued)
  3205. NetWare RUNCMDs Sorted by Resource
  3206. ------------------------------------------------------------------
  3207. Action      Resource      Attribute       Resource       Command
  3208.           Parameter       Qualifier      Qualifier
  3209. ------------------------------------------------------------------
  3210.  
  3211. Query       IPX           Version
  3212.  
  3213. Load        NLM           NLMName=<name>                 [Args=
  3214.                      "<argument>"]
  3215.      
  3216. UnLoad      NLM           NLMName=<name>
  3217.  
  3218. Broadcast   Server                                       Msg=
  3219.                      "<message>"
  3220.                      [UserName=
  3221.                      <uname>]
  3222.    
  3223. Disable     Server        Login
  3224.  
  3225. Down        Server                                       [Opts=
  3226.                      [0][1]]
  3227.    
  3228. Enable      Server        Login
  3229.  
  3230. Get         Server        Parm=
  3231. (NetWare                  "<parameter>"
  3232.  4.x)
  3233.  
  3234. Query       Server
  3235.  
  3236. Query       Server        Date
  3237.           Time
  3238.  
  3239. Query       Server        InternetAddr
  3240.  
  3241. Query       Server        LoginStatus
  3242.  
  3243. Query       Server        NumOfVols
  3244.  
  3245. Query       Server        Volumes
  3246.  
  3247. Set         Server        Date=<date>
  3248.           Time=<time>
  3249.  
  3250. Set         Server        Parm=           Value=
  3251. (NetWare                  "<parameter>"   <value>
  3252.  4.x)
  3253.  
  3254. Query       SPX           Config
  3255.                           
  3256.  
  3257.                           B-9
  3258. Table B-2 (continued)
  3259. NetWare RUNCMDs Sorted by Resource
  3260. ------------------------------------------------------------------
  3261. Action      Resource      Attribute       Resource       Command
  3262.           Parameter       Qualifier      Qualifier
  3263. ------------------------------------------------------------------
  3264.  
  3265. Query       SPX           Version
  3266.  
  3267. Disable     TTS
  3268.  
  3269. Enable      TTS
  3270.  
  3271. Query       TTS           Status
  3272.  
  3273. Query       User          DiskSpaceLeft   UserName=     VolName=
  3274.                 <uname>       <vname>
  3275.   
  3276. Query       User          DiskUsage       UserName=     VolName=
  3277.                 <uname>       <vname>
  3278.  
  3279. Add         Volume        Trustee         VolName=      UserName=
  3280.                 <vname>       <uname>
  3281.                     Rights=
  3282.                     [A][C][E][F]
  3283.                     [M][R][S][W]
  3284.  
  3285. Query       Volume                        VolName=
  3286.                 <vname>
  3287.   
  3288. Query       Volume        DiskUsage       VolName=      UserName=
  3289.                 <vname>       <uname>
  3290.  
  3291. Query       Volume        USpaceAllowed   VolName=      UserName=
  3292.                 <vname>       <uname>
  3293.   
  3294. Remove      Volume        Trustee         VolName=      UserName=
  3295.                 <vname>       <uname>
  3296.   
  3297. Set         Volume        USpaceAllowed=  VolName=      UserName=
  3298.           <space>         <vname>       <uname>
  3299.  
  3300. Set         Volume        NoRestriction   VolName=      UserName=
  3301.                 <vname>       <uname>
  3302.  
  3303.  
  3304.                        B-10
  3305.  
  3306.                               USER COMMENTS
  3307.  
  3308. Novell would like to hear your comments and suggestions about our
  3309. manuals.  Please write your comments below and send them to us at
  3310.  
  3311. Novell, Inc.                      NetWare Management Agent
  3312. Technical Publications            (NMA) for NetView 1.3B
  3313. MS S1-01-1                        NetWare Managment Agent for
  3314. 890 Ross Drive                    NetView Administration Guide
  3315. Sunnyvale, CA 94089               100-001523-004
  3316. U.S.A.                            October 1993
  3317.     
  3318. Fax: (408) 747-4066
  3319.  
  3320. For technical support issues contact your local dealer.
  3321.  
  3322. Your name and title: _________________________________________
  3323.  
  3324. Company: _____________________________________________________
  3325.  
  3326. Address: _____________________________________________________
  3327.  
  3328. Phone number: _________________________  Fax: _______________
  3329.  
  3330.  
  3331. I use this manual as:__an overview __a tutorial __a reference
  3332.  
  3333.                      __a guide     __other 
  3334.  
  3335.                        Excellent     Good     Fair     Poor
  3336.  
  3337. Completeness             _____       ____      ____     ____
  3338.  
  3339. Readability (style)      _____       ____      ____     ____
  3340.  
  3341. Organization             _____       ____      ____     ____
  3342.  
  3343. Accuracy                 _____       ____      ____     ____
  3344.  
  3345. Examples                 _____       ____      ____     ____
  3346.  
  3347. Usefulness               _____       ____      ____     ____
  3348.  
  3349.  
  3350. Please explain any of your above ratings:
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356. In what ways can this manual be improved?