ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgsnmpa.htm

409 lines
14 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change SNMP Attributes (CHGSNMPA)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="CHGSNMPA.Top_Of_Page"></a>
<h2>Change SNMP Attributes (CHGSNMPA)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CHGSNMPA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGSNMPA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGSNMPA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGSNMPA"></a>
<p>The Change SNMP Attributes (CHGSNMPA) command changes values and options used by the OS/400 SNMP agent. The command also is used to specify which SNMP managers receive traps generated by the local AS/400 system.
</p>
<p>The SNMP agent is shipped with the following values for the SNMP attributes.
</p>
<dl>
<dt><b>Keyword</b></dt>
<dd><b> Value
</b></dd>
<dt><b>SYSCONTACT </b></dt>
<dd>*NONE
</dd>
<dt><b>SYSLOC </b></dt>
<dd>*NONE
</dd>
<dt><b>SNDAUTTRP </b></dt>
<dd>*YES
</dd>
<dt><b>AUTOSTART </b></dt>
<dd>*NO
</dd>
<dt><b>OBJACC </b></dt>
<dd>*READ
</dd>
<dt><b>LOGSET </b></dt>
<dd>*NO
</dd>
<dt><b>LOGGET </b></dt>
<dd>*NO
</dd>
<dt><b>LOGTRP </b></dt>
<dd>*NO
</dd>
<dt><b>TRPMGR </b></dt>
<dd>*NONE
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGSNMPA.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.SYSCONTACT"><b>SYSCONTACT</b></a></td>
<td valign="top">System contact</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE, *CNTINF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.SYSLOC"><b>SYSLOC</b></a></td>
<td valign="top">System location</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE, *CNTINF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.SNDAUTTRP"><b>SNDAUTTRP</b></a></td>
<td valign="top">Send authentication traps</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.AUTOSTART"><b>AUTOSTART</b></a></td>
<td valign="top">Automatic start</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.OBJACC"><b>OBJACC</b></a></td>
<td valign="top">Object access</td>
<td valign="top"><b><u>*SAME</u></b>, *READ, *WRITE, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.LOGSET"><b>LOGSET</b></a></td>
<td valign="top">Log set requests</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.LOGGET"><b>LOGGET</b></a></td>
<td valign="top">Log get requests</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSNMPA.LOGTRP"><b>LOGTRP</b></a></td>
<td valign="top">Log traps</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGSNMPA.TRPMGR"><b>TRPMGR</b></a></td>
<td valign="top">Trap managers</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 300 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Manager internet address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Community name</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 3: Translate community name</td>
<td valign="top">
<b><u>*YES</u></b>, *NO</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGSNMPA.SYSCONTACT"></a>
<h3>System contact (SYSCONTACT)</h3>
<p>Specifies the name of the contact person for this AS/400 system, along with information on how to contact this person. This value is used only by SNMP-specific functions. This value also may be read or modified by an authorized SNMP manager.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No system contact exists.
</dd>
<dt><b>*CNTINF</b></dt>
<dd>The value is obtained from the service contact information specified by using the Work with Contact Information (WRKCNTINF) command. The value obtained consists of the contact person and the contact telephone numbers.
</dd>
<dt><b><i>system-contact</i></b></dt>
<dd>Specify the name of the contact person and other contact information. All of the characters specified must be able to be translated into the ASCII character set.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.SYSLOC"></a>
<h3>System location (SYSLOC)</h3>
<p>Specifies the physical location of this AS/400 system. This value is used only by SNMP-specific functions. This value also may be read or modified by an authorized SNMP manager.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No system location information exists.
</dd>
<dt><b>*CNTINF</b></dt>
<dd>The value is obtained from the service contact information specified by using the Work with Contact Information (WRKCNTINF) command. The value obtained consists of the mailing address.
</dd>
<dt><b><i>system-location</i></b></dt>
<dd>Specify the physical location of the system. All of the characters specified must be able to be translated into the ASCII character set.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.SNDAUTTRP"></a>
<h3>Send authentication traps (SNDAUTTRP)</h3>
<p>Specifies whether the SNMP agent may send any authenticationFailure traps to any defined SNMP managers. An authenticationFailure trap is sent by the SNMP agent if a request is received from an SNMP manager that contains a community name that is not recognized by the SNMP agent. This trap is only sent when SNDAUTTRP is *YES and when at least one trap manager has been defined. This value may also be read or modified by an authorized SNMP manager.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>authenticationFailure traps may be sent.
</dd>
<dt><b>*NO</b></dt>
<dd>authenticationFailure traps are not sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.AUTOSTART"></a>
<h3>Automatic start (AUTOSTART)</h3>
<p>Specifies whether the SNMP agent is started when the STRTCP command or STRTCPSVR SERVER(*AUTOSTART) command runs.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>The SNMP agent is started when the STRTCP command or STRTCPSVR SERVER(*AUTOSTART) command runs.
</dd>
<dt><b>*NO</b></dt>
<dd>The SNMP agent is not started when the STRTCP command runs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.OBJACC"></a>
<h3>Object access (OBJACC)</h3>
<p>Specifies the default object access for SNMP communities.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*READ</b></dt>
<dd>Allow SNMP managers that are part of a community to read all management information base (MIB) objects. Modification of MIB objects by SNMP managers is not permitted.
</dd>
<dt><b>*WRITE</b></dt>
<dd>Allow SNMP managers that are part of a community to modify all MIB objects that can be modified. Specifying *WRITE implies *READ access.
</dd>
<dt><b>*NONE</b></dt>
<dd>Do not allow SNMP managers that are part of a community to modify any MIB objects.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.LOGSET"></a>
<h3>Log set requests (LOGSET)</h3>
<p>Specifies the default value for whether set requests from SNMP managers in a community are logged in journal QSNMP in library QUSRSYS.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>Set requests are logged.
</dd>
<dt><b>*NO</b></dt>
<dd>Set requests are not logged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.LOGGET"></a>
<h3>Log get requests (LOGGET)</h3>
<p>Specifies the default value for whether get requests and get-next requests from SNMP managers in a community are logged in journal QSNMP in library QUSRSYS.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>Get requests and get-next requests are logged.
</dd>
<dt><b>*NO</b></dt>
<dd>Get requests and get-next requests are not logged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.LOGTRP"></a>
<h3>Log traps (LOGTRP)</h3>
<p>Specifies whether traps are logged in journal QSNMP in library QUSRSYS.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>Traps are logged.
</dd>
<dt><b>*NO</b></dt>
<dd>Traps are not logged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSNMPA.TRPMGR"></a>
<h3>Trap managers (TRPMGR)</h3>
<p>Specifies which SNMP managers receive traps generated by this AS/400 system.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No SNMP managers receive traps.
<p><b>Element 1: Manager Internet Address</b>
</p>
</dd>
<dt><b><i>manager-internet-address</i></b></dt>
<dd>Specify the internet address of the SNMP manager. The address must be of the form <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 to 255. This address is independent of the manager internet address specified on the ADDCOMSNMP and CHGCOMSNMP commands.
<p><b>Element 2: Community Name</b>
</p>
</dd>
<dt><b><i>community-name</i></b></dt>
<dd>Specify the SNMP community name to be placed in the traps sent to this SNMP manager. The community name specified in this element is independent of the community name specified on the ADDCOMSNMP, CHGCOMSNMP, and RMVCOMSNMP commands. The name may contain characters that cannot be displayed.
<p><b>Element 3: Translate Community Name</b>
</p>
</dd>
<dt><b><u>*YES</u></b></dt>
<dd>The community name is translated to ASCII characters when a trap is sent to the SNMP manager. This value should be specified when the community name consists entirely of characters that can be displayed. An error message is sent if the community name cannot be translated to ASCII characters.
</dd>
<dt><b>*NO</b></dt>
<dd>The community name is not translated to ASCII characters when a trap is sent to the SNMP manager. This value should be specified when the community name contains one or more characters that cannot be displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSNMPA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Changing System Contact and Automatic Start</b>
</p>
<p>
<pre>
CHGSNMPA SYSCONTACT('JOE SMITH, PHONE 555-1212')
AUTOSTART(*NO)
</pre>
</p>
<p>This command changes the system contact information and specifies that the SNMP agent should not start when the STRTCP command runs. All other values are unchanged.
</p>
<p><b>Example 2: Changing Trap Managers</b>
</p>
<p>
<pre>
CHGSNMPA TRPMGR(('9.8.7.6' 'TRAPCOMMUNITY')
('9.8.7.5' 'TRAPCOMMUNITY2'))
</pre>
</p>
<p>This command causes any traps generated by the local iSeries 400 to be sent to SNMP managers that have internet protocol addresses 9.8.7.6 and 9.8.7.5. Community name TRAPCOMMUNITY is placed in traps sent to 9.8.7.6, and community name TRAPCOMMUNITY2 is placed in traps sent to 9.8.7.5. For both managers the community name is translated to ASCII characters before being placed in the trap.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSNMPA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>TCP4001</b></dt>
<dd>Error occurred accessing SNMP configuration information.
</dd>
<dt><b>TCP8050</b></dt>
<dd>*IOSYSCFG authority required to use &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSNMPA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>