Erlang 21 - 11. Definition of Instrumentation Functions

इंस्ट्रूमेंटेशन फंक्शंस की 11 परिभाषा




erlang

इंस्ट्रूमेंटेशन फंक्शंस की 11 परिभाषा

इंस्ट्रूमेंटेशन फ़ंक्शंस की खंड परिभाषा उपयोगकर्ता परिभाषित कार्यों का वर्णन करती है, जिसे एजेंट अलग-अलग समय पर कॉल करता है।

11.1 चर साधन

स्केलर चर के लिए, एक फ़ंक्शन f(Operation, ...) को परिभाषित किया जाना चाहिए।

Operation new , delete , is_set_ok , is_set_ok , set , या undo

एक त्रुटि के मामले में, सभी इंस्ट्रूमेंटेशन फ़ंक्शन एक SNMPv1 या एक SNMPv2 त्रुटि कोड या तो वापस कर सकते हैं। यदि यह एक SNMPv2 कोड लौटाता है, तो इसे SNMPv1 कोड में भेजे जाने से पहले इसे SNMPv1 कोड में बदल दिया जाता है। सभी इंस्ट्रूमेंटेशन कार्यों के लिए SNMPv2 त्रुटि कोड का उपयोग करने की सिफारिश की जाती है, क्योंकि ये अधिक विवरण प्रदान करते हैं। त्रुटि कोड रूपांतरण के विवरण के लिए Appendix A देखें।

f (नया [, विस्तारा]]

फ़ंक्शन f(new [, ExtraArgs]) MIB में प्रत्येक चर के लिए कहा जाता है जब MIB को एजेंट में लोड किया जाता है। यह आवश्यक आरंभीकरण करना संभव बनाता है।

यह फ़ंक्शन वैकल्पिक है। वापसी मान छोड़ दिया गया है।

च (हटाएं [, विस्तारा]]

फ़ंक्शन f(delete [, ExtraArgs]) को MIB में प्रत्येक ऑब्जेक्ट के लिए कहा जाता है जब MIB को एजेंट से अनलोड किया जाता है। यह आवश्यक सफाई करने के लिए संभव बनाता है।

यह फ़ंक्शन वैकल्पिक है। वापसी मान छोड़ दिया गया है।

f (मिलता है [, extraArgs])

फ़ंक्शन f(get [, ExtraArgs]) को f(get [, ExtraArgs]) -रिक्वेस्ट या f(get [, ExtraArgs]) -नेक्स्ट रिक्वेस्ट वेरिएबल को संदर्भित करता है।

यह फ़ंक्शन अनिवार्य है।

वैध वापसी मान
  • {value, Value} Value सही प्रकार, लंबाई और सीमाओं के भीतर होना चाहिए, अन्यथा प्रतिक्रिया PDU में genErr को वापस कर दिया जाता है। यदि ऑब्जेक्ट एन्यूमरेटेड पूर्णांक है, तो प्रतीकात्मक एनुम मान का उपयोग परमाणु के रूप में किया जा सकता है। यदि ऑब्जेक्ट BITS प्रकार का है, तो रिटर्न मान पूर्णांक या बिट्स की एक सूची होगी जो सेट की गई हैं।
  • {noValue, noSuchName} (SNMPv1)
  • {noValue, noSuchObject | noSuchInstance} {noValue, noSuchObject | noSuchInstance} (SNMPv2)
  • genErr । यदि कोई त्रुटि हुई है तो उपयोग किया जाता है। ध्यान दें, यह एक आंतरिक प्रसंस्करण त्रुटि होनी चाहिए, उदाहरण के लिए एक प्रोग्रामिंग गलती के कारण कहीं। यदि चर मौजूद नहीं है, तो {noValue, noSuchName} या {noValue, noSuchInstance}

f (is_set_ok, NewValue [, ExtraArgs])

फ़ंक्शन f(is_set_ok, NewValue [, ExtraArgs]) को सेट-अनुरोध प्रसंस्करण के चरण एक में कहा जाता है ताकि नए मूल्य को विसंगतियों के लिए जांचा जा सके।

NewValue को MIB में निर्दिष्ट सही प्रकार, लंबाई और सीमाओं के भीतर की गारंटी है। यदि ऑब्जेक्ट एन्यूमरेटेड पूर्णांक या टाइप बिट्स है, तो पूर्णांक मान का उपयोग किया जाता है।

यह फ़ंक्शन वैकल्पिक है।

यदि यह फ़ंक्शन कहा जाता है, तो इसे फिर से कहा जाएगा, या तो undo या पहले तर्क के रूप में set साथ।

