		   CHAPTER 3  Sending NetWare Commands


This chapter describes how to send commands from the NetView
Network Communications Control Facility (NCCF) to the following
tkypes of NetWare servers.

o  NetWare for SAA v1.2 and later

o  NMA for NetView v1.2 and later

These versions of NetWare for SAA and NMA for NetView support
commands for the operating system and file services features of
NetWare v3.11 and later servers.

IMPORTANT:  This chapter does not describe how to send commands 
to an application that has been designed to use the NetWare Open
NetView interface.  For information on spending commands to this
type of application, refer to the manual for that application.


HOW TO SEND COMMANDS

NetWare servers support the RUNCMD feature in NetView NCCF. The 
format for a NetWare RUNCMD is

   RUNCMD SP=<service_point_name>,APPL=NETWARE,
     SName=<server_name> [OP=<userid>] <action> 
     <resource> <attribute_parameter> 
     <resource_qualifier> <command_qualifier>

Table 3-1 divides the NetWare RUNCMD into three
components.

Table 3-1
NetWare RUNCMD Components
-----------------------------------------------------------------
Command             Command
Components          Parameters
-----------------------------------------------------------------
Command routing     RUNCMD SP=<service_point_name>, APPL=NETWARE,
		    SName=<service_name>
		    
Command security    OP=<userid>

Server command      <action>
parameters for      <resource>
NetWare v3.1x and   <attribute_parameter>
NetWare v4.0        <resource_qualifier> 
servers             <command_qualifier>

-----------------------------------------------------------------

The following sections describe how to route commands to the 
destination server, comply with NetWare security, and assemble
server command parameters for NetWare v3.1x and NetWare v4.0
servers.

								 3-1
NOTE:  The NetWare RUNCMD format is a combination of NetView
RUNCMD parameters and parmeters for NetWare.  For additional 
information on NetView RUNCMD parameters and options, see the 
"NetView Operation" (SC31-6019) manual from IBM.

IMPORTANT:  When NCCF displays the message "No NetView Response
received," the message indicates that an end point server did not
respond to your command.  This message is generated by the 
collection point server.


Command Routing
---------------

The format of the command routing portion of a NetWare RUNCMD is

RUNCMD SP=<service_point_name>, APPL=NETWARE,
  SName=<server_name>
  
Table 3-2 shows how to address the NetWare RUNCMD routing parameters
for different types of NetWare servers.

Table 3-2
Command Routing Parameter Settings
-----------------------------------------------------------------
Destination      Parameter Setting for     Parameter Setting for
Server Type      SP=<service_point_name>   SName=<server_name>
-----------------------------------------------------------------
End point        Enter the PU name of a    Enter the name of the
server           collection point server.  end point server.

Collection       Enter the PU name of the  Enter the name of the
point server     collection point server   collection point server
or standalone    or the standalone server. or the standalone
server                                     server.
-----------------------------------------------------------------


Command Security
----------------

The format for the command security portion of a NetWare RUNCMD is

[OP=<userid>]

This command parameter is optional when the NetView security option
is disabled on the destination server.

When the security feature is enabled on the destination NetWare
server, you must include this parameter and replace the <userid>
variable with a valid NetWare user ID.  If your NetWare user ID
has been designated as a file server console operator, you are 
restricted to sending the NetWare QUERY commands, which request
information from the file server.  If your NetWare user ID has
supervisor-equivalent privileges, you can use all the commands 
supported by the server.

								 3-2
IMPORTANT:  When NetView security is enabled at the NetWare server,
a RUNCMD 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.

The command security feature is always enabled on NMA for NetView
servers.  (You must provide a user ID.) On NetWare for SAA
servers, the NetWare administrator can enable or disable this
feature.


Server Command Parameters
-------------------------

The format of the server command parameters portion of a NetWare
RUNCMD is

<action> <resource> <attribute_parameter>
  <resource_qualifier> <command_qualifier>
  
Table 3-3 lists and describes each of the server command
parameters for NetWare for SAA and NMA for NetView servers.

Table 3-3 
Server Command Parameters
-----------------------------------------------------------------
Parameter           Description
-----------------------------------------------------------------
action              Replace the action variable with one of the
		    following command actions:

		    o  Add

		    o  Broadcast

		    o  Disable

		    o  Down

		    o  Enable

		    o  Get

		    o  Load

		    o  Query

		    o  Remove

		    o  Set

		    o  Unload



								 3-3
Table 3-3 (continued)
Server Command Parameters
-----------------------------------------------------------------
Parameter           Description
-----------------------------------------------------------------
action              The first table under "Command Tables," later in
(continued)         this chapter, alphabetically lists the server
		    command parameters according to the action
		    parameter. "NetWare Command Descriptions,"
		    later in this chapter, describes the function and
		    format of each group of server command parameters.

resource            The resource parameters specifies the server
		    component that the command action affects.  Valid
		    command resources include

		    o  Communication service (CS)

		    o  Directory

		    o  File

		    o  IPX

		    o  NLM

		    o  Server

		    o  SPX

		    o  TTS

		    o  User

		    o  Volume

		    The second table uner "Command Tables," later in
		    this chapter, alphabetically lists the server
		    command parameters according to the resource
		    parameter.  "NetWare Command Descriptions," later
		    in this chapter, describes the function and format
		    of each group of server command parameters.

attribute_          The attribute parameter variable further
parameter           defines the action to be taken on the resource.
		    This parameter is not required for all
		    commands.

		    The tables under "Command Tables" and "Command
		    Descriptions" in this chapter list the commands
		    you can send to NetView.  If a table lists one
		    or more attribute parameters for a single
		    command, you must enter at least one or more
		    attribute parameter before sending the command.
		    You may include multiple attribute parameters
		   in the same command.
								 3-4
