                    CHAPTER 1  About NMA for NetView


This chapter describes

o  NetWare Management Agent (NMA) for NetView

o  The new features in NMA for NetView v1.3

o  The complete NMA for NetView feature set

IMPORTANT:  NMA for NetView and NetWare for SAA(TM) provide similar
support for NetView. Do not install NMA for NetView and NetWare
for SAA in the same NetWare v3.1x server.

NOTE:  NMA for NetView and NetWare for SAA servers are designed
to support the NetView network management program from IBM. These
NetWare products will support any other network management
program that is 100% compatible with NetView. The NET/MASTER
network management program from Systems Center is an example of a
program that is designed to be compatible with NetView.


WHAT IS NMA FOR NETVIEW?

NMA for NetView is a NetWare Loadable Module(TM)(NLM(R)) that
runs in a NetWare v3.1x server and enables the server to
participate in NetView network management. The NetWare v3.1x
product package includes NMA for NetView.

NetView is an IBM network management program that runs in the
Virtual Machine (VM) and Multiple Virtual Storage (MVS) host
environments. NetView is designed to be an enterprise-wide
network management tool. IBM publishes specifications that
describe how network product vendors an design products to
communicate with NetView.

Throughout this guide, a NetWare v3.1x server that is running NMA
for NetView is called an NMA for NetView server. The NMA for
NetView server uses the following connections:

o  A connection to a NetWare local area network (LAN), which
   connects to  workstations that use the file and print services
   provided by NetWare v3.1x

o  A connection that leads to a host computer that is running
   NetView

The connection and communications between the workstations and
NetWare v3.1x is a feature of NetWare v3.1x. NMA for NetView
provides for two types of connections between NMA for NetView and
the NetView host computer. The physical connection between NMA
for NetView and the NetView host is described later in this
chapter.

                                                              1-1
NMA for NetView exchanges three types of messages with NetView:

o  Alerts

o  Commands

o  Command responses

Alerts are messages that are sent from NMA for NetView to
NetView. NMA for NetView translates selected NetWare server error
and status messages into alerts.

Commands are messages that are sent from NetView to the NMA for
NetView server. NMA for NetView enables NetView to send commands
that request NetWare server information or control some NetWare
server features.

Command responses are messages that are sent to NetView after a
command message has been processed. Command response messages
contain information about the server or about the result of a
server command.

IMPORTANT:  The messages that travel between NMA for NetView and
the NetView host relate to the operation of the NetWare v3.11
server. NMA for NetView does not monitor, report, or control the
status of the NetWare LAN or NetWare LAN workstations. NMA for
NetView does not respond to maintenance statistic requests from
an IBM host.

NetView operators use a terminal to connect to the NetView
program on the host. From the terminal, the NetView operator can
view alert messages, send command messages, and view command
response messages. For more information on NetView operation, see
the NetView Operation Primer (SC30-3363) from IBM.

NOTE:  Novell(R) sells software that enables NetWare users to
connect to NetView and other host programs from a NetWare LAN
workstation. The NetWare 3270 LAN Workstation products allow
NetWare LAN workstations to emulate IBM terminals. NetWare for
SAA enables communications between NetWare 3270 LAN Workstations
and the host.


WHAT IS NEW IN VERSION 1.3?

NMA for NetView v1.3 provides the following new features:

o  Additional alerts for the NetWare operating system and its
   component services.  Also, some alert messages are changed.

o  New commands for requesting server status and controlling
   some server features.


                                                              1-2
o  A command filtering feature for disabling NetView access
   to one or more server commands.

o  Alert and command forwarding for applications that use the
   Open NetWare Interface.

These features are described with the complete set of NMA for
NetView features in the next section.


NMA FOR NETVIEW FEATURES

The principal features of NMA for NetView are

o  Alert generation

o  Command processing

o  Host communication options

o  Collection point communication options

o  Feature control

o  Support for the Open NetView Interface


Alert Generation
----------------

NMA for NetView generate alerts for the following server
processes:

o  Token ring adapters and drivers

o  Logical link control (LLC) protocol components of token ring
   drivers

o  The NetWare operating system and component services

NOTE:  The alerts for token ring adapters, drivers, and protocol 
components apply to the token ring components in the NMA for
NetView server. NMA for NetView does not generate alerts for
similar conditions in NetWare LAN workstations.

These NetView alert messages are listed in the NetWare Reference
Guide for NetView Operators. (For information on how to get this
guide, see "Obtaining the Software and the Manuals" in
Chapter 2.) Each message description in the NetWare Reference
Guide for NetView Operators includes the NetView alert, a
description of the alert cause, a suggested action, and the
NetWare message (if one exists) that would appear on the server
console.

                                                             1-3
SUGGESTION:  If the NetView operator contacts you for help with
an alert message, ask the operator to look it up in the NetWare
Reference Guide for NetView Operators. If the operator still
needs help, ask the operator to tell you the NetWare message that
corresponds to the alert message.

Because of differences between NetView and NetWare, the NetWare
message is always different from the corresponding NetView
message. (NetWare messages are described in NetWare v3.1x System
Messages.)


Command Processing
------------------

NMA for NetView processes two types of commands:

o  Server query commands

o  Server control commands

NMA for NetView allows you to control command processing with
the following features:

o  Command security

o  Command filtering

This section describes the actions these commands produce. For
detailed information on entering commands, see the NetWare
Reference Guide for NetView Operators.


Server Query Commands

Server query commands request information about server resources.
These commands allow the NetView operator to query for