मान्य वापसी मूल्य
  • noError
  • badValue | noSuchName | genErr badValue | noSuchName | genErr (SNMPv1)
  • noAccess | noCreation | inconsistentValue | resourceUnavailable | inconsistentName | genErr noAccess | noCreation | inconsistentValue | resourceUnavailable | inconsistentName | genErr (SNMPv2)

f (पूर्ववत करें, NewValue [, ExtraArgs])

यदि कोई त्रुटि हुई, तो इस फ़ंक्शन को is_set_ok फ़ंक्शन कहा जाता है। यदि set इस ऑब्जेक्ट के लिए कहा जाता है, तो undo नहीं कहा जाता है।

NewValue को MIB में निर्दिष्ट सही प्रकार, लंबाई और सीमाओं के भीतर की गारंटी है। यदि ऑब्जेक्ट एन्यूमरेटेड पूर्णांक या टाइप बिट्स है, तो पूर्णांक मान का उपयोग किया जाता है।

यह फ़ंक्शन वैकल्पिक है।

मान्य वापसी मूल्य
  • noError
  • genErr (SNMPv1)
  • undoFailed | genErr undoFailed | genErr (SNMPv2)

एफ (सेट, न्यूवैल्यू [, एक्स्ट्राएग्स])

इस फ़ंक्शन को सेट-अनुरोध प्रसंस्करण के चरण दो में सेट प्रदर्शन करने के लिए कहा जाता है। यह केवल तभी कहा जाता है जब संबंधित is_set_ok फ़ंक्शन मौजूद होता है और कोई भी रिटर्न नहीं देता है।

NewValue को MIB में निर्दिष्ट सही प्रकार, लंबाई और सीमाओं के भीतर की गारंटी है। यदि ऑब्जेक्ट एन्यूमरेटेड पूर्णांक या टाइप बिट्स है, तो पूर्णांक मान का उपयोग किया जाता है।

यह फ़ंक्शन अनिवार्य है।

मान्य वापसी मूल्य
  • noError
  • genErr (SNMPv1)
  • commitFailed | undoFailed | genErr commitFailed | undoFailed | genErr (SNMPv2)

11.2 टेबल इंस्ट्रूमेंटेशन

तालिकाओं के लिए, एक f(Operation, ...) फ़ंक्शन को परिभाषित किया जाना चाहिए (दिखाए गए फ़ंक्शन को f साथ उदाहरण दिया गया है)।

Operation new , delete , is_set_ok , is_set_ok , is_set_ok , undo या set

एक त्रुटि के मामले में, सभी इंस्ट्रूमेंटेशन फ़ंक्शन एक SNMPv1 या एक SNMPv2 त्रुटि कोड या तो वापस कर सकते हैं। यदि यह एक SNMPv2 कोड लौटाता है, तो इसे SNMPv1 कोड में भेजे जाने से पहले इसे SNMPv1 कोड में बदल दिया जाता है। सभी इंस्ट्रूमेंटेशन कार्यों के लिए SNMPv2 त्रुटि कोड का उपयोग करने की सिफारिश की जाती है, क्योंकि ये अधिक विवरण प्रदान करते हैं। त्रुटि कोड रूपांतरण के विवरण के लिए Appendix A देखें।

f (नया [, विस्तारा]]

फ़ंक्शन f(new [, ExtraArgs]) MIB में प्रत्येक ऑब्जेक्ट के लिए कहा जाता है जब MIB को एजेंट में लोड किया जाता है। यह आवश्यक आरंभीकरण करने के लिए संभव बनाता है।

यह फ़ंक्शन वैकल्पिक है। वापसी मान छोड़ दिया गया है।

च (हटाएं [, विस्तारा]]

फ़ंक्शन f(delete [, ExtraArgs]) को MIB में प्रत्येक ऑब्जेक्ट के लिए कहा जाता है जब MIB को एजेंट से अनलोड किया जाता है। इससे किसी भी आवश्यक सफाई को करना संभव हो जाता है।

यह फ़ंक्शन वैकल्पिक है। वापसी मान छोड़ दिया गया है।

f (मिलता है, रोविंडेक्स, कर्ल्स [, एक्स्ट्राअर्स])

फ़ंक्शन f(get, RowIndex, Cols [, ExtraArgs]) को कहा जाता है जब f(get, RowIndex, Cols [, ExtraArgs]) -रिक्वेस्ट एक टेबल को संदर्भित करता है।

यह फ़ंक्शन अनिवार्य है।

तर्क
  • RowIndex पूर्णांकों की एक सूची है जो पंक्ति के प्रमुख मानों को परिभाषित करता है। RowIndex सूची प्रतिनिधित्व (पूर्णांक की सूची) है जो OBJECT IDENTIFIER में Cols पूर्णांक का अनुसरण करता है।
  • Cols पूर्णांक की एक सूची है जो स्तंभ संख्या का प्रतिनिधित्व करते हैं। Cols को मान बढ़ाकर सॉर्ट किया जाता है और मान्य कॉलम नंबर होने की गारंटी दी जाती है।