Table 3-3 (continued)
Server Command Parameters
-----------------------------------------------------------------
Parameter           Description
-----------------------------------------------------------------
resource_           The resource_qualifier variable further defines
qualifier           the resource to receive the action. This
		    parameter is not required for all commands.

		    The tables under "Command Tables" and "Command
		    Descriptions" in this chapter list the commands
		    you can send to NetView. If the resource
		    qualifier for a command is not enclosed in
		    brackets, you must enter the resource qualifier.

command_            The command_qualifier variable further defines
qualifier           the action to be taken on the resource. This
		    parameter is not required for all commands.

		    The tables under "Command Tables" and "Command
		    Descriptions" in this chapter list the commands
		    you can send to NetView. If the command
		    qualifier for a command is not enclosed in
		    brackets, you must enter the command qualifier.

------------------------------------------------------------------

Command Example
---------------

The following is a sample RUNCMD command for a NetWare server:

   RUNCMD SP=NWSAA1, APPL=NETWARE,
   SName=Sales OP=JSmith Query User
     DiskSpaceLeft UserName=jbowman
   VolName=pubs
    
The command routing parameters define the PU name of a NetWare
for SAA server (NWSAA1), the application name (NetWare) of the
service, and the destination server name (Sales).

The JSmith variable represents the NetWare ID of the NetView
operator.

The server command parameters in the RUNCMD operate as follows:

o  The QUERY keyword represents the action.

o  The USER keyword indicates the resource to be queried.

o  The DISKSPACELEFT (disk space left) attribute parameter
   defines what user information the query will return.
   
o  The jbowman variable in the USERNAME resource qualifier
   names the user for which the command will retrieve information.
   
o  The pubs variable in the VOLNAME command qualifier identifies
   the volume for which the command will retrieve information.
								 3-5
The following command is an example of a command with multiple
attribute parameters.

   RUNCMD SP=NWSAA1, APPL=NetWare,
   SName=Sales OP=JSmith Query Server Date Time
   
In this example, both DATE and TIME are attribute parameters
for the QUERY SERVER command.  When this command is sent, 
NetWare returns the date and time for the specified server.


COMMAND TABLES

This section lists the server command parameters for NetWare
v3.1x and NetWare v4.0 servers.  Table 3-4 lists the server 
command parameters according to the action being performed.
Table 3-5 lists the server command parameters according to the 
resource on which the action is being performed (for example, a
file or directory).

The command tables use the following conventions:

o  When the phrase (v1.3 & later) appears in the Action column,
   the command and all its parameters can be used only with
   NetWare for SAA v1.3 and later and NMA for NetView v1.3 and
   later.
   
o  When the phrase (v1.3 & later) appears adjacent to a single
   attribute parameter or qualifier, the phrase indicates that
   parameter or qualifier can be used only with v1.3-and-later
   servers.  Unmarked parameters and qualifiers may be used with 
   v1.2-and-later servers.
   
o  When the phrase (NetWare v4.0 & later) appears in the Action
   column, the command and all its parameters can be used only 
   with NetWare for SAA servers that use NetWare v4.0 and later.
   These commands do not work with servers that use NetWare 
   v3.1x.
   
IMPORTANT:  These tables list the server command parameters for 
each command you can sent to NetWare.  These commands should
always be preceded with the following command routing and
command security parameters:   


   RUNCMD SP=<service_point_name>, 
     APPL=NETWARE SName=<server_name> OP=<userid> 









								 3-6
Table 3-4
NetWare Commands Sorted by Action
------------------------------------------------------------------
Action      Resource      Attribute       Resource       Command
			  Parameter       Qualifier      Qualifier
------------------------------------------------------------------
Add         Directory     Trustee         Path=<path>    UserName=
							 <uname>
							 Rights=
							 [ACEFMRSW]
	
Add         File          Trustee         Path=<path>    UserName=
							 <uname>
							 Rights=
							 [ACEFMRSW]
	
Add         Volume        Trustee         VolName=       UserName=
(v1.3 &                                   <vname>        <uname>
later)                                                   Rights=
							 [ACEFMRSW]

Broadcast   Server                                       Msg=
							 "<message>"
							 UserName=
							 <uname>
	
Disable     Server        Login

Disable     TTS

Down        Server                                       [Opts=
							 [01]]
	
Enable      Server        Login

Enable      TTS

Get         Server        Parm=
(v1.3 &                   "<parameter>"
later,
NetWare
v4.0 &
later)


Load        CS            CSName=<name>

Load        NLM           NLMName=<name>                  [Args=
							 "<argument>"]
	
Query       Directory                     Path=<path>


Query       Directory     Rights          Path=<path>    UserName=
							 <uname>
	  
Query       Directory     SpaceAllowed    Path=<path>
								 3-7
Table 3-4 (continued)
NetWare Commands Sorted by Action
------------------------------------------------------------------
Action      Resource      Attribute       Resource       Command
			  Parameter       Qualifier      Qualifier
------------------------------------------------------------------
Query       File                          Path=<path>    [UserName=
							 <uname>]
							 (v1.3 &
							 later)
Query       IPX           Version

Query       Server

Query       Server        Date
(v1.3 &                   Time
later)

Query       Server        InternetAddr

Query       Server        LoginStatus

Query       Server        NumOfVols

Query       Server        Volumes
(v1.3 &
later)

Query       SPX           Config

Query       SPX           Version

