z/OS UNIX snmp コマンド

snmp コマンドを使用して SNMP 要求をエージェントに出し、エージェントによって戻された SNMP 応答 を処理します。このコマンドは、65 535 バイトの最大 SNMP 応答パケット・サイズをサポートしています。SNMPv1、SNMPv2c、および SNMPv3 の要求をサポートしています。

トラップ要求タイプを指定して snmp コマンドを使用し、トラップおよび通知を受信し、フォーマットします。

形式:

MIB 変数の取得:

         .- -d 0-----------.  .- -h localhost---.   
>>-snmp--+-----------------+--+-----------------+--------------->
         '- -d debug_level-'  '- -h target host-'   

   .- -r 2------------.  .- -c public----------.   
>--+------------------+--+---------------------+---------------->
   '- -r retry number-'  '- - c community_name-'   

   .- -t 3-------------.                     
>--+-------------------+--+-----+--+-----+---------------------->
   '- -t timeout value-'  '- -v-'  '- -a-'   

>--+-get-----------------------------------------------------+-->
   +-getnext-------------------------------------------------+   
   | .- -m 10--------------.  .- -n 0-------------.          |   
   '-+---------------------+--+-------------------+--getbulk-'   
     '- -m max repetitions-'  '- -n non-repeaters-'              

   .--------------.   
   V              |   
>----mib_variable-+--------------------------------------------><

MIB 変数の設定:

         .- -d 0-----------.  .- -h localhost---.   
>>-snmp--+-----------------+--+-----------------+--------------->
         '- -d debug_level-'  '- -h target host-'   

   .- -r 2------------.  .- -c public----------.   
>--+------------------+--+---------------------+---------------->
   '- -r retry number-'  '- - c community_name-'   

   .- -t 3-------------.                          
>--+-------------------+--+-----+--+-----+--set----------------->
   '- -t timeout value-'  '- -v-'  '- -a-'        

   .----------------------------------.   
   V                                  |   
>----mib_variable--+---------+--value-+------------------------><
                   '-vartype-'            

MIB ツリーの探索:

         .- -d 0-----------.  .- -h localhost---.   
>>-snmp--+-----------------+--+-----------------+--------------->
         '- -d debug_level-'  '- -h target host-'   

   .- -r 2------------.  .- -c public----------.   
>--+------------------+--+---------------------+---------------->
   '- -r retry number-'  '- - c community_name-'   

   .- -t 3-------------.                     
>--+-------------------+--+-----+--+-----+---------------------->
   '- -t timeout value-'  '- -v-'  '- -a-'   

>--+-walk-----------------------------------------------------+-->
   | .- -m 10--------------.  .- -n 0-------------.           |   
   '-+---------------------+--+-------------------+--bulkwalk-'   
     '- -m max repetitions-'  '- -n non-repeaters-'               

>--mib_variable------------------------------------------------><

Help ヘルプの表示:

>>-snmp-- -?---------------------------------------------------><

トラップの受信:

         .- -d 0-----------.  .- -p 162---------.         
>>-snmp--+-----------------+--+-----------------+--trap--------><
         '- -d debug_level-'  '- -p port_number-'         

MIB 変数名の検出:

         .- -d 0-----------.                           
>>-snmp--+-----------------+--findname--mib_variable-----------><
         '- -d debug_level-'                           

パラメーター:

-d debug_level

デバッグ・レベルを指定します。有効なデバッグ・レベルは 0 から 4 です。 デフォルトのレベルは 0 であり、「デバッグなし」を意味します。高位の各トレース・レベルには、それよりも低位のレベルのトレース・メッセージがすべて含まれます。

-h target host

要求を送信するターゲット・ホストを指定します。これは、IPv4 (小数点付き 10 進数)、IPv6 (コロン付き 16 進数) アドレス、 ホスト名、または OSNMP.CONF 構成ファイル内の winSNMP 名です。ホストを指定しない場合、デフォルトはローカル・ホストになります。

snmp コマンドは、SNMPv1、SNMPv2c、および SNMPv3 の要求の送信をサポートしています。snmp コマンドは、OSNMP.CONF ファイルを使用して、SNMPv1、SNMPv2c、または SNMPv3 要求を送信するかどうかを決定します。-h パラメーターによって指定されたターゲットが、OSNMP.CONF ファイルの winSNMP 名と一致した場合は、snmp はこの項目に指定されたパラメーターを使用して、要求を送信します。-h パラメーターの指定がない場合、要求は SNMPv1 要求として送信されます。-h パラメーターが指定されていて も、OSNMP.CONF ファイルで見つからなかった場合は、次のエラー・メッセージが出されます。

EZZ3306I Error converting <name> to Entity

制約事項: 範囲情報をターゲット・ホストのホスト名または IP アドレスの一部として指定することはできません。

規則: SNMP Getbulk 要求、および Counter64 MIB オブジェクト値の取得は、SNMPv1 要求ではサポートされていません。これらの機能を実行するには、OSNMP.CONF ファイル内の項目を SNMPv2c セキュリティー・モデルまたは SNMPv3 セキュリティー・モデルを使用して構成し、その項目の winSNMPname をターゲット・ホストとして -h パラメーターに指定します。

-r retry number

タイムアウトになった場合の、コマンドの最大再試行回数を指定します。 デフォルト値は 2 です。

-c community_name

指定された変数を宛先 SNMP エージェントでアクセスするのに使用するコミュニティー名を指定します。コミュニティー名を指定しない場合は、デフォルトの名前 は public になります。ユーザー・ベースのセキュリティー・モデルを 使用する場合は、コミュニティー名は不要です。

