ADDCOMSNMP

La commande Ajouter une communauté SNMP (ADDCOMSNMP) définit un profil de communauté SNMP et l'ajoute à la liste des communautés de l'agent SNMP. Un agent SNMP utilise un profil de communauté pour déterminer s'il doit ou non donner suite à une demande envoyée par un gestionnaire SNMP. Le profil de communauté se compose d'un nom de communauté, d'une spécification d'accès aux objets et d'une liste des gestionnaires SNMP qui font partie de la communauté. Le nom de communauté associé au paramètre de communauté ASCII (ASCIICOM) définit une communauté. The Add Community for SNMP (ADDCOMSNMP) command defines an SNMP community profile and adds it to 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.

Plusieurs profils de communauté, chacun ayant un nom de communauté unique, peuvent coexister dans la liste des communautés de l'agent SNMP. De même, la même adresse Internet peut figurer dans plusieurs profils de communauté. Multiple community profiles, each having a unique community name may exist in the SNMP agent community list at one time. Similarly, the same internet address may appear in more than one community profile.

L'agent du système d'exploitation IBM i ne prend pas en charge les vues de communauté. Une vue est un sous-ensemble des objets de la base d'informations de gestion (MIB). Chaque communauté IBM i se compose de tous les objets de la MIB. The IBM i operating system agent does not support community views. A view is a subset of the objects in the management information base (MIB). Each IBM i community consists of all of the objects in the MIB.

Restrictions:

• Vous devez posséder le droit spécial de configuration du système d'entrée-sortie (*IOSYSCFG) pour utiliser cette commande. You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
• An SNMP manager sends three types of requests: get, get-next, and set. Get and get-next requests are used to read management information base (MIB) variables, and a set request is used to modify MIB variables. For a request from an SNMP manager to be accepted by the SNMP agent, all of the following must be true:
  1. Le nom de communauté de la demande du gestionnaire SNMP indique une communauté définie. The community name in the SNMP manager request specifies a defined community.
  2. L'adresse Internet du gestionnaire qui a envoyé la demande doit figurer dans le profil de communauté. The internet address of the manager that sent the request must be listed in the community profile.
  3. Pour une demande set, l'accès aux objets de la communauté doit autoriser les opérations d'écriture. Pour une demande get ou get-next, les opérations de lecture doivent être autorisées. For a set request, the community object access must allow write operations to occur. For a get request or get-next request, read operations must be allowed.
  4. Pour une demande set, l'objet indiqué dans la demande doit pouvoir être modifié. Pour une demande get ou get-next, l'objet doit pouvoir être lu. For a set request, the object specified in the request must be able to be changed. For a get request or get-next request, the object must be readable.

Paramètres

Nom de communauté (COM)Community name (COM)

Indique le nom de la communauté SNMP ajoutée. Chaque nom de communauté SNMP doit être unique. Specifies the name of the SNMP community being added. Each SNMP community name must be unique.

community-name

Indiquez le nom de la communauté SNMP ajoutée. Le nom peut contenir des caractères non affichables. Specify the name of the SNMP community being added. The name may contain characters that cannot be displayed.

Traduire le nom de communauté (ASCIICOM)Translate community name (ASCIICOM)

Indique si le nom de communauté est traduit en caractères ASCII lorsque le profil de communauté est ajouté à la liste des communautés de l'agent SNMP. Specifies whether the community name is translated to ASCII characters when the community profile is added to the SNMP agent community list.

*YES

Le nom de communauté est traduit en caractères ASCII lorsque le profil de communauté est ajouté à la liste des communautés de l'agent SNMP. Cette valeur doit être indiquée si le système du gestionnaire SNMP définit ses noms de communauté uniquement avec des caractères ASCII. Un message d'erreur est envoyé si le nom de communauté ne peut pas être traduit en caractères ASCII. The community name is translated to ASCII characters when the community profile is added to the SNMP agent community list. This value should be specified if the SNMP manager system defines its community names entirely of ASCII characters. An error message is sent if the community name cannot be translated to ASCII characters.

*NO