Query       TTS           Status

Query       User          DiskSpaceLeft   UserName=      VolName=
					  <uname>        <vname>
	
Query       User          DiskUsage       UserName=      VolName=
					  <uname>        <vname>
	
Query       Volume                        VolName=
					  <vname>
   
Query       Volume        DiskUsage       VolName=       UserName=
					  <vname>        <uname>
	  
Query       Volume        USpaceAllowed   VolName=       UserName=
					  <vname>        <uname>
	
Remove      Directory     Trustee         Path=<path>    UserName=
							 <uname>
	
Remove      File          Trustee         Path=<path>    UserName=
							 <uname>
	
								 3-8
Table 3-4 (continued)
NetWare Commands Sorted by Action
------------------------------------------------------------------
Action      Resource      Attribute       Resource       Command
			  Parameter       Qualifier      Qualifier
------------------------------------------------------------------
Remove      Volume        Trustee         VolName=       UserName=
					  <vname>        <uname>
	
Set         Directory     ADate=<date>    Path=<path>
			  ArDate=<date>
			  ArTime=<time>
			  CDate=<date>
			  CTime=<time>
			  Owner=<name>
			  UDate=<date>
			  UTime=<time>

Set         Directory     SpaceAllowed    Path=<path>
			  =space

Set         File          ADate=<date>    Path=<path>
			  ArDate=<date>
			  ArTime=<time>
			  CDate=<date>
			  CTime=<time>
			  Owner=<name>
			  UDate=<date>
			  UTime=<time>

Set         Server        Date=<date>
(v1.3 &                   Time=<time>
later)

Set         Server        Parm=           Value=
(v1.3 &                   "<parameter>"   <value>
later,
NetWare
v4.0 &
later)

Set         Volume        USpaceAllowed=  VolName=       UserName=
			  space           <vname>        <uname>
	  
Set         Volume        NoRestriction   VolName=       UserName=
(v1.3 &                   space           <vname>        <uname>
later)

UnLoad      CS            CSName=<name>

UnLoad      NLM           NLMName=<name>
-----------------------------------------------------------------




								 3-9
Table 3-5
NetWare Commands Sorted by Resource
------------------------------------------------------------------
Action      Resource      Attribute       Resource       Command
			  Parameter       Qualifier      Qualifier
------------------------------------------------------------------
Load        CS            CSName=<name>

Query       CS            Version
(v1.3 &
later)

UnLoad      CS            CSName=<name>

Add         Directory     Trustee         Path=<path>    UserName=
							 <uname>
							 Rights=
							 [ACEFMRSW]
	   
Query       Directory                     Path=<path>

Query       Directory     Rights          Path=<path>    UserName=
							 <uname>
	 

Query       Directory     SpaceAllowed    Path=path
								
Remove      Directory     Trustee         Path=<path>    UserName=
							 <uname>
	    
Set         Directory     ADate=<date>    Path=<path>
			  ArDate=<date>
			  ArTime=<time>
			  CDate=<date>
			  CTime=<time>
			  Owner=<name>
			  UDate=<date>
			  UTime=<time>

Set         Directory     SpaceAllowed    Path=<path>
			  =space
	  
Add         File          Trustee         Path=<path>    UserName=
							 <uname>
							 Rights=
							 [ACEFMRSW]
	
Query       File                          Path=<path>

Remove      File          Trustee         Path=<path>    UserName=
							 <uname>





								 3-10
Table 3-5 (continued)
NetWare Commands Sorted by Resource
------------------------------------------------------------------
Action      Resource      Attribute       Resource       Command
			  Parameter       Qualifier      Qualifier
------------------------------------------------------------------
Set         File          ADate=<date>    Path=<path>
			  ArDate=<date>
			  ArTime=<time>
			  CDate=<date>
			  CTime=<time>
			  Owner=<name>
			  UDate=<date>
			  UTime=<time>

       
Query       IPX           Version

Load        NLM           NLMName=<name>                 [Args=
							 "<argument>"]
	   
UnLoad      NLM           NLMName=<name>

Broadcast   Server                                       Msg=
							 "<message>"
							 [UserName=
							 <uname>]
	 
Disable     Server        Login

Down        Server                                       [Opts=
							     [01]]
	 
Enable      Server        Login

Get         Server        Parm=
(v1.3 &                   "<parameter>"
later,
NetWare
v4.0 &
later)

Query       Server

Query       Server        Date
(v1.3 &                   Time
later)

Query       Server        InternetAddr

Query       Server        LoginStatus

Query       Server        NumOfVols

Query       Server        Volumes
(v1.3 &                   
later)
								 3-11
Table 3-5 (continued)
NetWare Commands Sorted by Resource
------------------------------------------------------------------
Action      Resource      Attribute       Resource       Command
			  Parameter       Qualifier      Qualifier
------------------------------------------------------------------
Query       SPX           Config

Query       SPX           Version

Disable     TTS

Enable      TTS

Query       TTS           Status

Query       User          DiskSpaceLeft   UserName=     VolName=
					  <uname>       <vname>
	
Query       User          DiskUsage       UserName=     VolName=
					  <uname>       <vname>
	
Add         Volume        Trustee         VolName=      UserName=
(v1.3 &                                   <vname>       <uname>
later)                                                  Rights=
							[ACEFMRSW]

Query       Volume                        VolName=
					  <vname>
	
Query       Volume        DiskUsage       VolName       UserName=
					  =<vname>      <uname>
	
Query       Volume        USpaceAllowed   VolName=      UserName=
					  <vname>       <uname>
	
