nwcm(1Mipx)


nwcm -- view and configure NetWare Services information

Synopsis

nwcm [option ... ]

Description

Use nwcm on the UnixWare command line to: NetWare Services may also be configured using the graphical scoadmin(1M) tool.

Options

-q
Prevent printing the new value when setting or resetting parameter values.

-s param=value
Set the parameter to the indicated value. Replace param with a parameter listed in ``nwcm parameters''.

-t param=value
Test to see if the value for the parameter is valid. Replace param with a parameter from ``nwcm parameters''.

-L folder
List parameters in a folder (without displaying parameter values). To list all parameters, specify folder number 0.

-v param
View the value of the parameter. Replace param with a parameter from ``nwcm parameters''.

-V folder
View the values of parameters in a folder. To view values for all parameters, specify folder number 0.

-r param
Reset the value of the parameter to its default as specified in the configuration schema. Replace param with a parameter from ``nwcm parameters''.

-R folder
Reset the values for parameters in a folder to their default values, as specified in the configuration schema.

To reset all parameters to their default values, specify folder number 0. (For script writers, a faster way is to truncate the configuration file to zero length.)

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

Replace param with a parameter from ``nwcm parameters''.

-D folder
View the description string from the message catalog (or the parameter name in the current locale) for parameters in a folder.

To view the description string for all parameters, specify folder number 0.

-h param
View the input-help string for the specified parameter from the message catalog. Replace param with a parameter from ``nwcm parameters''.

-H folder
View the input-help strings from the message catalog for parameters in a folder. (To view the description string for all parameters, specify folder number 0.)

-f folder
View the description string from the message catalog for a folder. (To view the description string for all parameters, specify folder number 0.)

-F
View the number of folders.

-c
View the full pathname of the configuration file.

-C
View the full pathname of the configuration directory. This is always the basename of the configuration file.

-x
Remove parameters from the configuration file for packages no longer installed.

-W folder
View the valid strings for all the parameters in the specified folder.

-w param
View the valid strings for a specified parameter.

-A folder
Check the validity of the specified folder.

nwcm parameters

The following lists describe the nwcm parameters and when to use them: The parameter lists use the ``Yes'' and ``No'' values for enabling and disabling, respectively. You can also use ``yes'' and ``no'', ``True'' and ``False'', ``on'' and ``off'', or ``active'' and ``inactive'' instead of the ``Yes'' and ``No'' values. For example, entering any one of the following commands will produce the same results:

nwcm -s spx=Yes
nwcm -s spx =yes
nwcm -s spx=True
nwcm -s spx=on
nwcm -s spx=active

General server parameters (folder 1)