注: コミュニティー名には大文字小文字の区別があります。

-t timeout value

snmp コマンドが SNMP エージェントからの応答を待つ時間 (秒) を指定します。デフォルト値は 3 です。

-v

冗長出力を使用して、要求からの出力を表示することを指定します。 このオプションを使用すると、MIB オブジェクト ID の代わりにテキスト名が付いて値が戻されます。

-a

発信 IP アドレスとして、VIPA アドレス (使用可能な場合) ではなく、物理インターフェース・アドレスを使用して、要求パケットを送信するように指定します。 デフォルトでは、snmp コマンドは、現在では、VIPA アドレスを使用しています。別の方法としては、NOSVIPA オプションを OSNMP.CONF ファイルで構成することもできます。

-m max repetitions

getbulk および bulkwalk 要求にのみ適用されます。機能要求が getbulk でも bulkwalk でも ない場合は、これは無視されます。max repetitions は、最初の -n 個の後続項目の後、それぞれの変数 バインディング・ペアごとに戻されるアルファベット順の後続項目の数です。例えば、後続項目が -n 個 +1 で始まった場合、それぞれのバインディング変数ペアごとに -m 個の 後続項目が戻されます。デフォルトは 10 です。

-n nonrepeaters

getbulk または bulkwalk 要求にのみ適用されます。機能要求が getbulk でも bulkwalk でも ない場合は、これは無視されます。nonrepeaters 値は、変数バインディング・ペア (名前と値) の数 であり、最初の項目から始まります (この場合、後続項目が 1 つだけ戻されます)。デフォルト値は 0 です。

mib_variable

オブジェクト・ディスクリプター (テキスト名)、ASN.1 表記のオブジェクト ID、またはこの 2 つの組み合わせを使用して、管理情報ベース (MIB) を指定します。walk 要求と bulkwalk 要求とともに使用すると、これは MIB オブジェクト・プレフィックスになります。プレフィックスは、完全なオブジェクト ID であれば、どの先頭部分でも構いません。findname とともに使用すると、これは ASN.1 表記のオブジェクト ID になります。

vartype

設定される値のタイプを指定します。SNMP SET 要求を完了するためには、SMI_type が分かって いる必要があります。タイプの指定がない場合は、snmp は最初に MIBS.DATA ファイルを探し、 次に、コンパイルされた MIB を探して、タイプを判別します。変数が見つからない場合は、エラーが 戻されます。vartype が指定されている場合は、vartype は、MIB に割り当てられる 可能性のあるいずれのタイプよりも優先されます。vartype と値は互換性がある必要があります。例えば、タイプが "number" で、value に "foo" を指定する と、"foo" が数値でないためエラーが戻されます。vartype パラメーターでは、 大文字小文字の区別はありません。有効な変数タイプは、以下のとおりです。

• bitstring
• counter
• counter32
• counter64
• display または displaystring
• integer
• integer32
• ipaddress
• gauge
• gauge32
• nsapaddress
• null
• objectidentifier または OID
• octetstring
• opaque
• opaqueascii
• timeticks
• uinteger

value

SET 機能により設定される値を指定します。値の中で空白文字が必要な場合は、その値を二重引用符 (") で囲む必要があります。それも 1 つのタイプである値に変数を設定する場合は、 そのタイプも指定する必要があります。

-?

ヘルプ情報を表示します。

-p port_number

トラップを listen するポート番号を指定します。 ポート番号の指定がない場合は、snmp コマンドのトラップ機能は、snmp トラップのデフォルト・ポート番号である 事前割り当てポート 162 で listen します。

使用法:

• set 操作は、すべての MIB オブジェクトでサポートされている訳ではありません。 MIB オブジェクトを管理しているエージェントまたはサブエージェントが SET をサポートしない 場合は、set 操作はリジェクトされることがあります。
• 機能のキーワードには、大文字小文字の区別がありません。- オプションと変数タイプおよび変数値には、 大文字小文字の区別があります。
• 低いポート番号の使用が TCP/IP プロファイルの UDPCONFIG ステートメントによって制限されている場合 は、snmp トラップ・コマンドを出すためには、スーパーユーザー ・モードになっている必要があります。低いポートへのアクセスは、事前割り当てポート 162 をバインドするために必要です。 スーパーユーザー・モードになっていない場合 は、EZZ3301I Error return from bind() : EDC5111I Permission denied という エラーが出されます。

  UDPCONFIG ステートメントの詳細については、「z/OS Communications Server: IP 構成解説書」を参照してください。

• NetView® SNMP と z/OS UNIX snmp コマンドからのトラップを同時に listen する ためには、snmp コマンドで -p port_number パラメーターを使用します。 ポートで同時に listen できる管理アプリケーションは、1 つの IP アドレスにつき 1 つだけです。snmp トラップ・コマンドで -p を指定すると、事前割り当てポート 162 以外のポートを 使用することができます。いずれのポートも、エージェント・トラップ宛先として構成する 必要があります。
• (受け入れ可能なコミュニティー名またはユーザー名を使用して) 認証されていない snmp コマンドは、タイムアウトになります。
• snmp コマンドは、MIBS.DATA と OSNMP.CONF という 2 つの構成ファイルを使用します。 サンプル・ファイルは、/usr/lpp/tcpip/samples ディレクトリーで出荷されます。これらの構成ファイルについては、「z/OS Communications Server: IP 構成解説書」を参照してください。