Le nom de communauté n'est pas traduit en caractères ASCII lorsque le profil de communauté est ajouté à la liste des communautés de l'agent SNMP. Cette valeur doit être indiquée si le système du gestionnaire SNMP définit ses noms de communauté avec des caractères EBCDIC ou des caractères non affichables. The community name is not translated to ASCII characters when the community profile is added to the SNMP agent community list. This value should be specified if the SNMP manager system defines its community names using EBCDIC characters or characters that cannot be displayed.

Adresse Internet du gestionnaire (INTNETADR)Manager internet address (INTNETADR)

Indique les adresses Internet et le masque d'adresse Internet des gestionnaires SNMP qui font partie de cette communauté. L'adresse Internet peut être une adresse IPv4 ou IPv6. Specifies the internet addresses and internet address mask of the SNMP managers that are part of this community. The internet address may be an IPv4 or IPv6 address.

Valeurs uniques

*ANY

Autorise n'importe quel gestionnaire SNMP à faire partie de cette communauté. Allow any SNMP manager to be part of this community.

Autres valeurs (jusqu'à 300 répétitions)

Élément 1: Manager Internet Address

manager-internet-address

An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 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. An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in 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.

Élément 2: IP address mask

manager-internet-address-mask

Si l'adresse du gestionnaire associé est une adresse IPv6, le masque d'adresse Internet est soit un masque d'adresse IPv6 (par exemple FFFF:FFFF::), soit un entier de 0 à 128 indiquant le nombre de bits de préfixe d'adresse IPv6 utilisés pour construire un masque d'adresse IPv6. Si l'adresse Internet du gestionnaire est une adresse IPv4, le masque d'adresse Internet est soit un masque d'adresse IPv4 (par exemple 255.255.255.0), soit un entier de 0 à 32 indiquant le nombre de bits de préfixe d'adresse IPv4 utilisés pour construire un masque d'adresse IPv4. If the associated manager address is an IPv6 address, then the internet address mask is either an IPv6 address mask (for example, FFFF:FFFF::) or an integer from 0 to 128 specifying the number of IPv6 address prefix bits used to construct an IPv6 address mask. If the manager internet address is an IPv4 address, then internet address mask is either an IPv4 address mask (for example, 255.255.255.0) or an integer from 0 to 32 specifying the number of IPv4 address prefix bits used to construct an IPv4 address mask.

Accès aux objets (OBJACC)Object access (OBJACC)

Indique l'accès aux objets pour la communauté. Specifies the object access for the community.

*SNMPATR

L'accès aux objets défini par la commande Modifier les attributs SNMP (CHGSNMPA) est utilisé pour cette communauté. The object access defined with the Change SNMP Attributes (CHGSNMPA) command is used for this community.

*READ

Autorise les gestionnaires SNMP qui font partie de cette communauté à lire tous les objets de la base d'informations de gestion (MIB) avec des demandes get ou get-next. La modification des objets de la MIB par les gestionnaires SNMP n'est pas autorisée. Allow SNMP managers that are part of this community to read all management information base (MIB) objects with get or get-next requests. Modification of MIB objects by SNMP managers is not permitted.

*WRITE

Autorise les gestionnaires SNMP qui font partie de cette communauté à modifier, avec des demandes set, tous les objets de la MIB qui peuvent être modifiés. La spécification de *WRITE implique l'accès *READ. Allow SNMP managers that are part of this community to change all MIB objects that are able to change with set requests. Specifying *WRITE implies *READ access.

*NONE

N'autorise aucun accès aux objets de la MIB aux gestionnaires SNMP qui font partie de cette communauté. Do not allow SNMP managers that are part of this community any access to MIB objects.

Consigner les demandes set (LOGSET)Log set requests (LOGSET)

Indique si les demandes set des gestionnaires SNMP de cette communauté sont consignées dans le journal QSNMP de la bibliothèque QUSRSYS. Specifies whether set requests from SNMP managers in this community are logged in journal QSNMP in library QUSRSYS.

*SNMPATR

La valeur définie par la commande Modifier les attributs SNMP (CHGSNMPA) est utilisée pour cette communauté. The value defined with the Change SNMP Attributes (CHGSNMPA) command is used for this community.

*YES

Les demandes set sont consignées. Set requests are logged.

*NO

Les demandes set ne sont pas consignées. Set requests are not logged.

Consigner les demandes get (LOGGET)Log get requests (LOGGET)

Indique si les demandes get et get-next des gestionnaires SNMP de cette communauté sont consignées dans le journal QSNMP de la bibliothèque QUSRSYS. Specifies whether get requests and get-next requests from SNMP managers in this community are logged in journal QSNMP in library QUSRSYS.

*SNMPATR

La valeur définie par la commande Modifier les attributs SNMP (CHGSNMPA) est utilisée pour cette communauté. The value defined with the Change SNMP Attributes (CHGSNMPA) command is used for this community.

*YES

Les demandes get et get-next sont consignées. Get requests and get-next requests are logged.

*NO

Les demandes get et get-next ne sont pas consignées. Get requests and get-next requests are not logged.

Exemples

ADDCOMSNMP   COM(ROCHESTER)
             INTNETADR(('8.6.5.4' '255.255.255.0'))
             OBJACC(*WRITE)

Cette commande ajoute la communauté ROCHESTER à la liste des communautés de l'agent SNMP. Les gestionnaires SNMP dont les adresses Internet sont 8.6.5.4 et 8.6.5.3 sont les seuls gestionnaires de la communauté et peuvent modifier tous les objets de la MIB. This command adds the community ROCHESTER to the SNMP agent community list. SNMP managers with internet addresses 8.6.5.4 and 8.6.5.3 are the only managers in the community and are able to change all MIB objects.

Exemple 2Example 2

ADDCOMSNMP   COM(PUBLIC2)
             INTNETADR(('10.4.120.97' 16)( '9.71.128.4'
             '255.255.255.0') ('192.4.52.1' '255.255.0.0'))

Cette commande ajoute la communauté PUBLIC2 à la liste des communautés de l'agent SNMP. Les gestionnaires SNMP dont les adresses Internet sont 10.4.120.97, 9.71.128.4 et 192.4.52.1 sont les seuls gestionnaires de la communauté et peuvent modifier tous les objets de la MIB. Notez que le premier masque Internet est égal au masque 255.255.0.0. Toutes les autres valeurs de communauté restent inchangées. This command adds community PUBLIC2 to the SNMP agent community list. SNMP managers with internet addresses 10.4.120.97, 9.71.128.4, and 192.4.52.1 are the only managers in the community and are able to change all MIB objects. Note that the first internet mask is equal to 255.255.0.0 mask. All of the other community values are unchanged.

Exemple 3Example 3

ADDCOMSNMP   COM(PRIVATE)
             INTNETADR(('2001:db8::10f' 64)('2001:db8::10e'
             'FFFF:FFFF:FFFF:FFFF::'))

Cette commande ajoute la communauté PRIVATE à la liste des communautés de l'agent SNMP. Les gestionnaires SNMP dont les adresses Internet sont 2001:db8::10f et 2001:db8::10e sont les seuls gestionnaires de la communauté et peuvent modifier tous les objets de la MIB. Notez que la longueur de préfixe de la première adresse Internet est égale au masque FFFF:FFFF:FFFF:FFFF:: en notation hexadécimale à deux-points. Toutes les autres valeurs de communauté restent inchangées. This command adds community PRIVATE to the SNMP agent community list. SNMP managers with internet addresses 2001:db8::10f and 2001:db8::10e are the only managers in the community and are able to change all MIB objects. Note that the prefix length of the first internet address is equal to the second colon hexadecimal notation FFFF:FFFF:FFFF:FFFF:: mask. All of the other community values are unchanged.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP4001

Une erreur s'est produite lors de l'accès aux informations de configuration SNMP. Error occurred accessing SNMP configuration information.

TCP4008

La communauté existe déjà. Code anomalie &3. Community already exists. Reason code &3.

TCP8050

Le droit *IOSYSCFG est requis pour utiliser &1. *IOSYSCFG authority required to use &1.