Remove      Volume        Trustee         VolName=      UserName=
					  <vname>       <uname>
	
Set         Volume        USpaceAllowed=  VolName=      UserName=
			  space           <vname>       <uname>
			  
Set         Volume        NoRestriction   VolName=      UserName=
(v1.3 &                                   <vname>       <uname>
later)
-----------------------------------------------------------------










								 3-12
NETWARE COMMAND DESCRIPTIONS

This section describes the function and the server command
parameters for each command you can send to NetWare.  The server
command parameters in each command should always be preceded with
the following command routing and command security parameters:

  RUNCMD SP=<service_point_name>, APPL=NETWARE
    SName=<server_name> [OP=<userid>]

Many command descriptions include tables that use the following
conventions:

o  When the phrase (v1.3 & later) appears in the Action column,
   the command and all its parameters can be used only with
   NetWare for SAA v1.3 and later and NMA for NetView v1.3 and
   later.
   
o  When the phrase (v1.3 & later) appears adjacent to a single
   attribute parameter or qualifier, the phrase indicates that
   parameter or qualifier can be used only with v1.3-and-later
   servers.  Unmarked parameters and qualifiers may be used with 
   v1.2-and-later servers.
   
o  When the phrase (NetWare v4.0 & later) appears in the Action
   column, the command and all its parameters can be used only 
   with NetWare for SAA servers that use NetWare v4.0 and later.
   These commands do not work with servers that use NetWare 
   v3.1x.
   
ADD VOLUME, DIRECTORY, or FILE TRUSTEE
--------------------------------------
The ADD commands allow you to add a trustee to a volume, directory 
or file on a NetWare server. A trustee is a NetWare user that is
entitled to use the volume, directory, or file. Table 3-6 shows the 
server command parameters for each ADD command.

Table 3-6
NetWare ADD Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource       Command
			  Parameter      Qualifier      Qualifier
-----------------------------------------------------------------
Add         Directory     Trustee        Path=<path>    UserName=
							<uname>
							Rights=
							[ACEFMRSW]
	    
Add         File          Trustee        Path=<path>     UserName=
							<uname>
							Rights=
							[ACEFMRSW]

Add         Volume        Trustee        Path=<path>    UserName=
(v1.3 &                                                 <uname>
later)                                                  Rights=
							[ACEFMRSW]
----------------------------------------------------------------
								 3-13
The <path> variable specifies the NetWare directory path to the
volume, directory, or file. The path may include the volume,
directory, subdirectory, and filename.  For example:

  Volume:MyDir\MySubDir\MyFile.txt

The <uname> variable specifies the name of the user that will be
allowed access to the volume, directory or file.
							      
The Rights= command qualifier specifies how the user will be able
to use the volume, directory, or file. The Rights= command qualifier 
must be followed by one or more of the letters shown in Table 3-7. 


Table 3-7
NetWare Rights
-----------------------------------------------------------------
Rights           Description
-----------------------------------------------------------------
A                Access Control right allows users to modify
		 trustee assignments and Inherited Rights Masks.
    
C                Create right allows users to create files and 
		 subdirectories.
     
E                Erase right allows users to delete files and 
		 subdirectories.
     
F                File Scan right allows users to see files.

M                Modify right allows users to change directory and
		 file attributes and to rename subdirectories and
		 files.
     
R                Read right allows users to open and read files.

S                Supervisory right grants all rights to the
		 directory or file.
   
W                Write right allows users to write to files.
-----------------------------------------------------------------

When you enter the rights letters, enter them according to the
following rules:

o  The letters may be entered in any sequence.

o  The letters you type may be uppercase or lowercase letters.

o  Do not enter spaces before, between, or after the letters.

o  To assign all rights, enter ALL after the Rights= command
   qualifier.  You can enter ALL in any combination of uppercase
   and lowercase letters.


								 3-14
NOTE:  The Rights command qualifier simultaneously defines all new
rights for the directory, file, or volume.  To add rights to a 
directory, file or volume, you must include the letters for the 
new rights and the letters for all existing rights that are to be
retained.  To review the rights assigned to a directory or file,
use the QUERY DIRECTORY RIGHTS or QUERY FILE RIGHTS command.  For 
more information on path or NetWare rights, see "NetWare v3.1x
Concepts" or "NetWare v4.0 Concepts."


BROADCAST
---------

The BROADCAST command sends a message to workstation users that are
connected to the destination NetWare server.  You can broadcast a 
message to one user or to all users.  Consider using this command to 
warn users before shutting down a server.

The BROADCAST command requires the following parameters:

   Broadcast Server Msg="<message>" 
     UserName=<uname>

When sending commands replace the <message> variable with the message 
you want to send (the quotation marks are required).

To send a message to all workstation users that are currently logged
in, do one of the following:

o  Send the command without the UserName=<uname> command qualifier.

o  Send the command with the UserName=<uname> command qualifier
   and replace the <uname> variable with ALL (UserName=ALL).
   
To send a message to one or more users, send the command with a
UserName=<uname> command qualifier for each user.  For example:

  Broadcast Server Msg="Server is going down in 5 minutes."
    [UserName=jbowman] [UserName=vjang]
    
The <uname> variable specifies the NetWare user ID of the user that 
will receive the message.



DISABLE SERVER LOGIN or TTS
---------------------------

The DISABLE commands can be used to disable server login by
workstations or to disable the TTS.

Consider disabling server login when there are performance problems
with the server. Disabling server login prevents additional
workstations from logging in. Workstations that are already logged
in remain logged in.

								 3-15
