The Change Community for SNMP (CHGCOMSNMP) command changes an SNMP community profile in the SNMP agent community list. An SNMP agent uses a community profile to determine whether or not to honor a request sent by an SNMP manager. The community profile consists of a community name, an object access specification, and a list of the SNMP managers that are part of the community. The community name combined with the ASCII community (ASCIICOM) parameter defines a community.

Parameters

Keyword	Description	Choices	Notes
COM	Community name	Character value	Required, Key, Positional 1
ASCIICOM	Translate community name	*YES, *NO	Optional, Key
INTNETADR	Manager internet address	Single values: *SAME, *ANY Other values (up to 300 repetitions): Character value	Optional
OBJACC	Object access	*SAME, *SNMPATR, *READ, *WRITE, *NONE	Optional
LOGSET	Log set requests	*SAME, *SNMPATR, *YES, *NO	Optional
LOGGET	Log get requests	*SAME, *SNMPATR, *YES, *NO	Optional

Top

Community name (COM)

Specifies the name of the SNMP community being changed. The community must already exist in the SNMP agent community list. You can define an SNMP community using the Add Community for SNMP (ADDCOMSNMP) command.

The possible values are:

community-name

Specify the name of the SNMP community being changed. The name may contain characters that cannot be displayed.

Translate community name (ASCIICOM)

Specifies whether the community name is translated to ASCII characters before it is compared with the community name specified in a request from an SNMP manager. This parameter is used in combination with the community name to determine the community to be changed.

The possible values are:

*YES

The community name is translated to ASCII characters before it is compared with a community name specified by an SNMP manager.

*NO

The community name is not translated to ASCII characters before it is compared with a community name specified by an SNMP manager.

Manager internet address (INTNETADR)

The internet addresses of the SNMP managers that are part of this community.

The possible values are:

*SAME

The value does not change.

*ANY

Allow any SNMP manager to be part of this community.

manager-internet-address

Specify the internet address of the SNMP manager. The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes. Up to 300 unique internet addresses may be specified. The same internet address may appear in more than one community profile.

Object access (OBJACC)

Specifies the object access for the community.

The possible values are:

*SAME

The value does not change.

*SNMPATR

The object access defined with the Change SNMP Attributes (CHGSNMPA) command is used for this community.

*READ

Allow SNMP managers that are part of this community to read all management information base (MIB) objects. Modification of MIB objects by SNMP managers is not permitted.

*WRITE

Allow SNMP managers that are part of this community to change all MIB objects that can be changed. Specifying *WRITE implies *READ access.

*NONE

Do not allow SNMP managers that are part of this community to access any MIB objects.

Log set requests (LOGSET)

Specifies whether Set requests from SNMP managers in this community are logged in journal QSNMP in library QUSRSYS.

The possible values are:

*SAME

The value does not change.

*SNMPATR

The value defined with the Change SNMP Attributes (CHGSNMPA) command is used for this community.

*YES

Set requests are logged.

*NO

Set requests are not logged.

Log get requests (LOGGET)

Specifies whether get requests and get-next requests from SNMP managers in this community are logged in journal QSNMP in library QUSRSYS.

The possible values are:

*SAME

The value does not change.

*SNMPATR

The value defined with the Change SNMP Attributes (CHGSNMPA) command is used for this community.

*YES

Get requests and get-next requests are logged.

*NO

Get requests and get-next requests are not logged.

Examples

CHGCOMSNMP   COM(ENDICOTT)  INTNETADR(*ANY)  OBJACC(*READ)

This command changes community ENDICOTT to have an object access of read and to allow any SNMP manager to read the MIB objects on this system. All of the other community values are unchanged.

Error messages

*ESCAPE Messages

TCP4001

Error occurred accessing SNMP configuration information.

TCP4009

Community does not exist.

TCP8050

*IOSYSCFG authority required to use &1.