वैध वापसी मान
  • Cols सूची के रूप में कई तत्वों के साथ एक सूची, जहां प्रत्येक तत्व संबंधित कॉलम का मूल्य है। प्रत्येक तत्व हो सकता है:

    • {value, Value} Value सही प्रकार, लंबाई और सीमाओं के भीतर होना चाहिए, अन्यथा प्रतिक्रिया PDU में genErr को वापस कर दिया जाता है। यदि ऑब्जेक्ट एक एन्यूमरेटेड पूर्णांक है, तो प्रतीकात्मक एनुम मान का उपयोग किया जा सकता है (एक परमाणु के रूप में)। यदि ऑब्जेक्ट BITS प्रकार का है, तो रिटर्न मान पूर्णांक या बिट्स की एक सूची होगी जो सेट की गई हैं।
    • {noValue, noSuchName} (SNMPv1)
    • {noValue, noSuchObject | noSuchInstance} {noValue, noSuchObject | noSuchInstance} (SNMPv2)
  • {noValue, Error} । यदि पंक्ति मौजूद नहीं है, क्योंकि सभी कॉलम में {noValue, Error} ) है, तो एकल tuple {noValue, Error} को लौटाया जा सकता है। यह सभी तत्वों {noValue, Error} साथ सूची के लिए एक आशुलिपि है।
  • genErr । यदि कोई त्रुटि हुई है तो उपयोग किया जाता है ध्यान दें कि यह एक आंतरिक प्रसंस्करण त्रुटि होनी चाहिए, उदाहरण के लिए एक प्रोग्रामिंग गलती के कारण कहीं। यदि कुछ कॉलम मौजूद नहीं है, तो {noValue, noSuchName} या {noValue, noSuchInstance}

f (get_next, RowIndex, Cols [, ExtraArgs])

फ़ंक्शन f(get_next, RowIndex, Cols [, ExtraArgs]) को f(get_next, RowIndex, Cols [, ExtraArgs]) -बल्क-रिक्वेस्ट टेबल को संदर्भित करता है।

RowIndex तर्क मौजूदा पंक्ति या गैर-मौजूदा पंक्ति को संदर्भित कर सकता है, या यह अनिर्दिष्ट हो सकता है। Cols सूची दुर्गम कॉलम या गैर-मौजूदा कॉलम को संदर्भित कर सकती है। Cols सूची में प्रत्येक कॉलम के लिए, अगला अगला उदाहरण निर्धारित किया गया है, और इसके OBJECT IDENTIFIER का अंतिम भाग और इसका मान लौटाया गया है।

यह फ़ंक्शन अनिवार्य है।

तर्क
  • RowIndex पूर्णांक (संभवतः खाली) की एक सूची है जो एक पंक्ति के लिए प्रमुख मानों को परिभाषित करता है। RowIndex सूची प्रतिनिधित्व (पूर्णांकों की सूची) है, जो कि RowIndex में RowIndex पूर्णांक का अनुसरण करते हैं।
  • Cols पूर्णांक की एक सूची है, जो शून्य से अधिक या उसके बराबर है, जो स्तंभ संख्याओं का प्रतिनिधित्व करता है।
वैध वापसी मान
  • Cols सूची के रूप में कई तत्वों के साथ एक सूची प्रत्येक तत्व हो सकता है:

    • {NextOid, NextValue} , जहां NextOid इसी कॉलम के लिए अगला OBJECT IDENTIFIER है। इसे तालिका प्रविष्टि के बाद OBJECT IDENTIFER भाग के रूप में निर्दिष्ट किया जाना चाहिए। इसका अर्थ है कि पहला पूर्णांक स्तंभ संख्या है और शेष कुंजियों का एक विनिर्देश है। NextValue इस तत्व का मूल्य है।
    • endOfTable अगर इस के बाद कोई सुलभ तत्व नहीं हैं।
  • {genErr, Column} जहां Column त्रुटि का कारण बने Column को दर्शाता है। Column सूची में कॉलम में से एक होना चाहिए। ध्यान दें कि यह एक आंतरिक प्रसंस्करण त्रुटि होनी चाहिए, उदाहरण के लिए एक प्रोग्रामिंग गलती के कारण कहीं। यदि कुछ कॉलम मौजूद नहीं है, तो आपको अगला सुलभ तत्व (या endOfTable ) वापस करना होगा।

f (is_set_ok, RowIndex, Cols [, ExtraArgs])

फ़ंक्शन f(is_set_ok, RowIndex, Cols [, ExtraArgs]) को चरण-अनुरोध प्रसंस्करण के चरण एक में कहा जाता है ताकि असंगतताओं के लिए नए मूल्यों की जाँच की जा सके।