Novell recommends that you do not disable TTS.  TTS protects 
database applications from corruption caused when a server, 
workstation, or network failure interrupts a database transaction. 
TTS protects the database by backing out incomplete
transactions that 
result from a failure in a network component. 

Table 3-8 shows the format for the Disable Server Login and Disable
TTS commands.

Table 3-8
NetWare Disable Commands
-----------------------------------------------------------------
Action       Resource     Attribute     Resource        Command
			  Parameter     Qualifier       Qualifier
-----------------------------------------------------------------
Disable      Server       Login

Disable      TTS
-----------------------------------------------------------------


DOWN SERVER
-----------

The DOWN SERVER command brings down the NetWare server. This command 
uses the following parameters

   Down Server [Opts=[10]]
   
When the DOWN SERVER command is entered without the [Opts=[01]]
command qualifier, the server shuts down immediately, regardless of
the current state of server files.  If files are open, changes made
to those files may be lost.

NOTE:  The server may shut down before it responds to the DOWN
SERVER command. When this happens, NCCF may display a command
timeout message.

When the DOWN SERVER command is entered with the [Opts=[10]], you 
must choose option 1 or option 0 (zero).  Option 1 (Opts=1) shuts 
down the server immediately, regardless of the current state of 
server files.  Option 0 (Opts=0) shuts down the server only when 
no server files are open; if any server files are open, the server
is not shut down.

WARNING:  When you bring down a server, the server is instantly
unavailable to all users and to the NetWare administrator.  Before
bringing down a server, consider using the BROADCAST command warn
all users.  also, you should warn the NetWare administrator before
bringing down a server.





								 3-16
ENABLE SERVER LOGIN or TTS
--------------------------

The ENABLE commands can be used to enable server login by
workstations or to enable TTS.

TTS protects database applications from corruption caused when a
server, workstation, or network failure interrupts a database
transaction. TTS protects the database by backing out incomplete
transactions that result from a failure in a network component.

Table 3-9 shows the parameters required for the ENABLE commands.

Table 3-9
NetWare ENABLE Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource       Command
			  Parameter      Qualifier      Qualifier
-----------------------------------------------------------------
Enable      Server        Login

Enable      TTS
-----------------------------------------------------------------


GET SERVER
----------

The GET SERVER command allows you to display the value of MOST
(not all) server control parameters that can be set with the NetWare
SET command.Table 3-10 shows the syntax of the GET SERVER
command.

Table 3-10
NetWare GET SERVER Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource       Command
			  Parameter      Qualifier      Qualifier
-----------------------------------------------------------------
Get         Server        Parm=
(v1.3 &                   "<parameter>"
later, 
NetWare
v4.0 &
later)
-----------------------------------------------------------------


The GET SERVER command operates only on NetWare v4.x servers. To 
view one of the server parameters, enter the command and replace 
the parameter variable with one of the parameters supported by the 
NetWare 4.x SET command. 



								 3-17
You can enter a parameter name in uppercase or lowercase letters. 
You must enter a single space character between each pair of words 
in the parameter name, and you must enclose the parameter name in 
quotation marks. Do not enter additional space characters before or 
after the parameter name.

For a listing of parameters suppported by the SET command, see the 
NetWare 4.x Utilities Reference.

IMPORTANT: Not all parameters supported by the NetWare 4.x SET command 
are supported by the NetView GET SERVER command. See "Unsupported SET 
parameters" for a listing of SET parameters not supported by the GET 
SERVER command.

Unsupported SET Parameters
--------------------------

The following NetWare SET parameters are not supported by the NetView 
GET SERVER command:

o  Daylight Savings Time Offset
o  Delay Before First Watchdog Packet
o  Delay Between Watchdog Packets
o  Directory Cache Allocation Wait Time
o  Directory Cache Buffer NonReferenced Delay
o  Dirty Directory Cache Delay Time
o  File Delete Wait Time
o  Garbage Collection Interval
o  Minimum File Delete Wait Time
o  New Packet Receive Buffer Wait Time
o  New Service Process Wait Time
o  Psuedo Preemption Time
o  TIMESYNC Maximum Offset
o  TIMESYNC Polling Interval
o  TIMESYNC Time Adjustment
o  TTS Backout File Truncation Wait Time
o  TTS Unwritten Cache Wait Time
o  Turbo FAT Re-Use Wait Time


LOAD CS or NLM
--------------

The LOAD commands load a communication service NLM. Table 3-11 lists 
the parameters used by the LOAD commands.

Table 3-11
NetWare LOAD Commands
-----------------------------------------------------------------
Action      Resource     Attribute      Resource       Command
			 Parameter      Qualifier      Qualifier
-----------------------------------------------------------------
Load        CS           CSName=<name>

Load        NLM          NLMName=<name>                [Args=
						       "<argument>"]
-----------------------------------------------------------------
								 3-18
The <name> variable must be replaced with the name of the 
communication service or NLM. When loading an NLM, you may use the 
optional[Args="<argument>"] command qualifier to include any arguments 
or parameter that are required when you are loading the command from
the NetWare console.  These arguments or parameters must replace the
<argument> variable and be enclosed in quotation marks.  For more
information on LOAD NLM parameters, refer to the NetWare documentation
for the NLM.

WARNING:  If you send a LOAD command with an incomplete set of
parameters for an NLM or communication service, a prompt for the
missing parameters appears on the server console. The NLM or
communication service does not continue execution until the missing
information is entered at the server console. You are not notified
about the missing parameters, and the NLM or communication service
may appear to be operating when it is not.
								 
NOTE:  When loading an NLM with arguments, separate the arguments
with space characters and enclose the group of arguments with
quotation marks.