alert_notify_string=value
Specify a list of users who are to receive alert messages in addition to ADMIN. Enclose the list of usernames within single quotation marks. A semicolon should immediately follow each username. For example, to send alert messages to users Larry and Judy, the alert list should contain
`Judy;Larry;' 
Maximum length: 127. Default: Not Configured.

allow_change_to_client_rights=value
Control whether a Print or Job server may assume the rights of the submitter while servicing a queue job. If set to Yes, the submitter's rights are allowed to be assumed.

Supported values: Yes, No. Default: Yes.

allow_lip=value
Determine whether Large Internet Packets are allowed. If set to Yes, packets larger than 512 bytes can be sent on the network.

Supported values: Yes, No. Default: Yes.

allow_unencrypted_passwords=value
Control the use of unencrypted passwords. If set to No, passwords must be encrypted, preventing clients who use clear text passwords from logging in.

Supported values: Yes, No. Default: No.

burst_mode_clients=number
Limit the number of clients that can use the Packet Burst protocol. The server allocates a buffer in shared memory for the private use of each Packet Burst client.

If you allow all clients to use Packet Burst, you may need to increase the size of shared memory. When this parameter is set to zero, all clients can use the Packet Burst protocol.

Supported values: 0 to 1000. Default: 0.

burst_mode_protocol=value
Determine whether NetWare clients can use the Packet Burst protocol. The Packet Burst protocol reduces traffic by allowing a burst of packets to be acknowledged with one packet (rather than acknowledging each packet.)

If set to Yes, Packet Burst is enabled. Use the burst_mode_clients parameter to specify how many clients can use the protocol.

Supported values: Yes, No. Default: Yes.

console_device=value
Specify which device receives the server messages. The default allows you to view the file server messages from the desktop using Message Monitor.

Maximum length: 127. Default: /dev/osm.

console_display_watchdog_logouts=value
Control whether a message is sent to the server display device when the watchdog logs out a connection. If set to Yes, messages are sent.

Supported values: Yes, No. Default: No.

delay_before_first_watchdog_packet=number
Determine the number of seconds the server waits without receiving a request from a workstation before sending the first watchdog packet to that workstation.

Supported values: 16 to 1252. Default: 296.

delay_between_watchdog_packets=number
Determine the number of seconds between watchdog packets. A watchdog packet is sent only if no packets are received from the client in the specified interval.

Supported values: 10 to 626. Default: 60.

enable_ipx_checksums=number
Determine whether the server validates the data integrity of IPX packets.

Supported values:

Default: Enabled (1).

err_log_file_size=number
Specify the maximum size in bytes of the error log file SYS$LOG.ERR. When the maximum size is reached, the error log file is copied to a backup file, and the error log file is started over. At any given time, only one backup file will be kept.

Supported values: 65536 bytes to 4294967294 bytes. Default: 1048576.

file_access_control=value
Specify the file access mode for NetWare users. This parameter is used only if the access control mode is not specified for the volume in the voltab file.

Supported values:

netware
NetWare rights determine access

unix
UnixWare permissions determine access

both
both NetWare rights and UnixWare permissions determine access

none
no access control policy is enabled and files are accessible to all NetWare clients
Default: netware.

file_default_umask=value
Specify the umask that is used to assign UnixWare permissions on files created by NetWare users.

Supported values: octal 0000 to octal 0777. Default: 0002.

hybrid_allow_default_user=value
Determine whether all NetWare users must also be hybrid users. If set to No, NetWare users who do not have a mapping in the /etc/netware/nwusers file use the nwuser account. If set to Yes, all NetWare users must have a mapping or else they cannot log in.

This parameter is used only when the hybrid_users_enabled parameter is set to ``Yes''.

Supported values: Yes, No. Default: No.

hybrid_setuid_enabled=value
Determine whether the NetWare processes assume the UID and GID of the hybrid user when processing an NCP request. If set to ``Yes'', UnixWare auditing accurately reflects the UID of the NetWare user accessing the file.

Hybrid users will also be able to create files on NFS-mounted NetWare volumes when permitted by their UnixWare permissions.

Supported values: Yes, No. Default: No.

hybrid_users_enabled=value
Determine whether hybrid user mapping is activated. If set to ``Yes'', the server checks the /etc/netware/nwusers file when a NetWare user logs in.

If a UnixWare username has been assigned to the NetWare user, all files and directories created by the NetWare user will be owned by the assigned UnixWare user.

Supported values: Yes, No. Default: Yes.

login=value
Specify whether NetWare logins are allowed. If set to ``Yes'', NetWare users may log in. If set to ``No'', only ADMIN is allowed to log in.

Supported values: Yes, No. Default: Yes.

log_watchdog_logouts=value
Control whether log entries are created whenever a client is logged out by the watchdog. If set to ``Yes'', a log entry is made in the SYS$LOG.ERR error log file whenever this event occurs.

Supported values: Yes, No. Default: Yes.

max_connections=number
Specify the size of the Connection Table. Because both licensed connections and Directory Services connections use this table, configure the table for at least 10 more than your maximum number of licensed connections. Increase the number if you have a large directory tree or you receive messages that the Connection Table is full.

Supported values: 12 to 1000. Default: 50.

max_open_files=number
Specify the maximum number of unique files that can be opened simultaneously for all NetWare users. Because the NetWare server employs shared file descriptor technology, multiple opens of the same file by one or more NetWare users are counted as only one true open file. If this parameter is set to zero, then the formula (max_connections * 4) + 10 is used to calculate this value.

Supported values: 0 to 49000. Default: 0.

max_search_contexts=number
Specify the maximum number of NCP directory searches that can be processed simultaneously. Normally, only one NCP directory search occurs at a time. Increase the default if you are using applications that support multiple outstanding directory searches or if you are having problems with corrupt or invalid directory information.

Supported values: 16 to 100. Default: 16.

max_volumes=number
Specify the maximum number of volumes that the NetWare server can mount.

Supported values: 1 to 64. Default: 10.

native_locks=value
Specify whether NetWare byte range locks are reflected onto the UnixWare file system. If set to ``Yes'', any NetWare byte range lock within a file will be reflected as a UnixWare byte range lock on the entire file. If set to ``No'', NetWare byte range locks will not be reflected on the UnixWare file system.

Note that when set to ``Yes'', the UnixWare lock is an advisory lock and a UnixWare process may ignore the lock and proceed with the read or write of the file. When NetWare/UnixWare file sharing is required, UnixWare processes must yield to existing NetWare byte range locks. Performance is affected somewhat when this parameter is set to ``Yes''.

Supported values: Yes, No. Default: No.

ncp_packet_signature_option=number
Determine whether the server generates signatures for NCP packets.

Supported values:

Default: Enabled (1).

npfs_directory_mandatory_sync_interval=number
Determine the maximum length of time in seconds that can elapse between directory synchronization operations. You can override this value on a volume-by-volume basis by specifying the parameter in the voltab file.

If this value is smaller than the value set for the npfs_directory_min_sync_interval parameter for any volume, then the npfs_directory_min_sync_interval parameter is ignored, and synchronization will occur as specified by this value.

Supported values 0 to 3600. Default: 900.

npfs_directory_min_sync_interval=number
Specify the minimum number of seconds that must elapse between directory synchronization operations upon directory access. You can override this value on a volume-by-volume basis by specifying the parameter in the voltab file.

Supported values: 0 to 900. Default: 10.

npfs_directory_purge_threshold=number
Specify the number of deleted file entries that must exist within a directory before they are purged from the NetWare usinodes file. You can override this value on a volume-by-volume basis by specifying the parameter in the voltab file.

Setting this parameter to a very small value (such as 1) will cause deleted file entries to be purged frequently. Setting this parameter to a very large value (such as 1000000) will cause deleted file entries to be purged only when the volume usinodes file becomes full.

Supported values: 1 to 4294967294. Default: 32.

number_of_watchdog_packets=number
Specify the number of watchdog packets that the server sends to a workstation before logging the client out. Any packet from the client resets the count.

Supported values: 5 to 100. Default: 10.

nws_start_at_boot=value
Control whether the NetWare server is started at boot time. If set to ``Yes'', the NetWare Server automatically starts when UnixWare boots. If set to ``No'', the NetWare server does not start at boot time and must be started manually. If set to ``Yes'', IPX must also be configured to start at boot time.

Supported values: Yes, No. Default: Yes.

NDS parameter (folder 2)

ds_bindery_context=value
Specify the NDS container where bindery services are provided. The context is set to the server's container when DS is installed. You can set multiple contexts by separating contexts with semicolons (;).

Maximum length: 256. Default: Not Configured.

System tunable parameters (folder 4)

burst_mode_buffer_size=number
Specify the size in bytes of the Packet Burst buffer which in turn determines the maximum size burst the server can handle. Each client using the Packet Burst protocol receives a buffer of this size to store Packet Burst data. Changing the parameter may require a change in the size of shared memory.

Supported values: 3072 to 65535. Default: 24576.

burst_mode_packet_delay_threshold=number
Control requests from the client to NetWare Services for interpacket delay between bursts packets. Requests are ignored if the requested delay is less than this parameter.

Set this value at least to the system clock's resolution, typically 10000 microseconds (10 milliseconds).

Supported values: 0 to 999999. Default: 10000.

max_ncp_engines=number
Specify the maximum number of NCP engines that can run simultaneously.

Supported values: 5 to 50. Default: 10.

ncp_engines_to_start=number
Specify the number of NCP engines that run when the NetWare server starts. Increase the number if the nxinfo utility (see nxinfo(1Mnws)) reports an excessive number of packets dropped due to server busy. Use the nwengine utility (see nwengine(1Mnws)) to change the number of engines after the server is up.

Supported values: 2 to 50. Default: 2.

nemux_error_action=value
Control the action taken when an error occurs in the NetWare server. The following are possible settings and actions:

HEX Value: 0x01
Action on Error: Stop debug trace

HEX Value: 0x04
Action on Error: Stop all incoming messages

HEX Value: 0x10
Action on Error: Stop idle engines

HEX Value: 0x20
Action on Error: Send SIGQUIT signal to busy processes

HEX Value: 0x40
Action on Error: Send SIGQUIT signal to all processes.
Default: 0x05.

read_ahead_cache_buffer_size=number
Set the buffer size in bytes of the read-ahead cache. For optimal performance, the buffer size should be set to a multiple of the block size of the UnixWare file system. Changing the parameter may require a change in the size of shared memory.

Supported values: 4096 to 32768. Default: 8192.

read_ahead_enabled=value
Activate a read-ahead cache buffer. When a NetWare user opens an executable file, the file is read into this buffer before receiving the request to download the file. Clients using Packet Burst do not use this buffer. If set to Yes, you may need to adjust the value of the read_ahead_cache_buffer_size parameter.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

shm_access=number
Specify the UnixWare permissions of the shared memory segment used by the NetWare server. The default value allows only system processes to access the shared memory segment.

Supported values: 0600 to 0777. Default: 0600.

shm_key=number
Specify a unique key for the NetWare shared memory segment. When NetWare is started, this key is registered with UnixWare to ensure that no other processes use the same key for a shared memory segment. Change this parameter if UnixWare has already assigned this number to another segment.

Supported values: 0x1 to 0xFFFFFFFE. Default: 0x600d400.

shm_size=number
Specify the size of the shared memory segment in bytes. This value should be increased as connections, trustee assignments, and record locks increase.

Supported values: 4194304 (4MB) to the maximum virtual memory available on your system. Default: 4194304.

Miscellaneous parameters (folder 5)

binary_directory=value
Specify the UnixWare path to the location of the NetWare Services executable files.

Maximum length: 127. Default: /usr/sbin.

log_directory=value
Specify the UnixWare path to the directory where NetWare Services log files are found.

Maximum length: 127. Default: /var/netware.

server_name=value
Control the name under which all NetWare Services (NCP, AFP, and NVT) are advertised.

It must be unique from other NetWare servers and cannot contain spaces or punctuation marks. Alphabetic characters are converted to uppercase.

This parameter is set to the UnixWare node name when the system boots (unless it is overwritten during NetWare Services installation).

Length: 2 to 47 characters. Default: Not Configured.

Localization parameters (folder 6)

code_page=value
Specify the value of the code page used by all NetWare clients. The code page is a table that defines a particular character set required by the language and writing system of a country. If you change this parameter after NDS is installed, you must reinstall NDS. If set to 897 or 932 (for Japanese clients), the host_code_set parameter must be set to eucJP.

Supported values: 88591 (C locale), 437 (Western Europe, Americas), 850 (Western Europe, Americas), 860 (Portugal), 863 (French Canada), 865 (Norway, Denmark), sjis (Japan), nwsjis (Japan). Default: 88591.

country_code=value
Specify the value of the country code used by all NetWare clients.

Supported values: 1 (United States), 2 (French Canada), 2 (Latin America), 31 (Netherlands), 32 (Belgium), 33 (France), 34 (Spain), 39 (Italy), 41 (Swiss-French, German), 44 (United Kingdom), 45 (Denmark), 46 (Sweden), 47 9norway), 49 (Germany), 61 (Australia), 81 (Japan), 351 (Portugal), 358 (Finland). Default: 1.

host_code_set=value
Specify the character set used to store NetWare file and directory names in the UnixWare file system.

Note that when set to eucJP (for Japanese clients), the code_page parameter must also be set to 897 or 932.

Supported values: 88591 (North America, South America, and Western Europe), eucJP (Japan). Default: 88591.

IPX/SPX/NetBIOS transport parameters (folder 7)

diagnostics=value
Specify if the diagnostics daemon (diagnostics_daemon) is started by the NPS daemon.

Set this parameter to ``Yes'' if Network Management is enabled.

Supported values: ``Yes'', ``No''. Default: ``No''.

diagnostics_daemon=value
Specify the name for the IPX diagnostic protocol daemon.

The daemon is located in the directory specified by the binary_directory configuration parameter.

Maximum length: 127. Default: nwdiagd.

diagnostics_log_file=value
Specify the name of the log file for diagnostic messages. The location of the log file is set by log_directory.

To prevent the diagnostics daemon from logging messages to the file, set this parameter to /dev/null.

Maximum length: 127. Default: diag.log.

ipx_auto_discovery=value
Control discovery of the NetWare server's address. If set to ``Yes'', automatic discovery is enabled.

If the IPX Internal LAN Address has a non-zero value, discovery runs once and is turned off.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

ipx_internal_network=number
Provide a network address for access from multiple LANs. This parameter specifies the address of the internal network (LAN 0).

Set a value only if multiple networks are configured on your system. This address must be unique on the IPX internetwork.

The default value (0) means that no internal network is configured.

Enter values in hexadecimal (0xNNNNN), decimal (NNNNN) or octal (0NNNN). Values are displayed in hexadecimal format.

Supported values: 0x1 to 0xfffffffe. Default: 0x0.

ipx_max_hops=number
Specify the maximum number of routers that can be traversed while searching for a destination network. When the limit is reached, the packet is discarded.

Supported values: 2 to 16. Default: 16.

ipx_start_at_boot=value
Control if IPX is started at boot time.

If IPX is not started, services requiring IPX, such as Network UnixWare Client (NUC) and NVT, will not function.

Supported values: ``Yes'', ``No''. Default: Yes.

lan_x_adapter_type=value
Specify the interface between the device driver and IPX by indicating the cabling topology. (The x indicates by number which LAN you are configuring.)

Supported values: ETHERNET_DLPI, TOKEN-RING_DLPI. Default: ETHERNET_DLPI.

lan_x_frame_type=value
Specify the frame type. (The x 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; TOKEN-RING for Token Ring networks.

lan_x_if_name=value
Specify the interface name, which specifies the device driver used to attach to a network board. (The x indicates by number which LAN you are configuring.)

If the device driver uses a physical point of attachment, do not configure this parameter.

Maximum length: 127. Default: Not Configured.

lan_x_kb_per_sec=number
Specify the speed, in kilobytes per second, that data is transferred across the network. (The x indicates by number which LAN you are configuring.)

The value of this parameter is used to calculate the number of ticks for router packets.

Supported values: 0 to 4294967294. Default: 10000.

lan_x_ppa=number
Specify the physical point of attachment, or which network board to attach to. (The x indicates by number which LAN you are configuring.)

This number is used by DLPI style 2 drivers. If the device driver is not DLPI style 2, this parameter must be set to zero (0) and an interface name must be specified.

Supported values: 0 to 65535. Default: 0.

lan_x_rip_ageout_intervals=number
Specify the number of rip_bcast_intervals that must elapse since the last broadcast packet was received before a network is considered ``down'' and removed from the Router Information table. (The x indicates by number which LAN you are configuring.)

Supported values: 1 to 256. Default: 4 (4 * 2 * 30 = 240 seconds).

lan_x_rip_bcast_intervals=number
Specify the time (in 30 second intervals) between RIP broadcasts. (The x indicates by number which LAN you are configuring.)

Supported values: 1 and 6553. Default: 2 (60 seconds).

lan_x_rip_inter_pkt_delay=number
Specify the number of milliseconds that the RIP driver waits between sending packets on a LAN. (The x indicates by number which LAN you are configuring.)

This parameter prevents receiving servers and routers from getting packets too fast (and is ignored if the network is a WAN).

Supported values: 0 to 500. Default: 55.

lan_x_rip_max_pkt_size=number
Specify the maximum size in bytes for RIP packets. (The x indicates by number which LAN you are configuring.)

Packets larger than the maximum supported packet size for the network type cannot be sent.

Supported values: 40 to 4294967294. Default: 432.

lan_x_rip_send_changed_only=value
Minimize RIP traffic on a WAN.

You can specify that the RIP driver broadcasts only to indicate changes in router availability, or specify that the RIP driver broadcasts all information periodically.

If set to ``Yes'', RIP broadcasts changes only. If set to ``No'', RIP periodically broadcasts all server information.

Supported values: ``Yes'', ``No''. Default: ``No''.

lan_x_sap_ageout_intervals=number
Specify the number of sap_bcast_intervals that must elapse since the last broadcast packet was received before a NetWare server is considered to be down and removed from the Server Information table. (The x indicates by number which LAN you are configuring.)

Supported values: 1 to 256. Default: 4 (4 * 2 * 30 = 240 seconds).

lan_x_sap_bcast_intervals=number
Specify the time (in 30 second intervals) between SAP broadcasts. (The x indicates by number which LAN you are configuring.)

Supported values: 1 to 65535. Default: 2 (60 seconds).

lan_x_sap_inter_pkt_delay=number
Specify 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 (and is ignored if the network is a WAN). (The x indicates by number which LAN you are configuring).

Supported values: 0 to 500. Default: 55.

lan_x_sap_max_pkt_size=number
Specify the maximum size in bytes for SAP packets. (The x indicates by number which LAN you are configuring.)

Supported values: 96 to 4294967294. Default: 480.

lan_x_sap_reply_to_gns=value
Indicate if responses are sent to a Get Nearest Server (GNS) request. (The x indicates by number which LAN you are configuring.)

Supported values: ``Yes'', ``No''. Default: ``Yes''.

lan_x_sap_send_changed_only=value
Indicate if the SAP daemon broadcasts only to indicate changes in service availability. (The x indicates by number which LAN you are configuring.)

Supported values: ``Yes'', ``No''. Default: ``No''.

router_driver_daemon=value
Specify the name of an alternate router using the Replacable Router Interface.

Maximum length: 127. Default: Not Configured.

router_driver_name=value
Specify the full path of the RIPX device name.

Maximum length: 127. Default: /dev/ripx.

router_hash_buckets=number
Specify 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.

Any number is rounded up to a power of 2.

Supported values: 1 to 32768. Default: 512.

router_type=value
Specify if the Server Advertiser Protocol Daemon (sapd) starts, and if RIP advertises IPX networks.

If the nwcm parameter ipx_internal_network has a non-zero value, router_type sets to FULL when IPX starts. If router_type is set to FULL, sapd starts and RIP advertises.

If router_type is set to CLIENT, sapd does not start and RIP does not advertise.

Supported values: FULL, CLIENT. Default: FULL.

spx=value
Specify if the SPX driver is started by the NPS daemon (npsd).

SPX works with the IPX transport to guarantee successful delivery of data packets. IPX is a datagram service and SPX is a connection-based service. Some NetWare services, such as printing and NVT, require SPX.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

spx_max_connections=number
Specify the maximum number of connections the SPX can support.

Small systems might want to decrease this parameter to conserve memory resources. Increase this parameter if connections are failing because no more devices or sockets are available.

If the system is using NetWare print services, allow enough connections for the print server, the printers, and other NetWare servers serviced by the print server.

Systems configured for NVT services probably need to increase this parameter because NVT uses SPXII for its underlying protocol.

Supported values: 5 to 1024. Default: 100.

spx_max_sockets=number
Specify how many sockets SPX can use simultaneously for listening for connect requests from other end points.

You can set this parameter 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=value
Specify 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 for debug.

Values are any valid UnixWare filename (created in the directory log_directory), a valid path and filename, or /dev/null (disables logging).

Maximum length: 127. Default: sap.dump.

sap_fast_init=value
Specify if the SAP daemon performs fast initialization.

If set to ``Yes'', the SAP daemon becomes operational while establishing the table of known network serves. If set to ``No'', the SAP daemon becomes operational after establishing the table of known network servers.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

sap_file_compatibility=value
Enable or disable /var/spool/sap ``in'', ``out'' file compatibility (provide backwards compatibility for UnixWare 1.1).

Supported values: ``Yes'', ``No''. Default: ``No''.

sap_install_server=value
Control if this machine is advertised as an install server so others can install software from it.

If set to ``No'', the machine is not advertised as an install server.

Supported values: ``Yes'', ``No''. Default: ``No''.

sap_log_file=value
Specify the name of the file that saves the messages generated during the normal operation of the SAP daemon, such as messages relating to start and stop times or any unusual situations encountered.

Values are any valid UnixWare filename (created in the directory log_directory), a valid path and filename, or /dev/null (disables logging).

Maximum length: 127. Default: sap.log.

sap_max_messages=number
Specify the maximum number of messages that can be logged in the file specified by the sap_log_file parameter.

Use a value of 0 to disable logging.

Supported values: 0 to 4294967294. Default: 300.

sap_priority=number
Set the running priority for the SAP daemon relative to other processes. This parameter is used mainly to give SAP a higher priority than other processes.

Supported values: 0 to 40. Default: 15.

sap_remote_apps=value
Control if NetWare Services advertises remote application sharing.

If set to ``Yes'', NetWare Services advertises that it has applications to share. If set to ``No'', application sharing is not advertised.

Supported values: ``Yes'', ``No''. Default: ``No''.

sap_servers=number
Specify the maximum number of servers of all types that are seen on networks recognized by SAP. This parameter determines the size of the shared memory region used by SAP.

If this parameter is too small, new servers that do not fit in the table are ignored.

Supported values: 0 to 4294967294. Default: 3000.

sap_track_file=value
Specify the device that displays tracking messages showing SAP packets when the track on command is invoked.

Values are any valid UnixWare filename (created in the directory log_directory), a valid path and filename, the console, or /dev/null (disables logging).

Maximum length: 127. Default: /dev/console.

sap_unixware=value
Control if this machine is advertised as a UnixWare platform.

If set to ``Yes'', other machines can obtain the name and IPX address of this machine.

If you are going to use any peer-to-peer operations (such as Application Sharing), you must set this parameter to ``Yes''.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

NetWare management parameters (folder 11)

nm_etc_directory=value
Specify the directory where the definition files for the Network Management peer daemons reside.

Maximum length: 127. Default: /etc.

nwum=value
Specify if the Network Management daemon is started.

This parameter has meaning only in NetWare for UnixWare 4.02. It it checked when NetWare for UnixWare is initialized.

If set to ``Yes'', the Network Management daemon is started, and Network Management services are available from NetWare Services. If set to ``No'', Network Management services are not available.

Supported values: ``Yes'', ``No''. Default: ``No''.

nwum_daemon=value
Specify the name of the netware management daemon. This parameter has meaning only in NetWare for UnixWare 4.02.

The daemon is located in the directory specified by the environment variable NWBINDIR. If NWBINDIR is not set, binary_directory is used.

Maximum length: 127. Default: nwumd.

nwum_trap_time=number
Specify, in seconds, how often the Network Management daemon checks for error conditions.

Supported values: 0 to 300. Default: 5.

nwumps=value
This parameter is checked when NPSD starts.

If set to ``Yes'', nwumps_daemon is checked for the name of the daemon, and the daemon is started. If set to ``No'', nwumps is not started.

Supported values: ``Yes'', ``No''. Default: ``No''.

nwumps_daemon=value
Specify the name for the Network Management protocol stack daemon.

The daemon is located in the directory specified by the UnixWare environment variable NWBINDIR. If NWBINDIR is not set, binary_directory is used.

Maximum length: 127. Default: nwumpsd.

Printing (PSERVER) parameters (folder 12)

pserver_console_verbosity=value
Determine the type and quantity of messages that the print server displays. A low number minimizes the number of messages displayed; a high number increases the number of messages displayed.

Supported values: 0 to 5. Default: 1.

pserver_directory=value
Specify the name of the print server subdirectory created in the pserver log directory. This directory contains log files and the process identification file.

Maximum length: 127. Default: pserver.

pserver_log_directory=value
Specify the path where the print server directory is located.

If you do not configure this parameter, the value defined by log_directory is used.

Maximum length: 127. Default: Not Configured.

pserver_log_verbosity=value
Determine the type and quantity of messages that the print server writes to the log file. A low number minimizes the number of messages logged; a high number increases the number of messages logged.

Supported values: 0 to 5. Default: 1.

pserver_name=value
Specify the name of the print server defined either in the bindery database or in NDS.

If you do not configure a name, the name of the local NetWare server is used for the print server name.

Maximum length: 127. Default: Not Configured.

pserver_name_context=value
Specify the initial context that is used for Directory Services authentication.

If you do not configure a context, the print server cannot authenticate as a Directory Services object and must run in bindery mode.

Maximum length: 127. Default: Not Configured.

pserver_nwum_file=value
Specify the name of the file containing the Network Management information. NetWare management must be enabled for this option to work with the print server.

Maximum length: 127. Default: nwum.

pserver_password_file=value
Specify the name of the file containing the print server password.

Maximum length: 127. Default: password.

pserver_preferred_server=value
Specify the name of the NetWare server that the print server uses for its initial attachment.

If you do not configure server, the print server uses the local NetWare server for its initial attachment.

Maximum length: 127. Default: Not Configured.

pserver_preferred_tree=value
Specify the name of the NDS tree that the print server uses when attempting initial authentication.

If you do not configure a preferred tree, the preferred server is used for authentication.

Maximum length: 127. Default: Not Configured.

Printing (NPRINTER) parameters (folder 13)

nprinter_config_directory=value
Specify the name of the directory containing the NPRINTER configuration files.

Maximum length: 127. Default: nprinter.

nprinter_config_file=value
Specify the name of the remote printing configuration file.

Maximum length: 127. Default: RPConfig.

nprinter_console_device=value
Specify where NPRINTER error and console messages are sent.

Maximum length: 127. Default: Not Configured.

nprinter_control_file=value
Specify the name of the remote print server control file.

Maximum length: 127. Default: RPControl.

nprinter_prt_file=value
Specify the name of the printing configuration control file.

Maximum length: 127. Default: PRTConfig.

NVT parameters (folder 14)

spx_network_rlogin=value
Determine whether NVT remote login services are activated.

Supported values: ``Yes'', ``No''. Default: ``No''.

Time synchronization parameters (folder 15)

ts_add_time_source=value
Specify a NetWare server to be added to the end of the configured time source list specified with the ts_time_source parameter.

Maximum length: 48. Default: Not Configured.

ts_configured_sources=value
Determine whether the server relies exclusively on servers specified by the ts_time_source parameter.

When set to ``Yes'', the server relies exclusively on the servers specified by the ts_time_source parameter and ignores any advertising time sources.

When set to ``No'', the server attempts to contact a listed time source. If the server is unable to contact any, or the list is empty, then the server attempts to contact any advertising time source.

The server needs to contact only one time source.

Supported values: ``Yes'', ``No''. Default: ``No''.

ts_correction_floor=number
Control how closely servers will attempt to synchronize their clocks (in milliseconds). Adjustments smaller than this value are ignored.

Make sure the value of this parameter does not exceed the value specified by the ts_synchronization_radius parameter, or synchronization might not be achieved.

Supported values: 0 to 16777215. Default: 1.

ts_debug=number
Enable debug trace output at various points in the code.

Supported values: 0 to 7. Default: 0.

ts_directory_tree_mode=value
Control whether the server synchronizes only with servers in its NDS tree, or with all servers on the network.

This parameter has no effect if the ts_configured_sources parameter is set to ``Yes''.

If ts_configured_sources is set to ``No'', and ts_directory_tree_mode is set to ``Yes'', the server synchronizes only with servers in its tree.

If ts_configured_sources is set to ``No'', and ts_directory_tree_mode is set to ``No'', the server attempts to synchronize with any time source on the network.

If you use this configuration, make sure only valid time sources are advertising.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

ts_maximum_offset=number
Determine the maximum time adjustment, in seconds, that the server can make during one polling interval.

Maximum adjustment: 6 months. Supported values: 1 to 16777215. Default: 600.

ts_offset_ceiling=number
Limit the magnitude of the calculated error between two time sources.

If the server polls another time source that is out of synchronization by more than this amount, the server ignores the time source, assuming it is broken and unreliable.

The default value is a large number to increase the likelihood that all servers achieve time synchronization. Use caution when decreasing this parameter because it can lead to a situation in which the network is dividing into several portions that are converging to different time sources.

Supported values: 0 to 315532800 seconds (10 years). Default: 2000.

ts_polling_count=number
Specify how many time packets to exchange when polling. Increasing this number adds unnecessary traffic to the network.

Supported values: 1 to 1000. Default: 3.

ts_polling_interval=number
Determine how often (in seconds) the server checks to see if it is time synchronized with the network. All servers in the same NDS tree should use the same value.

Maximum setting: 31 days. Supported values: 0 to 2678400. Default: 600.

ts_remove_time_source=value
Specify a NetWare server to be removed from the configured time source list specified by the ts_time_source parameter.

Maximum length: 48. Default: Not Configured.

ts_service_advertising=value
Determine whether a time source advertises.

If set to ``Yes'', Single Reference, Reference, and Primary time sources advertise. You should set this parameter to ``No'' if you specified servers with the ts_time_source parameter. Secondary time servers do not advertise.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

ts_short_interval=number
Specify how often time synchronization polling occurs (in seconds) when a server discovers it is not synchronized with network time.

After the server is synchronized, the polling interval increases until the server is using the value specified by the ts_polling_interval parameter.

Supported values: 0 to 600. Default: 10.

ts_synchronization_radius=number
Control the maximum time adjustment, in milliseconds, that a server can differ from network time and still be considered synchronized.

Increase this parameter to allow a larger time difference between servers. Lowering the synchronization radius increases the chance of servers losing synchronization because of randomness between clocks.

Setting this parameter under 2000 milliseconds (2 seconds) is not recommended unless you are using an application that will not tolerate a 2000 millisecond deviation between time sources.

Supported values: 0 to 2147483647. Default: 2000.

ts_time_adjustment=[+ | -] hour:minute:second [at month/day/year hour:minute:second] [AM | PM]
Determine the size, date, and time of a single time adjustment.

If you do not specify a date and time, they default to six polling intervals or one hour from the current time, whichever is longer. All time sources synchronizing together adjust their clocks by the specified time at the specified date and time.

Use this parameter sparingly to correct network-wide time errors. Misuse of this parameter can corrupt time synchronization and the order of events on your network. You cannot use this parameter on a secondary time server. A Reference time server ignores the adjustments from primary time servers.

Maximum length: 99. Default: Not Configured.

ts_time_source=value
Specify a list of one or more time source servers.

Server names must be separated by spaces and are polled in the order they are listed. The server needs to successfully poll only one time source; once a time source is polled, no other time sources in the list are contacted.

Default: Not Configured.

ts_type=value
Determine how the server synchronizes time and is initially set during NDS installation. By default, time synchronization occurs within an NDS tree.

Supported types:

SINGLE
typically used for smaller LANs and serve as the sole time source

REFERENCE
typically used for larger LANs; and serve as a time source for Primary and Secondary servers

PRIMARY
typically used with a Reference server or other Primary servers

SECONDARY
obtain time from a Single Reference, Reference, or Primary time server

Default: Not Configured

NetWare for UNIX Client (NUC) parameters (folder 16)

netware_single_login=value
Determine whether NetWare UNIX clients can use their UnixWare passwords for backgroundauthentication to NetWare servers.

When set to ``Yes'', the authentication panel is displayed when necessary.

When set to ``No'', users must use nwlogin to access NetWare servers. or security reasons, a value of ``No'' also prevents the authentication panel from being displayed on a remote system.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

nuc=value
Determine whether NetWare UNIX client services are available. This service allows UnixWare users to access NetWare servers.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

nuc_checksum_level=value
Determine whether the client validates the data integrity of IPX packets.

Supported values:

Disabled (0)
client will not check or generate checksums

Enabled (1)
client will check and generate checksums if requested, but does not require them

Required (2)
client requires checksums

Default: Enabled (1).

nuc_signature_level=value
Determine whether the client generates signatures for NCP packets.

Supported values:

Disabled (0)
client will not respond to signature requests

Enabled (1)
client responds to signature requests, but does not request them

Preferred (2)
client requests signatures, but does not require them

Required (3)
client requires signatures

Default: Enabled (1).

nuc_xauto_panel=value
Control how users access NetWare Services.

If set to ``Yes'', the authentication window is displayed whenever necessary. If set to ``No'', users must use nwlogin to access NetWare Services.

Supported values: ``Yes'', ``No''. Default: ``Yes''.

NetWare over IP (NWIP) parameters (folder 17)

nwip_db_sync_interval=seconds
The time interval in seconds between synchronizing the SAP/RIP database with the DSS. The default value is 300 seconds.

nwip_domain
The NWIP DNS domain to which the host belongs.

nwip_nearest_server=server_list
A comma-separated list of NetWare/IP servers specified by their IP addresses.

nwip_nsq_broadcast=on|off
Defines whether NWIP will broadcast on the local TCP/IP network to locate the nearest Domain SAP/RIP Server (DSS). The default value is on.

nwip_port=port
The UDP port that NWIP will use to contact the DSS and other NetWare/IP servers. The default value is 43981 (0xABCD).

nwip_preferred_dss=DSS_list
A comma-separated list of preferred DSS servers specified by their IP addresses.

Usage

If you use spaces before or after the equal sign, surround the parameter with quotation marks. For example:

nwcm -s burst_mode_protocol=on

or

nwcm -s ``burst_mode_protocol = on''

References

``NetWare Setup''

``Maintaining the NetWare server''


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.