Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP 9000 Networking: NetWare 4.1/9000 Utilities Reference > Chapter 3 Server Utilities

nwcm

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

Purpose

CAUTION: This command should only be used to configure parameters that are not configurable using the System Administration Manager (SAM).

Use at the HP-UX prompt to

  • View and configure NetWare Services system parameters.

  • Update NetWare Services parameters in the startup files.

  • View and change IPX/SPX configuration information.

  • View adapter and device information.

  • View default settings for NetWare Services volumes.

  • View NetWare Services network information.

Syntax

nwcm [option...]

Option

Use to

-s param=value

Set the parameter to the indicated value. Replace param with a parameter from the "nwcm Parameters Tables."

-v param

View the value of the parameter. Replace param with a parameter from the "nwcm Parameters Tables."

-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 the "nwcm Parameters Tables."

-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 the "nwcm Parameters Tables."

-h param

View the input-help string for the specified parameter from the message catalog. Replace param with a parameter from the "nwcm Parameters Tables."

nwcm Parameters Tables

The following tables list the nwcm parameters and describe when to use them:

  • "General Server Parameters"

  • "NDS Parameter"

  • "System Tunable Parameters"

  • "Miscellaneous Parameters"

  • "Localization Parameters"

  • "IPX/SPX Parameters"

  • "SAP Parameters"

  • "NetWare Management Parameters"

  • "Printing (PSERVER) Parameters"

  • "Printing (NPRINTER) Parameters"

  • "NVT Parameter"

  • "Time Synchronization Parameters"

Table 3-1 General Server Parameters

Parameter

Use to

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

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

Default: "/dev/console"

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

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

enable_ipx_checksums =number

Determine whether the server validates the data integrity of IPX packets.

Supported values: Disabled (0)-server will not check or generate checksums, Enabled- (1) server will check and generate checksums if requested, but does not require them, Required (2)-server requires checksums

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.

Default: 1048576

Supported values: 65536 bytes to 4294967294 bytes

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-HP-UX permissions determine access, both-Both NetWare rights and HP-UX 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 HP- UX 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/ netware4/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_users_enabled =value

Determine whether hybrid user mapping is activated. If set to Yes, the server checks the / etc/netware4/nwusers file when a NetWare user logs in.

If a HP-UX username has been assigned to the NetWare user, all files and directories created by the NetWare user will be owned by the assigned NetWare 4.1/9000 user.

Supported values: Yes, No

Default: Yes

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, HP-UX 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 HP-UX permissions.

Supported values: Yes, No

Default: No

log_watchdog_logouts=va lue

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

login=value

Supported values: Yes, No

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.

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 x 4) + 10 is used to calculate this value.

Supported values: 0 to 49000

Default: 0

max_search_contexts=nu mber

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 HP-UX file system. If set to Yes, any NetWare byte range lock within a file will be reflected as a HP-UX byte range lock on the entire file. If set to No, NetWare byte range locks will not be reflected on the HP-UX file system.

Note that when set to Yes, the HP-UX lock is an advisory lock and a HP-UX process may ignore the lock and proceed with the read or write of the file. When NetWare/HP-UX file sharing is required, HP-UX 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: Disabled (0)-server will not respond to signature requests, Enabled (1)-server responds to signature requests, but does not request them, Preferred (2)-server requests signatures, but does not require them, Required (3)--server requires signatures

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_thre shold=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

 

Table 3-2 System Tunable Parameters

Parameter

Use to

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=nu mber

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

Supported values: 2 to 50

Default: 2

read_ahead_cache= 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

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 HP-UX file system. Changing the parameter may require a change in the size of shared memory.

Supported values: 4096 to 32768

Default: 8192

shm_access=number

Specify the HP-UX 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 HP-UX to ensure that no other processes use the same key for a shared memory segment. Change this parameter if HP-UX 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

 

Localization Parameters

Table 3-3 IPX/SPX Parameters

Parameter

Use to

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_log_file=value

Default: "diag.log"

Specify the name of the log file for diagnostic messages. The location of the log file is log_directory.

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

Maximum length: 127

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

lan_x_trsr=value

Controls whether or not this machine uses Token Ring source routing. When set to "Yes," other machines can be accessed across a Token Ring bridge. x can be a value between 1 and 16.

Supported values: Yes, No

Default: Yes

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 1010

Default: 1010

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 1010

Default: 1010

 

Table 3-4 SAP Param

Parameter

Use to

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 HP-UX filename (created in the directory log_directory), a valid path and filename, or /dev/null (disables logging).

Maximum length: 127

Default: "sap.dump"

sap_file_ compatibility= value

Enable or disable /var/spool/sap in,out file compatibility (provides backwards compatibility for HP-UX 10.10).

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 HP-UX filename (created in the directory log_directory), a valid path and filename, or /dev/null (disables logging).

Maximum length: 127

Default: "sap.log"

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 don't 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 HP-UX 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"

 

Table 3-5 NetWare Management Parameters

Parameter

Use to

nwum_trap_time= number

Specify, in seconds, how often the Network Management daemon checks for error conditions. A value of "-1" means disable traps

Supported values: -1 to 300

Default: 5

 

Table 3-6 Printing (PSERVER) Parameters

Parameter

Use to

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_password_ file=value

Specify the name of the file containing the print server password.

Maximum length: 127

Default: "password"

 

Table 3-7 Printing (NPRINTER) Parameters

Parameter

Use to

nprinter_console_ device=value

Specify where NPRINTER error and console messages are sent.

Maximum length: 127

Default: Not Configured

 

Table 3-8 Time Synchronization Parameters

Parameter

Use to

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_debug=number

Enable debug trace output at various points in the code.

Supported values: 0 to 7

Default: 0

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_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

 

Using nwcm

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"

To view all the parameters available with this command, use the -v parameter. For example:

nwcm -V*

Additional Information

Topic

See

NetWare Setup

"NetWare Setup"

"Maintaining the NetWare Server" in Supervising the Network

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1996 Hewlett-Packard Development Company, L.P.