ntx_comun Command

AIX Version 4.3 Commands Reference, Volume 4

ntx_comun Command

Purpose

Displays and configures a Simple Network Management Protocol (SNMP) community profile for a Network Terminal Accelerator (NTX).

Syntax

ntx_comun [ -d Device ] [ -f File | [ -o ObjectID ] Community { na | ro | rw } ]

Description

The ntx_comun command displays and configures an adapter's SNMP community profile. A profile consists of community names and their respective permissions that determine access to Management Information Base (MIB) objects. If you do not specify any flags with the ntx_comun command, the command retrieves the current community configuration profile from the adapter and displays it on the standard output. The output is in the format required by the File parameter.

You can also use this command to configure community profiles. A community is a set of network management stations (NMSs) that have access to the adapter's SNMP agent. The Community parameter specifies the community name. The Community parameter is an ASCII string. You should configure community profiles with the ntx_comun command before issuing the ntx_snmp command to turn on the SNMP agent.

You use the -o flag to identify an ID for a MIB object or subtree. You can set the community's access mode to the object as one of the following:

na	not accessible
ro	read-only
rw	read-write

To configure permissions for multiple MIB subtrees for a single community, the host must issue the ntx_comun command multiple times for each subtree.

When the adapter's SNMP agent receives an protocol data unit (PDU), the agent first verifies that the community specified within the PDU has appropriate access to all of the MIB variables specified in the PDU. If the community profiles are not configured before the SNMP agent begins receiving PDUs, the SNMP agent uses a default read-only community profile with a community name of public.

Flags

-d Device

Specifies the raw device file name of the adapter. Use this option to override the default device name /dev/rhp0.

-f File

Reads the community profile configuration file and sends it to the adapter. A configuration file can have one or more entries with one entry per line. Each entry ends with a new-line character and has the following form:

ObjectID Community Mode

These fields have the following values:

ObjectID: Identifies the MIB object. You can specify a single ID in dot notation or use the all keyword to specify all objects.
Community: Specifies the community name.
Mode: Sets the access mode. You can specify ro (read-only), rw (read/write), or na (not accessible).

Separate each field with a space or tab character. To create a comment line, start a line with a # (pound sign). Characters to the right of the # (pound-sign) are ignored.

-o ObjectID

Identifies an MIB object. The ObjectID variable is a dot notation string. You can specify an ID for a leaf object or an MIB subtree. If the ObjectID variable identifies a subtree, access includes all elements of that tree. If the ObjectID variable is not specified, then access permission includes the whole MIB. Refer to the relevant MIB documents to determine the ID for an object.

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 set the community name to public, with access denied only to 1.3.6.1.2.1.1.3.0, enter:
```
ntx_comun -o 1.3.6.1.2.1.1.3.0 public na
```
To set the community with read-only access to the system group, enter:
```
ntx_comun -o 1.3.6.1.2.1.1 rosys ro
```
To set the community with read-write access to the whole MIB, enter:
```
ntx_comun writer rw
```
To set the community with no access at all, enter:
```
ntx_comun criminal na
```

Files

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

Related Information

The ntx_snmp command.

The rhp file.

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

RFC 1213, Management Information Base for Network Management of TCP/IP-Based Internets: MIB-II.