Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ nwcm(1M) — UnixWare 2.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought






       nwcm(1M)                                                    nwcm(1M)


       NAME
             nwcm - view and change NetWare configuration parameters

       SYNOPSIS
             nwcm [-CcFqx -d parameter -D folder -h parameter -H folder -f
             folder -L folder
             -r parameter -R folder -s parameter=value -t parameter=value
             -v parameter -V folder]

       DESCRIPTION
             The nwcm command lets you view and change various NetWare-
             related configuration parameters, including those associated
             with IPX/SPX, NUC, NVT, and SAP.

             The nwcm command maintains a database of these parameters and
             their associated values.  The database is divided into logical
             groups called folders (not analogous to the UnixWare Desktop
             concept of folders).

             See the subsection "nwcm Parameter Descriptions" for a list of
             folders and the parameters they contain.

          Options
             -c    Display the full path name of the configuration file.

             -C    Display the full path name of the configuration
                   directory. This is always the "basename" of the
                   configuration file.

             -d parameter
                   Display the description strings (or name of the
                   parameters in the current locale) for parameter from the
                   message catalog.

             -D folder
                   Display the description string (or name of the parameter
                   in the current locale) for all parameters in folder from
                   the message catalog.  Using folder 0 lists all
                   parameters in all folders.

             -f folder
                   Display the description string for folder from the
                   message catalog.  Using folder 0 lists all parameters in
                   all folders.




                           Copyright 1994 Novell, Inc.               Page 1













      nwcm(1M)                                                    nwcm(1M)


            -F    Display the number of folders.

            -h parameter
                  Display the help string for parameter from the message
                  catalog.

            -H folder
                  Display the help strings for all parameters in folder
                  from the message catalog.  Using folder 0 lists all
                  parameters in all folders.

            -L folder
                  List all of the parameters in the specified folder
                  (without displaying any parameter values).  Using folder
                  0 lists all parameters.

            -q    When setting or resetting parameter values, do not print
                  out the new value.

            -r parameter
                  Reset the value of parameter to its default value, as
                  specified in the configuration schema.

            -R folder
                  Resets the values for all parameters in the specified
                  folder to their default values, as specified in the
                  configuration schema.  Using a folder number 0 causes
                  all parameters to be reset to their default values.
                  (For script writers, a faster way of accomplishing this
                  task is to truncate the configuration file to zero
                  length.)

            -s parameter=value
                  Sets the parameter to the indicated value.

            -t param=value
                  Tests the indicated value to see if it is valid for the
                  named parameter.

            -v parameter
                  View the value of parameter param.

            -V folder
                  View the values of all parameters in folder.  Using a
                  folder number of 0 displays all parameters and their
                  values.


                          Copyright 1994 Novell, Inc.               Page 2













       nwcm(1M)                                                    nwcm(1M)


             -x    Remove from the configuration file all parameters
                   associated with packages no longer installed.

          Parameter Values
             If you use spaces before or after the equal sign in the -s or
             -t options, you must surround the entire parameter with
             quotes.  For example, the following two commands are both
             valid:

                         nwcm -s burst_mode_protocol=on
                         nwcm -s "burst_mode_protocol = on"

             The parameter descriptions below  list  some  parameters  with
             supported  values  of  on and off.  For these parameters, nwcm
             will also accept values of active and yes for on,  and  values
             of  inactive  and  no for off.  Regardless of the value use to
             set the parameter, current values  for  these  parameters  are
             always reported as on or off by nwcm.

          nwcm Parameter Descriptions
             The nwcm command maintains a database of parameters and
             values.  The parameters related to UnixWare are divided into
             folders according to these categories:

             Folder 1
                   General Server

             Folder 5
                   Miscellaneous

             Folder 6
                   Localization

             Folder 7
                   Internetwork Packet Exchange (IPX) and Sequenced Packet
                   Exchange (SPX)

             Folder 8
                   Service Advertising Protocol (SAP)

             Folder 11
                   Network Management (SNMP)

             Folder 13
                   nprinter(1M)



                           Copyright 1994 Novell, Inc.               Page 3













      nwcm(1M)                                                    nwcm(1M)


            Folder 14
                  Novell Virtual Terminal (NVT)

            Folder 16
                  NetWare Unix Client (NUC)

            Unused folder numbers are reserved for future use.  The
            following are detailed descriptions of the parameters found in
            each folder.

            General Server Parameters (Folder 1):
            _____________________________________________________________________________
           | binary_directory|  This parameter specifies the                            |
           |                 |  UnixWare path to the location of                        |
           |                 |  the NetWare executable files.                           |
           |                 |  Maximum length: 127 characters                          |
           |                 |  Default: /usr/sbin                                      |
           |_________________|__________________________________________________________|
           | log_directory   |  This parameter specifies the                            |
           |                 |  UnixWare directory where SAP and                        |
           |                 |  IPX logs are located.                                   |
           |                 |  Length: 127 characters                                  |
           |                 |  Default: /var/netware                                   |
           |_________________|__________________________________________________________|
           | server_name     |  This parameter controls the name                        |
           |                 |  by which all NetWare services                           |
           |                 |  (for example, SAP and NVT) are                          |
           |                 |  advertised on the network and                           |
           |                 |  must be unique from all other                           |
           |                 |  NetWare servers on the network.                         |
           |                 |  When UnixWare boots, the system                         |
           |                 |  sets server_name to the UnixWare                        |
           |                 |  node name (returned by uname                            |
           |                 |  -n).  To disable the automatic                          |
           |                 |  setting of this parameter, edit                         |
           |                 |  the boot script /etc/init.d/nw,                         |
           |                 |  commenting out the following two                        |
           |                 |  lines by placing a pound sign at                        |
           |                 |  the beginning of each line (as                          |
           |                 |  shown):                                                 |
           |                 |  # server_name="`uname -n`"                              |
           |                 |  # /usr/sbin/nwcm -s"server_name=$server_name" >/dev/null|
           |                 |  Note that server_name must be                           |
           |                 |  set for NetWare services to                             |
           |_________________|__________________________________________________________|



                          Copyright 1994 Novell, Inc.               Page 4













       nwcm(1M)                                                    nwcm(1M)


      |                 |        function properly.                                |
      |                 |        Length: 2 to 47 characters                        |
      |                 |        Default: Set by the NetWare                       |
      |                 |        initialization scripts.                           |
      |_________________|__________________________________________________________|

             Miscellaneous Parameters (Folder 5):
             _______________________________________________________
            | diagnostics         |  This parameter specifies      |
            |                     |  whether the diagnostics daemon|
            |                     |  (diagnostics_daemon) is       |
            |                     |  started by the NetWare        |
            |                     |  protocol stack daemon         |
            |                     |  [npsd(1M)].  It should be set |
            |                     |  to on if Novell NetWare for   |
            |                     |  UNIX is installed and running.|
            |                     |  Supported values: on, off     |
            |                     |  Default: off                  |
            |_____________________|________________________________|
            | diagnostics_daemon  |  This parameter specifies the  |
            |                     |  name of the diagnostics       |
            |                     |  daemon.                       |
            |                     |  Maximum length: 127           |
            |                     |  Default: "nwdiagd"            |
            |_____________________|________________________________|
            | diagnostics_log_file|  This parameter specifies the  |
            |                     |  name of the log file for      |
            |                     |  diagnostic messages. The      |
            |                     |  location of the log file is   |
            |                     |  log_directory (see General    |
            |                     |  Server Parameters).  To       |
            |                     |  disable the diagnostics daemon|
            |                     |  from logging messages to the  |
            |                     |  file, set this parameter to   |
            |                     |  "/dev/null."                  |
            |                     |  Maximum length: 127           |
            |                     |  Default: "diag.log"           |
            |_____________________|________________________________|

             Localization Parameters (Folder 6):








                           Copyright 1994 Novell, Inc.               Page 5













      nwcm(1M)                                                    nwcm(1M)


            __________________________________________________________
           | default_LANG   |  This parameter specifies the          |
           |                |  default locale for the system.        |
           |                |  Maximum Length: 127 characters        |
           |                |  Default: "C"                          |
           |________________|________________________________________|
           | default_NLSPATH|  This parameter specifies the          |
           |                |  default search path that is           |
           |                |  appended to the definition of         |
           |                |  the UNIX environment variable         |
           |                |  NSLPATH.  NLSPATH is used in the      |
           |                |  X/Open fashion to indicate the        |
           |                |  location, in the form of a            |
           |                |  search path, and naming               |
           |                |  convention associated with the        |
           |                |  message catalog files.  If            |
           |                |  default_NLSPATH is set to NULL        |
           |                |  (""), which is the default            |
           |                |  value, a search path is formed        |
           |                |  by using the UNIX environment         |
           |                |  variable NWBINDIR in the              |
           |                |  following fashion:                    |
           |                |  $NWBINDIR/nls/English/%N.cat,         |
           |                |  where %N.cat is the name of the       |
           |                |  catalog file.  If NWBINDIR is         |
           |                |  not set in the environment, then      |
           |                |  the value of the General Server       |
           |                |  (Folder 1) parameter                  |
           |                |  binary_directory will be used to      |
           |                |  form a search path in the             |
           |                |  following fashion:                    |
           |                |  <binary_directory>/nls/English/%N.cat.|
           |                |  Maximum Length: 127 characters        |
           |                |  Default: ""                           |
           |________________|________________________________________|

            IPX/SPX Parameters (Folder 7):
            _________________________________________________________
           | ipx_auto_discovery         |  This parameter controls  |
           |                            |  automatic discovery of   |
           |                            |  the server's address.    |
           |                            |  When set to on, automatic|
           |                            |  discovery of the network |
           |                            |  address for the server is|
           |____________________________|___________________________|



                          Copyright 1994 Novell, Inc.               Page 6













       nwcm(1M)                                                    nwcm(1M)


      |                            |        enabled. When set t| off,
      |                            |        automatic discovery|is
      |                            |        disabled.          |
      |                            |        Supported values: o|, off
      |                            |        Default: on        |
      |____________________________|___________________________|
      | ipx_internal_network       |  This parameter provides a|
      |                            |  single network address   |
      |                            |  for access from multiple |
      |                            |  lans. It specifies the   |
      |                            |  network address of the   |
      |                            |  internal network (LAN 0).|
      |                            |  A value needs to be set  |
      |                            |  only if multiple networks|
      |                            |  are configured on your   |
      |                            |  system.  This network    |
      |                            |  address must be unique   |
      |                            |  from all other assigned  |
      |                            |  network addresses on the |
      |                            |  IPX internetwork.        |
      |                            |  Supported values: 1 to   |
      |                            |  0xfffffffe               |
      |                            |  Default: 0               |
      |____________________________|___________________________|
      | ipx_max_hops               |  This parameter is the    |
      |                            |  maximum number of routers|
      |                            |  that can be traversed    |
      |                            |  while searching for a    |
      |                            |  destination network. When|
      |                            |  this limit is reached,   |
      |                            |  the packet is discarded. |
      |                            |  Supported values: 2 to   |
      |                            |  126                      |
      |                            |  Default: 16              |
      |____________________________|___________________________|
      | ipx_start_at_boot          |  This parameters controls |
      |                            |  whether IPX is started at|
      |                            |  boot time.  If set to on,|
      |                            |  IPX automatically starts |
      |                            |  at boot time.  If set to |
      |                            |  off, IPX does not start  |
      |                            |  at boot time.            |
      |                            |  Supported values: on, off|
      |                            |  Default: on              |
      |____________________________|___________________________|



                           Copyright 1994 Novell, Inc.               Page 7













      nwcm(1M)                                                    nwcm(1M)


     |____________________________|___________________________|
     | lan_x_adapter              |  This parameter specifies |
     |                            |  the name of the device   |
     |                            |  driver for the network   |
     |                            |  board. The "x" in the    |
     |                            |  parameter indicates by   |
     |                            |  number which LAN you are |
     |                            |  configuring.             |
     |                            |  Valid values are the path|
     |                            |  and filename of a valid  |
     |                            |  LAN driver.              |
     |                            |  Maximum length: 127      |
     |                            |  Default: ""              |
     |____________________________|___________________________|
     | lan_x_adapter_type         |  This parameter specifies |
     |                            |  the interface between the|
     |                            |  device driver and IPX by |
     |                            |  indicating the cabling   |
     |                            |  topology (Ethernet or    |
     |                            |  token ring) and the      |
     |                            |  driver interface (DLPI or|
     |                            |  LLI).  The "x" in the    |
     |                            |  parameter indicates by   |
     |                            |  number which LAN you are |
     |                            |  configuring.             |
     |                            |  Supported values:        |
     |                            |  ETHERNET_DLPI,           |
     |                            |  ETHERNET_LLI,            |
     |                            |  TOKENRING_DLPI           |
     |                            |  Default: "ETHERNET_DLPI" |
     |____________________________|___________________________|
     | lan_x_frame_type           |  This parameter specifies |
     |                            |  the frame type.  The "x" |
     |                            |  in the parameter         |
     |                            |  indicates by number which|
     |                            |  LAN you are configuring. |
     |                            |  Supported Values:        |
     |                            |  ETHERNET_802.2,          |
     |                            |  ETHERNET_II,             |
     |                            |  ETHERNET_SNAP,           |
     |                            |  ETHERNET_802.3, TOKEN-   |
     |                            |  RING, TOKEN-RING_SNAP    |
     |                            |  Default: "ETHERNET_802.2"|
     |                            |  for Ethernet networks,   |
     |____________________________|___________________________|



                          Copyright 1994 Novell, Inc.               Page 8













       nwcm(1M)                                                    nwcm(1M)


      |                            |  "TOKEN-RING" for Token   |
      |                            |  Ring networks            |
      |____________________________|___________________________|
      | lan_x_kb_per_sec           |  This parameter specifies |
      |                            |  the speed ith which data |
      |                            |  is transferred across the|
      |                            |  network. The value of    |
      |                            |  this parameter is used to|
      |                            |  calculate the number of  |
      |                            |  ticks for router packets.|
      |                            |  The "x" in the parameter |
      |                            |  indicates by number which|
      |                            |  LAN you are configuring. |
      |                            |  Supported values: 0 to   |
      |                            |  maxint                   |
      |                            |  Default: 10000           |
      |____________________________|___________________________|
      | lan_x_network              |  This parameter specifies |
      |                            |  the IPX external network |
      |                            |  number for the cabling   |
      |                            |  system to which the      |
      |                            |  network board is         |
      |                            |  attached.  All IPX       |
      |                            |  drivers linked to this   |
      |                            |  cabling system must use  |
      |                            |  the same network number  |
      |                            |  for the cabling system   |
      |                            |  and its frame type.  The |
      |                            |  x in the parameter name  |
      |                            |  specifies which network  |
      |                            |  is being configured. Each|
      |                            |  frame type requires its  |
      |                            |  own unique IPX external  |
      |                            |  network number. This     |
      |                            |  parameter must be        |
      |                            |  specified: the default is|
      |                            |  not a valid value.       |
      |                            |  Supported values: Any    |
      |                            |  hexadecimal integer from |
      |                            |  1 to 0xFFFFFFFE which    |
      |                            |  does not conflict with   |
      |                            |  other assigned IPX       |
      |                            |  network numbers (internal|
      |                            |  and external)            |
      |____________________________|___________________________|



                           Copyright 1994 Novell, Inc.               Page 9













      nwcm(1M)                                                    nwcm(1M)


     |                            |  Default: 0               |
     |____________________________|___________________________|
     | lan_x_ppa                  |  This parameter specifies |
     |                            |  the network board with   |
     |                            |  which the LAN is         |
     |                            |  associated.  This number |
     |                            |  is used by DLPI style 2  |
     |                            |  drivers.  If the device  |
     |                            |  driver used by the       |
     |                            |  network is not DLPI style|
     |                            |  2 then this parameter    |
     |                            |  must be set to zero (0)  |
     |                            |  and an interface name    |
     |                            |  must be specified.  The  |
     |                            |  "x" in the parameter     |
     |                            |  indicates by number which|
     |                            |  LAN you are configuring. |
     |                            |  Supported values: 0 to   |
     |                            |  65535                    |
     |                            |  Default: 0               |
     |____________________________|___________________________|
     | lan_x_rip_ageout_intervals |  This parameter specifies |
     |                            |  the number of            |
     |                            |  rip_bcast_intervals that |
     |                            |  must elapse since the    |
     |                            |  last broadcast packet was|
     |                            |  received before a server |
     |                            |  is considered "down" and |
     |                            |  removed from the Router  |
     |                            |  Information table.  The  |
     |                            |  "x" in the parameter     |
     |                            |  indicates by number which|
     |                            |  LAN you are configuring. |
     |                            |  Supported values: 1 to   |
     |                            |  256                      |
     |                            |  Default: 4               |
     |____________________________|___________________________|
     | lan_x_rip_bcast_intervals  |  This parameters specifies|
     |                            |  the time interval        |
     |                            |  (expressed in 30 second  |
     |                            |  intervals) between RIP   |
     |                            |  broadcasts.  The "x" in  |
     |                            |  the parameter indicates  |
     |                            |  by number which LAN you  |
     |____________________________|___________________________|



                          Copyright 1994 Novell, Inc.              Page 10













       nwcm(1M)                                                    nwcm(1M)


      |                            |  are configuring.         |
      |                            |  Supported values: 1 and  |
      |                            |  65535                    |
      |                            |  Default: 2               |
      |____________________________|___________________________|
      | lan_x_rip_inter_pkt_delay  |  This parameter specifies |
      |                            |  the number of            |
      |                            |  milliseconds that the RIP|
      |                            |  driver waits between     |
      |                            |  sending packets on a LAN.|
      |                            |  This prevents receiving  |
      |                            |  servers/routers from     |
      |                            |  getting packets too fast.|
      |                            |  (This parameter is       |
      |                            |  ignored if the network is|
      |                            |  a WAN.)  The "x" in the  |
      |                            |  parameter indicates by   |
      |                            |  number which LAN you are |
      |                            |  configuring.             |
      |                            |  Supported values: 0 to   |
      |                            |  500                      |
      |                            |  Default: 55              |
      |____________________________|___________________________|
      | lan_x_rip_max_pkt_size     |  This parameter specifies |
      |                            |  the maximum size in bytes|
      |                            |  for RIP packets.  The "x"|
      |                            |  in the parameter         |
      |                            |  indicates by number which|
      |                            |  LAN you are configuring. |
      |                            |  Supported values: 40 to  |
      |                            |  maxint                   |
      |                            |  Default: 432             |
      |____________________________|___________________________|
      | lan_x_rip_send_changed_only|  This parameter indicates |
      |                            |  whether the RIP driver   |
      |                            |  broadcasts only to       |
      |                            |  indicate changes in      |
      |                            |  service availability.    |
      |                            |  The "x" in the parameter |
      |                            |  indicates by number which|
      |                            |  LAN you are configuring. |
      |                            |  Supported values: on, off|
      |                            |  Default: off             |
      |                            |                           |
      |____________________________|___________________________|



                           Copyright 1994 Novell, Inc.              Page 11













      nwcm(1M)                                                    nwcm(1M)


     |____________________________|___________________________|
     | lan_x_sap_ageout_intervals |  This parameter specifies |
     |                            |  the number of            |
     |                            |  sap_bcast_intervals (see |
     |                            |  the following parameter) |
     |                            |  that must elapse since   |
     |                            |  the last broadcast packet|
     |                            |  was received before a    |
     |                            |  server is considered     |
     |                            |  "down" and removed from  |
     |                            |  the Server Information   |
     |                            |  table.  The "x" in the   |
     |                            |  parameter indicates by   |
     |                            |  number which LAN you are |
     |                            |  configuring.             |
     |                            |  Supported values: 1 to   |
     |                            |  256                      |
     |                            |  Default: 4               |
     |____________________________|___________________________|
     | lan_x_sap_bcast_intervals  |  This parameter specifies |
     |                            |  the time (expressed in 30|
     |                            |  second intervals) between|
     |                            |  SAP broadcasts. The "x"  |
     |                            |  in the parameter         |
     |                            |  indicates by number which|
     |                            |  LAN you are configuring. |
     |                            |  Supported values: 1 to   |
     |                            |  65535                    |
     |                            |  Default: 2               |
     |____________________________|___________________________|
     | lan_x_sap_inter_pkt_delay  |  This parameter specifies |
     |                            |  the number of            |
     |                            |  milliseconds that the SAP|
     |                            |  daemon waits between     |
     |                            |  sending packets on a LAN.|
     |                            |  This prevents receiving  |
     |                            |  servers/routers from     |
     |                            |  getting packets too fast.|
     |                            |  (This parameter is       |
     |                            |  ignored if the network is|
     |                            |  a WAN.)  The "x" in the  |
     |                            |  parameter indicates by   |
     |                            |  number which LAN you are |
     |                            |  configuring.             |
     |____________________________|___________________________|



                          Copyright 1994 Novell, Inc.              Page 12













       nwcm(1M)                                                    nwcm(1M)


      |                            |  Supported values: 0 to   |
      |                            |  500                      |
      |                            |  Default: 55              |
      |____________________________|___________________________|
      | lan_x_sap_max_pkt_size     |  This parameter specifies |
      |                            |  the maximum size in bytes|
      |                            |  for SAP packets.  The "x"|
      |                            |  in the parameter         |
      |                            |  indicates by number which|
      |                            |  LAN you are configuring. |
      |                            |  Supported values: 96 to  |
      |                            |  maxint                   |
      |                            |  Default: 480             |
      |____________________________|___________________________|
      | lan_x_sap_reply_to_gns     |  This parameter indicates |
      |                            |  whether responses are    |
      |                            |  sent to a Get Nearest    |
      |                            |  Server (GNS) request. The|
      |                            |  "x" in the parameter     |
      |                            |  indicates by number which|
      |                            |  LAN you are configuring. |
      |                            |  Supported values: on, off|
      |                            |  Default: on              |
      |____________________________|___________________________|
      | lan_x_sap_send_changed_only|  This parameter indicates |
      |                            |  whether the SAP daemon   |
      |                            |  broadcasts only to       |
      |                            |  indicate changes in      |
      |                            |  service availability.    |
      |                            |  The "x" in the parameter |
      |                            |  indicates by number which|
      |                            |  LAN you are configuring. |
      |                            |  Supported values: on, off|
      |                            |  Default: off             |
      |____________________________|___________________________|
      | router_driver_daemon       |  This parameter specifies |
      |                            |  the name of an alternate |
      |                            |  router using the         |
      |                            |  Replaceable Router       |
      |                            |  Interface.               |
      |                            |  Maximum length: 127      |
      |                            |  Default: ""              |
      |____________________________|___________________________|
      | router_driver_name         |                           |
      |____________________________|___________________________|



                           Copyright 1994 Novell, Inc.              Page 13













      nwcm(1M)                                                    nwcm(1M)


     |                            |  This parameter specifies |
     |                            |  the full path of the RIPX|
     |                            |  device name.             |
     |                            |  Maximum length: 127      |
     |                            |  Default: "/dev/ripx"     |
     |____________________________|___________________________|
     | router_hash_buckets        |  This parameter specifies |
     |                            |  the number of hash       |
     |                            |  entries in the Routing   |
     |                            |  Information Table.       |
     |                            |  Increase this value if a |
     |                            |  very large number of     |
     |                            |  networks is visible from |
     |                            |  the local network on     |
     |                            |  which the router/server  |
     |                            |  resides.  Decrease this  |
     |                            |  value if a very small    |
     |                            |  number of networks is    |
     |                            |  visible from the local   |
     |                            |  network on which the     |
     |                            |  router/server resides.   |
     |                            |  Supported values: 1 to   |
     |                            |  32768.  Any number       |
     |                            |  provided is rounded up to|
     |                            |  a power of 2.            |
     |                            |  Default: 64              |
     |____________________________|___________________________|
     | router_type                |  This parameter is        |
     |                            |  automatically set at     |
     |                            |  package installation     |
     |                            |  time.  For an Application|
     |                            |  Server (AS), the default |
     |                            |  value is FULL.  For a    |
     |                            |  Personal Edition (PE),   |
     |                            |  the default value is     |
     |                            |  CLIENT.  On a PE, the    |
     |                            |  value can be changed to  |
     |                            |  full if services are to  |
     |                            |  be offered by the system.|
     |                            |  Supported values: FULL,  |
     |                            |  CLIENT                   |
     |                            |  Default for PE: CLIENT;  |
     |                            |  Default for AS: FULL.    |
     |                            |                           |
     |____________________________|___________________________|



                          Copyright 1994 Novell, Inc.              Page 14













       nwcm(1M)                                                    nwcm(1M)


      |____________________________|___________________________|
      | spx                        |  This parameter specifies |
      |                            |  whether the SPX driver is|
      |                            |  started by the NetWare   |
      |                            |  protocol stack daemon    |
      |                            |  [npsd(1M)].  SPX is a    |
      |                            |  Novell transport protocol|
      |                            |  that works with the IPX  |
      |                            |  transport to guarantee   |
      |                            |  successful delivery of   |
      |                            |  data packets across the  |
      |                            |  network.  IPX is a       |
      |                            |  datagram service and SPX |
      |                            |  is a connection-based    |
      |                            |  service.  Some NetWare   |
      |                            |  services require SPX, for|
      |                            |  example, printing and    |
      |                            |  NVT.                     |
      |                            |  Supported values: on, off|
      |                            |  Default: on              |
      |____________________________|___________________________|
      | spx_max_connections        |  This parameter specifies |
      |                            |  the maximum number of    |
      |                            |  connections the SPX can  |
      |                            |  support.  Small systems  |
      |                            |  may want to decrease this|
      |                            |  parameter to conserve    |
      |                            |  memory resources.  If the|
      |                            |  system is using NetWare  |
      |                            |  print services, allow    |
      |                            |  enough sockets for the   |
      |                            |  print server, the        |
      |                            |  printers, and other      |
      |                            |  NetWare servers serviced |
      |                            |  by the print server.     |
      |                            |  Systems which are        |
      |                            |  configured for NVT       |
      |                            |  services will probably   |
      |                            |  need to increase this    |
      |                            |  parameter since NVT now  |
      |                            |  uses SPXII for its       |
      |                            |  underlying protocol.     |
      |                            |  Increase this parameter  |
      |                            |  if connections are       |
      |____________________________|___________________________|



                           Copyright 1994 Novell, Inc.              Page 15













      nwcm(1M)                                                    nwcm(1M)


     |                            |  failing because no more  |
     |                            |  devices or sockets are   |
     |                            |  available.               |
     |                            |  Supported values: 5 to   |
     |                            |  1024                     |
     |                            |  Default: 100             |
     |____________________________|___________________________|
     | spx_max_sockets            |  This parameter specifies |
     |                            |  how many sockets SPX can |
     |                            |  use simultaneously for   |
     |                            |  listening for connect    |
     |                            |  requests from other end  |
     |                            |  points.  This parameter  |
     |                            |  is configurable so that  |
     |                            |  small systems can        |
     |                            |  efficiently use allocated|
     |                            |  memory for optimal system|
     |                            |  performance.  Increase   |
     |                            |  the value if applications|
     |                            |  are failing because      |
     |                            |  listening sockets cannot |
     |                            |  be opened.               |
     |                            |  Supported values: 5 to   |
     |                            |  200                      |
     |                            |  Default: 50              |
     |____________________________|___________________________|
            SAP Parameters (Folder 8):
            _________________________________________________________
           | sap_dump_file         |  This parameter specifies the  |
           |                       |  name of the file that receives|
           |                       |  the output when the SAP daemon|
           |                       |  dumps the SAP tables.  The    |
           |                       |  dump is initiated by sending  |
           |                       |  the SAP daemon a SIGPIPE and  |
           |                       |  is generally used only for    |
           |                       |  debug.  Valid values are any  |
           |                       |  valid UNIX filename (created  |
           |                       |  in the log_directory; see     |
           |                       |  General Server Parameters), a |
           |                       |  valid path and filename, or   |
           |                       |  "/dev/null" (disables         |
           |                       |  logging).                     |
           |                       |  Maximum length: 127           |
           |                       |  Default: "sap.dump"           |
           |_______________________|________________________________|



                          Copyright 1994 Novell, Inc.              Page 16













       nwcm(1M)                                                    nwcm(1M)


      |_______________________|________________________________|
      | sap_file_compatibility|  This parameter is used to     |
      |                       |  enable the UnixWare 1.0       |
      |                       |  compatibility usage of        |
      |                       |  /var/spool/sap/in and         |
      |                       |  /var/spool/sap/out files for  |
      |                       |  Service Advertising.  However,|
      |                       |  developers should use the APIs|
      |                       |  available through libnwutil   |
      |                       |  instead of enabling this      |
      |                       |  parameter.                    |
      |                       |  Supported values: on, off     |
      |                       |  Default: off                  |
      |_______________________|________________________________|
      | sap_install_server    |  This parameter controls       |
      |                       |  whether or not an install     |
      |                       |  server broadcasts SAPs. When  |
      |                       |  set to on, SAPing is enabled  |
      |                       |  on the install server.  When  |
      |                       |  set to off, SAPing is         |
      |                       |  disabled.                     |
      |                       |  Supported values: on, off     |
      |                       |  Default: off                  |
      |_______________________|________________________________|
      | sap_log_file          |  This parameter specifies the  |
      |                       |  name of the file that saves   |
      |                       |  the messages generated during |
      |                       |  the normal operation of the   |
      |                       |  SAP daemon, such as messages  |
      |                       |  relating to start/stop times  |
      |                       |  or any unusual situations     |
      |                       |  encountered.  Valid values are|
      |                       |  any valid UNIX filename       |
      |                       |  (created in the log_directory;|
      |                       |  see General Server            |
      |                       |  Parameters), a valid path and |
      |                       |  filename, or "/dev/null"      |
      |                       |  (disables logging)            |
      |                       |  Maximum length: 127           |
      |                       |  Default: "sap.log"            |
      |_______________________|________________________________|
      | sap_max_messages      |  This parameter specifies the  |
      |                       |  maximum number of messages    |
      |                       |  that will be logged in the    |
      |_______________________|________________________________|



                           Copyright 1994 Novell, Inc.              Page 17













      nwcm(1M)                                                    nwcm(1M)


     |                       |  file specified by the         |
     |                       |  sap_log_file parameter.       |
     |                       |  Supported values: 0 to maxint |
     |                       |  Default: 300                  |
     |_______________________|________________________________|
     | sap_priority          |  This parameter sets a value   |
     |                       |  that specifies the running    |
     |                       |  priority for the SAP daemon   |
     |                       |  relative to other processes   |
     |                       |  and is mainly used to give SAP|
     |                       |  a higher priority than other  |
     |                       |  processes.                    |
     |                       |  Supported values: 0 to 40     |
     |                       |  Default: 15                   |
     |_______________________|________________________________|
     | sap_remote_apps       |  This parameter controls       |
     |                       |  whether or not the server     |
     |                       |  advertises remote application |
     |                       |  sharing.  When set to on, the |
     |                       |  server advertises that it has |
     |                       |  applications to share.  When  |
     |                       |  set to off, application       |
     |                       |  sharing is not advertised.    |
     |                       |  Supported values: on, off     |
     |                       |  Default: off                  |
     |_______________________|________________________________|
     | sap_servers           |  This parameter specifies the  |
     |                       |  maximum number of servers of  |
     |                       |  all types that will ever be   |
     |                       |  seen on all networks          |
     |                       |  recognized by SAP.  This      |
     |                       |  determines the size of the    |
     |                       |  shared memory region used by  |
     |                       |  SAP.  If this parameter is too|
     |                       |  small, new servers that don't |
     |                       |  fit in the table will be      |
     |                       |  ignored.                      |
     |                       |  Supported values: 50 to maxint|
     |                       |  Default: 2000                 |
     |_______________________|________________________________|
     | sap_track_file        |  This parameter specifies the  |
     |                       |  device that displays the      |
     |                       |  tracking messages showing SAP |
     |                       |  packets when the "track on"   |
     |_______________________|________________________________|



                          Copyright 1994 Novell, Inc.              Page 18













       nwcm(1M)                                                    nwcm(1M)


      |                       |  command is invoked.  Valid    |
      |                       |  values are any valid UNIX     |
      |                       |  filename (created in the      |
      |                       |  log_directory; see General    |
      |                       |  Server Parameters), a valid   |
      |                       |  path and filename, the        |
      |                       |  console, or "/dev/null"       |
      |                       |  (disables logging)            |
      |                       |  Maximum length: 127           |
      |                       |  Default: "/dev/console"       |
      |_______________________|________________________________|
      | sap_unixware          |  This parameter controls       |
      |                       |  whether or not this machine is|
      |                       |  advertised as a UnixWare      |
      |                       |  platform.  When set to on,    |
      |                       |  other machines on the network |
      |                       |  can obtain the name and IPX   |
      |                       |  address of this machine.  This|
      |                       |  parameter must be set to on to|
      |                       |  enable peer-to-peer operations|
      |                       |  such as SAP and NVT.          |
      |                       |  Supported values: on, off     |
      |                       |  Default: on                   |
      |_______________________|________________________________|

             Network Management (SNMP) Parameters (Folder 11):
             _____________________________________________________
            | nm_etc_directory|  This parameter specifies the    |
            |                 |  location of the network         |
            |                 |  management configuration files. |
            |                 |  Length: 127 charaacters         |
            |                 |  Default: "/etc/netmgt"          |
            |_________________|__________________________________|
            | nwum            |  This parameter is checked when  |
            |                 |  the NetWare Protocol Stack      |
            |                 |  daemon [see npsd(1M)] starts.   |
            |                 |  The nwum parameter is used to   |
            |                 |  start the Novell NetWare for    |
            |                 |  Unix network management peer,   |
            |                 |  and is ignored unless NetWare   |
            |                 |  for Unix is installed and the   |
            |                 |  NetWare for Unix daemon is      |
            |                 |  running.  If the NetWare for    |
            |                 |  Unix daemon is running when     |
            |_________________|__________________________________|



                           Copyright 1994 Novell, Inc.              Page 19













      nwcm(1M)                                                    nwcm(1M)


     |                 |        npsd(1M) starts and the va|ue of
     |                 |        nwum is on, then the NetWa|e for
     |                 |        Unix network management pe|r is
     |                 |        started, and NetWare for U|ix
     |                 |        statistics are available f|om
     |                 |        the SNMP agent.  If the va|ue of
     |                 |        nwum is off, NetWare for U|ix
     |                 |        statistics are not availab|e.
     |                 |        Supported values: on, off |
     |                 |        Default: off              |
     |_________________|__________________________________|
     | nwumps          |  This parameter is checked when  |
     |                 |  npsd(1M) starts.  If the value  |
     |                 |  is on, then nwumps_daemon is    |
     |                 |  checked for the name of the     |
     |                 |  daemon and the daemon is        |
     |                 |  started.  If the value is off,  |
     |                 |  the nwumps_daemon is not        |
     |                 |  started.                        |
     |                 |  Supported values: on, off       |
     |                 |  Default: on                     |
     |_________________|__________________________________|
     | nwumps_daemon   |  This parameter specifies the    |
     |                 |  name for the network management |
     |                 |  protocol stack daemon.  The     |
     |                 |  daemon is located in the        |
     |                 |  directory specified by the UNIX |
     |                 |  environment variable NWBINDIR.  |
     |                 |  If NWBINDIR is not set, the     |
     |                 |  value of binary_directory (see  |
     |                 |  General Server Parameters) is   |
     |                 |  used.                           |
     |                 |  Maximum length: 127             |
     |                 |  Default: "nwumpsd"              |
     |_________________|__________________________________|
     | nwum_daemon     |  This parameter specifies the    |
     |                 |  name of the NetWare for Unix    |
     |                 |  netware management daemon, and  |
     |                 |  is ignored unless Novell's      |
     |                 |  NetWare for Unix is installed   |
     |                 |  and running.  The daemon is     |
     |                 |  located in the directory        |
     |                 |  specified by the environment    |
     |                 |  variable NWBINDIR.  If NWBINDIR |
     |_________________|__________________________________|



                          Copyright 1994 Novell, Inc.              Page 20













       nwcm(1M)                                                    nwcm(1M)


      |                 |  is not set, the value of        |
      |                 |  binary_directory (see General   |
      |                 |  Server Parameters) is used.     |
      |                 |  Maximum length: 127             |
      |                 |  Default: "nwumd"                |
      |_________________|__________________________________|
      | nwum_trap_time  |  This parameter specifies, in    |
      |                 |  seconds, how often the NetWare  |
      |                 |  for Unix network management peer|
      |                 |  (see nwum parameter, above)     |
      |                 |  checks for error conditions.    |
      |                 |  Supported values: 0 to 300      |
      |                 |  Default: 5                      |
      |_________________|__________________________________|

             nprinter Parameters (Folder 13):
             _________________________________________________________
            | nprinter_config_directory|  This parameter specifies   |
            |                          |  the name of the directory  |
            |                          |  containing the nprinter(1M)|
            |                          |  configuration files.       |
            |                          |  Maximum length: 127        |
            |                          |  Default: "nprinter"        |
            |__________________________|_____________________________|
            | nprinter_config_file     |  This parameter specifies   |
            |                          |  the name of the remote     |
            |                          |  printing configuration     |
            |                          |  file.                      |
            |                          |  Maximum length: 127        |
            |                          |  Default: "RPConfig"        |
            |__________________________|_____________________________|
            | nprinter_console_device  |  This parameter specifies   |
            |                          |  where nprinter(1M) error   |
            |                          |  and console messages are   |
            |                          |  sent.                      |
            |                          |  Maximum length: 127        |
            |                          |  Default: ""                |
            |__________________________|_____________________________|
            | nprinter_control_file    |  This parameter specifies   |
            |                          |  the name of the remote     |
            |                          |  printing control file.     |
            |                          |  Maximum length: 127        |
            |                          |  Default: "RPControl"       |
            |                          |                             |
            |__________________________|_____________________________|



                           Copyright 1994 Novell, Inc.              Page 21













      nwcm(1M)                                                    nwcm(1M)


           |__________________________|_____________________________|
           | nprinter_prt_file        |  This parameter specifies   |
           |                          |  the name of the printing   |
           |                          |  configuration file.        |
           |                          |  Maximum length: 127        |
           |                          |  Default: "PRTConfig"       |
           |__________________________|_____________________________|

            Novell Virtual Terminal (NVT) Parameters (Folder 14):
            _______________________________________________________
           | spx_network_rlogin|  This parameter determines       |
           |                   |  whether NVT remote login        |
           |                   |  services will be activated.     |
           |                   |  Supported values: on, off       |
           |                   |  Default: off                    |
           |___________________|__________________________________|

            NetWare Unix Client (NUC) Parameters (Folder 16):
            _________________________________________________________
           | netware_single_login|  When set, this parameter allows |
           |                     |  all users to access NetWare     |
           |                     |  servers from UnixWare without   |
           |                     |  explicit authentication to the  |
           |                     |  server, if the passwords on     |
           |                     |  UnixWare and NetWare are        |
           |                     |  identical.  This parameter      |
           |                     |  enables this feature for the    |
           |                     |  entire system.  (Note that there|
           |                     |  is no automatic synchronization |
           |                     |  of passwords between UnixWare   |
           |                     |  and NetWare.)                   |
           |                     |  Supported values: on, off       |
           |                     |  Default: off                    |
           |_____________________|__________________________________|
           | nuc                 |  This parameter, when set to on, |
           |                     |  enables NetWare UNIX Client     |
           |                     |  Services.  When set to off,     |
           |                     |  NetWare UNIX Client Services are|
           |                     |  disabled.                       |
           |                     |  Supported values: on, off       |
           |                     |  Default: off                    |
           |_____________________|__________________________________|
           | nuc_checksum_level  |  This parameter sets the base IPX|
           |                     |  checksum level for the NetWare  |
           |_____________________|__________________________________|



                          Copyright 1994 Novell, Inc.              Page 22













       nwcm(1M)                                                    nwcm(1M)


      |                     |        Unix Client.  Checksums ta|e
      |                     |        effect for all application| that
      |                     |        use the NetWare API librar|es to
      |                     |        gain access to NetWare ser|ers.
      |                     |        Supported values: 0 (Clien| will
      |                     |        not perform any IPX checks|ms),
      |                     |        1 (Client will not request|IPX
      |                     |        checksums, but will perfor| them
      |                     |        if required by the NetWare|
      |                     |        server), 2 (Client will re|uest
      |                     |        IPX checksums, but will no|
      |                     |        perform them if the NetWar|
      |                     |        server cannot or will not |
      |                     |        support them), and 3 (Clie|t
      |                     |        requires IPX checksums).  |
      |                     |        Default: 1                |
      |_____________________|__________________________________|
      | nuc_signature_level |  This parameter sets the base NCP|
      |                     |  signature level for the NetWare |
      |                     |  Unix Client.  Signatures takes  |
      |                     |  effect for all applications     |
      |                     |  which use the NetWare API       |
      |                     |  libraries to gain access to     |
      |                     |  NetWare servers.                |
      |                     |  Supported values:  0 (Client    |
      |                     |  will not perform any NCP        |
      |                     |  signatures), 1 (Client will not |
      |                     |  request NCP signatures, but will|
      |                     |  perform them if required by the |
      |                     |  NetWare server), 2 (Client will |
      |                     |  request NCP signatures, but will|
      |                     |  not perform them if the NetWare |
      |                     |  server cannot or will not       |
      |                     |  support them), and 3 (Client    |
      |                     |  requires NCP signatures).       |
      |                     |  Default: 1                      |
      |_____________________|__________________________________|
      | nuc_xauto_panel     |  This parameter controls how     |
      |                     |  users access NetWare servers.   |
      |                     |  When set to off, users must use |
      |                     |  nwlogin to access NetWare       |
      |                     |  servers.                        |
      |                     |  Supported values: on, off       |
      |                     |  Default: off                    |
      |_____________________|__________________________________|



                           Copyright 1994 Novell, Inc.              Page 23













      nwcm(1M)                                                    nwcm(1M)


      EXAMPLES
            To print brief descriptions of all folders:

                        nwcm -f 0

            To list all available parameters (in all  folders)  and  their
            current values:

                        nwcm -V 0

            To list all parameters in Folder 5 along  with  a  brief  help
            message for each:

                        nwcm -D 5

            To list all parameters in Folder 5 along with a detailed  help
            message for each:

                        nwcm -H 5

            To display a help message for a particular parameter, such  as
            server_name:

                        nwcm -h server_name
























                          Copyright 1994 Novell, Inc.              Page 24








Typewritten Software • bear@typewritten.org • Edmonds, WA 98026