o  Server information such as the number of volumes on a server,
   the server's login status, and the server's internetwork
   address
   
o  Volume information such as the space allowed for a user, and
   the space used by a user
   
o  Directory information such as the space allowed for a
   directory, and a user's rights to the directory
   
o  File information

o  A user's usage of a volume and the remaining space allowed to
   the user

o  The version numbers of the Sequenced Packet Exchange (SPX) and
   Internetwork Packet Exchange (IPX) protocols
                                                              1-4
o  The configuration of the SPX protocol

o  The status of the Transaction Tracking Service (TTS)


Server Control Commands

Server control commands allow a NetView operator to

o  Enable or disable server login, shut down a server, and
   broadcast a message to server users
   
o  Set server date and time

o  Set the volume space allowed to a user and remove a user
   from a volume

o  Set the space allowed to a directory; add or remove a
   directory trustee; and set the owner, creation date, and
   creation time for a directory
   
o  Add and remove file trustees and set the file owner, the
   creation date and time, the update date and time, the access
   date, and the archive date and time

o  Enable or disable the Transaction Tracking Service (TTS)

o  Load and unload an NLM


NOTE:  If a NetView operator sends a LOAD command with an
incomplete set of parameters for an NLM, a prompt for the
missing parameters appears on the server console. The NLM does
not begin operating until the missing information is entered at
the server console. The NetView operator is not notified about
the missing parameters and may not be aware that the NLM is
not operating.

Also, if the NetView operator sends an UNLOAD command for an
NLM, the command will fail if the NLM or is exporting functions
and symbols to another NLM. If the UNLOAD command fails, a
message appears on the System Console. The NetView operator is
not notified about the failure and may not be aware that the NLM
is still operating.











                                                              1-5
Command Security

As shown in Table 1-1, NMA for NetView checks each NetView
command for a valid NetWare user ID with the appropriate status.


Table 1-1
NetView Command Processing
-----------------------------------------------------------------
Server Command Type         NetWare User ID Status Required for
                            Processing
-----------------------------------------------------------------
Query                       File server console operator or
                            Supervisor

Control                     Supervisor
-----------------------------------------------------------------

When a command message does not that do not include an acceptable
NetWare user ID, NetWare rejects the command and sends the
following message to NetWare:

Invalid operator name

When this message appears on the NetView console the name variable
displays the user ID that was rejected.

NOTE:  A NetView command must include a user ID (other than
SUPERVISOR) with either supervisor-equivalent privileges or file
server console operator status. Although the SUPERVISOR user ID
has supervisor-equivalent privileges, the server rejects RUNCMDs
that include the SUPERVISOR user ID.

Command Filtering

The command filtering feature allows you to disable NetWare
processing of select commands that may be sent by NetView
operators.  You can disable any numbe of commands by listing
them in a file that NMA for NetView reads when loading.

When a NetView operator sends a command that has been disabled by
command filtering, NMA for NetView returns the following message
to NetView:

Cannot access this NetView Runcmd










                                                              1-6
Host Communications Options
---------------------------

NMA for NetView provides two options for communicating with the
host computer:

o  Direct host communications over a token ring LAN

o  Collection point communications via a NetWare for SAA server


Direct Host Communications

When using the direct host communications option, the NMA for
NetView server must connect to a token ring LAN. The host
computer must also connect, either directly or indirectly, to the
same token ring LAN.

Indirect connections are supported by a variety of host
communications equipment, such as an IBM 3174 Attachment.

Alerts and command responses from the NMA for NetView server
travel over the token ring LAN to the host. Commands from NetView
travel over the token ring LAN to the NMA for NetView server.


Collection Point Communications

When using the collection point communications option, NMA for
NetView indirectly connects to the host computer through a
NetWare for SAA server. In this system configuration, the NetWare
for SAA server is called a collection point server.

When operating as a collection point server, the NetWare for SAA
server uses the following connections:

o  A connection via the NetWare LAN to the NMA for NetView server

o  A token ring, SDLC, QLLC, or Ethernet connection to the host
   computer running NetView

When NMA for NetView is ready to send an alert, it sends the
alert over the NetWare LAN to the collection point server. The
collection point server forwards the alert to NetView.

When NetView is ready to send a command to an NMA for NetView
server, it sends the command to the collection point server. The
collection point server forwards the command over the NetWare LAN
to the NMA for NetView server. Command response messages from NMA
for NetView follow the same communications path as alert
messages.




                                                              1-7
Advantages of Collection Point Communications

The collection point server option can reduce the cost of NetView
management in NetWare LANs with multiple servers. If your NetWare
LAN does not use token ring cabling, for example, the collection
point server option can eliminate the cost of a token ring
adapter for each NMA for NetView server.

The collection point server option also reduces the number of
host connections required by NetWare servers. The host must
allocate a physical unit (PU) for each NMA for NetView or NetWare
for SAA server that is configured for direct host communications.
NetView messages flow over a session between the PU and the
system services control point (SSCP) host component. Servers that
are configured for collection point communications use the
SSCP-PU session allocated to the collection point server;
they do not require an additional PU assignment.

Support for the Open NetView Interface

NMA for NetView can provide a connection between NetView and
other application that conform to the NetWare Open NetView
interface.  When an application uses the Open NetView interface,
a server running NMA for NetView can

o  Receive alerts from the application and forward them to
   NetView

o  Receive commands from NetView and forward them to the
   application

For more information on the NetView support provided by an
application, refer to the documentation supplied with the
application.









                                                              1-8
