ntx_nms Command

AIX Version 4.3 Commands Reference, Volume 4

ntx_nms Command

Purpose

Displays and configures network management station (NMS) authentication for the Network Terminal Accelerator (NTX) Simple Network Management Protocol (SNMP) agent.

Syntax

ntx_nms [ -d Device ] [ -f File | [ -r ] Host ]

Description

The ntx_nms command displays and configures NMS authentication for the adapter's SNMP agent. If you issue this command without any flags, the command displays the NMS configuration for the adapter identified by the /dev/rhp0 device file. The configuration is displayed on standard output in the same format required by the File parameter.

You configure NMS authentication by providing a list of authentication hosts to the SNMP agent. You can add to or remove from the list of authenticated hosts with the ntx_nms command. If you do not configure NMS authentication, then the SNMP agent accepts protocol data units (PDUs) from any NMS. To authenticate SNMP PDUs, run the ntx_nms command before starting the SNMP agent with the ntx_snmp command.

When authentication is in place, the SNMP agent discards PDUs from any NMS host that is not on its authentication list. If you have both NMS authentication and traps configured, the agent generates an authentication failure trap when it refuses a PDU. If traps are not configured, the agent discards the PDU and does not generate a trap. For information on configuring traps, see the ntx_traps command.

Flags

-d Device	Specifies the adapter raw device file name. The default is the /dev/rhp0 file.
-f File	Identifies a NMS configuration file. This file contains a list of hosts to authenticate. Each entry in the list is separated by new-line characters. Each entry on the list is a host name or Internet address. Comment lines are designated with the # (pound sign). Characters to the right of the # (pound sign) are ignored.
-r Host	Removes the specified host from the authentication list.

Parameters

Host

Specifies a host name or an Internet address to add to the authentication list.

Exit Status

This command returns the following exit values:

0	Successful completion.
>0	An error occurred.

Security

Access Control: You must have root authority to run this command.

Auditing Events: N/A

Examples

To configure the SNMP agent to receive PDUs from the host at 192.6.153.6, enter:

ntx_nms 192.6.153.6

Files

/usr/bin/ntx_nms	Contains the ntx_nms command.
/dev/rhp0	Default NTX raw device file name.

Related Information

Commands: ntx_snmp, ntx_traps.

Files: /dev/rhp.

"Configuring the Network Terminal Accelerator" in AIX Versions 3.2 and 4 Asynchronous Communications Guide