QUERY CS VERSION
----------------

The QUERY CS VERSION command returns the version level of the 
communication executive.  This command uses the following syntax:

  Query CS Version
  
IMPORTANT:  The QUERY CS VERSION command operates only with 
NetWare for SAA v1.3 or later.


QUERY DIRECTORY
---------------

As shown in Table 3-12, the QUERY DIRECTORY command has three forms.

Table 3-12
NetWare Query Directory Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Query       Directory                    Path=<path>

Query       Directory     Rights         Path=<path>    UserName=
							<uname>
	 
Query       Directory     SpaceAllowed   Path=<path>
-----------------------------------------------------------------



								 3-19
When the QUERY DIRECTORY command is used without an attribute
parameter, the command returns the following information:

o  Volume where the directory resides

o  Directory owner

o  Inherited rights mask

o  Creation date and time

o  Archive date and time


WARNING: The QUERY DIRECTORY command returns invalid values for 
the following parameters: Access date and time, Modification date 
and time, and Owner rights. Ignore these values if they are displayed.

The QUERY DIRECTORY RIGHTS command returns the rights assigned to
the specified NetWare user for the specified directory. The rights
are listed in Table 3-7.

The QUERY DIRECTORY SPACEALLOWED command returns the amount of
available space in the specified directory and the amount of space
reserved for the directory.

Use the <path> variable to specify the directory for which you want 
information. When using the QUERY DIRECTORY RIGHTS command, use the
<uname> variable to specify the user for which you want information.

QUERY FILE
----------
As shown in Table 3-13, the QUERY FILE command has two forms.

Table 3-13
NetWare Query Server Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Query       File                         Path=<path>   [UserName=
						       <uname>]
						       (v1.3 &
						       later)

Query       File          Rights         Path=<path>   UserName=
						       <uname>
-----------------------------------------------------------------








								 3-20
When the QUERY FILE command does not include an attribute parameter,
the command returns the following information:

o  Attributes

o  Volume where the file resides

o  Mode

o  Size

o  Owner
							      
o  Inherited rights mask

o  Access date and time

o  Modification date and time

o  Creation date and time

o  Name space values

o  User rights if a user name is included.  The user name is optional

WARNING:  The QUERY FILE command sometimes also returns archive dates
and times.  These values are invalid.  Ignore these values if they 
are displayed.  Sometimes Attributes and Inherited Rights mask data 
may not display.

When the QUERY FILE command includes the Rights attribute parameter,
the command returns only the rights assigned to the specified user.

Use the <path> variable to specify the file for which you want
information.  the <uname> variable specifies the user whose file
rights you want to view.

The USERNAME command qualifier is optional when the QUERY FILE
command is entered without the Rights attribute parameter.  To 
display the file information and the rights for a specific user,
include the USERNAME command qualifier and replace the <uname>
variable with the users NetWare ID.


QUERY IPX VERSION
-----------------

The QUERY IPX command returns the IPX version information. This 
command uses the following syntax:

   Query IPX Version




								 3-21
QUERY SERVER
------------

Table 3-14 lists the parameters used by each of the QUERY SERVER
commands.

Table 3-14
NetWare QUERY SERVER Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Query       Server

Query       Server        Date      
(v1.3 &                   Time
later)

Query       Server        InternetAddr

Query       Server        LoginStatus

Query       Server        NumOfVols

Query       Server        Volumes
(v1.3 &
later)

-----------------------------------------------------------------

When the QUERY SERVER command is used without an attribute
parameter, the command returns the following information:

o  NetWare version number

o  Maximum number of connections supported

o  Number of connections in use

o  System Fault Tolerance (SFT) Level

o  TTS Level

o  Maximum number of volumes supported

o  Security restriction level

When the QUERY SERVER command includes an attribute parameter,
NetWare returns the information requested by the parameter
(see Table 3-15).






								 3-22
Table 3-15
QUERY SERVER Attribute Parameters
-----------------------------------------------------------------
Attribute        Information Sent
Parameter        to NetView 
-----------------------------------------------------------------
Date             The server date.

InternetAddr     The network and node addresses of the server.

LoginStatus      The server login status.  The status is either
		 enabled or disabled.
		 
NumOfVols        The number of server volumes.

Time             The server time.

Volumes          A list of the volumes mounted on the server.

-----------------------------------------------------------------


QUERY SPX
---------

As shown in Table 3-16, the QUERY SPX command has two forms.

Table 3-16
NetWare QUERY SPX Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Query       SPX           Config

Query       SPX           Version
-----------------------------------------------------------------
								 
The QUERY SPX CONFIG command returns the maximum number of SPX
connections supported and the number of available connections. The
QUERY SPX VERSION command returns the SPX version number.


QUERY TTS
---------

The QUERY TTS command returns the status of the TTS, which is either 
enabled or disabled. TTS protects database applications from 
corruption caused when a server, workstation, or network failure
interrupts a database transaction. TTS protects the database by 
backing out incomplete transactions that result from a failure in a 
network component.  The format for this command is

  Query TTS Status



								 3-23
QUERY USER
----------

The QUERY USER command has two forms, which are listed in 
Table 3-17.

Table 3-17
NetWare QUERY USER Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Query       User          DiskSpaceLeft  UserName=     VolName=
					 <uname>       <vname>
	 
Query       User          DiskUsage      UserName=     VolName=
					 <uname>       <vname>
-----------------------------------------------------------------

The QUERY USER DISKSPACELEFT command returns the amount of
remaining volume disk space allocated to the user. The QUERY USER
DISKUSAGE command returns the number of directories, files, and
blocks being used by a user.

