[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
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

The ntx_snmp, and ntx_traps commands.

The /dev/rhp file.

Network Terminal Accelerator Overview in AIX Versions 3.2 and 4 Asynchronous Communications Guide.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]