यदि फ़ंक्शन को कॉल किया जाता है, तो इसे फिर से undo , या पहले तर्क के रूप में set साथ बुलाया जाएगा।

यह फ़ंक्शन वैकल्पिक है।

तर्क
  • RowIndex पूर्णांकों की एक सूची है जो पंक्ति के प्रमुख मानों को परिभाषित करता है। RowIndex सूची प्रतिनिधित्व (पूर्णांक की सूची) है जो OBJECT IDENTIFIER में Cols पूर्णांक का अनुसरण करता है।
  • Cols {Column, NewValue} की एक सूची है, जहाँ Column एक पूर्णांक है, और NewValue को MIB में निर्दिष्ट सही प्रकार, लंबाई और सीमाओं के भीतर होने की गारंटी है। यदि ऑब्जेक्ट एन्यूमरेटेड पूर्णांक या टाइप बिट्स है, तो पूर्णांक मान का उपयोग किया जाता है। सूची को Column (बढ़ते) द्वारा क्रमबद्ध किया गया है और प्रत्येक Column को एक वैध कॉलम संख्या होने की गारंटी है।
वैध वापसी मान
  • {noError, 0}
  • {Error, Column} , जहां चर के लिए is_set_ok के समान Error है, और Column दोषपूर्ण Column को दर्शाता है। Column सूची में कॉलम में से एक होना चाहिए।

एफ (पूर्ववत करें, रोविंडेक्स, कर्ल्स [, एक्स्ट्राएग्स])

यदि कोई त्रुटि होती है, तो is_set_ok फ़ंक्शन के बाद फ़ंक्शन f(undo, RowIndex, Cols [, ExtraArgs]) कहा जाता है। यदि set इस ऑब्जेक्ट के लिए कहा जाता है, तो undo नहीं कहा जाता है।

यह फ़ंक्शन वैकल्पिक है।

तर्क
  • RowIndex पूर्णांकों की एक सूची है जो पंक्ति के प्रमुख मानों को परिभाषित करता है। RowIndex सूची प्रतिनिधित्व (पूर्णांक की सूची) है जो OBJECT IDENTIFIER में Cols पूर्णांक का अनुसरण करता है।
  • Cols {Column, NewValue} की एक सूची है, जहाँ Column एक पूर्णांक है, और NewValue को MIB में निर्दिष्ट सही प्रकार, लंबाई और सीमाओं के भीतर होने की गारंटी है। यदि ऑब्जेक्ट एन्यूमरेटेड पूर्णांक या टाइप बिट्स है, तो पूर्णांक मान का उपयोग किया जाता है। सूची को Column (बढ़ते) द्वारा क्रमबद्ध किया गया है और प्रत्येक Column को एक वैध कॉलम संख्या होने की गारंटी है।
वैध वापसी मान
  • {noError, 0}
  • {Error, Column} जहां Error चर के लिए undo लिए समान है, और Column दोषपूर्ण Column को दर्शाता है। Column सूची में कॉलम में से एक होना चाहिए।

f (सेट, रोविंडेक्स, कर्ल्स [, एक्ट्रा एग्स])

फ़ंक्शन f(set, RowIndex, Cols [, ExtraArgs]) को सेट-अनुरोध प्रसंस्करण के चरण दो में सेट प्रदर्शन करने के लिए कहा जाता है। इसे केवल तभी कहा जाता है जब संबंधित is_set_ok फ़ंक्शन मौजूद नहीं था, या {noError, 0} वापस लौटा।

यह फ़ंक्शन अनिवार्य है।

तर्क
  • RowIndex पूर्णांकों की एक सूची है जो पंक्ति के प्रमुख मानों को परिभाषित करती है। RowIndex सूची प्रतिनिधित्व (पूर्णांक की सूची) है जो OBJECT IDENTIFIER में Cols पूर्णांक का अनुसरण करता है।
  • Cols {Column, NewValue} की एक सूची है, जहाँ Column एक पूर्णांक है, और NewValue को MIB में निर्दिष्ट सही प्रकार, लंबाई और सीमाओं के भीतर होने की गारंटी है। यदि ऑब्जेक्ट एन्यूमरेटेड पूर्णांक या टाइप बिट्स है, तो पूर्णांक मान का उपयोग किया जाता है। सूची को Column (बढ़ते) द्वारा क्रमबद्ध किया गया है और प्रत्येक Column को एक वैध कॉलम संख्या होने की गारंटी है।
वैध वापसी मान
  • {noError, 0}
  • {Error, Column} जहां Error वैरिएबल के लिए set के समान है, और Column गलत Column को दर्शाता है। Column सूची में कॉलम में से एक होना चाहिए।