The <uname> variable specifies the user for which you want
information. The <vname> variable specifies the volume for which you
want the information.


QUERY VOLUME
------------

Table 3-18 lists the three forms of the QUERY VOLUME command.

Table 3-18
NetWare QUERY VOLUME Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Query       Volume                       VolName=
					 <vname>
	   
Query       Volume        DiskUsage      VolName       UserName=
					 =<vname>        <uname>
 
Query       Volume        USpaceAllowed  VolName=      UserName=
					 <vname>         <uname>
-----------------------------------------------------------------







								 3-24
When used without an attribute parameter, the Query Volume command
returns

o  Volume number

o  Number of sectors per block

o  Total number of blocks

o  Starting block number

o  Total available blocks

o  Total directory slots

o  Available directory slots

o  Maximum directory slots used

o  Volume status (mounted/hashing/removable)

The QUERY VOLUME DISKUSAGE command returns the number of
directories,
files, and blocks being used by a user. The QUERY VOLUME USPACEALLOWED
command returns the amount of space allowed to the specified user.

The <vname> variable specifies the volume for which you want
information; the <uname> variable specifies the user for which you
want information.


REMOVE VOLUME, DIRECTORY, or FILE TRUSTEE
-----------------------------------------

The REMOVE commands allow you to remove a trustee from a volume, 
directory,
or file on a NetWare server. A trustee is a NetWare user
that is entitled to use the volume, directory, or file. 

Table 3-19 shows the
parameter used by the REMOVE commands.

Table 3-19
NetWare REMOVE Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Remove      Directory     Trustee        Path=<path>   UserName=
						       <uname>
	  
Remove      File          Trustee        Path=<path>   UserName=
						       <uname>
	  
Remove      Volume       Trustee         VolName       UserName=
					 =<vname>      <uname>
-----------------------------------------------------------------
								 3-25
When using the REMOVE DIRECTORY TRUSTEE and REMOVE FILE TRUSTEE 
commands, the <path> variable specifies the NetWare directory path
to the directory or file from which the trustee will be removed.
The path may include the file server, volume, directory,
subdirectory, or filename. For example:

  Volume:MyDir\MySubDir\MyFile.txt

For more information on specifying a
directory or file path, see
"NetWare v3.1x Concepts"
or "NetWare 4.0 Concepts."

The <uname> variable specifies the name of the user that will be
denied access to the file or directory. 

When using the Remove Volume Trustee command, the <vname> variable
specifies the volume from which the trustee will be removed.


SET DIRECTORY
-------------

The SET DIRECTORY commands allow you to set one or more properties
of a directory with a single command.  Table 3-20 shows the parameters
used by the SET DIRECTORY commands.

Table 3-20
NetWare SET DIRECTORY Commands
----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
Set         Directory     ADate=<date>   Path=<path>
			  ArDate=<date>
			  ArTime=<time>
			  CDate=<date>
			  CTime=<time>
			  Owner=<name>
			  UDate=<date>
			  UTime=<time>

Set         Directory     SpaceAllowed   Path=<path>
			  =<space>
-----------------------------------------------------------------

The attribute parameters in Table 3-20 define the directory
properties to be set.  Table 3-21 shows the properties that each
attribute parameter controls.






								 3-26
Table 3-21
SET DIRECTORY Attribute Parameters
-----------------------------------------------------------------
Attribute        Property
Parameter        Defined 
-----------------------------------------------------------------
ADate=<date>     Directory access date. Replace the <date> 
		 variable with the new access date for the 
		 directory.
		 
ArDate=<date>    Directory archive date.  Replace the <date> 
		 variable with the new archive date for the 
		 directory.

ArTime=<time>    Directory archive time.  Replace the <time> 
		 variable with the new archive time for the 
		 directory.

CDate=<date>     Directory creation date.  Replace the <date> 
		 variable with the new creation date for the 
		 directory. 
		 
CDate=<date>     Directory creation time.  Replace the <time>
		 variable with the new creation time for the 
		 directory.

Owner=<name>     Directory owner.  Replace the <name> variable
		 with the user ID for the new owner of the  
		 directory.

UDate=<date>     Directory update date.  Replace the <date> 
		 variable with the new update date for the 
		 directory.

UTime=<time>     Directory update time.  Replace the <time> 
		 variable with the new update time for the 
		 directory.

SpaceAllowed=    The Maximum space allowed for all files and 
<space>          subdirectories within the directory.  Replace
		 the <space> variable with a number that represents
		 the maximum size of the directory.  You cannot
		 specify unlimited space; you must specify a value.

-----------------------------------------------------------------

The <path> variable identifies the directory to be modified.


SET FILE
--------

The SET FILE command allows you to set one or more properties of a 
files with a single command.  Table 3-22 shows the parameters used
by the SET FILE command.
								 3-27
Table 3-22
NetWare SET FILE Commands
-----------------------------------------------------------------
Action      Resource      Attribute       Resource      Command
			  Parameter       Qualifier     Qualifier
-----------------------------------------------------------------
Set         File          ADate=<date>    Path=<path>
			  ArDate=<date>
			  ArTime=<time>
			  CDate=<date>
			  CTime=<time>
			  Owner=<name>
			  UDate=<date>
			  UTime=<time>

----------------------------------------------------------------

The attribute parameters in Table 3-22 defines the directory
properties to be set.  Table 3-23 shows the properties that each
attribute parameter controls.
								 
Table 3-23
SET FILE Attribute Parameters
-----------------------------------------------------------------
Attribute        Property
Parameter        Defined 
-----------------------------------------------------------------
ADate=<date>     File access date. Replace the <date> variable
		 with the new access date for the file.
		 
ArDate=<date>    File archive date.  Replace the <date> variable
		 with the new archive date for the file.

ArTime=<time>    File archive time.  Replace the <time> variable
		 with the new archive time for the file.

CDate=<date>     File creation date.  Replace the <date> variable
		 with the new creathion date for the file. 
		 
CDate=<date>     File creation time.  Replace the <time> variable
		 with the new creation time for the file.

Owner=<name>     File owner.  Replace the <name> variable with 
		 the user ID for the new owner of the file. 

UDate=<date>     File update date.  Replace the <date> variable
		 with the new update date for the file.

UTime=<time>     File update time.  Replace the <time> variable
		 with the new update time for the file.

-----------------------------------------------------------------




								 3-28
The <path> variable identifies the directory path to the file you are
modifying. The <path> variable must include the name of the file.

SET SERVER
----------
The SET SERVER commands allow you to set one or more properties of 
a server with a single command.  It allows you to reset the value of
most (not all) server control parameters supported by the NetWare 4.x
SET command. Table 3-24 shows the parameters used by the SET SERVER 
commands.

Table 3-24
NetWare SET SERVER Commands
-----------------------------------------------------------------
Action      Resource      Attribute       Resource      Command
			  Parameter       Qualifier     Qualifier
-----------------------------------------------------------------
Set         Server        Date=<date>
(v1.3 &                   Time=<time>
later)

Set         Server        Parm=            Value=
(v1.3 &                   "<parameter>"    <value>
later,
NetWare
v4.0 &
later)
-----------------------------------------------------------------
		    
To set the server date, use the Date attribute parameter and replace
the <date> variable with the new date.  To set the server time, use
the Time attribute parameter and replace the <time> variable with
the new server time.

To set one of the server parameters, use the Parm attribute parameter 
and replace the parameter variable with one of the parameters supported 
by the NetWare SET command

The SET SERVER PARM command operates only with NetWare 4.x servers. 
If you need to adjust one of these parameters in a NetWare v3.1x server,
contact the NetWare administrator. The NetWare administrator can use 
the NetWare SET command to set all these parameters on NetWare 4.x servers.

You can enter a parameter name in uppercase or lowercase letters. You 
must enter a single space character between each pair of words in the 
parameter name, and you must enclose the parameter name in quotation marks. 
Do not enter additional space characters before or after the parameter name.

For a listing of parameters suppported by the SET command, see the 
NetWare 4.x Utilities Reference.

WARNING:  Not all parameters supported by the NetWare 4.x SET command 
are supported by the NetView SET SERVER command. See "Unsupported SET 
parameters" for a listing of SET parameters not supported by the SET SERVER 
command.
								 3-29
Unsupported SET Parameters
--------------------------

The following NetWare SET parameters are not supported by the NetView 
SET SERVER command:

o  Daylight Savings Time Offset
o  Delay Before First Watchdog Packet
o  Delay Between Watchdog Packets
o  Directory Cache Allocation Wait Time
o  Directory Cache Buffer NonReferenced Delay
o  Dirty Directory Cache Delay Time
o  File Delete Wait Time
o  Garbage Collection Interval
o  Minimum File Delete Wait Time
o  New Packet Receive Buffer Wait Time
o  New Service Process Wait Time
o  Psuedo Preemption Time
o  TIMESYNC Maximum Offset
o  TIMESYNC Polling Interval
o  TIMESYNC Time Adjustment
o  TTS Backout File Truncation Wait Time
o  TTS Unwritten Cache Wait Time
o  Turbo FAT Re-Use Wait Time

SET VOLUME
----------

As shown in Table 3-25, the SET VOLUME command has two forms.

Table 3-25
SET VOLUME Attribute Parameters
-----------------------------------------------------------------
Action      Resource      Attribute       Resource      Command
			  Parameter       Qualifier     Qualifier
-----------------------------------------------------------------
Set         Volume        USpaceAllowed   VolName=      UserName=
			  =space          <vname>       <uname>
			  
Set         Volume        NoRestriction   VolName=      UserName=
(v1.3 &                                   <vname>       <uname>
later)
-----------------------------------------------------------------

The SET VOLUME USPACEALLOWED command defines the total amount of
space that can be allocated to the specified user on the specified
volume.

The SET VOLUME NORESTRICTION command removes all restrictions on 
the amount of space the specified user on the specified volume.  
This command operates only with NetWare for SAA v1.3 or later and
NMA for NetView v1.3 or later.

The <space> variable defines the allocated space in kilobytes, while
the <vname> and <uname> variables define the volume and user to which
the command applies.

								 3-30
UNLOAD CS or NLM
----------------

This command unloads a communication service or NLM. Table 3-26 lists 
the parameters used by the UNLOAD CS and UNLOAD NLM commands.

Table 3-26
NetWare UNLOAD Commands
-----------------------------------------------------------------
Action      Resource      Attribute      Resource      Command
			  Parameter      Qualifier     Qualifier
-----------------------------------------------------------------
UnLoad      CS            CSName=<name>

UnLoad      NLM           NLMName=<name>
-----------------------------------------------------------------

The <name> variable must be replaced with the name of the
communication service or NLM to be unloaded.

WARNING:  If you send an UNLOAD command for an NLM or communication
service, the command will fail if the NLM or communication service
is exporting functions and symbols to another NLM or communication
service. If the UNLOAD command fails, a message appears on the
system console. You are not notified about the failure, and the NLM
or communication service may appear to be unloaded when it is not.






















								 3-31

