background image

Ethernet Subagent

SNMP Configuration and Management Manual — 424777-006

14 -31

Data Definitions

Data Definitions

Because they are standard events, most of the tokens, structures, and values 
appearing in ZESA events are defined in the ZSPI and ZEMS data definition files 
ZSPIDDL and ZEMSDDL and their associated language-specific files. Data elements 
defined by the Ethernet Subagent are in the file ZESADDL and associated language-
specific files:

The complete set of SPI definition files is usually located in the ZSPIDEF subvolume of 
the NonStop Kernel installation volume. See the 

SPI Programming Manual

 for 

information on the ZSPI data definitions and data definition files in general. See the 

EMS Manual

 for information on ZEMS data definitions.

3010

TCPIP-OBJ-UNAVAIL

Object Unavailable

The configured TCP/IP process interface has 
transitioned from a “connected” state into a 
“disconnected” or “disabled” state.

3011

SRL-CALL-FAILED

Transient Fault

A Shared Resource Library (SRL) call to the 
SLSA has failed.

3012

INTERNAL-FAULT

Object Unavailable

The Ethernet Subagent process has 
terminated after detecting an internal fault 
condition.

3013

CONFIGURATION-INVALID

Object Unavailable

The startup parameters passed to the 
Ethernet Subagent process at startup are 
unusable.

3014

TAKEOVER-BY-BACKUP

Transient Fault

The Ethernet Subagent primary process has 
stopped and the backup process is taking 
over the primary role.

ZESADDL

Data Definition Language (DDL) definitions from which the 
language-specific definitions are derived

ZESAC

Definitions for C programs

ZESACOB

Definitions for COBOL programs

ZESAPAS

Definitions for Pascal programs

ZESATACL

Definitions for TACL programs

ZESATAL

Definitions for TAL programs

Table 14-8. Ethernet Subagent Event Messages

(page 2 of 2)

Number

ZESA-EVT-

Standard Event and Description

Summary of Contents for T9576G06

Page 1: ...ent and subagents The SNMP Agent and its subagents comply with SNMP Requests for Comment RFCs so that SNMP compliant management applications known as SNMP managers can manage various resources on an HP NonStop host Product Version SNMP Agent T9576G06 T9576H01 Supported Release Version Updates RVUs This manual supports the G06 24 RVU and all subsequent G series RVUs and the H06 03 RVU and all subse...

Page 2: ...ecember 2003 424777 005 SNMP Agent T9576G06 September 2004 424777 006 SNMP Agent T9576G06 T9576H01 July 2004 Subagent Product Versions IPX SPX Subagent T8170D30 TCP IP Subagent T7862G05 Ethernet Token Ring Subagent T0326G06 Trap Multiplexer T1041G06 NonStop NET MASTER Trap Subagent T8491D20 EMS Trap Subagent T9632D31 Host Resources Subagent T8496G04 ONS Subagent T8103D40 ...

Page 3: ...ation xxvi Related Reading xxviii Notation Conventions xxviii Part I Installing and Configuring SNMP 1 The NonStop SNMP Environment Subsystem Components 1 4 SNMP Manager Station 1 4 SNMP Manager 1 5 PDU 1 5 MIB 1 5 SNMP Agent 1 5 SNMP Subagent 1 6 Toolkits 1 6 Message Protocol 1 6 General SNMP Message Format 1 7 Request PDUs 1 7 Response PDU 1 8 Trap PDU 1 8 Transmitting and Receiving SNMP Packets...

Page 4: ...RUN Command 2 14 The SNMPCTL File and TRAPPORT 2 16 PARAM Statements Custom Configuration for the RUN Command 2 16 Using SCF to Configure Components of the SNMP Agent Environment 2 16 SNMP Agent Process 2 16 Security 2 16 Request Response Connections 2 17 Trap Connections 2 17 Trap Port 2 17 Configuring the SNMP Agent Through SNMP Requests 2 17 Request Response Connections 2 17 Trap Connections 2 ...

Page 5: ...Traps 2 41 Single Host Connections 2 42 Multiple Host Connections 2 43 3 MIBs Supported by the SNMP Agent SNMP Agent MIB Groups 3 1 RFC Compliance 3 2 Installation 3 2 System Group 3 3 MIB Objects 3 3 RFC Compliance 3 5 SNMP Group 3 6 MIB Objects 3 7 RFC Compliance 3 10 zagInternal Group 3 10 MIB Objects 3 11 SNMP Manager Access to Private MIB Objects 3 20 Table Row Management Overview 3 22 Managi...

Page 6: ...T Object 4 8 Naming Conventions ENDPOINT Object 4 8 ENDPOINT Object States 4 9 ENDPOINT Object Attributes 4 10 Default ENDPOINT Object 4 10 The PROFILE Object 4 12 Naming Conventions PROFILE Object 4 12 PROFILE Object States 4 14 PROFILE Object Attributes 4 14 Default PROFILE Object 4 14 The TRAPDEST Object 4 16 Naming Conventions TRAPDEST Object 4 16 TRAPDEST Object States 4 17 TRAPDEST Object At...

Page 7: ...ration and the TCPIP PROCESS NAME Startup Parameter 4 27 5 SCF Commands for the SNMP Agent Configuration Restrictions Attribute Conflicts 5 2 ABORT Command 5 3 ABORT ENDPOINT Command 5 3 ABORT PROFILE Command 5 4 ABORT TRAPDEST Command 5 5 ADD Command 5 5 ADD ENDPOINT Command 5 6 ADD PROFILE Command 5 8 ADD TRAPDEST Command 5 10 ALTER Command 5 13 ALTER ENDPOINT Command 5 13 ALTER PROCESS Command ...

Page 8: ...roubleshooting 6 SNMP Agent PTrace Facility Introduction to PTrace 6 1 Running PTrace 6 3 Starting a Noninteractive PTrace Session 6 3 Starting an Interactive PTrace Session 6 4 Device Type 6 4 PTrace Commands 6 4 PTrace Commands Supported by the NonStop Agent 6 5 PTrace Commands Not Supported by the NonStop Agent 6 5 Subset of Useful NonStop Agent PTrace Commands 6 5 FROM Command 6 6 NEXT Command...

Page 9: ...CP IPv6 Subagent and its Managed Resources 8 5 Standard MIB II Groups Supported by the TCP IP Subagent 8 5 Private MIB Objects Supported by the TCP IP Subagent 8 7 MIB Value Derivation 8 7 Unavailable Resources 8 8 Reporting Values for Uninstrumented Objects 8 8 Refreshing MIB Values 8 9 Initiating Backup Process Takeover 8 10 Related Documents 8 11 RFC Compliance 8 11 Installing the TCP IP Subage...

Page 10: ...C Compliance 8 63 udpTable Maintenance 8 63 Traps Generated by the TCP IP Subagent 8 64 EMS Support 8 64 Data Definitions 8 67 Subsystem ID 8 68 Tokens in ZTSA Event Messages 8 68 Event Message Descriptions 8 70 1001 ZTSA EVT SUBAGENT AVAIL 8 70 1002 ZTSA EVT SUBAGENT UNAVAIL 8 72 1003 ZTSA EVT AGENT OBJ AVAIL 8 75 1004 ZTSA EVT AGENT OBJ UNAVAIL 8 77 1005 ZTSA EVT BACKUP OBJ AVAIL 8 79 1006 ZTSA ...

Page 11: ...tural Overview 9 1 RFC Compliance 9 3 Installation 9 4 Dependencies 9 4 Installation Steps 9 4 Configuration 9 8 Event Filter 9 8 Trap Connections 9 9 Starting and Stopping the Subagent 9 9 The Trap PDU 9 10 The EMS Trap MIB 9 12 10 NonStop NET MASTER Trap Subagent Architectural Overview 10 1 RFC Compliance 10 3 Installation 10 3 Dependencies 10 3 Installation Steps 10 4 Configuration 10 9 Modifyi...

Page 12: ...1 8 RFC Compliance 11 8 Installation 11 8 Dependencies 11 8 Installation Steps 11 9 Configuration 11 10 Starting and Stopping the Subagent 11 12 Troubleshooting the Subagent 11 21 EMS Event Messages 11 22 Startup Problems 11 22 Manager Timeouts 11 22 hrSystem Group 11 25 MIB Objects 11 25 Sample Data 11 27 RFC Compliance 11 28 hrSystem Group Maintenance 11 28 hrStorage Group 11 29 MIB Objects 11 3...

Page 13: ...77 MIB Objects 11 78 Sample Data 11 84 zhrmThreshold Group Maintenance 11 84 zhrmDevUnavail Group 11 85 MIB Objects 11 85 Sample Data 11 90 zhrmDevUnavail Group Maintenance 11 90 zhrmSaProcess Group 11 91 MIB Objects 11 91 Sample Data 11 94 zhrmSaProcess Group Maintenance 11 95 zhrmRefresh Group 11 96 MIB Objects 11 96 Sample Data 11 98 zhrmRefresh Group Maintenance 11 98 Traps 11 99 Routing Traps...

Page 14: ...ap to Event Conversion 12 1 SNMP Request Processing 12 3 Related Documents 12 3 Installation 12 4 Dependencies 12 4 Installation Steps 12 4 Configuration 12 4 Starting and Stopping the Trap Multiplexer 12 6 Using the t and PARAM Startup Parameters 12 10 ztmxPDUStatistics Group 12 12 MIB Objects 12 12 ztmxPDUStatistics Group Maintenance 12 15 ztmxProcess Group 12 16 MIB Objects 12 16 ztmxProcess Gr...

Page 15: ...ication Components 12 48 Preparing the Application 12 49 Running the Application 12 50 Application Control Flow 12 51 Application Source Code 12 52 13 IPX SPX Subagent G Series Architectural Overview 13 1 The IPX SPX Subagent MIB 13 4 Refreshing IPXPROTO Object Values 13 6 Connections Between Subagent and Other Processes 13 7 Resource Utilization 13 9 Subagent Backup Process 13 10 First Failure Da...

Page 16: ...EVT EMSCOLL UNAVAILABLE 13 64 1009 ZISA EVT IPXPROTO AVAILABLE 13 66 1010 ZISA EVT IPXPROTO UNAVAILABLE 13 68 1011 ZISA EVT MEMORY ALLOC FAILURE 13 70 1012 ZISA EVT PROCESS TRAPPED 13 72 14 Ethernet Subagent Architectural Overview 14 1 The Ethernet Subagent and Its Managed Resources 14 1 The Ethernet Subagent and the SNMP Agent 14 1 dot3 Statistics Group Supported by the Ethernet Subagent 14 3 The...

Page 17: ...UBAGENT UNAVAIL 14 36 3003 ZESA EVT AGENT OBJ AVAIL 14 39 3004 ZESA EVT AGENT OBJ UNAVAIL 14 41 3005 ZESA EVT BACKUP OBJ AVAIL 14 43 3006 ZESA EVT BACKUP OBJ UNAVAIL 14 46 3007 ZESA EVT EMSCOLL AVAIL 14 49 3008 ZESA EVT EMSCOLL UNAVAIL 14 51 3009 ZESA EVT TCPIP OBJ AVAIL 14 54 3010 ZESA EVT TCPIP OBJ UNAVAIL 14 56 3011 ZESA EVT SRL CALL FAILED 14 59 3012 ZESA EVT INTERNAL FAULT 14 61 3013 ZESA EVT...

Page 18: ...n Versus Subsystem Specific Errors B 2 SCF Error Messages Help B 3 If You Have to Call HP B 3 NonStop Agent Error Messages B 4 SNMP Error 00001 B 4 SNMP Error 00002 B 4 SNMP Error 00004 B 4 SNMP Error 00005 B 5 SNMP Error 00006 B 5 SNMP Error 00007 B 6 SNMP Error 00009 B 6 C Unsolicited SNMP Agent Messages Traps C 1 Events C 2 001 ZSMP EVT INVALID CAID C 3 002 ZSMP EVT INTERNAL ERROR C 3 003 ZSMP ...

Page 19: ...tecture 1 16 Figure 2 1 Default SNMP Agent Manager Interaction Over TCP IP 2 5 Figure 2 2 Running Multiple SNMP Agents on a Single Node 2 19 Figure 2 3 Running SNMP Agents on Multiple Nodes 2 21 Figure 2 4 Managing Overlapping Sets of Resources 2 22 Figure 2 5 Authenticating Requests Received Through TCP IP 2 30 Figure 2 6 Multiple Local SNMP Agents Single Host Request Response Connections 2 36 Fi...

Page 20: ...d Trap Generation 11 101 Figure 12 1 Trap Multiplexer Functions and Components 12 2 Figure 12 2 Mapping of Trap Header Variables to EMS Event Tokens 12 22 Figure 12 3 Sample Application Interactions 12 48 Figure 12 4 Sample Application Control Flow 12 52 Figure 13 1 NonStop IPX SPX Interactions 13 2 Figure 13 2 IPX SPX Subagent Interactions 13 3 Figure 13 3 Indexes Linking MIB Table Entries 13 5 F...

Page 21: ...rough SNMP 8 18 Table 8 3 Private ZTSA MIB Objects Supported by the TCP IP Subagent 8 21 Table 8 4 TCP IP Subagent State Object Resource Object Pairs 8 28 Table 8 5 Interfaces Group Objects Supported by TCP IP Subagent 8 31 Table 8 6 Compliance With Interfaces Group Definitions in RFC 1213 8 38 Table 8 7 IP Group Objects Supported by TCP IP Subagent 8 41 Table 8 8 Compliance With IP Group Definiti...

Page 22: ... Definitions in RFC 1514 11 61 Table 11 12 zhrmTableInfo Group Objects Supported by Host Resources Subagent s MIB 11 64 Table 11 13 zhrmThreshold Group Objects Supported by Host Resources Subagent s MIB 11 78 Table 11 14 zhrmDevUnavail Group Objects Supported by Host Resources Subagent s MIB 11 86 Table 11 15 zhrmSaProcess Group Objects Supported by Host Resources Subagent s MIB 11 92 Table 11 16 ...

Page 23: ...10 tdmNwSaAgentNamesEntry Objects Supported by the Subagent 13 42 Table 13 11 tdmNwSaIPXPROTONamesEntry Objects Supported by the Subagent 13 43 Table 13 12 IPX SPX Subagent Event Messages 13 45 Table 13 13 ZISA Tokens in ZISA Event Messages 13 46 Table 13 14 ZSPI Tokens in ZISA Event Messages 13 47 Table 13 15 ZEMS Tokens in ZISA Event Messages 13 47 Table 14 1 Querying an Ethernet Subagent Throug...

Page 24: ...Contents SNMP Configuration and Management Manual 424777 006 xxii Tables continued ...

Page 25: ... Version SNMP Agent T9576G06 T9576H01 Supported Release Version Updates RVUs This manual supports the G06 24 RVU and all subsequent G series RVUs and the H06 03 RVU and all subsequent H series RVUs until otherwise indicated by its replacement publication Document History Part Number Published 424777 006 July 2005 Part Number Product Version Published 424777 002 SNMP Agent T9576G06 May 2002 424777 ...

Page 26: ...ooting the SNMP Agent H series information has been added Section 8 TCP IP Subagent H series information has been added Section 10 ONS Trap Subagent D series This section has been deleted Section 11 NonStop NET MASTER Trap Subagent Has become section Section 10 NonStop NET MASTER Trap Subagent Section 12 Host Resources Subagent Has become Section 11 Host Resources Subagent Section 13 Trap Multiple...

Page 27: ...n your message If your comments are specific to a particular manual also include the part number and title of the manual Many of the improvements you see in manuals are a result of suggestions from our customers Please take this opportunity to help us improve future manuals Audience This manual has two audiences NonStop system personnel and users of the SNMP manager NonStop system personnel includ...

Page 28: ...escription of each section Part I Installing and Configuring SNMP Section 1 The NonStop SNMP Environment provides a high level view of SNMP and how it is implemented in the NonStop environment Section 2 Installing and Configuring the SNMP Agent describes how to configure the SNMP agent using SCF the RUN command PARAM statements and the SNMPCTL file This section describes how to configure security ...

Page 29: ...t is installed Section 13 IPX SPX Subagent G Series describes the product that as a manager receives traps from network devices and converts them into EMS events and as a subagent provides manager station access to an MIB that describes trap conversion activities and configuration attributes Section 14 Ethernet Subagent describes the Internetwork Packet Exchange Sequenced Packet Exchange IPX SPX S...

Page 30: ...re documents that describe the Internet suite of protocols and related experiments The Internet Architecture Board requires that protocols be documented in RFCs so that standards and ideas are widely accessible You can also obtain information about SNMP at libraries and book stores Many excellent and up to date books are available Notation Conventions Hypertext Links Blue underline is used to indi...

Page 31: ...side of the list or horizontally enclosed in a pair of brackets and separated by vertical lines For example FC num num text K X D address 1 Braces A group of items enclosed in braces is a list from which you are required to choose one item The items in the list may be arranged either vertically with aligned braces on each side of the list or horizontally enclosed in a pair of braces and separated ...

Page 32: ...f the syntax of a command is too long to fit on a single line each continuation line is indented three spaces and is separated from the preceding line by a blank line This spacing distinguishes items in a continuation line from items in a vertical list of selections For example ALTER OUT file spec LINE attribute spec i and o In procedure calls the i notation follows an input parameter one that pas...

Page 33: ...ndicate text that is displayed or returned exactly as shown For example Backup Up lowercase italic letters Lowercase italic letters indicate variable items whose values are displayed or returned For example p register process name Brackets Brackets enclose items that are sometimes but not always displayed For example Event number number Subject first subject value A group of items enclosed in brac...

Page 34: ...ecedes a binary number The H notation precedes a hexadecimal number For example 005400 P p register E e register Notation for Management Programming Interfaces The following list summarizes the notation conventions used in the boxed descriptions of programmatic commands event messages and error lists in this manual UPPERCASE LETTERS Uppercase letters indicate names from definition files enter thes...

Page 35: ...s placed in the right margin of changed portions of text figures tables examples and so on Change bars highlight new or revised information For example The message types specified in the REPORT clause are different in the COBOL85 environment and the Common Run Time Environment CRE The CRE has many new message types and some new message type codes for old message types In the CRE the message type S...

Page 36: ...About This Manual SNMP Configuration and Management Manual 424777 006 xxxiv Change Bar Notation ...

Page 37: ...Installing and Configuring SNMP Part I consists of the following sections which give an overview of the SNMP agent and provide installation and configuration information Section 1 The NonStop SNMP Environment Section 2 Installing and Configuring the SNMP Agent ...

Page 38: ...Part I Installing and Configuring SNMP SNMP Configuration and Management Manual 424777 006 ...

Page 39: ... community in the late 1980s as a means for managing TCP IP and Ethernet networks Because of its relative simplicity SNMP has gained widespread acceptance as a protocol for managing devices from multiple vendors on a network Today many vendors offer SNMP compliant applications that run on several workstation platforms These applications manage devices attached to various kinds of networks when the...

Page 40: ... IP Expand 1 5 Managed Resources SNMP Agent Subagent 1 Subagent 2 Managed Resources Subagent retrieves information from managed subsystem 4 SNMP agent forwards authenticated requests to appropriate subagent Subagent sends response and trap messages to SNMP agent Managed Resources Authentication Table Entry Entry 2 3 6 0 SNMP agent sends events to EMS collector Legend Trap messages Request response...

Page 41: ...ts Sends traps through the TCP IP process ZTC0 to the Internet address associated with each SNMP manager from which a request is received includes the community Tandem in the traps ZTC0 is on the local node The SNMP manager must be using TCP IP Sends the event messages that the SNMP agent generates to the EMS collector process 0 on the local node Forwards requests pertaining to managed resources o...

Page 42: ...A device on which an SNMP manager runs Figure 1 2 Key Components in the SNMP Environment PDU PDU MIB Definitions SNMP Manager Station Managed Resources System 2 Local Area Network Wide Area Network SNMP Manager Station MIB Definitions Managed Resources System 1 System 3 Managed Resources MIB Managed Resources MIB Subagent Managed Resources MIB Subagent MIB SNMP Agent Subagent SNMP Agent MIB VST010...

Page 43: ...value changing a value or sending unsolicited notifications known as traps to an SNMP manager Message Protocol on page 1 6 provides more detail about the various kinds of PDUs MIB Information exchanged between managers and agents An MIB describes a collection of objects that can be managed An example of an MIB object is the physical location of a node MIBs are described in a language known as Abst...

Page 44: ...ke customer written NonStop applications manageable by SNMP managers For more information about the Subagent Toolkit refer to the SNMP Subagent Programmer s Guide HP also offers a Manager Services toolkit that allows C and C programmers to create SNMP managers that run as NonStop Kernel processes in either the Guardian or in the Open System Services OSS environment For information about Manager Se...

Page 45: ...DUs Request PDUs The three kinds of request PDUs have the same format as the response PDU but the error status and error index fields are always set to 0 The request id uniquely identifies individual requests Variable bindings are a list of variable names and corresponding values Figure 1 3 Format of SNMP Messages version community PDU PDU type request id 0 0 variable bindings PDU type request id ...

Page 46: ...ap operation The Trap operation issues an unsolicited message to an SNMP manager to signal an important event The enterprise field provides the SNMP agent object identifier or subagent object identifier the object identifier for the SNMP agent is 1 3 6 1 4 1 169 3 155 1 Object identifiers are described under Information Protocol on page 1 9 The agent address field is the Internet address of the de...

Page 47: ...ed through the UDP protocol are discussed Section 2 Installing and Configuring the SNMP Agent and in Section 3 MIBs Supported by the SNMP Agent Information Protocol The foundation of any network management system is a collection of information about the elements to be managed In SNMP environments this information is described by a MIB Management Information Base Each item in a MIB is known as a MI...

Page 48: ...ogical names Object identifiers are expressed in numeric dot notation For example the System group of MIB II is identified as system 1 3 6 1 2 1 1 As Figure 1 4 shows an object identifier is a sequence of integers resulting from traversing a global tree The object tree is composed of an unlabeled root connected to labeled nodes Each node in turn can have subordinate nodes of its own A node and its...

Page 49: ...rectory 1 mgmt 2 mib II 1 system 1 interfaces 2 at 3 ip 4 icmp 5 tcp 6 udp 7 egp 8 cmot 9 transmission 10 snmp 11 host 25 experimental 3 private 4 enterprises 1 tandem 169 nonstopsystems 3 tlam 19 tcp ip 80 zsmp 155 zsmpagent 1 zagInternal 7 zagInProcess 1 zagInEndpoint 2 zagInProfile 3 zagInTrapdest 4 joint iso ccit 2 1 3 6 1 2 1 1 object identifier VST012 vsd object identifier 1 3 6 1 4 1 169 3 ...

Page 50: ... 7 4 2 1 4 The Management Information Base Each MIB object is identified by an object descriptor and identifier Sometimes MIB objects are divided into groups called object groups Most items subordinate to MIB II in Figure 1 4 are actually object groups Examples are the UDP group the Interfaces group and the TCP group Many of these groups are supported by the TCP IP Subagent s MIB as described in S...

Page 51: ...provide information about how the tables are created and maintained Table 1 1 System Group Objects Supported by SNMP Agent s MIB Object and Attributes Definition Format of Value Derivation of Value sysContact 1 3 6 1 2 1 1 4 read write DisplayString SIZE 0 255 Information describing the contact person for this node This value is stored in SNMPCTL The default value is unknown Initially the default ...

Page 52: ...and is supported on G series and H series RVUs of the NonStop Kernel ServerNet LAN Systems Access SLSA subsystem The SLSA subsystem supports parallel LAN I O on systems that implement ServerNet The SNMP agent authenticates requests as it receives them using the scheme described in Section 2 Installing and Configuring the SNMP Agent The SNMP agent uses the Subsystem Programmatic Interface SPI proto...

Page 53: ...nts about the resources they manage Subagents can reside on the same node as the SNMP agent or on different nodes Each SNMP agent can support one instance of any particular subagent The SNMP control file SNMPCTL contains configuration parameters for the SNMP agent When the primary SNMP agent process is active it writes trace records to the file ZZSMPTRP When the backup process becomes active it wr...

Page 54: ...op SNMP Figure 1 5 NonStop SNMP Architecture SNMP Manager Station Local Area Network Wide Area Network TCP IP ZTC0 Legend IPC messages SNMP request response messages SNMP traps NSK operations SNMP Agent Independent SNMP Subagents SNMPCTL ZZSMPTRP ZZSMPTRB EMS Collector SNMP Manager Station MIB SNMP Manager VST013 vsd ...

Page 55: ...cument describes ASN 1 conventions for defining traps The degree to which subagents comply with MIB object definitions in RFCs is often documented in this manual in three column tables For example the following excerpt from a table describes how the TCP IP Subagent s MIB complies with IP group definitions in RFC 1213 and is followed by an explanation of each column in the table Table 1 2 Complianc...

Page 56: ...lowing sources DDN Network Information Center 14200 Park Meadow Drive Suite 200 Chantilly VA 22021 USA phone 1 800 365 3642 mail nic nic ddn mil The Internet If your site has IP connectivity to the Internet community you can use anonymous FTP to the host nic ddn mil residing at 192 112 36 5 and retrieve files from the directory rfc Electronic mail Send a message to mail server nisc sri com In the ...

Page 57: ...ation The SNMP agent is delivered ready to be installed and started without any custom configuration You install the SNMP agent using the Distributed Systems Management Software Configuration Manager DSM SCM product The SNMP agent program file is installed on your system as SYSTEM SYSTEM SNMPAGT Refer to the DSM SCM User s Guide for complete software installation information The device type for th...

Page 58: ...see in trap messages received from the SNMP agent The HP resources that the SNMP manager wants to manage The Internet addresses by which the SNMP agent can be reached The SNMP traps and MIB objects the SNMP agent and its subagents support and what they mean in the context of the NonStop environment The community name that must be included in requests to the SNMP agent The location of the NonStop s...

Page 59: ...MS event messages Starts a backup process if you requested one Processes configuration information Creates a trap destination definition if none already exists for the Internet address associated with any manager from which the SNMP agent receives a request through TCP IP The Default SNMP Agent When started without any customization the SNMP agent Receives and sends SNMP messages through NonStop K...

Page 60: ...ocesses to the appropriate subagent and returns responses to the requesting manager The subagents to which the SNMP agent forwards requests are installed started and configured separately from the SNMP agent Defining the connection between the subagent and the SNMP agent is part of the subagent s configuration not the SNMP agent s configuration Section IV SNMP Subagents describes installing starti...

Page 61: ... Kernel System TCP IP Expand 1 5 Managed Resources SNMP Agent Subagent 1 Subagent 2 Managed Resources Subagent retrieves information from managed subsystem 4 SNMP agent forwards authenticated requests to appropriate subagent Subagent sends response and trap messages to SNMP agent Managed Resources Authentication Table Entry Entry 2 3 6 0 SNMP agent sends events to EMS collector Legend Trap message...

Page 62: ...gent Configure the SNMPCTL file in one of four ways RUN command parameters RUN Command on page 2 7 PARAM statements PARAM Statements Custom Configuration for the RUN Command on page 2 16 Table 2 1 Initial Values of Objects in the SNMP Agent s MIB MIB Object Initial Value System group objects sysDescr Tandem NonStop Kernel System Version Dxx Node node name Agent agent process name where Dxx is the ...

Page 63: ...sued RUN Command To start the SNMP agent use the RUN command No additional configuration beyond that provided through the RUN command startup parameters is required for the SNMP agent to receive and reply to SNMP requests solely through NonStop Kernel IPC calls However even in this limited scope additional configuration is required to allow the SNMP agent to forward traps to SNMP managers that com...

Page 64: ...nd the WARM Startup Parameter on page 2 14 tells you how to find out the name of the agent process other run option is any of the TACL RUN command options Refer to the TACL Reference Manual for more information about these options HP recommends using at least the NOWAIT option so you can resume TACL operations once the SNMP agent is started startup parameter is one of the following parameters that...

Page 65: ...nfiguration either through SCF or through SNMP as described in Part II SCF for the SNMP Agent and in Configuring the SNMP Agent Through SNMP Requests on page 2 17 WARM instructs the SNMP agent to use the SNMPCTL file in the run subvolume If no SNMP file exists the SNMP agent creates one and fills it with the default configuration values WARM is the default value for this parameter COLLECTOR altern...

Page 66: ... communicating through NonStop Kernel IPC calls and SCF that one SNMP agent process can simultaneously support The default value is 20 PORT request port number specifies the port number to monitor for requests from managers communicating over TCP IP The default value is 161 the SNMP standard port for receiving requests If a port number greater than 1023 is used the agent process need not be associ...

Page 67: ...tribute value for ENDPOINT objects created through SCF and the default zagInEpNetwork object value for zagInEndpointTable rows created through SNMP The default NETWORK attribute for TRAPDEST objects created through SCF and the default zagInTdNetwork object value for zagInTrapdestTable rows created through SNMP If you do not include the TCPIP PROCESS NAME startup parameter the default TCP IP proces...

Page 68: ... TCP IPv6 allows this through the creation of Logical Network Partitions LNPs The TCP IPv6 Configuration and Management Manual gives a detailed explanation of how to create and use LNPs Each LNP is associated with a separate TCP6SAM process Thus each LNP on which you want to provide SNMP services requires that you run a separate instance of the SNMP Agent To provide SNMP services on one or more LN...

Page 69: ...OR alternate collector process The EMS collector to which to send event messages 0 on the local node DATAPAGES pages E XTENSIBLE The amount of storage to allocate for use as general dynamic memory 240 2048 byte pages extensible MAXOPENERS number of openers The maximum number of openers the agent can support simultaneously 20 PORT request port number The port number to monitor for manager requests ...

Page 70: ...rst time you start an SNMP agent process the SNMP agent creates an SNMPCTL file and fills it with default RUN command configuration values You can then modify the SNMP file using RUN command parameters SCF PARAM statements or SNMP requests WARM is the default value TCPIP PROCESS NAME node tcpip process The default TCP IP process to be used when request response connections and trap destinations ar...

Page 71: ...command Values set when the COLD parameter is specified persist only as long as the agent process is running Here is an example of the RUN command in which the COLD parameter is specified RUN SNMPAGT NAME ZSNMP NOWAIT COLD Use SCF or SNMP to configure all components of the SNMP agent See Part II SCF for the SNMP Agent for more information on SCF for SNMP COLD and WARM Configuration Scenarios Note ...

Page 72: ...re equivalent to the following RUN command SNMPAGT NAME ZSNMP NOWAIT CPU 4 6 DATAPAGES 4000 E TRACE TRAPPORT 2000 Using SCF to Configure Components of the SNMP Agent Environment A third way to configure and manage the SNMP agent environment is with SCF The following five components of the SNMP agent can be configured using SCF Refer to Part II SCF for the SNMP Agent for complete information on SCF...

Page 73: ... Trap Port The object trap port can t be configured or managed through SCF Configuring the SNMP Agent Through SNMP Requests You can configure and manage the following components of the SNMP agent environment through SNMP requests Request Response Connections The SNMP agent s zagInEndpoint group objects define the Internet addresses and TCP IP processes to be used for the receiving and sending of r...

Page 74: ...the zagInEndpointTable corresponds to an SCF ENDPOINT object You create alter the attributes of activate inactivate and remove rows in the SNMP agent s private MIB zagInTrapdestTable to manage the destinations to which the SNMP agent sends traps Each row in the zagInTrapdestTable corresponds to an SCF TRAPDEST object However the object zagInTdPort cannot be viewed or managed through SCF only from ...

Page 75: ... 006 2 19 Single Node and Multiple Node Scenarios Single Node and Multiple Node Scenarios Figure 2 2 Running Multiple SNMP Agents on a Single Node SNMP Manager TCP IP SNMP Agent ZSNM1 SNMP Agent ZSNM0 Managed Resources Subagents Managed Resources Subagents 130 25 88 1 130 25 88 2 VST202 vsd ...

Page 76: ... least one TCP IP subnet is available for each SNMP agent running Each SNMP agent must be reached through a separate Internet address You can configure both NonStop TCP IP and NonStop TCP IPv6 to have distinct subnets To configure distinct subnets for NonStopTCP IP v6 use the Logical Network Partition feature described in the TCP IPv6 Configuration and Management Manual In the Parallel Library TCP...

Page 77: ...ing because a TCP IP subnet can be used by only one agent process at a time Each SNMP agent must be reached through a separate Internet address A disadvantage of this scenario is that A and C cannot be managed if B fails Figure 2 3 Running SNMP Agents on Multiple Nodes Note YParallel Library TCP IP and NonStop TCP IPv6 do not support this configuration B C SNMP Agent A SNMP Manager SNMP Manager SN...

Page 78: ...esources through SNMP agents 3 and 2 SNMP agent 2 processes requests from both managers The advantage of this scenario is that if A or C fails resources accessed through SNMP agent 2 and its subagents can still be monitored Figure 2 4 Managing Overlapping Sets of Resources SNMP Manager X SNMP Agent 2 B A SNMP Agent 1 Subagents Managed Resources Subagents Managed Resources TCP IP SNMP Manager Y C S...

Page 79: ...col is not restricted to NonStop Kernel IPC calls follow these guidelines Start each SNMP agent from a different subvolume Each SNMP agent uses the SNMPCTL file on the subvolume from which the SNMP agent was run Running each SNMP agent from a different subvolume ensures that each SNMP agent maintains its own distinct configuration Start only one SNMP agent process using the built in defaults Start...

Page 80: ...E ZSNM1 NOWAIT SYSTEM TCON1 7 TCPIP PROCESS NAME ZTC1 SYSTEM TCON1 12 SCF SCF T9082D20 01JUN93 18MAY93 01 09 96 12 38 06 System EAST Copyright Tandem Computers Incorporated 1986 1996 1 INFO PROCESS ZSNM0 SUB ALL SNMP Info PROCESS Name EMS Collector ZSNM0 EAST 0 SNMP Info PROFILE Name Access Hostaddr Community ZSNM0 DEFAULT READONLY 0 0 0 0 public SNMP Info ENDPOINT Name Network Hostaddr ZSNM0 DEFA...

Page 81: ... which the SNMP agent accepts or rejects requests from SNMP managers through TCP IP Configure and manage TCP IP request response connections between the SNMP agent and SNMP managers Configure and manage the definitions of destinations to which the SNMP agent sends traps When you start the SNMP agent using the default startup parameters the SNMP agent sends its events to the EMS collector 0 To use ...

Page 82: ... against the PROCESS object and specifying a new value for the EMSCOLL attribute For example ALTER PROCESS ZSNMP EMSCOLL ACOL Configuring Security Before the SNMP agent processes an SNMP request the SNMP agent authenticates the request to determine whether the SNMP manager is qualified to perform the operation in the request The request authentication rules implemented by the SNMP agent depend on ...

Page 83: ...y string composed of one or two discrete sections delimited by two colons as follows community name subagent password The community string included in incoming requests is part of the SNMP manager s configuration and is set as described in the documentation provided by the vendor of the SNMP manager The SNMP agent parses the community name portion of the community string Community names that an SN...

Page 84: ...operations are described by one of two access modes specified as ACCESS attributes in SCF READONLY and READWRITE If the access mode is READONLY the SNMP agent accepts GetRequest and GetNextRequest PDUs from the SNMP manager SetRequest PDUs are dropped If the access mode is READWRITE the SNMP agent accepts SetRequest GetRequest and GetNextRequest PDUs from the SNMP manager If the request is for an ...

Page 85: ...owing attribute values associated with it the SNMP agent process is ZSNMP PROFILE ZSNMP DEFAULT COMMUNITY public HOSTADDR 0 0 0 0 ACCESS READONLY You must add an authentication table entry for each community other than public from which the SNMP agent will be receiving SNMP requests Unless you stop or alter the default authentication table entry the SNMP agent continues to accept incoming Get and ...

Page 86: ...ITE READONLY HOSTADDR 130 253 15 230 0 0 0 0 SNMP agent receives request N O N O N O YES YES Does access mode permit requested operation YES SNMP Manager Station Authentication Table Request authenticationFailure Trap Response private tsmaccess 130 253 15 230 GetNext Does entry exist SNMP agent looks for entry containing community name Does address in request match address in table entry SNMP agen...

Page 87: ...ity name and Internet address in the request are not examined However they are passed to the subagent to which the request is forwarded the subagent can then employ additional security based on the community name and Internet address All MIB objects under the control of the SNMP agent are accessible Requests for operations on objects in the zagInProfile group are performed only if the PAID of the ...

Page 88: ...s community string agent community string subagent password Security Scenarios for SNMP Managers Using TCP IP Table 2 3 Security Scenarios page 1 of 2 Scenario Tasks Method SCF Commands Allow an SNMP manager to retrieve information only Ask the SNMP administrator to send requests to the SNMP agent under the public community By default the SNMP agent accepts Get and GetNext requests from all member...

Page 89: ...pply to all managers using the community name If READONLY access is not acceptable ask the other SNMP administrators to reconfigure their managers to send requests under a different community name STOP PROFILE ALTER PROFILE START PROFILE Revoke all access privileges from an SNMP manager Deactivate the authentication table entry for the community under which the SNMP manager has been sending reques...

Page 90: ...ges The default TCP IP request response connection definition specifies that the SNMP agent receives SNMP requests and returns responses through any available subnet associated with TCP IP process ZTC0 on the node on which the agent process is running You can specify that a different TCP IP process be used in the default configuration by including a TCPIP PROCESS NAME startup parameter in the RUN ...

Page 91: ... HFFFF0000 SUBNET2 WEST LAN2 130 252 87 1 ETHERNET HFFFF0000 status subnet ztc0 subnet2 TCPIP Status SUBNET WEST ZTC0 SUBNET2 Name Status SUBNET2 STARTED Multiple Agent Connections If the same TCP IP subsystem is handling SNMP agent manager communication for more than one SNMP agent process each SNMP agent must either be reached through a separate Internet address or must be configured at startup ...

Page 92: ...st response connection definition associated using each SNMP agent was altered as illustrated in the following SCF commands STOP ENDPOINT ZSNM1 DEFAULT STOP ENDPOINT ZSNM0 DEFAULT ASSUME PROCESS ZSNM1 ALTER ENDPOINT DEFAULT HOSTADDR 130 25 88 2 START ENDPOINT DEFAULT ASSUME PROCESS ZSNM0 ALTER ENDPOINT DEFAULT HOSTADDR 130 25 88 1 START ENDPOINT DEFAULT Each SNMP agent now has a distinct subnet to...

Page 93: ...es in the Parallel Library TCP IP process In Figure 2 7 agent processes on three nodes are started using the built in defaults Later the default request response connection definitions are altered for all three SNMP agents The following example illustrates altering connection definitions using SCF SYSTEM B ASSUME PROCESS ZSNMP STOP ENDPOINT DEFAULT ALTER ENDPOINT DEFAULT HOSTADDR 130 25 86 2 START...

Page 94: ...efinition You specify and request information about trap destinations by issuing SCF commands against TRAPDEST objects SNMP Set requests against the SNMP agent s zagInTrapdestTable entry objects as described in Section 3 MIBs Supported by the SNMP Agent Figure 2 7 Multiple Remote SNMP Agents Single Host Request Response Connections B C SNMP Agent ZSNMP A SNMP Manager 130 25 86 1 130 25 86 2 130 25...

Page 95: ...l node The zagInTdType object specifies the type of the trap destination directed or broadcast Directed trap destinations receive only trap messages specifically directed to the trap destinations by the agent or subagent from which the trap originates Broadcast trap destinations receive all trap messages except directed ones The zagInTdPort object specifies the port to which traps should be sent T...

Page 96: ... agent receives a request from the SNMP manager at Internet address 155 186 130 123 the SNMP agent creates and starts another TRAPDEST object TRAPDEST agent process DYNA1 COMMUNITY Tandem NETWORK ZTC0 HOSTADDR 155 186 130 123 Once you explicitly create a TRAPDEST object using the ADD command dynamic TRAPDEST generation stops The default trap port would be 162 however the port cannot be seen in SCF...

Page 97: ...to an SNMP manager that communicates with the SNMP agent through NonStop Kernel IPC calls configure a trap destination using a host address of 127 0 0 1 the local loopback address a TCP IP convention that refers to this host Disabling the Sending of Traps Any SNMP manager using the proper access authority can disable the sending of authenticationFailure traps to all configured trap destinations by...

Page 98: ...stination through a different TCP IP process In this configuration ZSNM0 was started using the built in defaults ZSNM1 was started from a different subvolume using a value of ZTC1 for the TCPIP PROCESS NAME startup parameter Figure 2 8 Multiple SNMP Agents Single Host Connections SNMP Manager Station 2 130 25 88 1 130 25 88 2 ZTC1 SNMP Agent ZSNM0 SNMP Agent ZSNM1 SNMP Manager Station 1 Legend Tra...

Page 99: ...R 130 25 88 1 START ENDPOINT DEFAULT ADD TRAPDEST STA1 HOSTADDR 130 25 86 15 START TRAPDEST STA1 ASSUME PROCESS ZSNM1 STOP ENDPOINT DEFAULT ALTER ENDPOINT DEFAULT HOSTADDR 130 25 88 2 START ENDPOINT DEFAULT ADD TRAPDEST STA1 NETWORK ZTC0 HOSTADDR 130 25 86 15 START TRAPDEST STA1 Multiple Host Connections The TCP IP process handling the sending of traps does not have to be on the same node as the a...

Page 100: ...nario Note that the SNMP agent on node B uses the default NETWORK attribute value in its TRAPDEST object definition SYSTEM B ASSUME PROCESS ZSNMP STOP ENDPOINT DEFAULT ALTER ENDPOINT DEFAULT HOSTADDR 130 25 86 2 START DEFAULT ADD TRAPDEST STA2 HOSTADDR 130 25 86 4 START TRAPDEST STA2 Figure 2 9 Multiple SNMP Agents Multiple Host Connections B C SNMP Agent ZSNMP A SNMP Manager 2 at 130 25 86 4 130 ...

Page 101: ...ENDPOINT DEFAULT ALTER ENDPOINT DEFAULT NETWORK B ZTC0 HOSTADDR 130 25 86 1 START DEFAULT ADD TRAPDEST STA2 NETWORK B ZTC0 HOSTADDR 130 25 86 4 START TRAPDEST STA2 SYSTEM C ASSUME PROCESS ZSNMP STOP ENDPOINT DEFAULT ALTER ENDPOINT DEFAULT NETWORK B ZTC0 HOSTADDR 130 25 86 3 START DEFAULT ADD TRAPDEST STA2 NETWORK B ZTC0 HOSTADDR 130 25 86 4 START TRAPDEST STA2 ...

Page 102: ...Installing and Configuring the SNMP Agent SNMP Configuration and Management Manual 424777 006 2 46 Multiple Host Connections ...

Page 103: ...are not included in the ISV They belong to the System and SNMP groups from MIB II known to all SNMP managers SNMP Agent MIB Groups The SNMP agent supports the objects in these three MIB groups System group This MIB II group provides configuration information about the SNMP agent and the node on which it resides SNMP group This MIB II group provides statistical information about all the SNMP messag...

Page 104: ...ofile 3 zagInTrapdest 4 In this section System group objects are defined in the subsection System Group SNMP group objects are defined in the subsection SNMP Group The zagInternal group objects are defined in the subsection zagInternal Group RFC Compliance The SNMP agent supports the MIB II System and SNMP group objects in strict compliance with the standards specified in RFC 1213 Management Infor...

Page 105: ...r objects that provides general information about the host on which the SNMP agent is installed iso 1 identified organization 3 dod 6 internet 1 mgmt 2 mib II 1 system 1 sysDescr 1 sysObjectID 2 sysUpTime 3 sysContact 4 sysName 5 sysLocation 6 sysServices 7 MIB Objects Table 3 1 describes the MIB II System group objects that are supported by the SNMP agent ...

Page 106: ...IER The enterprise identifier of the SNMP agent The constant value for this object is 1 3 6 1 4 1 169 3 155 1 Assigned by the Internet sysUpTime 1 3 6 1 2 1 1 3 read only TimeTicks The difference in hundredths of a second between the GMT Julian timestamp when the SNMP agent was brought up and the current GMT Julian timestamp Refer to the documentation for your SNMP manager Returned by Guardian pro...

Page 107: ... from a gethostname call on that process Otherwise it is derived from the name received from a gethostname call on the local ZTC0 process sysLocation 1 3 6 1 2 1 1 6 read write DisplayString SIZE 0 255 The physical location of the node on which the SNMP agent is installed This value is stored in SNMPCTL Initially derived from the default value of unknown Can be set by an authorized SNMP manager sy...

Page 108: ...n 3 dod 6 internet 1 mgmt 2 mib II 1 snmp 11 snmpInPkts 1 snmpOutPkts 2 snmpInBadVersions 3 snmpInBadCommunityNames 4 snmpInBadCommunityUses 5 snmpInASNParseErrs 6 snmpInTooBigs 8 snmpInNoSuchNames 9 snmpInBadValues 10 snmpInReadOnlys 11 snmpInGenErrs 12 snmpInTotalReqVars 13 snmpInTotalSetVars 14 snmpInGetRequests 15 snmpInGetNexts 16 snmpInSetRequests 17 snmpInGetResponses 18 snmpInTraps 19 snmp...

Page 109: ...d that used an unknown SNMP community name An integer set by the SNMP agent counter snmpInBadCommunity Uses 1 3 6 1 2 1 11 5 read only Counter The total number of SNMP messages received that represented an SNMP operation not allowed by the community named in the message An integer set by the SNMP agent counter snmpInASNParseErrs 1 3 6 1 2 1 11 6 read only Counter The total number of ASN 1 or BER e...

Page 110: ...t counter snmpInGetRequests 1 3 6 1 2 1 11 15 read only Counter The total number of GetRequest PDUs accepted and processed An integer set by the SNMP agent counter snmpInGetNexts 1 3 6 1 2 1 11 16 read only Counter The total number of GetNextRequest PDUs accepted and processed An integer set by the SNMP agent counter snmpInSetRequests 1 3 6 1 2 1 11 17 read only Counter The total number of SetRequ...

Page 111: ...GetNexts 1 3 6 1 2 1 11 26 read only Counter The total number of GetNextRequest PDUs generated The constant value for this object is 0 snmpOutSetRequests 1 3 6 1 2 1 11 27 read only Counter The total number of SetRequest PDUs generated The constant value for this object is 0 snmpOutGetResponses 1 3 6 1 2 1 11 28 read only Counter The total number of GetResponse PDUs generated An integer set by the...

Page 112: ...he SNMP agent can be addressed and the TCP IP process that handles request response messages between managers and the SNMP agent zagInProfile objects which define the criteria the SNMP agent uses to determine whether to accept or reject incoming requests from SNMP managers that communicate with the SNMP agent through TCP IP zagInTrapdest objects which define SNMP manager Internet addresses and TCP...

Page 113: ...gInProfile 3 zagInProfileTable 1 zagInProfileEntry 1 zagInPfRowStatus 1 zagInPfName 2 zagInPfState 3 zagInPfHostAddr 4 zagInPfCommunity 5 zagInPfAccess 6 zagInTrapdest 4 zagInDirectedTrapdestName 1 zagInTrapdestTable 2 zagInTrapdestEntry 1 zagInTdRowStatus 1 zagInTdName 2 zagInTdState 3 zagInTdHostAddr 4 zagInTdCommunity 5 zagInTdNetwork 6 zagInTdType 7 zagInTdPort 8 MIB Objects Table 3 3 describe...

Page 114: ...SNMP agent for example D23 zagInProcName 1 3 6 1 4 1 169 3 155 1 7 1 3 read only DisplayString A string that shows the current process name for the SNMP agent The processName value which is assigned by the RUN command NAME option when the SNMP agent is started Derived from SNMP agent calls to the Guardian procedure PROCESS_GETINFO_ zagInProcPAID 1 3 6 1 4 1 169 3 155 1 7 1 4 read only DisplayStrin...

Page 115: ... string that shows the CPU time for the SNMP agent process HH MM SS centisecond value which is derived from SNMP agent calls to the Guardian procedure PROCESS_ GETINFOLIST_ zagInProcPri 1 3 6 1 4 1 169 3 155 1 7 1 9 read only INTEGER 1 199 The current process priority Numeric value with range of 1 through 199 which is assigned by the RUN command PRI option or by CMON Derived from SNMP agent calls ...

Page 116: ...est response messages between managers and the SNMP agent zagInEndpointTable 1 3 6 1 4 1 169 3 155 1 7 2 1 not accessible A list of Endpoint object entries zagInEndpointEntry 1 3 6 1 4 1 169 3 155 1 7 2 1 1 not accessible INTEGER 1 65535 An Endpoint entry containing objects that define a socket on which SNMP manager messages are received and to which replies are sent zagInEpRowStatus 1 3 6 1 4 1 1...

Page 117: ...n only be read DEFINED 1 STARTED 3 STARTING 4 STOPPED 5 Default value is DEFINED Set by the SNMP agent zagInEpHostAddr 1 3 6 1 4 1 169 3 155 1 7 2 1 1 4 read write DisplayString The local host IP address that the agent is to monitor for incoming messages Format of For IP addresses this value must either be the default value 0 0 0 0 or a fully specified address for example 103 252 12 3 Can be set b...

Page 118: ... accessible through TCP IP read write access through IPC interface INTEGER 1 6 Used to manage the creation alternation and deletion of table rows The row must be in the notReady or notInService state for any row object to be modified Numeric value of 1 through 6 See Table 3 6 for RowStatus values and their descriptions Set by the SNMP agent or through authenticated SNMP requests received through t...

Page 119: ...ough IPC interface DisplayString A data string compared with the agent section of the community string of received messages to authenticate the message The SNMP agent uses the agent community string for request authentication and passes the entire community string to subagents The agent section of the community string can be 0 to 50 bytes The default value is public The value can be set from SCF o...

Page 120: ...tion zagInTdRowStatus 1 3 6 1 4 1 169 3 155 1 7 4 2 1 1 read write INTEGER SIZE 1 6 Used to manage the creation alternation and deletion of table rows The row must be in the notReady or the notInService state for any row object to be modified Numeric value of 1 through 6 See Table 3 6 for RowStatus values and their descriptions Set by the SNMP agent or by an authorized SNMP manager zagInTdName 1 3...

Page 121: ... 3 6 1 4 1 169 3 155 1 7 4 2 1 6 read write DisplayString The name of the TCP IP process that the agent uses to send traps TCP IP process name The default value is ZTC0 Can be set by an authorized SNMP manager assigned from SCF or set by the run startup parameter TCPIP PROCESS NAME zagInTdType 1 3 6 1 4 1 169 3 155 1 7 4 2 1 7 read write INTEGER 1 2 Broadcast trap destinations are sent all trap me...

Page 122: ...imPID DisplayString read only The SNMP agent s primary process ID zagInProcBkupPID DisplayString read only The SNMP agent s backup process ID zagInProcCreatTime DisplayString read only The SNMP agent s instantiation timestamp zagInProcCpuTime DisplayString read only The SNMP agent s CPU usage time zagInProcPri Integer read only The SNMP agent s priority zagInProcHomeTerm DisplayString read only Th...

Page 123: ...on table entry zagInPfCommunity DisplayString read write A data string compared with the community string of requests received through TCP IP for the purpose of accepting or rejecting the request zagInPfAccess Integer read write The authority of the community members to retrieve and alter network management information zagInTrapdestTable Row Objects zagInTdRowStatus Integer read write The object u...

Page 124: ...OINT PROFILE or TRAPDEST object attributes a RowStatus object is automatically created for that object In Table 3 5 an X identifies table row objects for zagInEndpointTable zagInProfileTable and zagInTrapdestTable that can be accessed by SCF commands and those that can be accessed by Set operations issued from SNMP managers The RowStatus and State object values determine the operations you can per...

Page 125: ...tocol Accessible to SNMP Managers Through the IPC Interface zagInEndpointTable zagInEpRowStatus X X zagInEpName X X X zagInEpState X X X zagInEpHostAddr X X X zagInEpNetwork X X X zagInProfileTable zagInPfRowStatus X zagInPfName X X zagInPfState X X zagInPfHostAddr X X zagInPfCommunity X X zagInPfAccess X X zagInTrapdestTable zagInTdRowStatus X X zagInTdName X X X zagInTdState X X X zagInTdHostAdd...

Page 126: ...tate values describe the availability of an entry for use by the SNMP agent and managers Note The zagInProfileTable entries can only be accessed through SNMP requests received though NonStop Kernel IPC calls if the Processor Accessor ID PAID of the manager process is compatible with that of the agent process In Figure 2 5 the authentication table permits the SNMP agent to accept Get and GetNext re...

Page 127: ...sequently set by the SNMP agent The State object value identifies the current operational state of the table row defined started starting or stopped createAndGo 4 An action value that can only be written Is supplied in a Set command by the management application that wants to create a new row and have it available for use by the SNMP agent createAndWait 5 An action value that can only be written I...

Page 128: ...ee columns to this value zagInEpRowStatus Object zagInTdRowStatus Object zagInPfRowStatus Object 1 The row state object2 will be set to The equivalent SCF command issued against an ENDPOINT TRAPDEST or PROFILE object is Create a table row Add a definition to the SNMPCTL file createAndWait X X X defined ADD Create a table row and make it available for use by the SNMP agent Add and activate a defini...

Page 129: ... object has never been started otherwise stopped ABORT or STOP Make a table row available for use by the SNMP agent Activate a definition in the SNMPCTL file active X X X starting then started START Table 3 7 RowStatus Values and Table Management Operations page 2 of 2 To do this Set one of the following row status objects denoted in the next three columns to this value zagInEpRowStatus Object zag...

Page 130: ...is example TRAP is the name and index value for the new row Its OID is derived from the ASCII character set In the value line of this example a RowStatus value of 4 createAndGo has been specified After receiving the Set operation message the SNMP agent creates the RowStatus object and all other columnar objects that have default values See Table 3 8 The row Name object zagInEpName zagInTdName zagI...

Page 131: ...Status object to active 1 Table 3 8 ENDPOINT and TRAPDEST Default Values Table Row Object Attribute zagInEndpointTable Default Value zagInTrapdestTable Default Value zagInProfileTable Default Value NAME none a name must be supplied by an authorized SNMP management application none a name must be supplied by an authorized SNMP management application none a name must be supplied by an authorized SNM...

Page 132: ...w are immediately removed from the SNMP agent s private MIB and a noError response is returned by the SNMP agent Configuring the SNMP Agent Through SNMP Requests You can also configure and manage the following components of the SNMP agent environment through SNMP requests Request Response Connections The SNMP agent s zagInEndpoint group objects define the Internet addresses and TCP IP processes to...

Page 133: ...Figure 2 5 the authentication table permits the SNMP agent to accept Get and GetNext requests from any SNMP manager belonging to the public community as well as Set requests sent under the Private community from the SNMP manager whose address is 130 252 15 230 zagInProfile group objects are not accessible through TCP IP s UDP transport protocol SNMP Agent Private MIB Objects Table 3 11 lists the S...

Page 134: ...TCP IP process specified in the TCPIP PROCESS NAME startup parameter or if none is specified against ZTC0 on the local node sysLocation unknown sysServices 79 SNMP group object snmpEnableAuthenTraps 1 yes Table 3 11 SNMP Agent Private MIB Objects That Describe the SNMP Operations Environment page 1 of 4 SNMP Agent Private MIB Object What the Object Defines and Its Default Value Equivalent SCF Cons...

Page 135: ...ode NETWORK attribute zagInTrapdestTable Contains all of the trap destination definitions All of the TRAPDEST objects currently defined zagInTrapdestEntry Each row in the zagInTrapdestTable represents a trap destination definition TRAPDEST object zagInTdRowStatus The value of this object is the means by which trap destination definitions are created and removed and also the means by which their av...

Page 136: ...lt Although there is no equivalent SCF construct all trap destinations created through SCF have a type value of broadcast zagInTdPort An entry containing the value of the trap port The default vale is 162 This object can not be viewed modified using the SCF commands This can only be set by the manager when the zagInTdRowStatus is DEFINED or STOPPED zagInProfileTable Contains all of the authenticat...

Page 137: ...nPfName A name that serves as an index into the table uniquely identifying the table row defining the entry profile name zagInPfState The operational state of the authentication table entry Reflects result of issuing SCF ADD START STOP ABORT commands as returned by a STATUS command See Table 3 4 on page 3 20 zagInPfHostAddr The Internet address of the manager or managers whose security is being de...

Page 138: ...can be accessed only through SNMP requests received though NonStop Kernel IPC calls Requests for operations on objects in the zagInProfile group are performed only if the PAID of the manager process is compatible with that of the agent process For more details see Figure 2 5 the authentication table permits the SNMP agent to accept Get and GetNext requests from any SNMP manager belonging to the pu...

Page 139: ... 006 Part II SCF for the SNMP Agent Part III consists of the following sections which describe the Subsystem Control Facility SCF interface to the SNMP agent Section 4 Introduction to SCF for the SNMP Agent Section 5 SCF Commands for the SNMP Agent ...

Page 140: ...Part II SCF for the SNMP Agent SNMP Configuration and Management Manual 424777 006 ...

Page 141: ...This section describes Tasks you can perform with SCF SCF and the DSM family of products SCF concepts of objects object attributes and object states Running SCF Entering SCF commands SCF error messages The SCF online help facility A brief introduction to the SNMP network management environment and the part the NonStop agent plays in such an environment SCF information specific to the NonStop agent...

Page 142: ...ures data definitions and protocols that support the interface between the operations and subsystem environments SPI is the foundation on which some management applications are built and the foundation of the SCF interface to HP subsystems that support SPI The Subsystem Control Point SCF provides an operator interface to an intermediate process called the Subsystem Control Point SCP The SCP proces...

Page 143: ...tic of that object To define an attribute with the ADD command or to change it with the ALTER command you provide an attribute specifier consisting of an attribute name and a value You can add or alter several attributes of an object in a single command Default values exist for most attributes The INFO command displays the current attribute values for an object In the display generated by the INFO...

Page 144: ...An object is always in one of several operational states such as DEFINED STARTED or STOPPED The sequence of states an object goes through varies from object to object and from subsystem to subsystem The state of an object at a given time is important Certain commands have no effect on an object when it is in one state but do affect the object when it is in another state Figure 4 2 Table 4 1 States...

Page 145: ...t defines the EMS collector to which the NonStop agent process sends event messages it generates The components of the NonStop agent configuration represented by the PROCESS object type and its attributes are highlighted in bold in Figure 4 3 Naming Conventions PROCESS Object In SCF commands the name associated with the PROCESS object is the name assigned to the NonStop agent process when it is in...

Page 146: ... specifies the EMS collector process to which the NonStop agent is to send events it generates For more detail about this attribute see the ALTER Command on page 5 13 Default PROCESS Object When you initially start the NonStop agent process the following PROCESS object is automatically configured and started PROCESS ZSNMP EMSCOLL 0 Note For information on NonStop agent process startup parameters s...

Page 147: ... PROCESS Object State Transition Sequence STARTED SNMP agent process stopped outside of SCF TACL STOP ZSNMP ALTER INFO NAMES STATUS TRACE VERSION PROCESS Expecting an existing SCF supported object name TACL RUN SNMPAGT NAME ZSNMP STARTING SNMP agent process not running SNMP agent process completes initialization tasks VST005 vsd ...

Page 148: ...nStop agent is known to other entities on the network HOSTADDR attribute The components of a NonStop agent configuration represented by the ENDPOINT object type and its attributes are highlighted in bold in Figure 4 5 Naming Conventions ENDPOINT Object You assign a unique name to each request response connection being used by a given NonStop agent process The name consists of The name of the PROCE...

Page 149: ...wing commands For example the following command returns the status of all ENDPOINT objects whose object names begin with END STATUS ENDPOINT ZSNMP END The next example returns the status of all ENDPOINT objects defined for the NonStop agent process named ZSNMP ASSUME PROCESS ZSNMP STATUS ENDPOINT ENDPOINT Object States The ENDPOINT object is always in one of the DEFINED STARTED STARTING STOPPING o...

Page 150: ... configured and started ENDPOINT agent process DEFAULT NETWORK ZTC0 HOSTADDR 0 0 0 0 This default ENDPOINT object is stored in the SNMPCTL file Table 4 2 ENDPOINT Object States State Description DEFINED The ENDPOINT object has been configured with the SCF ADD command but has not been initially activated for use in the NonStop agent operations environment STARTED The ENDPOINT object is either ready...

Page 151: ... Not Found Error ABORT ALTER DELETE INFO START STATUS or STOP ENDPOINT STOPPING Yes No ABORT STOP ENDPOINT START ENDPOINT Are any requests currently being processed No Yes ABORT STOP ENDPOINT DELETE ENDPOINT No definition for Underlying resource becomes available ABORT STOP ENDPOINT STARTING STOPPED DELETE ENDPOINT Are all underlying resources available this object exists VST009 vsd Underlying res...

Page 152: ...attributes are highlighted in bold in Figure 4 7 Naming Conventions PROFILE Object You assign a unique name to each entry in the authentication table being used by a given NonStop agent process The name consists of The name of the PROCESS object that identifies the NonStop agent process using the authentication table A period A pound sign A logical identifier representing the PROFILE object defini...

Page 153: ...xample the following command returns information about all PROFILE objects whose object name begins with PROF INFO PROFILE ZSNMP PROF The next example would return information about all PROFILE objects configured for the NonStop agent process ZSNMP ASSUME PROCESS ZSNMP INFO PROFILE Figure 4 7 The PROFILE Object ABORT INFO STOP ALTER START DELETE STATUS SNMP Manager Managed Resources Subagent SNMP ...

Page 154: ...e security is being defined in the authentication table entry For a detailed description of these attributes see the ADD Command on page 5 5 Default PROFILE Object When you initially start the NonStop agent process with the default WARM option the following PROFILE object is automatically configured and started PROFILE agent process DEFAULT COMMUNITY public ACCESS READONLY HOSTADDR 0 0 0 0 This de...

Page 155: ...Object Figure 4 8 PROFILE Object State Transition Sequence STARTED ADD PROFILE DEFINED STOPPED ABORT STOP PROFILE START PROFILE START PROFILE DELETE PROFILE Object Not Found Error ABORT ALTER DELETE INFO START STATUS or STOP PROFILE ABORT STOP PROFILE DELETE PROFILE No definition for this objectexists VST011 vsd ...

Page 156: ... The Internet address of the manager to which traps are to be sent HOSTADDR attribute The components of a NonStop agent configuration represented by the TRAPDEST object type and its attributes are highlighted in bold in Figure 4 9 Naming Conventions TRAPDEST Object You assign a unique name to each trap destination configured for a given NonStop agent process The name consists of The name of the PR...

Page 157: ...RAPDEST object name specifications for the following commands The following example returns information about all TRAPDEST objects whose object name began with TRAP INFO TRAPDEST ZSNMP TRAP The following example returns information about all TRAPDEST objects defined for NonStop agent process ZSNMP ASSUME PROCESS ZSNMP INFO TRAPDEST TRAPDEST Object States The TRAPDEST object is always in one of the...

Page 158: ... TRAPDEST object for each Internet address from which it receives a request These dynamically generated TRAPDEST objects are named DYNA0 DYNA1 and so on They are stored in the SNMPCTL file For example if the NonStop agent receives a request from the manager at Internet address 130 252 86 10 it creates and starts the following TRAPDEST object TRAPDEST agent process DYNA0 COMMUNITY Tandem NETWORK ZT...

Page 159: ...bled and disabled see The TRAPDEST Object on page 4 16 SCF Configured Trap Destination Limitations Broadcast Only The NonStop agent supports two types of trap destinations directed and broadcast The NonStop agent sends traps to directed trap destinations only when specifically told to do so by a subagent Directed trap destinations only receive traps that are specifically directed at them The NonSt...

Page 160: ...Sequence STARTED ADD TRAPDEST DEFINED STOPPED ABORT STOP TRAPDEST START TRAPDEST DELETE TRAPDEST Object Not Found Error ABORT ALTER DELETE INFO START STATUS or STOP TRAPDEST Underlying resource becomes unavailable STARTING Are all underlying resources available START TRAPDEST Yes No SNMP agent generates coldStart trap DELETE TRAPDEST No definition for ABORT STOP TRAPDEST this objectexists VST013 v...

Page 161: ...y to process commands by displaying its prompt You can change this prompt with the SETPROMPT command SCF waits for a command followed by a return After it receives and processes the command SCF displays its prompt for the next command Entering SCF Commands An SCF command always begins with a keyword identifying the command such as START VOLUME or TRACE Some SCF commands let you control your SCF se...

Page 162: ...te of the NonStop agent TRAPDEST object named ZSNMP TRAP STATUS TRAPDEST ZSNMP TRAP SNMP Status TRAPDEST Name State ZSNMP TRAP STARTED When including command modifiers options that affect the scope of the command or object attributes to define characteristics of an object separate each keyword value pair from the object name with a comma For example INFO PROCESS ZSNMP SUB All DETAIL ADD TRAPDEST Z...

Page 163: ... that a command be applied to an object SUB NONE to an object and its subordinates SUB ALL or only to the subordinates of an object and not the object itself SUB ONLY For example INFO PROCESS ZSNMP SUB ALL You can use the DETAIL option to request that detailed information be returned in response to a request for information For example VERSION ZSNMP DETAIL For the command modifiers valid for each ...

Page 164: ...ypes of error messages Command parsing error messages Common error messages common to all subsystems SCF generated error messages Subsystem specific error messages For SCF error messages see Appendix B SCF Error Messages for the NonStop Agent SCF Online Help You access the interactive SCF online help facility with the HELP command When you enter the HELP command with no options SCF displays a menu...

Page 165: ...based network An SNMP network management environment consists of one or more SNMP managers one or more SNMP agents and the network management information that is retrieved and manipulated by the agents on behalf of the managers The NonStop agent provides the means by which HP customers operating multiplatform networks can have HP subsystems managed from SNMP compliant network managers The SNMP age...

Page 166: ...fore you can issue SCF commands to retrieve information or perform any configuration or management tasks for the NonStop agent If you know the name of the NonStop agent process you can find out about the current NonStop agent configuration by issuing SCF INFO and STATUS commands and including the SUB ALL command modifier The NonStop agent process is often started under the name ZSNMP If you do not...

Page 167: ... PROCESS NAME Startup Parameter The NonStop agent has a startup parameter TCPIP PROCESS NAME that allows you to specify the TCP IP process to be used as the default value for the NETWORK attribute when ENDPOINT and TRAPDEST objects are created If you do not include the TCPIP PROCESS NAME startup parameter when you start the NonStop agent the default TCP IP process is ZTC0 on the local node ...

Page 168: ...Introduction to SCF for the SNMP Agent SNMP Configuration and Management Manual 424777 006 4 28 SCF Configuration and the TCPIP PROCESS NAME Startup Parameter ...

Page 169: ...orted for NonStop Agent Objects Object Type for Which Command Is Supported Command Sensitive 1 PROCESS PROFILE ENDPOINT TRAPDEST null2 ABORT Yes X X X ADD Yes X X X ALTER Yes X X X X DELETE Yes X X X INFO No X X X X NAMES No X X START Yes X X X STATUS No X X X X STOP Yes X X X TRACE Yes X VERSION No X X 1 A sensitive command can have detrimental effects if improperly used These commands can be iss...

Page 170: ...re creating Attribute Conflicts Within a NonStop Agent Configuration Object definitions not allowed within a NonStop agent configuration Two ENDPOINT objects cannot use the same TCP IP Internet address same NETWORK attribute and same or overlapping HOSTADDR attribute values Two PROFILE objects cannot be defined with the same community same COMMUNITY attribute value When you try to add the conflict...

Page 171: ...and to inactivate a request response connection between a NonStop agent process and managers agent process endpoint name identifies the request response connection being inactivated agent process identifies the NonStop agent process to which the ENDPOINT object belongs It consists of a dollar sign followed by one to five alphanumeric characters the first of which must be alphabetic endpoint name i...

Page 172: ...response connection defined by the END1 object ABORT ENDPOINT ZSNMP END1 ABORT PROFILE Command Use the ABORT PROFILE command to inactivate an authentication table entry agent process profile name identifies the authentication table entry being inactivated agent process identifies the NonStop agent process to which the PROFILE object belongs It consists of a dollar sign followed by one to five alph...

Page 173: ... be alphabetic trapdest name identifies the TRAPDEST object It consists of a pound sign followed by one to seven alphanumeric characters the first of which must be alphabetic Considerations ABORT TRAPDEST Traps being generated by or received for forwarding by the NonStop agent when a TRAPDEST object is aborted are not sent to that particular destination Example ABORT TRAPDEST The following example...

Page 174: ...s preceded by a dollar sign The first alphanumeric character must be a letter The process name can optionally be qualified with a node name backslash followed by one to seven alphanumeric characters the first of which must be a letter identifying the node on which the process is running The default is the TCP IP process specified in the TCPIP PROCESS NAME startup parameter when the NonStop agent p...

Page 175: ... added and started ENDPOINT ZSNMP DEFAULT NETWORK ZTC0 HOSTADDR 0 0 0 0 By default then the NonStop agent receives and sends SNMP requests through any available subnet associated with the TCP IP process ZTC0 on the same node as the NonStop agent process is running Two ENDPOINT objects cannot use the same TCP IP Internet address or use an address that is a member of a full wildcard address specific...

Page 176: ... which must be alphabetic COMMUNITY community name specifies the community name that must be present in requests sent by managers for the NonStop agent to accept the request community name is a case sensitive of 1 to 50 character enclosed string within quotation marks The default is public HOSTADDR ip address specifies the Internet address of the managers whose security is being defined in the aut...

Page 177: ...est has been forwarded to a subagent the subagent might employ additional security based on the subagent password portion of the community string If you start a NonStop agent process with its default WARM startup parameter and name the process ZSNMP a PROFILE object called ZSNMP DEFAULT with the following attribute values is automatically added and started PROFILE ZSNMP DEFAULT COMMUNITY public HO...

Page 178: ...ecause default values are assumed when an attribute keyword value pair is omitted the following SCF commands have the same result ADD PROFILE ZSNMP UBLAN COMMUNITY GetComm ADD PROFILE ZSNMP UBLAN COMMUNITY GetComm HOSTADDR 0 0 0 0 ACCESS READONLY ADD TRAPDEST Command Use the ADD TRAPDEST command to define a manager to which traps are to be sent trap destination agent process trapdest name identifi...

Page 179: ...started If none was specified ZTC0 on the local node HOSTADDR ip address specifies the Internet address of the manager to which trap messages are to be sent Enter ip address in standard Internet address dotted decimal format consisting of the ASCII values of four bytes separated by periods enclosed within quotation marks For example 133 50 85 43 There is no default value for the HOSTADDR attribute...

Page 180: ... and starts the following TRAPDEST object TRAPDEST agent process DYNA0 COMMUNITY Tandem NETWORK ZTC0 HOSTADDR 130 252 86 10 Then if the NonStop agent receives a request from the manager at Internet address 155 186 130 123 it creates and starts another TRAPDEST object TRAPDEST agent process DYNA1 COMMUNITY Tandem NETWORK ZTC0 HOSTADDR 155 186 130 123 Once you explicitly create a TRAPDEST object wit...

Page 181: ...NETWORK ZTC0 HOSTADDR 130 252 86 10 ALTER Command The ALTER command Changes attribute values associated with an object Requires that if you include an attribute keyword you also include a value Is a sensitive command ALTER ENDPOINT Command Use the ALTER ENDPOINT command to change the TCP IP process or Internet address in a request response connection between a NonStop agent process and managers ag...

Page 182: ... for this attribute if the process runs on a different node or allow the attribute to default to such a process HOSTADDR ip address specifies the Internet addresses by which the NonStop agent is known to the network Enter ip address in standard Internet address dotted decimal format consisting of the ASCII values of four bytes separated by periods enclosed within quotation marks For example 133 50...

Page 183: ...nning Considerations ALTER PROCESS You can issue an ALTER command against a PROCESS object while the object is in the STARTED state In the event of a takeover by the backup NonStop agent process the backup process also sends its events to the EMS collector identified in the current EMSCOLL setting The value of the EMSCOLL attribute is not saved in the SNMPCTL file in which the NonStop agent mainta...

Page 184: ...must be alphabetic profile name identifies the PROFILE object It consists of a pound sign followed by one to seven alphanumeric characters the first of which must be alphabetic COMMUNITY community name specifies the community name that must be present in requests sent by managers for the NonStop agent to accept the request community name is a case sensitive of 1 to 50 character enclosed string wit...

Page 185: ...N ALTER PROFILE UBLAN ACCESS READONLY START PROFILE UBLAN ALTER TRAPDEST Command Use the ALTER TRAPDEST command to change a trap destination definition agent process trapdest name identifies the trap destination definition being altered agent process identifies the NonStop agent process to which the TRAPDEST object belongs It consists of a dollar sign followed by one to five alphanumeric character...

Page 186: ...y be qualified with a node name backslash followed by one to seven alphanumeric characters the first of which must be a letter identifying the node on which the process is running HOSTADDR ip address specifies the Internet address of the manager to which trap messages are to be sent Enter ip address in standard Internet address dotted decimal format consisting of the ASCII values of four bytes sep...

Page 187: ...to which the ENDPOINT object belongs It consists of a dollar sign followed by one to five alphanumeric characters the first of which must be alphabetic endpoint name identifies the ENDPOINT object It consists of a pound sign followed by one to seven alphanumeric characters the first of which must be alphabetic Example DELETE ENDPOINT The following example stops and removes the request response con...

Page 188: ... PROFILE ZSNMP UBLAN DELETE PROFILE ZSNMP UBLAN DELETE TRAPDEST Command Use the DELETE TRAPDEST command to remove a trap destination from a NonStop agent configuration agent process trapdest name identifies the trap destination being removed from the NonStop agent configuration agent process identifies the NonStop agent process to which the TRAPDEST object belongs It consists of a dollar sign foll...

Page 189: ... process identifies the NonStop agent process to which the ENDPOINT object belongs It consists of a dollar sign followed by one to five alphanumeric characters the first of which must be alphabetic endpoint name identifies the ENDPOINT object It consists of a pound sign followed by one to seven alphanumeric characters the first of which must be alphabetic DETAIL specifies that the display contain ...

Page 190: ...e object set Examples INFO PROCESS The following example displays detailed information about NonStop agent process ZSNMP INFO PROCESS ZSNMP DETAIL SNMP Detailed Info PROCESS EAST ZSNMP Program file name EAST DEV SNMP SNMPAGT Swap volume QA EMS Collector EAST 0 The next example displays information about all the objects defined for NonStop agent process ZSNMP INFO PROCESS ZSNMP SUB ALL SNMP Info PR...

Page 191: ...tion table entry agent process profile name identifies the authentication table entry whose attribute values you want to display agent process identifies the NonStop agent process to which the PROFILE object belongs It consists of a dollar sign followed by one to five alphanumeric characters the first of which must be alphabetic profile name identifies the PROFILE It consists of a pound sign follo...

Page 192: ...ribute values you want to display agent process identifies the NonStop agent process to which the TRAPDEST object belongs It consists of a dollar sign followed by one to five alphanumeric characters the first of which must be alphabetic trapdest name identifies the TRAPDEST object It consists of a pound sign followed by one to seven alphanumeric characters the first of which must be alphabetic DET...

Page 193: ... NONE ALL ONLY selects the objects whose names are to be displayed Example NAMES The following example lists the names of all objects defined for NonStop agent process ZSNMP NAMES ZSNMP SNMP Names PROCESS EAST ZSNMP PROCESS ZSNMP PROFILE ZSNMP DEFAULT ZSNMP UBLAN ENDPOINT ZSNMP DEFAULT TRAPDEST ZSNMP TRAP NAMES PROCESS agent process SUB NONE ALL ONLY NONE returns the name of the NonStop agent proc...

Page 194: ...ENDPOINT object It consists of a pound sign followed by one to seven alphanumeric characters the first of which must be alphabetic Considerations START ENDPOINT When you START an ENDPOINT object if the TCP IP subnet represented by the object definition is not available the ENDPOINT object enters the STARTING state and the NonStop agent periodically tries to access the resources When the resource b...

Page 195: ...y NonStop agent process ZSNMP START PROFILE ZSNMP START TRAPDEST Command Use the START TRAPDEST command to activate the sending of traps to a defined trap destination agent process trapdest name identifies the trap destination definition to activate agent process identifies the NonStop agent process to which the TRAPDEST object belongs It consists of a dollar sign followed by one to five alphanume...

Page 196: ...NDPOINT command to display the operational state of a request response connection agent process endpoint name identifies the request response connection whose operational state you want to display agent process identifies the NonStop agent process to which the ENDPOINT object belongs It consists of a dollar sign followed by one to five alphanumeric characters the first of which must be alphabetic ...

Page 197: ...ZSNMP SNMP Status ENDPOINT Name State ZSNMP DEFAULT STOPPED ZSNMP END1 STARTED STATUS PROCESS Command Use the STATUS PROCESS command to display the operational states of the objects defined for a NonStop agent configuration The display returned by the STATUS PROCESS command also indicates whether the NonStop agent process is being traced and the name of the trace file agent process identifies the ...

Page 198: ... for all objects defined for NonStop agent process ZSNMP 12 STATUS PROCESS ZSNMP SUB ALL SNMP Status PROCESS ZSNMP Name Status Trace Trace file ZSNMP STARTED OFF N A SNMP Status PROFILE Name State ZSNMP DEFAULT STARTED SNMP Status ENDPOINT Name State ZSNMP DEFAULT STOPPED ZSNMP END1 STARTED SNMP Status TRAPDEST Name State ZSNMP REMOTE DEFINED ZSNMP TRAP0 STARTED ZSNMP TRAP1 STOPPED STATUS PROFILE ...

Page 199: ...try A returned state of STARTED means the entry is part of the current authentication scheme Example STATUS PROFILE The following example displays the operational state of the authentication table entries defined for NonStop agent process ZSNMP 12 STATUS PROFILE ZSNMP SNMP Status PROFILE Name State ZSNMP DEFAULT STARTED STATUS TRAPDEST Command Use the STATUS TRAPDEST command to display the operati...

Page 200: ...e or while the TRAPDEST object was in the STARTED state one of the following conditions occurred The configured TCP IP process is not available None of the subnets associated with the configured TCP IP process are available The SCP process is not available Every time the NonStop agent generates a trap or receives a trap to be forwarded from a subagent it attempts to reconnect If the reconnection i...

Page 201: ...NDPOINT When you STOP an ENDPOINT object only you affect the availability of the TCP IP subnets for handling communication between the NonStop agent and managers The TCP IP process and subnets are still available for handling communication between other entities If the NonStop agent is processing an SNMP request when a STOP command is issued the STOP command waits until processing is finished At t...

Page 202: ... Example STOP PROFILE The following example inactivates an entry in the authentication table used by NonStop agent process ZSNMP STOP PROFILE ZSNMP LANMGR STOP TRAPDEST Command Use the STOP TRAPDEST command to disable the sending of trap messages to a specific trap destination agent process trapdest name identifies the trap destination being inactivated agent process identifies the NonStop agent p...

Page 203: ...sensitive command PROCESS agent process identifies the NonStop agent process to be traced It consists of a dollar sign followed by one to five alphanumeric characters the first of which must be alphabetic STOP ends the current trace operation COUNT count specifies the number of trace records to be captured count is an integer in the range 1 through 32767 If you omit this option or set it to 1 reco...

Page 204: ...e trace operation are to be placed This option is required when you are starting a trace operation If the file already exists it is purged of data before the trace is initiated If the file does not exist it is created with an extent size based on the value of the PAGES parameter If TO is not specified the existing trace is either stopped if STOP is specified or modified as specified in the trace o...

Page 205: ...racing stops when the backup takes over The only way to enable tracing in the backup is to include the TRACE startup parameter when you start the NonStop agent process On a takeover the backup begins tracing its reinitialization storing a complete set of records for all objects The NonStop agent supports the PTrace utility described in Section 6 SNMP Agent PTrace Facility Examples TRACE The follow...

Page 206: ... specifies that complete version information be returned If it is omitted only one line of version information is displayed Examples VERSION The following example shows the display for the VERSION command VERSION PROCESS ZSNMP VERSION PROCESS EAST ZSNMP SNMP Agent T9576D23 17JAN96 With the DETAIL option the display looks like this VERSION PROCESS ZSNMP DETAIL Detailed VERSION PROCESS EAST ZSNMP SY...

Page 207: ...on and Management Manual 424777 006 Part III Troubleshooting Part IV consists of the following sections which provide diagnostic information Section 6 SNMP Agent PTrace Facility Section 7 Troubleshooting the SNMP Agent ...

Page 208: ...Part III Troubleshooting SNMP Configuration and Management Manual 424777 006 ...

Page 209: ...tion is recorded in its trace files This information varies as to the type of events that are recorded the amount of detail included and other subsystem specific parameters You can generate a NonStop agent trace file interactively or programmatically as follows To start a trace and capture data interactively use the SCF TRACE command To start a trace and capture data programmatically use a managem...

Page 210: ...llect the trace data while you perform operations related to the problem that you are analyzing 3 Stop the trace by issuing another SCF TRACE command The following command stops the trace for the NonStop agent process ZSNMP TRACE PROCESS ZSNMP STOP 4 Display the trace file with the PTrace utility Run PTrace from TACL to display the traces in the file named TRACE PTRACE FROM DATA SNMP TRACE For add...

Page 211: ... returns a command interpreter prompt after sending the startup message to PTrace If you omit this option TACL or SCF pauses while PTrace runs OUT file name designates the initial destination for PTrace display output for the session You can use this formatted file for your problem diagnosis If you omit the OUT option the output destination defaults to the output file of the TACL or SCF process th...

Page 212: ... Interactive PTrace Session To start PTrace interactively enter PTRACE at the TACL or SCF prompt PTrace displays its product banner followed by its prompt the question mark When you are finished using PTrace enter the EXIT command to return to TACL or SCF Device Type When a trace file is created the type of the device being traced is recorded in that file When PTrace opens the trace file it uses t...

Page 213: ...ds available to all subsystems refer to the PTrace Reference Manual Table 6 1 describes the SELECT command PTrace Commands Not Supported by the NonStop Agent The following subsystem dependent PTrace commands are not supported by the NonStop agent Subset of Useful NonStop Agent PTrace Commands Table 6 1 lists and describes a subset of PTrace commands that are particularly useful when formatting Non...

Page 214: ...ical disk pack mounted on a disk unit For example DATA5 subvolume name identifies a related set of files defined by the user For example SNMT101 file id identifies a particular file within the subvolume For example ZZSMPTRP For convenience default values are provided for all parts except file id The initial default values are the values provided by the TACL or SCF process through which you invoked...

Page 215: ...lled ZZSMPTRP in the subvolume SNMT101 in the current system and volume resets session parameters to their defaults and displays the trace file header record FROM snmt101 zzsmptrp Trace of NOVA ZSNMP Type 31 30 Ptrace Data File DATA5 SNMT101 ZZSMPTRP Trace started 11 19 97 11 27 50 33 First trace entry 11 19 97 11 27 50 63 Last trace entry 11 19 97 11 27 53 76 Trace file is in extended format Trac...

Page 216: ...pressed as discussed in the following subsection determines the number of records sent to the output Considerations PTrace NEXT Command Pressing the BREAK key terminates the NEXT command search or display The function keys on an HP 6530 terminal can be used as shorthand for various NEXT count commands For example pressing the F6 function key displays six records Examples PTrace NEXT Command 1 The ...

Page 217: ...RECORD command displays records selected by record number You can display records individually in a range or ALL The RECORD command never displays more than the number of records specified by the LIMIT command first is an integer that specifies the record number of the first or only record to be displayed last is an integer that specifies the record number of the last record in a range of records ...

Page 218: ...P Trace started 11 19 97 11 27 50 33 First trace entry 11 19 97 11 27 50 63 Last trace entry 11 19 97 11 27 53 76 Trace file is in extended format Trace entry size limit 0 11 27 50 630 000 000 1 Common kernel 11 27 50 760 000 130 2 Method 11 27 50 760 000 000 3 Method 11 27 50 760 000 000 4 Method SELECT Command The SELECT command establishes the selection criteria that control which trace records...

Page 219: ...nd is not entered or if the SELECT command is specified with no keywords ALL is assumed Examples PTrace SELECT Command 1 The following command sequence positions the record pointer at record 1 and changes the detail to off to display header information only RECORD 0 Trace of NOVA ZSNMP Type 31 30 Ptrace Data File DATA5 SNMT101 ZZSMPTRP Trace started 11 19 97 11 27 50 33 First trace entry 11 19 97 ...

Page 220: ...itten by the Common Kernel and displays the next two records SELECT COMMON Ptrace Select Key 254 NEXT 2 End of Trace file 4 This example positions the record pointer at record 1 and displays the next three records RECORD 0 Trace of NOVA ZSNMP Type 31 30 Ptrace Data File DATA5 SNMT101 ZZSMPTRP Trace started 11 19 97 11 27 50 33 First trace entry 11 19 97 11 27 50 63 Last trace entry 11 19 97 11 27 ...

Page 221: ...ame apparent The guidelines provided in this section should help you If you suspect the trouble is in one of the underlying network resources being used by the SNMP agent start with the TCP IP Configuration and Management Manual for troubleshooting guidelines for the TCP IP subsystem For systems running on a G series or H series RVU of the NonStop Kernel if you suspect the trouble is in the Server...

Page 222: ...P Get request indicates that a zagInEpState object is stopped 5 you can set the zagInEpStatus object to active 1 through SNMP If the object remains in the STARTING state at least one of the following conditions is true The configured TCP IP process is not available The SCP process is not available The specified subnet is not available The SNMP agent periodically tries to access the resource As soo...

Page 223: ...he EMS trap subagents These subagents documented in Section 9 EMS Trap Subagent let you view EMS events as traps on an SNMP manager station This subsection provides an example showing how to create and use a filter that selects messages generated by the SNMP agent and TCP IP subsystem Section 3 MIBs Supported by the SNMP Agent describes event messages generated by the SNMP agent For more informati...

Page 224: ... are secured so that you can access them it is easy to run a printing distributor The simplest case is to run a printing distributor to your terminal by entering a TACL command such as the following EMSDIST NAME DIST1 TYPE PRINTING COLLECTOR 0 TEXTOUT TERM1 FILTER SYSTEM MYFLTRS SNMPF This command starts distributor process DIST1 which sends all messages received after startup to terminal TERM1 if...

Page 225: ...ent process Alter trace parameters set by a previous TRACE command Stop a previously requested trace operation The complete syntax of the SCF TRACE command is in the TRACE Command on page 5 35 The following command starts a trace operation on the agent process writes results into the file named DATA1 TRC TRACE and allows the trace data to be overwritten when the EOF is reached TRACE PROCESS ZSNMP ...

Page 226: ...a normal response The SNMP agent usually increments one of the counters in its SNMP group In most cases the SNMP agent also assigns a value to the Error Status field of a GetResponse PDU or generates a trap Table 7 1 Handling Requests That Cannot Be Processed page 1 of 3 Error Condition SNMP Group Counter Incremented Error Status Value Assigned Message Handling The results of an operation cannot f...

Page 227: ...ned READONLY access snmpInBadCommunityUses SNMP agent stops processing the request and generates an authenticationFailur e trap The SNMP agent receives a SetRequest PDU for a MIB object assigned read only access snmpOutNoSuchNames noSuchName SNMP agent stops processing the request The SNMP agent receives a SetRequest for a MIB object that has been assigned read write access but is not in the Syste...

Page 228: ...request Any other condition that does not produce a normal response such as certain errors returned in the SPI interface snmpOutGenErrs genErr SNMP agent stops processing the request The SNMP agent receives no response from a subagent noSuchName SNMP agent stops processing the request Table 7 1 Handling Requests That Cannot Be Processed page 3 of 3 Error Condition SNMP Group Counter Incremented Er...

Page 229: ...the following sections which describe the SNMP subagents Section 8 TCP IP Subagent Section 9 EMS Trap Subagent Section 10 NonStop NET MASTER Trap Subagent Section11 Host Resources Subagent Section12 Trap Multiplexer Subagent Manager Section13 IPX SPX Subagent G Series Section14 Ethernet Subagent ...

Page 230: ...Part IV SNMP Subagents SNMP Configuration and Management Manual 424777 006 ...

Page 231: ... SNMP agent the TCP IP Subagent and the managed TCP IP resources is illustrated in Figure 8 1 Architectural Overview of the TCP IP Subagent on page 8 2 The SNMP agent receives and authenticates SNMP request messages regarding HP TCP IP resources and forwards authenticated requests to the TCP IP Subagent with which it is communicating The TCP IP Subagent translates the request retrieves the request...

Page 232: ...P subsystem TCP IP Subagent Scenarios on page 8 3 illustrates valid and invalid configuration scenarios to keep in mind when planning for your TCP IP Subagent configuration An X indicates an invalid configuration Figure 8 1 Architectural Overview of the TCP IP Subagent For G series using the SLSA SRL ZLANMSRL For H series using SLDA DLL ZLANMDLL TCP IP Subagent SCP ZNET SLSA Manager ZZLAN ZLMnn SN...

Page 233: ...tem TCP IP Subsystem x TCP IP Subagent SNMP Agent NonStop Servers LAN LAN TCP IP Subagent SNMP Agent TCP IP Subsystem TCP IP Subsystem NonStop Server LAN SNMP Manager NonStop Servers SNMP Manager TCP IP Subagent SNMP Agent TCP IP Subsystem NonStop Server LAN SNMP Manager TCP IP Subsystem SNMP Manager TCP IP Subagent SNMP Agent TCP IP Subsystem x NonStop Servers LAN SNMP Manager VST995 vsd ...

Page 234: ...P agent TCP IP Subagent pair for each TCP IP subsystem you want to monitor The TCP IP Subagent does not have to reside on the same node as the SNMP agent with which it is communicating but the TCP IP resources being managed by the TCP IP Subagent must reside on the same node as the TCP IP Subagent You define the SNMP agent with which the TCP IP Subagent communicates when you start the subagent By ...

Page 235: ...e TCP IPv6 environment Standard MIB II Groups Supported by the TCP IP Subagent The TCP IP Subagent supports the following MIB II groups defined in RFC 1213 These groups a subset of the MIB II groups are identified by a check mark in the following list iso 1 identified organization 3 dod 6 internet 1 mgmt 2 mib II 1 system 1 interfaces 2 at 3 ip 4 icmp 5 tcp 6 udp 7 egp 8 cmot 9 transmission 10 snm...

Page 236: ...iguration and Management Manual 424777 006 8 6 Standard MIB II Groups Supported by the TCP IP Subagent The objects in these groups are described in the subsections dedicated to each supported MIB II group later in this section ...

Page 237: ...the TCP IP subsystem being monitored Status of the TCP IP subsystem Name of the subnets associated with the TCP IP subsystem Status of the subnets IP address of the subnets These private MIB objects are defined by HP and reside in the ztsa subtree within the nonstopsystems subtree registered to HP iso 1 identified organization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 ...

Page 238: ...cess becomes unavailable the entire MIB II table is cleared and an SNMP noSuchName error is returned to the SNMP manager in the response to the request The value of the TCP IP Subagent s private ztsaKeepAliveTimer object defines the interval at which the TCP IP Subagent looks for lost resources If the SCP process goes away for example and ztsaKeepAliveTimer is set to 30 the TCP IP Subagent attempt...

Page 239: ...Information Cache Refresh Timer The information cache or info cache timer controls the rate at which the TCP IP Subagent updates values of objects that it retrieves by issuing a SPI INFO command This information is relatively static The info cache timer is initially set with the info startup parameter and can be managed through SNMP by setting the ztsaInfoCache object You can disable the info cach...

Page 240: ... been updated the value of ztsaRefreshNow returns to 0 autoDynamicRefresh and the values in the refresh timer objects ztsaInfoCache ztsaStatusCache and ztsaStatsCache once again determine the rate at which MIB II values are refreshed These objects are described in detail in Table 8 3 Private ZTSA MIB Objects Supported by the TCP IP Subagent on page 8 21 Initiating Backup Process Takeover The TCP I...

Page 241: ...Table 8 14 Compliance With UDP Group Definitions in RFC 1213 Installing the TCP IP Subagent When the TCP IP Subagent runs on NonStop systems these products must also be configured and running SNMP agent EMS TCP IP G00 00 or later for G series systems At least one SNMP manager that can send requests to the SNMP agent for processing by the TCP IP Subagent Installation Steps Run the Install or Distri...

Page 242: ...pAliveTimer object In addition for the TCP IP Subagent to communicate with a HP TCP IP subsystem the SCP process ZNET or the SCP process specified for the scp startup parameter must be running If the SCP process is not available the TCP IP Subagent enters a loop trying to reconnect to it at the rate specified in its ztsaKeepAliveTimer object Starting the TCP IP Subagent Start the TCP IP Subagent u...

Page 243: ...tions HP recommends using at least the NOWAIT option so that you can resume TACL operations once the subagent is started displays help information startup parameter is one of the following parameters with which you can control attributes of the TCP IP Subagent process Note Run the TCP IP Subagent process at a priority equal to or less than that of the SCP process with which it is communicating Not...

Page 244: ...NFO derived MIB values are refreshed only when the ztsaRefreshNow object is set to forceDynamicRefresh 1 The default is 180 seconds k keep alive timer specifies the time interval in seconds between attempts by the TCP IP Subagent to reconnect to a TCP IP SNMP agent backup or EMS collector process that is in the disconnected state The default value is 60 s tcpip subsystem1 tcpip subsystemn identifi...

Page 245: ...ng that SPI STATISTICS derived MIB values are only refreshed when the ztsaRefreshNow object is set to forceDynamicRefresh 1 The default is 60 seconds status status cache refresh specifies in seconds the rate at which the TCP IP Subagent updates values of objects that it retrieves by issuing a SPI STATUS command The range for status cache refresh is 0 to 32000 A value of 0 disables this timer indic...

Page 246: ...gentState Name of subagent process ztsaProcessName Version of subagent process object file ztsaProcessVersion Name of subagent program file ztsaProgramFile Current process priority of subagent process ztsaProcessPriority Group ID under which subagent was started ztsaProcessGroupID User ID under which subagent was started ztsaProcessUserID Processor in which subagent s primary process is running zt...

Page 247: ...lt values or values specified in startup parameters Rate at which SPI INFO based object values are refreshed ztsaInfoCache TCP IP process being monitored ztsaTcpIpProcess State of the connection between subagent and monitored TCP IP process ztsaTcpIpState SCP process used for SPI requests ztsaScpProcess Name of the TCP IP subsystem being monitored ztsaTcpIpName Status of the TCP IP subsystem ztsaT...

Page 248: ...Switching to the backup subagent process ztsaSwitchToBackup Now 0 autoProcessPairControl at startup EMS collector process to which subagent sends events ztsaEmsCollectorName c 0 on the same node as the subagent ztsaEmsCollectorState must be set to disabled 3 before the ztsaEmsCollectorName object can be set State of the connection to the EMS collector ztsaEmsCollectorState None in normal circumsta...

Page 249: ...s TCP IP process being monitored ztsaTcpIpProcess t ZTC0 on the same node as the subagent ztsaTcpIpState must be set to disabled 3 before the ztsaTcpIpProcess object can be set State of the connection to the monitored TCP IP process ztsaTcpIpState None in normal circumstances value is connected Table 8 2 Controlling a TCP IP Subagent Through SNMP page 2 of 2 You can control this attribute of a TCP...

Page 250: ...gentState 2 ztsaProcessName 3 ztsaProcessVersion 4 ztsaProgramFile 5 ztsaProcessPriority 6 ztsaProcessGroupID 7 ztsaProcessUserID 8 ztsaPrimaryCPU 9 ztsaPrimaryPIN 10 ztsaBackupCPU 11 ztsaBackupPIN 12 ztsaBackupState 13 ztsaSwitchtoBackupNow 14 ztsaEmsCollectorName 15 ztsaEmsCollectorState 16 ztsaKeepAliveTimer 17 ztsaRefreshNow 18 ztsaStatsCache 19 ztsaStatusCache 20 ztsaInfoCache 21 ztsaTcpIpPro...

Page 251: ...ess name specified for the TACL NAME option when the TCP IP Subagent was started and the sequence number assigned to the process by the NonStop Kernel ztsaProcessVersion 1 3 6 1 4 1 169 3 202 4 read only DisplayString SIZE 0 255 The version of the TCP IP Subagent process object file T7862Dnn_date HP SNMP TCP IP Subagent where Dnn is the product version of the TCP IP Subagent for example D20 ztsaPr...

Page 252: ...sor in which the backup process will start or is running cpu number specified for the b startup parameter After startup the value can be set by an SNMP manager A value of 1 indicates the backup is not configured Setting this object is permitted only if ztsaBackupState is set to disabled 3 Once ztsaBackupCPU has been set to a new value ztsaBackupState must be set to enabled 4 for the new value to t...

Page 253: ...P Subagent was started using the b startup parameter Setting this object to 1 causes the TCP IP Subagent backup process to take over and a new backup process to be created Setting this object is permitted only if ztsaBackupState is connected 1 ztsaEmsCollectorName 1 3 6 1 4 1 169 3 202 15 read write DisplayString SIZE 0 15 The name of the EMS collector process to which the TCP IP Subagent sends ev...

Page 254: ...e k startup parameter After startup the value can be set by an SNMP manager The default is 60 seconds ztsaRefreshNow 1 3 6 1 4 1 169 3 202 18 read write INTEGER A means of forcing an update of the MIB II tables and generating traps if needed One of these values autoDynamicRefresh 0 forceDynamicRefresh 1 This object normally reads 0 indicating that the MIB values are refreshed at the rates indicate...

Page 255: ...jects derived from STATUS only when ztsaRefreshNow is set to forceDynamicRefresh 1 ztsaInfoCache 1 3 6 1 4 1 169 3 202 21 read write INTEGER 0 32000 The cache update interval in seconds for SPI INFO command based objects A value in the range 0 to 32000 specified for the info startup parameter The default is 180 seconds After startup the value can be set by an SNMP manager Value 0 disables cache ti...

Page 256: ...saTableEntry 1 3 6 1 4 1 169 3 202 26 1 not accessible The entry that contains information related to the TCP IP subsystems Contains the ztsaTcpIpName and ztsaTcpIpStatus fields ztsaTcpIpName 1 3 6 1 4 1 169 3 202 26 1 1 read only DisplayString The TCP IP subsystem name monitored by the TCP IP SA tcpip process specified for the s start up parameter ztsaTcpIpStatus 1 3 6 1 4 1 169 3 202 26 1 2 read...

Page 257: ... One of these values aborting 0 defined 1 diagnosis 2 started 3 starting 4 stopped 5 stopping 6 suspended 7 unknown 8 suspending 9 Contains the status in the ZSUBNET STATE field of the ZTCI MAP STATUS SUBNET structure returned from a SPI STATUS SUBNET command on tcpip subsystem ztsaSubnetAddr 1 3 6 1 4 1 169 3 202 27 1 3 read only IpAddress The IP address of the subnet corresponding to the TCP IP ...

Page 258: ... SNMP Set request generated states used when resource objects are being reconfigured The meanings of each state is as follows Table 8 4 TCP IP Subagent State Object Resource Object Pairs The operational state of this resource object Is indicated or controlled by this state object Which can contain one of the following states ztsaAgentName ztsaAgentState Connected 1 Disconnected 2 ztsaBackupCPU zts...

Page 259: ... Descriptions on page 8 70 An SNMP general error is returned if the TCP IP Subagent receives a Set enabled request against a state object that is in the connected state Modifying the Value of a Resource Object To modify the value of a resource object 1 Set the value of resource object s associated state object to Disabled 2 Set the resource object to a new value 3 Set the value of the resource obj...

Page 260: ...TCP IP subsystem being managed An interface is defined as the association between a TCP IP subnet and the underlying I O process that controls access to the LAN or X25 network The Interfaces group consists of one scalar object and one table the ifTable The objects identified by a check mark in the following list are objects for which there is corresponding HP instrumentation iso 1 identified organ...

Page 261: ...R The number of network interfaces of the TCP IP resources managed or used by the subagent since the subagent was started Corresponds to the number of supported interfaces comprising the ifTable Integer with maximum value 32 767 returned from a SPI INFO command on SUBNET ztsaTcpIpProcess ifTable Objects Entries describing the interfaces of the TCP IP resources being managed Refer to ifTable Mainte...

Page 262: ...nners identify the product name product number release and compilation dates For X 25 interface type only line is returned ifType 1 3 6 1 2 1 2 2 1 3 read only INTEGER The type of interface distinguished according to the physical link protocols immediately below the network layer in the protocol stack The ZTYPE field of the ZTCI DDL INFO SUBNET structure returned from the SPI INFO command on SUBNE...

Page 263: ...urns a corresponding TLAM process name A SPI INFO command on PORT IP of the TLAM process returns ZMAX REQ SIZE value The largest value possible is 32 000 bytes ifType 5 X 25 is not supported in this implementation If ifType is 24 loopback ifMtu is set to 0 to alert the SNMP manager that this value is meaningless for a loopback interface ifSpeed 1 3 6 1 2 1 2 2 1 5 read only Gauge An estimate of th...

Page 264: ...ET ztsaTcpIpProcess returns a corresponding TLAM process name A SPI INFO command on SERVICE 8022 for Ethernet or 8023 for SNAP of the TLAM process returns current attribute values for the L28022 or L18023 services respectively ifOperStatus 1 3 6 1 2 1 2 2 1 8 read only INTEGER The current operational state of the interface The value depends on the contents of the ZSUBNET STATE field of the ZTCI DD...

Page 265: ...delivered to a higher layer protocol LM_Get_Statistics_ on PIF name returns ifInNUcastPkts for SLSA ifInDiscards 1 3 6 1 2 1 2 2 1 13 read only Counter The number of inbound packets that were discarded even though no errors were detected to prevent their being deliverable to a higher layer protocol LM_Get_Statistics on PIF name returns ifInDiscards for SLSA ZAGGR SDUS NOT DELIV field of the ZLAM D...

Page 266: ...the constant 0 is returned ifOutUcastPkts 1 3 6 1 2 1 2 2 1 17 read only Counter The number of packets that a higher level protocol requested to transmit to a subnetwork unicast address including those that were discarded or not sent LM_Get_Statistics_ on PIF name returns ifOutUcastPkts for SLSA ifOutUcastPkts is not supported for the D series TLAM interface the constant 0 is returned ifOutNUcastP...

Page 267: ...number of outbound packets that could not be transmitted because of errors LM_Get_Statistics_ on PIF name returns ifOutErrors for SLSA ZSTATS SUBNET OUT ERRS field of the ZTCI DDL STATS SUBNET structure returned from a SPI STATISTICS command on SUBNET ztsaTcpIpProcess returns ifOutErrors for TLAM ifOutQLen 1 3 6 1 2 1 2 2 1 21 read only Counter The length of the output queue in packets LM_Get_Stat...

Page 268: ...ble 8 5 ifIndex Yes See Table 8 5 ifDescr Yes See Table 8 5 ifType Partial See Table 8 5 ifMtu Partial See Table 8 5 ifSpeed Yes See Table 8 5 ifPhysAddress Partial See Table 8 5 ifAdminStatus Partial Constant value of up 1 ifOperStatus Yes See Table 8 5 ifLastChange Yes See Table 8 5 ifInOctets Partial See Table 8 5 ifInUcastPkts Partial See Table 8 5 ifInNUcastPkts Partial See Table 8 5 ifInDisc...

Page 269: ...s LMPIFAttr LMPIFStatus LMPIFStatistics If the TCP IP Subagent finds a change in the subnet configuration while building the ifTable it also updates the indexes in the ipAddrTable ipRouteTable and ipNetToMediaTable in the IP group The TCP IP Subagent assigns a number to each SUBNET object defined in the HP TCP IP subsystem it is managing That number represents both the index of the ifTable and the...

Page 270: ... list are objects for which there is corresponding HP instrumentation iso 1 identified organization 3 dod 6 internet 1 mgmt 2 mib II 1 ip 4 ipForwarding 1 ipDefaultTTL 2 ipInReceives 3 ipInHdrErrors 4 ipInAddrErrors 5 ipForwDatagrams 6 ipInUnknownProtos 7 ipInDiscards 8 ipInDelivers 9 ipOutRequests 10 ipOutDiscards 11 ipOutNoRoutes 12 ipReasmTimeout 13 ipReasmReqds 14 ipReasmOKs 15 ipReasmFails 16...

Page 271: ...ts in the MIB II IP group that have HP instrumentation Table 8 7 IP Group Objects Supported by TCP IP Subagent page 1 of 8 Object and Attributes Definition Format and Derivation of Value ipForwarding 1 3 6 1 2 1 4 1 read only INTEGER An indication of whether datagrams addressed to other entities are being forwarded by the managed TCP IP subsystem The constant value is 1 forwarding because the HP T...

Page 272: ...pProcess ipInDiscards 1 3 6 1 2 1 4 8 read only Counter The number of input datagrams that were not erroneous but had to be discarded because of a lack of buffer space for example This counter does not include any datagrams discarded while awaiting reassembly The value integer of the ZSTATS IP FRAG DROP field of the ZTCI DDL IP STATS structure returned from a SPI STATISTICS command on PROCESS ztsa...

Page 273: ...route because all of its default gateways are down The value integer of the ZSTATS IP CANT FWD field of the ZTCI DDL IP STATS structure returned from a SPI STATISTICS command on PROCESS ztsaTcpIpProcess ipReasmReqds 1 3 6 1 2 1 4 14 read only Counter The number of IP fragments received that needed to be reassembled The value integer of the ZSTATS IP FRAG field of the ZTCI DDL IP STATS structure re...

Page 274: ...n the ZIP ADDR field of the ZTCI DDL INFO SUBNET structure returned from a SPI INFO command on SUBNET ztsaTcpIpProcess ipAdEntIfIndex 1 3 6 1 2 1 4 20 1 2 read only INTEGER The value uniquely identifying the interface to which this entry is applicable Each interface is also identified by the same value of ifIndex in the Interfaces group An integer value computed by the TCP IP Subagent ipAdEntNetMa...

Page 275: ...aintained ipRouteDest 1 3 6 1 2 1 4 21 1 1 read only IpAddress The destination IP address of this route An entry with a value of 0 0 0 0 is considered a default route Multiple routes to a single destination can appear in the table The IP address contained in the ZDEST IP ADDR field of the ZTCI DDL INFO ROUTE structure returned from a SPI INFO command on SUBNET ztsaTcpIpProcess ipRouteIfIndex 1 3 6...

Page 276: ...cast media the value of this field is the agent s IP address on that interface The IP address contained in the ZGW IP ADDR field of the ZTCI DDL INFO ROUTE structure returned from SPI INFO command on ROUTE ztsaTcpIpProcess ipRouteType 1 3 6 1 2 1 4 21 1 8 read only INTEGER The type of route The value depends on the contents of the ZIF GW field of the ZTCI DDL INFO ROUTE structure returned from a S...

Page 277: ...structure Because setting individual route masks is not supported on the SPI interface the associated subnet mask is used to add new routes ipRouteInfo 1 3 6 1 2 1 4 21 1 13 read only OBJECT IDENTIFIER A reference to MIB definitions specific to the particular routing protocol responsible for this route as determined by the value specified for the route s ipRouteProto object The constant value of t...

Page 278: ...oMediaType 1 3 6 1 2 1 4 22 1 4 read only INTEGER The method used to map physical to IP addresses This object has the constant value of 4 static Table 8 8 Compliance With IP Group Definitions in RFC 1213 page 1 of 3 Object Descriptor Complianc e Explanation ipForwarding Yes Set operation not supported attempt returns noSuchName error See Table 8 7 for description of retrievable information ipDefau...

Page 279: ...sponding HP instrumentation exists 0 is returned ipRouteDest Yes Set operation not supported attempt returns noSuchName error See Table 8 7 for description of retrievable information ipRouteIfIndex Yes Set operation not supported attempt returns noSuchName error See Table 8 7 for description of retrievable information ipRouteMetric1 through ipRouteMetric5 Yes Set operation not supported attempt re...

Page 280: ...ly through SCF or programmatically through SPI The TCP IP Subagent uses this configuration information to derive table entries The TCP IP Subagent builds entries by sending an INFO SPI command to the ROUTE object It then maps the values found in the ZTCI DDL INFO ROUTE token into the appropriate MIB objects ipRouteMask Yes Set operation not supported attempt returns noSuchName error See Table 8 7 ...

Page 281: ...t finds a change in the subnet configuration while building the ipNetToMediaTable it also updates the indexes in the ifTable and the ipAddrTable When the TCP IP Subagent finds that a SUBNET object has been deleted or added it removes or adds the corresponding ipNetToMediaTable entry ICMP Group The ICMP group contains information about the Internet Control Message Protocol ICMP layer of the TCP IP ...

Page 282: ...by icmpErrors The sum of all ICMP message counters in the ZSTATS ICMP IN HIST array plus the sum of the values in the following fields of the ZTCI DDL ICMP STATS structure returned from a SPI STATISTICS command on PROCESS ztsaTcpIpProcess ZSTATS ICMP BADCODE ZSTATS ICMP TOO SHORT ZSTATS ICMP XSUM ZSTATS ICMP BAD LEN icmpInErrors 1 3 6 1 2 1 5 2 read only Counter The number of ICMP messages receive...

Page 283: ...sages received Offset 10 in the ZSTATS ICMP IN HIST array in the ZTCI DDL ICMP STATS structure icmpInEchoReps 1 3 6 1 2 1 5 9 read only Counter The number of ICMP echo reply messages received Offset 2 in the ZSTATS ICMP IN HIST array in the ZTCI DDL ICMP STATS structure icmpInTimestamps 1 3 6 1 2 1 5 10 read only Counter The number of ICMP timestamp request messages received Offset 15 in the ZSTAT...

Page 284: ... 1 2 1 5 17 read only Counter The number of ICMP time exceeded messages sent Offset 11 in the ZSTATS ICMP OUT HIST array in the ZTCI DDL ICMP STATS structure icmpOutParmProbs 1 3 6 1 2 1 5 18 read only Counter The number of ICMP parameter problem messages sent Offset 12 in the ZSTATS ICMP OUT HIST array in the ZTCI DDL ICMP STATS structure icmpOutSrcQuenchs 1 3 6 1 2 1 5 19 read only Counter The n...

Page 285: ...DDL ICMP STATS structure Table 8 10 Compliance With ICMP Group Definitions in RFC 1213 page 1 of 2 Object Descriptor Complianc e Explanation icmpInMsgs Yes See Table 8 9 icmpInErrors Yes See Table 8 9 icmpInDestUnreachs Yes See Table 8 9 icmpInTimeExcds Yes See Table 8 9 icmpInParmProbs Yes See Table 8 9 icmpInSrcQuenchs Yes See Table 8 9 icmpInRedirects Yes See Table 8 9 icmpInEchos Yes See Table...

Page 286: ...gorithm 1 tcpRtoMin 2 tcpRtoMax 3 tcpMaxConn 4 tcpActiveOpens 5 tcpPassiveOpens 6 tcpAttemptFails 7 tcpEstabResets 8 tcpCurrEstab 9 tcpInSegs 10 tcpOutSegs 11 icmpOutTimeExcds Yes See Table 8 9 icmpOutParmProbs Yes See Table 8 9 icmpOutSrcQuenchs Yes See Table 8 9 icmpOutRedirects Yes See Table 8 9 icmpOutEchos Yes See Table 8 9 icmpOutEchoReps Yes See Table 8 9 icmpOutTimestamps Yes See Table 8 9...

Page 287: ...ission timeout The constant value for this object is 1000 milliseconds tcpRtoMax 1 3 6 1 2 1 6 3 read only INTEGER The maximum value permitted for a retransmission timeout The constant value for this object is 30000 milliseconds tcpMaxConn 1 3 6 1 2 1 6 4 read only INTEGER The limit on the total number of TCP connections that can be supported The constant value for this object is 1 maximum number ...

Page 288: ...rom a SPI STATISTICS command on PROCESS ztsaTcpIpProcess tcpOutSegs 1 3 6 1 2 1 6 11 read only Counter The total number of segments sent including those on current connections but excluding those containing only retransmitted octets ZSTATS TCP OUT PKTS field of the ZTCI DDL TCP STATS structure returned from a SPI STATISTICS command on PROCESS ztsaTcpIpProcess tcpRetransSegs 1 3 6 1 2 1 6 12 read o...

Page 289: ... CLOSING 10 timeWait TIME WAIT tcpConnLocalAddress 1 3 6 1 2 1 6 13 1 2 read only IpAddress The local IP address for the TCP connection ZNET STATUS LOC ADDR field of the ZTCI DDL STATUS PROTO structure returned from a SPI STATUS command on PROCESS ztsaTcpIpProcess For a connection in the LISTEN state that is willing to accept connections for any IP interface associated with the node the value is 0...

Page 290: ...ved in error The sum of the values in the following fields of the ZTCI DDL TCP STATS structure returned from a SPI STATISTICS command on PROCESS ztsaTcpIpProcess ZSTATS TCP BAD OFF ZSTATS TCP BAD SEGS ZSTATS TCP BAD XSUM ZSTATS TCP BAD HDR LEN Table 8 12 Compliance With TCP Group Definitions in RFC 1213 page 1 of 2 Object Descriptor Complianc e Explanation tcpRtoAlgorithm Yes See Table 8 11 tcpRto...

Page 291: ...roup The UDP group contains information about the User Datagram Protocol UDP The UDP group consists of a collection of scalar objects and one table udpTable The objects identified by a check mark in the following list are objects for which there is corresponding HP TCP IP subsystem instrumentation iso 1 identified organization 3 dod 6 internet 1 mgmt 2 mib II 1 udp 7 udpInDatagrams 1 udpNoPorts 2 ...

Page 292: ...S UDP IN PKTS field of the ZTCI DDL UDP STATS structure returned from a SPI STATISTICS command on PROCESS ztsaTcpIpProcess udpInErrors 1 3 6 1 2 1 7 3 read only Counter The number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port The sum of the values in the following fields of the ZTCI DDL UDP STATS structure returned f...

Page 293: ...ad only IpAddress The local IP address for the UDP listener The IP address contained in the ZNET STATUS LOC ADDR field of the ZTCI DDL STATUS PROTO structure returned from a SPI STATUS command on PROCESS ztsaTcpIpProcess In the case of a UDP listener that is willing to accept datagrams for any IP interface associated with the node the value is 0 0 0 0 udpLocalPort 1 3 6 1 2 1 7 5 1 2 read only INT...

Page 294: ...StatusCache object Whenever the status of a subnet changes the TCP IP Subagent sends a trap The TCP IP Subagent sends traps only to broadcast type trap destinations Table 8 15 describes traps the TCP IP Subagent generates The traps are a subset of the generic SNMP traps prescribed in RFC 1157 EMS Support This subsection describes the Event Management Service EMS events listed in Table 8 16 generat...

Page 295: ...onnected state 1004 AGENT OBJ UNAVAIL Object Unavailable The interface to the SNMP agent configured for SNMP messaging has transitioned into the disconnected state 1005 BACKUP OBJ AVAIL Object Available The backup process has transitioned into the connected state 1006 BACKUP OBJ UNAVAIL Object Unavailable The backup process has transitioned into the disconnected state 1007 EMSCOLL AVAIL Object Ava...

Page 296: ... configuration is invalid The subagent process abends after sending this event 1014 TAKEOVER BY BACKUP Transient Fault The TCP IP Subagent primary process has stopped and the backup process is taking over the primary role 1015 LANMON OBJ UNAVAIL Transient Fault The LANMON process did not respond to the LM_Get_Version_ function The ifDescr values will not contain the version string 1022 PIFGETSTATU...

Page 297: ...d an error The ifTable values derived through the INFO command are not current until the timer expires the same ZLANMSRL function is retried and a response obtained 1039 LIFGETATTR ERROR Transient Fault The LM_Get_Attributes_ function returned an error The ifTable values are not current until the timer expires the same ZLANMSRL function is retried and a response obtained 1041 PIFGETSTATS ERROR Tra...

Page 298: ... 02 z owner TYPE ZSPI DDL CHAR8 REDEFINES z filler 02 z number TYPE ZSPI DDL INT VALUE IS ZTSA VAL NUMBER 02 z version TYPE ZSPI DDL UINT VALUE IS ZTSA VAL VERSION END Table 8 17 ZTSA Tokens in ZTSA Event Messages Token Contents ZTSA TKN SUBAGENT Identifies the subject of the event as being the TCP IP Subagent process ZTSA TKN AGENT Identifies the subject of the event as being the interface betwee...

Page 299: ...er ZEMS TKN SUBJECT MARK Event subject marker ZEMS TKN SUPPRESS DISPLAY Display do not display event flag ZEMS TKN CHANGE REASON Reason for object state change ZEMS TKN STATE CURRENT Current object state private enumerations ZTSA VAL STATE CONNECTED ZTSA VAL STATE DISCONNECTED ZTSA VAL STATE ENABLED ZTSA VAL STATE DISABLED ZEMS TKN STATE PREVIOUS Previous object state private enumerations ZTSA VAL...

Page 300: ...e specification of the message examine the message template source file STSATMPL The message templates for standard formatted messages are defined in the EMS Manual Descriptions of listed tokens or values The cause of the event the conditions that prompted the TCP IP Subagent to generate the event message The effects associated with or resulting from the cause Recovery procedures you can follow to...

Page 301: ...reason ZTSA VAL STATE DISCONNECTED indicates the previous state of the TCP IP Subagent process The DDL AS clause of this value disconnected appears in the message text following previous state indicating that the subagent was in a nonoperational state ZTSA VAL STATE CONNECTED indicates the new state of the TCP IP Subagent process The DDL AS clause of this value connected appears in the message tex...

Page 302: ...TcpIpProcess object Recovery Informational message only no corrective action is needed Sample Message 96 02 08 12 21 51 NOVA ZTSA TANDEM TCPIPSA D20 001001 Object available TCP IP SNMP subagent NOVA ZTSA 384314581 event number subagent process available reason underlying serv up previous state disconnected current state connected user content undefined 1002 ZTSA EVT SUBAGENT UNAVAIL The TCP IP Sub...

Page 303: ... the message text following cause ZTSA VAL STATE state indicates the previous state of the TCP IP Subagent process The DDL AS clause associated with this value is inserted in the message text following previous state Message Text Object unavailable 1 2 event number 3 cause 4 previous state 5 current state 6 underlying object 9 symptom string 7 user content 8 Value of ZEMS TKN CHANGE REASON Associa...

Page 304: ... defined event Because the TCP IP Subagent process has not defined this as a private event the DDL AS clause undefined always appears in the message text following user content Cause The TCP IP Subagent process terminated for reasons other than an internal fault or invalid startup configuration Effect The TCP IP Subagent process is unavailable Recovery Contact your HP service provider and provide ...

Page 305: ... UNDERLYING UP indicates the reason the SNMP agent process has become available The DDL AS clause associated with this value underlying serv up is inserted in the message text following reason indicating that the interface with the SNMP agent process is available because an underlying resource upon which it depends has become available Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN AGENT ZEMS...

Page 306: ...pears in the message text following user content Cause The TCP IP Subagent reacquired its connection to the configured SNMP agent process Effect Requests can now be made against the MIB II and private MIB objects supported by the TCP IP Subagent Recovery Informational message only no corrective action is needed Sample Message 96 02 08 12 21 51 NOVA ZTSA TANDEM TCPIPSA D20 001003 Object available a...

Page 307: ... the reason the SNMP agent process has become unavailable The DDL AS clause underlying serv failed is inserted in the message text following cause indicating that an underlying service the SNMP agent depends on has failed Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN AGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN UNDERLYING OBJ NAME ...

Page 308: ...ation internal context text indicates where in the subsystem or application code the fault occurred ZEMS VAL NULL indicates the type of subsystem defined event Because the TCP IP Subagent process has not defined this as a private event the DDL AS clause undefined always appears in the message text following user content Cause The TCP IP Subagent lost its connection to the configured SNMP agent pro...

Page 309: ...of this token backup process is inserted in the message text following Object available ztsaProcessName is the TCP IP Subagent process name specified for the TCP IP Subagent s private ztsaProcessName MIB object ZTSA EVT BACKUP OBJ AVAIL is the event number 1005 The DDL AS clause of this value backup process available appears in the message text following event number Unconditional Tokens ZEMS TKN ...

Page 310: ...ning ZEMS VAL UNDERLYING UP underlying serv up indicates that the backup TCP IP Subagent process is available because an underlying resource on which it depends has become available ZEMS VAL OPERATOR INITIATED operator initiated indicates that an operator has brought the backup TCP IP Subagent process up by setting the ztsaBackupState MIB object to enabled Value of ZEMS TKN STATE PREVIOUS Associat...

Page 311: ... backup In case of a primary failure the backup resumes subagent processing using the last successfully checkpointed configuration Recovery Informational message only no corrective action is needed Sample Messages 96 02 08 11 31 36 NOVA ZTSA TANDEM TCPIPSA D20 001005 Object available backup process NOVA ZTSA 383996885 event number backup process available reason underlying serv up previous state d...

Page 312: ...The DDL AS clause of this value backup process unavailable appears in the message text following event number Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN BACKUP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYMPTOM STRING ZEMS TKN USER CONTENT Value 1 ZTSA TKN BACKUP 2 ztsaProcessName 3 ZTSA EVT BACKUP OBJ UNAVAIL 4 ZEMS VAL reason 5 ZT...

Page 313: ...ess specified for the subagent s private ztsaProcessName MIB object is inserted in the message text following underlying object Value of ZEMS TKN CHANGE REASON Associated Text DDL AS Clause and Meaning ZEMS VAL UNDERLYING FAILED underlying serv failed indicates that an underlying service the backup TCP IP Subagent process depends on has failed ZEMS VAL OPERATOR INITIATED operator initiated indicat...

Page 314: ...ry process failure occurs Recovery Check the status of the configured backup processor ztsaBackupCPU If it is not available or there are insufficient resources to run a backup process disable the backup set ztsaBackupState Disabled 3 set the ztsaBackupCPU to an available processor and reenable the backup set ztsaBackupState Enabled 4 Sample Message 96 02 08 10 54 34 NOVA ZTSA TANDEM TCPIPSA D20 00...

Page 315: ... DDL AS clause associated with this value is inserted in the message text following reason Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN EMSCOLLECTOR ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN USER CONTENT Value 1 ZTSA TKN EMSCOLLECTOR 2 ztsaEmsCollectorName 3 ZTSA EVT EMSCOLL OBJ AVAIL 4 ZEMS VAL reason 5 ZTSA VAL STATE state 6 ZTSA V...

Page 316: ...owing user content Cause The subagent acquired or reacquired its connection to the configured EMS collector process ztsaEmsCollectorName Effect Subsequent EMS events generated by the subagent are sent to ztsaEmsCollectorName Recovery Informational message only no corrective action is needed Value of ZEMS TKN STATE PREVIOUS Associated Text DDL AS Clause ZTSA VAL STATE CONNECTED connected indicates ...

Page 317: ... for the TCP IP Subagent s private ztsaEmsCollectorName MIB object ZTSA EVT EMSCOLL OBJ UNAVAIL is the event number 1008 The DDL AS clause of this value emscollector interface unavailable appears in the message text following event number Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN EMSCOLLECTOR ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS ...

Page 318: ...KN CHANGE REASON Associated Text DDL AS Clause and Meaning ZEMS VAL UNDERLYING FAILED underlying serv failed indicates that an underlying service the interface with the EMS collector process depends on has failed ZEMS VAL OPERATOR INITIATED operator initiated indicates that an operator has taken the EMS collector process out of service Value of ZEMS TKN STATE PREVIOUS Associated Text DDL AS Clause...

Page 319: ...e text following user content Cause The subagent lost its connection to the configured EMS collector process ztsaEmsCollectorName Effect Events generated by the subagent are discarded until the EMS collector interface is returned to a connected state The subagent attempts to reacquire the EMS collector connection whenever the subagent attempts to generate an event message Recovery Check the operat...

Page 320: ...ted with this value is inserted in the message text following reason Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN TCPIP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN USER CONTENT Value 1 ZTSA TKN TCPIP 2 ztsaTcpIpProcess 3 ZTSA EVT TCPIP OBJ AVAIL 4 ZEMS VAL reason 5 ZTSA VAL STATE state 6 ZTSA VAL STATE CONNECTED 7 ZEMS VAL NULL Conditi...

Page 321: ...lues are rebuilt using SPI responses from the TCP IP process ztsaTcpIpProcess When the update sequence is complete as indicated by ztsaRefreshNow value autoDynamicRefresh 0 SNMP requests made against the MIB II objects return current values Recovery Informational message only no corrective action is needed Value of ZEMS TKN STATE PREVIOUS Associated Text DDL AS Clause ZTSA VAL STATE CONNECTED conn...

Page 322: ... TCPIP OBJ UNAVAIL ZTSA TKN TCPIP identifies the subject of the event the TCP IP process The DDL heading of this token tcpip resource is inserted in the message text following Object unavailable Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN TCPIP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYMPTOM STRING ZEMS TKN USER CONTENT Value 1 ZT...

Page 323: ...ined in the preceding table appears in the message text following current state Value of ZEMS TKN CHANGE REASON Associated Text DDL AS Clause and Meaning ZEMS VAL UNDERLYING FAILED underlying serv failed indicates that an underlying service the TCP IP process depends on has failed ZEMS VAL OPERATOR INITIATED operator initiated indicates that an operator has taken the TCP IP process out of service ...

Page 324: ...ocess has not defined this as a private event the DDL AS clause undefined always appears in the message text following user content Cause The TCP IP Subagent process lost its connection to the configured TCP IP process ztsaTcpIpProcess the SCP SPI interface process ztsaScpProcess or the SNMP agent process ztsaAgentName If the underlying object is the SNMP agent process ztsaAgentName the subagent h...

Page 325: ...user content undefined 96 02 08 12 18 39 NOVA ZTSA TANDEM TCPIPSA D20 001010 Object unavailable tcpip resource NOVA ZTC0 event number tcpip resource unavailable cause underlying serv failed previous state connected current state disconnected underlying object NOVA ZSNMP symptom string T7862D20_01JAN96_TCPIPSA user content undefined 1011 ZTSA EVT OUT OF MEMORY ZTSA TKN SUBAGENT identifies the subje...

Page 326: ...ould not be extended to satisfy a memory allocation request Effect The operation that was in progress is aborted This might result in objects transitioning into the disconnected state to be later reconnected The subagent functionality will be impaired as long as the memory shortage continues Recovery Free swap space on the subagent process swap volume or stop and restart the subagent with a differ...

Page 327: ...age text following event number ZEMS VAL INTERNAL FAILED indicates that an internal error was encountered The DDL AS clause associated with this value internal failed is inserted in the message text following cause Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYMPTOM STRING ZEMS TKN ...

Page 328: ...nt the DDL AS clause undefined always appears in the message text following user content Cause The TCP IP Subagent internal consistency checking logic has detected a program logic error Effect The TCP IP Subagent terminates Recovery Contact your service provider and provide all relevant information as follows Descriptions of the problem and accompanying symptoms The saveabend file if generated Det...

Page 329: ...able ztsaProcessName is the TCP IP Subagent process name specified for the TCP IP Subagent s private ztsaProcessName MIB object ZTSA EVT CONFIGURATION INVALID is the event number 1013 The DDL AS clause of this value startup configuration invalid appears in the message text following event number Unconditional Tokens ZEMS TKN SUBJECT MARK ZTSA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASO...

Page 330: ...ge Status cache value bad value out of range Keep alive timer value bad value out of range Backup CPU value bad value out of range SCP process name parameter bad value invalid Non local SCP process name parameter bad value Unrecognized parameter type bad value Incomplete parameter specification bad value missing value Parameter bad value specified multiple times ZEMS VAL NULL indicates the type of...

Page 331: ... the value Primary stopped appears in the message text Cause The subagent primary process terminated The recognized causes are either process termination or primary processor failure Effect The backup process takes over the subagent primary role using the last known configuration parameters Any transactions that were in progress at the time of the primary failure are lost The new primary attempts ...

Page 332: ...of this value lanmon resource unavailable appears in the message text following event number ZTSA VAL TF LANMON identifies the type of transient fault that occurred For this event the DDL heading of the value lanmon not responding appears in the message text following fault type ZEMS VAL NULL indicates the type of subsystem defined event Because the TCP IP Subagent process has not defined this as ...

Page 333: ... related products as well Sample Message 98 04 08 11 31 35 NOVA ZTSA TANDEM TCPIPSA G05 001015 Transient Fault TCP IP SNMP Subagent NOVA ZTSA 3693561 event number lanmon resource unavailable fault type lanmon not responding user content undefined 1022 ZTSA EVT PIFGETSTATUS ERROR ZTSA TKN SUBAGENT identifies the subject of the event the TCP IP Subagent process The DDL heading of this token TCP IP S...

Page 334: ...on returned an error for the PIF Effect The ifTable values obtained through the STATUS command are not current until the timer expires the same ZLANMSRL call is retried and a response obtained Recovery Generally this condition is transient and no corrective action is necessary If the problem persists contact your service provider and provide all relevant information as follows Descriptions of the ...

Page 335: ...e text following event number ZTSA VAL TF PIFGETATTR identifies the type of transient fault that occurred For this event the DDL heading of the value PIF attr cmd not completed appears in the message text following fault type ZEMS VAL NULL indicates the type of subsystem defined event Because the TCP IP Subagent process has not defined this as a private event the DDL AS clause undefined always app...

Page 336: ... and the numbers and versions of all related products as well Sample Message 98 04 08 11 31 35 NOVA ZTSA TANDEM TCPIPSA G05 001023 Transient Fault TCP IP SNMP Subagent NOVA ZTSA 3693561 event number LM_Get_Attributes error on PIF fault type PIF attr cmd not completed user content undefined 1039 ZTSA EVT LIFGETATTR ERROR ZTSA TKN SUBAGENT identifies the subject of the event the TCP IP Subagent proc...

Page 337: ...ttributes_ function returned an error for the LIF Effect The ifTable values are not current until the timer expires the same ZLANMSRL call is retried and a response obtained Recovery Generally this condition is transient and no corrective action is necessary If the problem persists contact your service provider and provide all relevant information as follows Descriptions of the problem and accompa...

Page 338: ... following event number ZTSA VAL TF PIFGETSTATS identifies the type of transient fault that occurred For this event the DDL heading of the value PIF stats cmd not completed appears in the message text following fault type ZEMS VAL NULL indicates the type of subsystem defined event Because the TCP IP Subagent process has not defined this as a private event the DDL AS clause undefined always appears...

Page 339: ...ur local operating procedures require contacting the GCSC supply your system number and the numbers and versions of all related products as well Sample Message 97 04 08 11 31 35 NOVA ZTSA TANDEM TCPIPSA G02 001041 Transient Fault TCP IP SNMP Subagent NOVA ZTSA 3693561 event number lmPIFgetstats error fault type PIF stats cmd not completed user content undefined Converting Events to Traps Any proce...

Page 340: ...TCP IP Subagent SNMP Configuration and Management Manual 424777 006 8 110 Converting Events to Traps ...

Page 341: ...s from log files and route them to specific destinations Different kinds of distributors support different destinations as the figure illustrates Distributors can be configured to use a filter to select events to route Events that need to be read as text can be formatted by using a template A template provides instructions for how information should be displayed Templates can be used by subsystems...

Page 342: ...nts Compaq Subsystems Customer Applications Alternate Collectors Primary Collector 0 Log Files Log File Compatibility Distributor Z0 Filter Filter Filter Template Forwarding Distributor Consumer Distributor Printing Distributor Template Remote Collector Management Application EMS Printer File Terminal Console VST801 vsd ...

Page 343: ...onvention for Defining Traps for Use with the SNMP Figure 9 2 EMS Trap Subagent Components Compaq Subsystems Customer Applications Primary or Alternate Collector Log File SNMP Agent SNMP Manager Station EMS Trap MIB Definition Event Messages SNMP Traps Filter EMS Trap Subagent Template Files ZSMPTMP L ZSMPTMP L ZSMPTMP L ZSMPTMP L EM S VST802 vsd ...

Page 344: ...ng values for the variable bindings of enterprise specific traps Installation Steps Run the Distributed Systems Management Software Configuration Manager DSM SCM to install EMS DSM Template Services and the SNMP agent Refer to the DSM SCM User s Guide for complete software installation information The EMS Trap Subagent is installed automatically when you install EMS Ensure that the EMS file named ...

Page 345: ...S BEGIN IMPORTS enterprises FROM RFC1155 SMI DisplayString OBJECT TYPE FROM RFC 1212 TRAP TYPE FROM RFC 1215 EMS event MIB iso OBJECT IDENTIFIER 1 org OBJECT IDENTIFIER iso 3 dod OBJECT IDENTIFIER org 6 internet OBJECT IDENTIFIER dod 1 directory OBJECT IDENTIFIER internet 1 mgmt OBJECT IDENTIFIER internet 2 experimental OBJECT IDENTIFIER internet 3 private OBJECT IDENTIFIER internet 4 enterprises ...

Page 346: ...tem definitions trapSSID OBJECT TYPE SYNTAX TrapSSIDtype ACCESS not accessible STATUS mandatory DESCRIPTION subsystem ID that generated the EMS event ems 1 trapEventNumber OBJECT TYPE SYNTAX TrapEventNumbertype ACCESS not accessible STATUS mandatory DESCRIPTION Event number of event ems 2 trapContentStandard OBJECT TYPE SYNTAX TrapContentStandardtype ACCESS not accessible STATUS mandatory DESCRIPT...

Page 347: ...estamp is GMT ems 6 trapCritical OBJECT TYPE SYNTAX TrapCriticaltype ACCESS not accessible STATUS mandatory DESCRIPTION zems tkn critical zspi val false then not critical else CRITICAL ems 7 trapText OBJECT TYPE SYNTAX TrapTexttype ACCESS not accessible STATUS mandatory DESCRIPTION The text expansion of the EMS event ems 8 emsMessage TRAP TYPE ENTERPRISE snmpagent VARIABLES trapSSID trapEventNumbe...

Page 348: ... subsystems This example filter also provides as part of the routing destination statement a DEFINE name _SNMP_AGENT to identify the SNMP agent The DEFINE name which circumvents hard coding of an agent process name is resolved at run time as in Starting and Stopping the Subagent on page 9 9 The lines shown in bold type contain the event selection specifications Note See the Operator Messages Manua...

Page 349: ...rsion of the routing distributor filter is in the file identified by object filter The collector from which events are to be taken is identified by collector process If the destination statement in the filter uses a DEFINE name you must resolve the name before starting EMSDIST as follows ADD DEFINE define name FILE agent process TRAP where the qualifier TRAP is required In the following example th...

Page 350: ...ess of the system on which the SNMP agent forwarding the trap is installed generic trap A 16 bit number set to 6 to signify that the trap is enterpriseSpecific specific trap A 16 bit number set to 0 time stamp A 32 bit number indicating how much time has passed since the SNMP agent was last started The subagent inserts 0 and the SNMP agent inserts the value of sysUpTime which is defined in Table 3...

Page 351: ...pass the filter MYFILTER frame push agent process if argument value agent process processname if deviceinfo devicetype subtype agent process 31 30 then output expected the process name of an SNMP agent unframe return if definedelete _snmp_agent add define _snmp_agent file agent process trap emsdist nowait name type printing filter myfilter collector 0 gmt on output EMS event subagent process start...

Page 352: ...calar objects identified by a check mark in the following list iso 1 identified organization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 ems 12 trapSSID 1 trapEventNumber 2 trapContentStandard 3 trapSubject 4 trapProcess 5 trapGenerationtime 6 trapCritical 7 trapText 8 Table 9 1 describes the objects in the EMS Trap MIB ...

Page 353: ... subsystem name or number Refer to the Operator Messages Manual to interpret HP values version identifies the software release version of the subsystem For HP subsystems this value matches the three character release ID in the product release version for example D23 ZSPI TKN SSID token value trapEventNumber 1 3 6 1 4 1 169 3 12 2 not accessible DisplayString SIZE 1 6 An integer that uniquely ident...

Page 354: ...rovide other state change an object needs an operator to change or notice its state attention needed an application cannot continue until an operator takes some action attention completed an action described by an earlier event having the value attention needed has been completed usage threshold the usage level of an object or resource exceeds the configured level unknown returned for any event no...

Page 355: ... process node name process name sequence number For an unnamed process node name cpu pin sequence number node name identifies the system on which the process resides process name is the name assigned at startup time of the form name where name has from one through five characters sequence number is an integer used to distinguish among different instances of a process cpu pin is a process ID consis...

Page 356: ...major subsystem function loss of fault tolerance capability or loss of subsystem integrity One of these enumerated values CRITICAL not critical ZEMS TKN EMPHASIS token value If the value of this token is false 0 the value passed is not critical If the value is non zero the value passed is CRITICAL trapText 1 3 6 1 4 1 169 3 12 8 not accessible DisplayString SIZE 1 1000 Text describing the event AS...

Page 357: ...nship between EMS and NonStop NET MASTER Event messages are sent by subsystems and applications to one or more collectors A collector known as 0 is configured at system generation and this collector is the primary collector Other secondary collectors can be started after system load Each collector writes the events it receives to a log file Distributors read events from log files and route them to...

Page 358: ...rview Figure 10 1 EMS and NonStop NET MASTER Components Filter Consumer Distributor NonStopTM NET MASTER MS LOGPROC MSGPROC OCS Window NCL Procedures Log EMSPROC or RMS Message Handler EMS Alternate Collectors Primary Collector 0 Log Files Log File Compaq Subsystems Customer Applications Activity VST901 vsd ...

Page 359: ...warding to SNMP managers which can interpret the traps after the EMS Trap MIB has been installed RFC Compliance The EMS Trap MIB complies with RFC 1215 A Convention for Defining Traps for Use with the SNMP Installation This subsection describes how to install the NonStop NET MASTER Trap Subagent Dependencies The following products must be configured and running for the NonStop NET MASTER Subagent ...

Page 360: ...he DSM SCM User s Guide or the INSTALL User s Guide for complete software installation information Figure 10 2 NonStop NET MASTER Trap Subagent Components EMS NonStopTM NET MASTER MS EMSPROC or RMS Message Handler NonStopTM NET MASTER Trap Subagent SNMP Traps SNMP Manager Station EMS Trap MIB Definition Alternate Collectors Primary Collector 0 Log Files Log File Filter Event Messages Compaq Subsys...

Page 361: ...SMIBA and shown in Example 10 1 onto any SNMP manager you want to receive traps from the subagent Compile the MIB as described in the documentation provided with your SNMP manager Compiling the MIB allows the SNMP manager to display the names rather than only numeric object identifiers of MIB objects The subagent can then be configured To view an example trap produced by TESTSEND start the SNMP ag...

Page 362: ...DEFINITIONS BEGIN IMPORTS enterprises FROM RFC1155 SMI DisplayString OBJECT TYPE FROM RFC 1212 TRAP TYPE FROM RFC 1215 EMS event MIB iso OBJECT IDENTIFIER 1 org OBJECT IDENTIFIER iso 3 dod OBJECT IDENTIFIER org 6 internet OBJECT IDENTIFIER dod 1 directory OBJECT IDENTIFIER internet 1 mgmt OBJECT IDENTIFIER internet 2 experimental OBJECT IDENTIFIER internet 3 private OBJECT IDENTIFIER internet 4 en...

Page 363: ...1 1000 item definitions trapSSID OBJECT TYPE SYNTAX TrapSSIDtype ACCESS not accessible STATUS mandatory DESCRIPTION subsystem ID that generated the EMS event ems 1 trapEventNumber OBJECT TYPE SYNTAX TrapEventNumbertype ACCESS not accessible STATUS mandatory DESCRIPTION Event number of event ems 2 trapContentStandard OBJECT TYPE SYNTAX TrapContentStandardtype ACCESS not accessible STATUS mandatory ...

Page 364: ...m ss Timestamp is GMT ems 6 trapCritical OBJECT TYPE SYNTAX TrapCriticaltype ACCESS not accessible STATUS mandatory DESCRIPTION zems tkn critical zspi val false then not critical else CRITICAL ems 7 trapText OBJECT TYPE SYNTAX TrapTexttype ACCESS not accessible STATUS mandatory DESCRIPTION The text expansion of the EMS event ems 8 emsMessage TRAP TYPE ENTERPRISE snmpagent VARIABLES trapSSID trapEv...

Page 365: ... differs from the one defined by the EMS Trap MIB you need to create a MIB definition in ASN 1 and modify GENTRAP to correspond The trap built by GENTRAP contains items corresponding to the objects in the EMS Trap MIB described later in this section Trap object definitions in GENTRAP are shown in bold italic type in Example 10 2 Changing Subagent SNMP Agent Communication Three procedures in NMMTRA...

Page 366: ...s the agent each time it is called To improve efficiency the procedure could open the agent and set a global flag first time it is called then check the flag each time to decide whether to open the agent or not This procedure assumes that the NCL variables for the event exist and are set correctly Do not run this procedure from an environment that does not have the event OCS for example include nn...

Page 367: ... 1 169 3 12 5 generating process trap value 5 ems tandem spi zems_tkn_zems_tkn_proc_desc trap oid 6 1 3 6 1 4 1 169 3 12 6 date time trap value 6 ems tandem spi zems_tkn_gentime YYYY MM DD HH MM SS mmmmmm trap oid 7 1 3 6 1 4 1 169 3 12 7 emphasis token if ems tandem spi zems_tkn_emphasis Y then trap value 7 not critical else trap value 7 CRITICAL trap oid 8 1 3 6 1 4 1 169 3 12 8 event text trap ...

Page 368: ...urns an integer describing the outcome of the function call The sendtrap function is invoked as follows file id is the file identifier you associated with the openagent operation GENTRAP assigns the name myagt generic trap is an integer identifying one of the standard trap types Valid values are 2 linkDown 3 linkUp 4 authenticationFailure 5 egpNeighborLoss 6 enterpriseSpecific GENTRAP passes the v...

Page 369: ...e function call GENTRAP uses a variable named err to hold this value The closeagent return codes their meanings and the actions taken by GENTRAP when they occur are described in Messages on page 10 18 Trap Connections Traps from the NonStop NET MASTER Trap Subagent are routed to SNMP managers identified in the SNMP agent s TRAPDEST objects Refer to Configuring Trap Destinations on page 2 38 for mo...

Page 370: ... 8 Table 10 1 describes the objects in the EMS Trap MIB enterprise The object identifier for the SNMP agent indicating the origin of the trap 1 3 6 1 4 1 169 3 155 1 agent address The Internet address of the system on which the SNMP agent forwarding the trap is installed generic trap A 16 bit number set to 6 to signify that the trap is enterpriseSpecific specific trap A 16 bit number set to 0 time...

Page 371: ...ization providing the software that generated the trap For HP subsystems the owner value is TANDEM ss is the subsystem name or number Refer to the Operator Messages Manua to interpret HP values version identifies the software release version of the subsystem For HP subsystems this value matches the three character release ID in the product release version for example D31 ZSPI TKN SSID token value ...

Page 372: ...o provide other state change An object needs an operator to change or notice its state attention needed An application cannot continue until an operator takes some action attention completed An action described by an earlier event having the value attention needed has been completed usage threshold The usage level of an object or resource exceeds the configured level unknown Returned for any event...

Page 373: ...a named process node name process name sequence number For an unnamed process node name cpu pin sequence number node name identifies the system on which the process resides process name is the name assigned at startup time of the form name where name has from one through five characters sequence number is an integer used to distinguish among different instances of a process cpu pin is a process ID...

Page 374: ...erated values CRITICAL not critical ZEMS TKN EMPHASIS token value If the value of this token is false 0 the value passed is not critical If the value is non zero the value passed is CRITICAL trapText 1 3 6 1 4 1 169 3 12 8 not accessible DisplayString SIZE 1 1000 Text describing the event ASCII text EMSTEXT procedure call Table 10 2 openagent Return Codes and GENTRAP Actions Return Code Meaning GE...

Page 375: ...ons GENTRAP takes when sendtrap fails The format of the message is as follows return code has the value 1 through 3 as described in Table 10 3 Table 10 3 sendtrap Return Codes and GENTRAP Actions Return Code Meaning GENTRAP Actions 0 The function completed successfully Processing continues 1 The OID count is less than 0 Processing continues after a message is displayed at an OCS window 2 The total...

Page 376: ...he format of the message is as follows return code has the value 1 as described in Table 10 4 sys file rc value contains an integer if the FILE CLOSE verb in the closeagent function failed 16 UBD closed sys file error value is the Guardian error number corresponding to the value of sys file rc sysmsg is a text message Table 10 4 closeagent Return Codes and GENTRAP Actions Return Code Meaning GENTR...

Page 377: ...port proactive hardware management Other additional groups defined by HP support management of the subagent and control over the objects it maintains in its MIB The Host Resources Subagent can be configured to monitor both NonStop Kernel Guardian and Open System Services OSS personalities The remainder of this subsection provides more information about the features of the Host Resources Subagent S...

Page 378: ...or these MIB groups Figure 11 1 Derivation of Information for RFC 1514 Support hrStorage Group hrDevice Group hrSystem Group hrSWRun Group hrSWRunPerf Group Spooler Procedure SNMP Manager Station Guardian Procedures Host Resources Subagent SNMP Agent Host Resources MIB Source NonStop System Processors File System Disks Tape Drives Spooler Supervisor Printers Network Devices System Processes VST100...

Page 379: ...nsmission 10 snmp 11 host 25 hrSystem 1 hrStorage 2 hrDevice 3 hrSWRun 4 hrSWRunPerf 5 hrSWInstalled 6 The subagent does not support the optional hrSWInstalled group MIB Extensions The Host Resources Subagent s MIB also supports the following groups defined by HP zhrmTableInfo group This group describes the status of and operations performed on objects in the hrStorage and hrDevice groups zhrmThre...

Page 380: ... in a state that may require operator attention zhrmSaProcess group This group provides information on the subagent process This group also lets you change the priority of the subagent process cause the subagent s backup process to take over and a new backup process to be created control which NonStop Kernel personality Guardian or OSS is to be monitored and control whether the subagent maintains ...

Page 381: ...cular device is no longer running A particular disk is demonstrating critically high usage A particular CPU is demonstrating critically high RAM usage Entries maintained in several MIB groups also support proactive management of hardware resources The zhrmThreshold group provides information on device utilization that exceeds a settable threshold The zhrmDevUnavail group provides device statistics...

Page 382: ...every 60 seconds Updates the values of hrSystemDate and hrSystemUpTime in the hrSystem group whenever these objects are accessed by a manager MIB Value Management To minimize the size of the subagent s MIB reduce the overhead of refreshing data and highlight certain critical resources you can Limit entries in the hrSWRun and hrSWRunPerf groups to specific processes Limit entries in the hrDevice gr...

Page 383: ...ue of an object in the zhrmSaProcess group Monitoring the Open System Services OSS File System To start the Host Resources Subagent to an HP NonStop Kernel Open System Services OSS environment use the u startup parameter RUN HMSAX NAME HRMIB NOWAIT u To monitor both Guardian and OSS environments enter RUN HMSAX NAME HRMIB NOWAIT t u If you specifiy neither the u or t startup parameters monitoring ...

Page 384: ...mmer s Guide describes Spooler procedure SPOOLERSTATUS2 which the subagent uses to obtain values for MIB objects that are printers RFC Compliance The Host Resources Subagent supports objects defined in the mandatory groups and two of the optional groups of the Host Resources MIB defined in RFC 1514 hrSystem group hrStorage group hrDevice group hrSWRun group hrSWRunPerf group For details about how ...

Page 385: ...ided The RFC1514 file contains definitions identical to those in RFC 1514 with two exceptions InternationalDisplayString objects and hrPartitionID have been redefined as DisplayString objects so that managers can display their values in a readable format instead of hexadecimal format Additionally the two Boolean objects have been redefined as INTEGER objects with values of TRUE and FALSE displayab...

Page 386: ...ources Subagent Configuration Options page 1 of 3 Subagent Attribute RUN Startup Para meter Settable MIB Object Name Group Name Default Behavior SNMP agent process name a ZSNMP on the same system as the subagent specified at startup Subagent process Priority n zhrmSaPri zhrmSaProcess group Priority is 145 Backup process creation b No backup process Backup process takeover zhrmSwitchToBackupNow zhr...

Page 387: ... a terminal or Spooler destination o No tracing To a disk file l No tracing Trap generation zhrmDevUnTrapEnable zhrmDevUnavail group zhrmThrDiskTrapEnable zhrmThreshold group zhrmThrRAMTrapEnable zhrmThreshold group Traps enabled Thresholds related to trap generation and zhrmThreshold group MIB objects maintained Low threshold i zhrmThrDiskLowValue zhrmThreshold group zhrmThrRAMLowValue zhrmThresh...

Page 388: ...n example of starting the subagent to monitor a NonStop Kernel Guardian environment RUN HMSAX NAME HRMIB NOWAIT The next example starts the subagent monitoring only the OSS personality The Guardian personality is not monitored RUN HMSAX NAME HRMIB NOWAIT u To monitor both Guardian and OSS environments RUN HMSAX NAME HRMIB NOWAIT t u NonStop Kernel personality to be monitored Guardian t zhrmExamine...

Page 389: ...ou can specify from one through five alphanumeric characters but the first character must be alphabetic other run option is any of the TACL RUN command options Refer to the TACL Reference Manual for more information about these options HP recommends using at least the NOWAIT option so that you can resume TACL operations after subagent startup displays help information startup parameter is one of t...

Page 390: ...ckup cpu is not up and running backup process will start on any available cpu If the specified backup cpu is not a valid cpu number then the following EMS event message will be generated and HRSA process will stop Invalid CPU number Program terminated d dynamic object refresh rate specifies in one minute intervals the rate at which the subagent refreshes values describing the status of and statist...

Page 391: ...anager after the subagent is running by setting the value of zhrmDynamRefreshNow in the zhrmRefresh group e initialization file specifies the name of a file that identifies processes and devices whose values you want represented in the subagent s MIB If this startup parameter is not used the subagent looks for a file named HMSAINI in the current volume and subvolume of the user who starts the suba...

Page 392: ...rtup you might want to query the MIB to ensure that values are present for objects you are interested in DeviceTable precedes a list of one or more device name specifications SWRunTable precedes a list of one or more program file name specifications The w startup parameter or a value of swValuesDisabled for zhrmEnableSoftwareGroup in the zhrmSaProcess group overrides specifications in this list ex...

Page 393: ...le scratch not important enough f iffile specifies the name of a network interface file The subagent uses this file to maintain values for MIB objects in the hrNetworkTable If this parameter is not specified the file name IFTBL in the current volume and subvolume of the user who starts the subagent is assumed You create the network interface file initially by using a Subsystem Control Facility SCF...

Page 394: ...bagent creates an entry in a table in its zhrmThreshold group to describe the device The default high value threshold is 90 By default the subagent sends a trap when utilization of a RAM storage area or disk device has reached or exceeds the high threshold After the subagent is started you can separately manage the high value thresholds for RAM and for disk devices by setting the values of zhrmThr...

Page 395: ...ou can change the subagent process priority after the subagent is started by setting the value of zhrmSaPri in the zhrmSaProcess group p spooler process identifies the supervisor process for the Spooler controlling printers whose MIB object values you are interested in Every Spooler installed on your system has a supervisor process If you omit the name the default supervisor process SPLS is presum...

Page 396: ...sed This minimizes SNMP manager timeouts Whenever the values of configuration objects are refreshed the values for MIB objects in the hrSWRun and hrSWRunPerf groups are also refreshed The values of these hardware and software objects can be refreshed on demand from an SNMP manager after the subagent is running by setting the value of the object zhrmStableRefreshNow in the zhrmRefresh group t cause...

Page 397: ...N option RUN HMSAX NAME HMSA OUT S OUT NOWAIT o Spooler information is formatted as a C language compatible file file code 180 which you can convert to an edit file file code 101 or use directly from any utility program If you want a second copy of the log file you can also use the l startup parameter However use of this startup parameter slows subagent processing time because a high volume of tra...

Page 398: ... assigned at SNMP agent startup must not be in use by some other process such as another SNMP agent process Section 2 Installing and Configuring the SNMP Agent provides complete information on agent startup options You can use SCF to determine whether a SNMP agent has been started by checking the status of the agent s ENDPOINT OBJECT as in the following example where the name of the SNMP agent pro...

Page 399: ...US command STATUS ZHMSA DETAIL If the WAIT state is 004 LDONE and the process time does not change increase the subagent is most likely waiting for an internal call to complete In many cases this condition is transient The subagent becomes responsive again as soon as the communications line or remote system become available If you experience this problem frequently you can modify the subagent s in...

Page 400: ...s can be used to exclude or include monitoring of the Guardian personality or the OSS personality of the SNMP Kernel You can use these startup parameters but enable or disable the Guardian or OSS personality maintenance as needed by setting the value of zhrmExamineGuardian or zhrmExamineOSS is zhrmSaProcess group Refer to Starting and Stopping the Subagent on page 11 12 for information about start...

Page 401: ...bagent s MIB supports the objects identified by a check mark in the following list dod 6 iso 1 identified organization 3 dod 6 internet 1 mgmt 2 mib 2 1 host 25 hrSystem 1 hrSystemUpTime 1 hrSystemDate 2 hrSystemInitialLoadDevice 3 hrSystemInitialLoadParameters 4 hrSystemNumUsers 5 hrSystemProcesses 6 hrSystemMaxProcesses 7 MIB Objects Table 11 2 describes how the Host Resources Subagent supports ...

Page 402: ...t Greenwich mean time Refer to RFC1514 for an explanation of how to interpret the octet string used to format DateAndTime values Guardian procedure JULIANTIMESTAMP hrSystemInitialLoadDevice 1 3 6 1 2 1 25 1 3 read only INTEGER 1 2147483647 Index of hrDeviceEntry for system load subvolume hrDeviceEntry is a row in the hrDeviceTable described under hrDevice Group Integer without leading 0s Guardian ...

Page 403: ... Gauge Number of users running a command interpreter Users logged in through a non TACL process such as Pathway are not counted Users running multiple TACLs are counted only once Integer without leading 0s Guardian procedure PROCESS_GETINFOLIST_ hrSystemProcesses 1 3 6 1 2 1 25 1 6 read only Gauge Number of process control blocks in both low and high process identification numbers PINs currently i...

Page 404: ...zhrmRefresh group When values of hrSystem group objects are refreshed values for objects in the hrSWRun and hrSWRunPerf groups are also refreshed The values of hrSystemDate and hrSystemUpTime are also updated each time these objects are accessed in response to a manager request Table 11 3 Compliance With hrSystem Group Definitions in RFC 1514 Object Descriptor Compliance Explanation hrSystemUpTime...

Page 405: ...ion 3 dod 6 internet 1 mgmt 2 mib 2 1 host 25 hrStorage 2 hrMemorySize 2 hrStorageTable 3 hrStorageEntry 1 hrStorageIndex 1 hrStorageType 2 hrStorageDescr 3 hrStorageAllocationUnits 4 hrStorageSize 5 hrStorageUsed 6 hrStorageAllocationFailure 7 Figure 11 3 illustrates how the hrStorageTable is related to the hrFSTable in the hrDevice group The values of hrFSStorageIndex in the hrFSTable correspond...

Page 406: ...s on the system Refer to hrStorage Group Maintenance later in this section for information on how entries are maintained hrStorageIndex 1 3 6 1 2 1 25 2 3 1 1 read only INTEGER 1 2147483647 An index value having a corresponding value hrFSStorageInde x in the hrFSTable A Guardian file system corresponds to a writable disk For CPUs 1 through 16 For disks 1001 through 10000 For file system 10001 and ...

Page 407: ...procedure PROCESSOR_GETINFOLIST _ For disks and file system entries Guardian procedure FILE_ GETINFOLISTBYNAME_ hrStorageAllocationUnits 1 3 6 1 2 1 25 2 3 1 4 read only INTEGER 1 2147483647 The number of bytes allocated by the entry when storage is requested For RAM an integer without leading 0s indicating the page size For disks and file system entries 2048 indicating one page For RAM Guardian p...

Page 408: ...l memory the number of free pages returned by Guardian procedure PROCESSOR_ GETINFOLIST_ is subtracted from the value of hrStorageSize For disks and file system entries the number of free pages returned by Guardian procedure FILE_ GETINFOLISTBYNAME_ is subtracted from the value of hrStorageSize hrStorageAllocationFailures 1 3 6 1 2 1 25 2 3 1 7 read only Counter The number of requests for storage ...

Page 409: ... 33 45 1001 1 3 6 1 2 1 25 2 1 4 DSM P 4230 1C 2048 316470 311818 0 05 22 95 10 33 45 1002 1 3 6 1 2 1 25 2 1 4 DSM2 P 4220 1 2048 146726 145449 0 05 22 95 10 33 45 1003 1 3 6 1 2 1 25 2 1 4 DSM3 P 4230 1C 2048 316470 275811 0 05 22 95 10 33 45 1004 1 3 6 1 2 1 25 2 1 4 ISVD20 P 4230 3 2048 316470 225707 0 05 22 95 10 33 45 1005 1 3 6 1 2 1 25 2 1 4 SYSTEM P 4250 2 2048 976611 488322 0 05 22 95 10...

Page 410: ...stem entries as the number of writable disks OSS For OSS there can be one or more disks for one fileset An entry exists for the fileset and for each disk of a fileset To derive entries for physical memory the subagent calls Guardian procedure PROCESSOR_GETINFOLIST_ to obtain values for each processor To derive logical disk device and file system entries the subagent calls Guardian procedure DEVICE...

Page 411: ...s are also refreshed The hrSWRun and hrSWRunPerf groups Three of the groups defined by HP zhrmTableInfo zhrmThreshold and zhrmRefresh hrDevice Group The hrDevice group is a large group consisting of a main table the hrDeviceTable five dependent tables hrNetworkTable hrProcessorTable hrPrinterTable hrDiskStorageTable and hrPartitionTable and the hrFSTable Objects in the hrDevice group describe proc...

Page 412: ...ionFSIndex 5 hrFSTable 8 hrFSEntry 1 hrFSIndex 1 hrFSMountPoint 2 hrFSRemoteMountPoint 3 hrFSType 4 hrFSAccess 5 hrFSBootable 6 hrFSStorageIndex 7 hrFSLastFullBackupDate 8 hrFSLastPartialBackupDate 9 Figure 11 4 illustrates hrDevice group table relationships The major table in the hrDevice group is the hrDeviceTable which contains an entry for each entry in five other tables in the hrDevice group ...

Page 413: ...777 006 11 37 hrDevice Group Two additional tables are related to hrDevice group tables the ifTable and the hrStorageTable The ifTable is one of the objects in the Interfaces group one of the MIB II groups The hrStorageTable is described in hrStorage Group on page 11 29 ...

Page 414: ...FSTable hrFSIndex hrFSStorageIndex hrStorageTable hrStorageIndex hrDeviceTable hrDeviceIndex hrNetworkTable hrDeviceIndex hrNetworkIfIndex hrPartitionTable hrDeviceIndex hrPartiionIndex hrPartitionFSIndex hrProcessorTable hrDeviceIndex hrPrinterTable hrDeviceIndex hrDiskStorageTable hrDeviceIndex Storage Group Device Group MIB II Interfaces Group Legend ifTable ifIndex VST1004 vsd ...

Page 415: ...es are maintained hrDeviceIndex 1 3 6 1 2 1 25 3 2 1 1 read only INTEGER 1 2147483647 Index values that point to entries in hrProcessorTable hrPrinterTable hrDiskStorageTable hrNetworkTable and the hrPartitionTable For CPUs 1 through 16 For network devices 101 through 500 For printers 501 through 1000 For disks 1001 through 10000 For tape drives 10001 through 11000 Computed by Host Resources Subag...

Page 416: ...eset Loopback device NOIOP hrDeviceID 1 3 6 1 2 1 25 3 2 1 4 read only ProductID An identifier characterizing the entry as a particular device type and subtype The root of the identifier is the same for all entries 1 3 6 1 4 1 169 3 180 Appended to this value are the type and subtype values For example the hrDeviceID for a 4500 1038 MB formatted capacity per spindle disk would look like this 1 3 6...

Page 417: ...T fileset name Refer to hrDeviceGroup Maintenance later in this section for more information hrDeviceErrors 1 3 6 1 2 1 25 3 2 1 6 read only Counter The number of errors detected on the device described by the entry Constant 0 for OSS Simulation using information about changes in device states hrProcessorTable Objects Entries describing processors associated with the system Refer to hrDevice Group...

Page 418: ...g network devices associated with the system Refer to hrDevice Group Maintenance later in this section for information about how network entries are maintained hrNetworkIfIndex 1 3 6 1 2 1 25 3 4 1 1 read only INTEGER Value of ifIndex that corresponds to the network device the entry represents Integer without leading 0s Computed by Host Resources Subagent hrPrinterTable Objects Entries describing ...

Page 419: ...etectedError State 1 3 6 1 2 1 25 3 5 1 2 read only OCTET STRING A description of any error condition existing for the printer One of these values offline 40 noPaper 02 no error 00 The last error value returned by Spooler procedure SPOOLERSTATUS2 Error codes 100 device not ready and 104 device does not respond are mapped to offline Error code 102 paper out is mapped to noPaper hrDiskStorageTable O...

Page 420: ...e value is always false nonRemovable Guardian procedure DEVICE_ GETINFOBYLDEV_ For OSS Constant hrDiskStorageCapacity 1 3 6 1 2 1 25 3 6 1 4 read only KBytes The total number of kilobytes the disk represented by the entry can store Integer without leading 0s Guardian procedure FILE_ GETINFOLIST BYNAME_ e hrPartitionTable Objects Entries describing partitions of long term storage devices associated...

Page 421: ...value hrFSIndex in the hrFSTable Integer without leading 0s Computed by Host Resources Subagent hrFSTable Objects Entries describing each file system associated with the system For NonStop systems there is one file system entry per writable disk Refer to hrDevice Group Maintenance later in this section for information about how entries are maintained hrFSIndex 1 3 6 1 2 1 25 3 8 1 1 read only INTE...

Page 422: ...describes a file system that is readable and writeable or only readable For Guardian readWrite For OSS readWrite or readOnly For Guardian Always readWrite For OSS RW flag from ZXCONFIG file hrFSBootable 1 3 6 1 2 1 25 3 8 1 6 read only INTEGER true 1 false 2 An indication of whether the disk represented by the entry is bootable For NonStop systems only SYSTEM is bootable For OSS the disk entry is ...

Page 423: ...1 2 1 25 3 1 6 DSM2 P 4220 1 1 3 6 1 4 1 169 3 180 3 19 running 0 05 22 95 10 35 30 1003 1 3 6 1 2 1 25 3 1 6 DSM3 P 4230 1C 1 3 6 1 4 1 169 3 180 3 21 running 0 05 22 95 10 35 30 1004 1 3 6 1 2 1 25 3 1 6 ISVD20 P 4230 3 1 3 6 1 4 1 169 3 180 3 21 running 0 05 22 95 10 35 30 1005 1 3 6 1 2 1 25 3 1 6 SYSTEM P 4250 2 1 3 6 1 4 1 169 3 180 3 29 running 0 05 22 95 10 35 30 10001 1 3 6 1 2 1 25 3 1 1...

Page 424: ...rdDisk 2 1953222 Time hrPartitionIndex hrPartitionLabel hrPartitionID hrPartitionSize hrPartitionFSIndex 05 22 95 10 37 45 1 DSM P 1 632940 1 05 22 95 10 37 45 1 DSM2 P 1 293452 2 05 22 95 10 37 45 1 DSM3 P 1 632940 3 05 22 95 10 37 45 1 ISVD20 P 1 632940 4 05 22 95 10 37 45 1 SYSTEM P 1 1953222 5 Time hrFSIndex hrFSMountPoint hrFSRemoteMountPoint hrFSType hrFSAccess hrFSBootable hrFSStorageIndex ...

Page 425: ...able 11 6 hrPrinterDetectedErrorStat e Yes See Table 11 6 hrDiskStorageAccess Yes See Table 11 6 hrDiskStorageMedia Yes See Table 11 6 hrDiskStorageRemoveble Yes See Table 11 6 hrDiskStorageCapacity Yes See Table 11 6 hrPartitionIndex Yes See Table 11 6 hrPartitionLabel Yes See Table 11 6 hrPartitionID Yes See Table 11 6 hrPartitionSize Yes See Table 11 6 hrPartitionFSIndex Yes See Table 11 6 hrFS...

Page 426: ...d range of index values Processors The subagent uses Guardian procedures PROCESSORSTATUS PROCESSORTYPE and PROCESSOR_GETINFOLIST_ to construct processor entries in the hrProcessorTable Network interfaces The subagent accesses the network interface file to build hrNetworkTable entries Refer to Starting and Stopping the Subagent on page 11 12 for a description of how the f startup parameter is used ...

Page 427: ...ubagent startup time MIB values are refreshed at a frequency controlled by the s and startup parameters Device Device State hrDeviceStatus Processors tapes and network interfaces up 2 running down 5 down Disks up 2 running down 5 down special 4 testing mount 4 testing revive 3 warning exercise 4 testing exclusive 4 testing harddown 5 down Printers waiting 2 running busy 2 running suspended 5 down ...

Page 428: ...up objects are refreshed values for objects in the following groups are also refreshed The hrSWRun and hrSWRunPerf groups Four of the groups defined by HP zhrmTableInfo zhrmDevUnavail zhrmThreshold and zhrmRefresh s hrDeviceIndex hrDeviceType hrDeviceDescr hrDeviceID hrProcessorFrwID hrNetworkIfIndex hrDiskStorageAccess hrDiskStorageMedia hrDiskStorageRemoveble hrPartitionIndex hrPartitionLabel hr...

Page 429: ...zation 3 dod 6 internet 1 mgmt 2 mib 2 1 host 25 hrSWRun 4 hrSWOSIndex 1 hrSWRunTable 2 hrSWRunEntry 1 hrSWRunIndex 1 hrSWRunName 2 hrSWRunID 3 hrSWRunPath 4 hrSWRunParameters 5 hrSWRunType 6 hrSWRunStatus 7 Figure 11 5 illustrates how the hrSWRunTable is related to the hrSWRunPerfTable in the hrSWRunPerf group Each hrSWRunTable entry has an index hrSWRunIndex that points to an entry in hrSWRunPer...

Page 430: ...ources Subagent hrSWRunTable Objects Entries describing each process specified by the e startup parameter that is currently running on the system Each process running has one entry If the process is running as a process pair each member has a separate entry Refer to hrSWRun Group Maintenance later in this section for information on how entries are maintained hrSWRunIndex 1 3 6 1 2 1 25 4 2 1 1 rea...

Page 431: ...s 1 3 6 1 4 1 169 3 180 0 For non operating system processes a 0 is added to the subagent s object identifier For operating systems 9050 is added For OSS 9594 is added hrSWRunPath 1 3 6 1 2 1 25 4 2 1 4 read only InternationalDisplayString SIZE 0 128 The fully qualified name of the program file whose process the entry represents For non operating system processes node name volume name subvolume na...

Page 432: ... for an operating system process is CPU 0 loaded with D20 06 at March 18 1995 14 44 3 0 running 36 days 21 hours 7 minutes 3 seconds hrSWRunType 1 3 6 1 2 1 25 4 2 1 6 read only INTEGER unknown 1 operatingSystem 2 deviceDriver 3 application 4 The type of software the entry represents One of the following values operatingSystem application The value operatingSystem is returned for NonStop system pr...

Page 433: ...17 hours 14 minutes 54 seconds operatingSystem running 05 22 95 10 39 52 101 NSK D20 1 3 6 1 4 1 169 3 180 9050 SYSTEM SYS02 OS CPU 1 loaded with D20 06 at May 19 1995 16 58 15 4 running 2 days 17 hours 11 minutes 36 seconds operatingSystem running 05 22 95 10 39 52 1019 XMIOP 1 3 6 1 4 1 169 3 180 0 SHERIFF SYSTEM SYS02 XMIOP XMIOP S 0 19 started May 19 1995 16 55 56 42 1 by 255 255 application r...

Page 434: ... MLMAN 1 3 6 1 4 1 169 3 180 0 SHERIFF SYSTEM SYS02 MLMAN ZLMG P 1 36 started May 20 1995 17 2 51 1 by 255 255 application running RFC Compliance Table 11 9 summarizes compliance of hrSWRun group support with RFC 1514 hrSWRun Group Maintenance If the value of zhrmEnableSoftwareGroup in the zhrmSaProcess group is set to 1 the values of objects in this group are all derived anew and existing values ...

Page 435: ...Group objects Set it to 1 to enable object maintenance hrSWRunPerf Group The hrSWRunPerf group consists of one table the hrSWRunPerfTable which contains one entry for each entry in the hrSWRunTable in the hrSWRun group The objects in the hrSWRunPerf group describe the CPU and memory utilization of processes running on the host The Host Resources Subagent s MIB supports the objects identified by a ...

Page 436: ...n the hrSWRun group Refer to hrSWRunPerf Group Maintenance later in this section for information on how entries are maintained hrSWRunPerfCPU 1 3 6 1 2 1 25 5 1 1 1 read only INTEGER The number of centiseconds of the total system s CPU resources consumed by the process described by this entry For operating system entries the CPU busy time Integer without leading 0s The process time is obtained by ...

Page 437: ...fter startup by setting the value of zhrmEnableSoftwareGroup in the zhrmSaProcess group Use the w startup parameter to suppress creation of hrSWRun group objects Omit the w startup parameter to enable object creation Set zhrmEnableSoftwareGroup to 0 to disable maintenance of hrSWRunGroup objects Set it to 1 to enable object maintenance Table 11 11 Compliance With hrSWRunPerf Group Definitions in R...

Page 438: ...9 nonstopsystems 3 zhrm 180 zhrmTableInfo 1 zhrmInfStorTable 1 zhrmInfStorEntries 1 zhrmInfStorFirstIndex 2 zhrmInfStorLastIndex 3 zhrmInfStorLastDynamRefresh 4 zhrmInfStorLastStableRefresh 5 zhrmInfStorGetCounter 6 zhrmInfStorGetNextCounter 7 zhrmInfStorSetCounter 8 zhrmInfDevTable 2 zhrmInfDevEntries 1 zhrmInfDevFirstIndex 2 zhrmInfDevLastIndex 3 zhrmInfDevLastDynamRefresh 4 zhrmInfDevLastStable...

Page 439: ...tCounter 6 zhrmInfNetGetNextCounter 7 zhrmInfNetSetCounter 8 zhrmInfPrnTable 5 zhrmInfPrnEntries 1 zhrmInfPrnFirstIndex 2 zhrmInfPrnLastIndex 3 zhrmInfPrnLastDynamRefresh 4 zhrmInfPrnLastStableRefresh 5 zhrmInfPrnGetCounter 6 zhrmInfPrnGetNextCounter 7 zhrmInfPrnSetCounter 8 zhrmInfDiskTable 6 zhrmInfDiskEntries 1 zhrmInfDiskFirstIndex 2 zhrmInfDiskLastIndex 3 zhrmInfDiskLastDynamRefresh 4 zhrmInf...

Page 440: ...er to zhrmTableInfo Group Maintenance later in this section for information on how object values are maintained zhrmInfStorEntries 1 3 6 1 4 1 169 3 180 1 1 1 read only Gauge The current number of entries in the hrStorageTable Integer without leading 0s Computed by Host Resources Subagent zhrmInfStorFirstIndex 1 3 6 1 4 1 169 3 180 1 1 2 read only INTEGER 1 65535 The lowest value of hrStorageIndex...

Page 441: ...performed on hrStorageTable objects since the subagent was last started Integer without leading 0s Computed by Host Resources Subagent zhrmInfStorSetCounter 1 3 6 1 4 1 169 3 180 1 1 8 read only Counter The number of Set operations performed on hrStorageTable objects since the subagent was last started Integer without leading 0s Computed by Host Resources Subagent zhrmInfDevTable Group Objects Obj...

Page 442: ...eRefresh 1 3 6 1 4 1 169 3 180 1 2 5 read only DisplayString The system time at which hrDeviceTable values controlled by the s startup parameter or the zhrmStableRefresh Now object were last refreshed month DD YYYY HH MM SS Guardian procedure JULIANTIMESTAMP zhrmInfDevGetCounter 1 3 6 1 4 1 169 3 180 1 2 6 read only Counter The number of Get operations performed on hrDeviceTable objects since the ...

Page 443: ...alue of hrDeviceIndex for hrProcessorTable entries Integer without leading 0s hrProcessorTable zhrmInfCpuLastIndex 1 3 6 1 4 1 169 3 180 1 3 3 read only INTEGER 1 65535 The highest value of hrDeviceIndex for hrProcessorTable entries Integer without leading 0s hrProcessorTable zhrmInfCpuLastDynamRefresh 1 3 6 1 4 1 169 3 180 1 3 4 read only DisplayString The system time at which hrProcessorTable va...

Page 444: ...t leading 0s Computed by Host Resources Subagent zhrmInfNetTable Group Objects Objects describing the status and usage of the hrNetworkTable Refer to zhrmTableInfo Group Maintenance later in this section for information on how object values are maintained zhrmInfNetEntries 1 3 6 1 4 1 169 3 180 1 4 1 read only Gauge The current number of entries in the hrNetworkTable Integer without leading 0s Com...

Page 445: ...NetGetCounter 1 3 6 1 4 1 169 3 180 1 4 6 read only Counter The number of Get operations performed on hrNetworkTable objects since the subagent was last started Integer without leading 0s Computed by Host Resources Subagent zhrmInfNetGetNextCounter 1 3 6 1 4 1 169 3 180 1 4 7 read only Counter The number of GetNext operations performed on hrNetworkTable objects since the subagent was last started ...

Page 446: ...1 3 6 1 4 1 169 3 180 1 5 3 read only INTEGER 1 65535 The highest value of hrDeviceIndex for hrPrinterTable entries Integer without leading 0s hrPrinterTable zhrmInfPrnLastDynamRefresh 1 3 6 1 4 1 169 3 180 1 5 4 read only DisplayString The system time at which hrPrinterTable values controlled by the d startup parameter or the zhrmDynamRefresh Now object were last refreshed month DD YYYY HH MM SS ...

Page 447: ...uted by Host Resources Subagent zhrmInfDiskTable Group Objects Objects describing the status and usage of the hrDiskStorageTable Refer to zhrmTableInfo Group Maintenance later in this section for information on how object values are maintained zhrmInfDiskEntries 1 3 6 1 4 1 169 3 180 1 6 1 read only Gauge The current number of entries in the hrDiskStorageTable Integer without leading 0s Computed b...

Page 448: ...skGetCounter 1 3 6 1 4 1 169 3 180 1 6 6 read only Counter The number of Get operations performed on hrDiskStorageTable objects since the subagent was last started Integer without leading 0s Computed by Host Resources Subagent zhrmInfDiskGetNextCounter 1 3 6 1 4 1 169 3 180 1 6 7 read only Counter The number of GetNext operations performed on hrDiskStorageTable objects since the subagent was last ...

Page 449: ...1 3 6 1 4 1 169 3 180 1 7 3 read only INTEGER 1 65535 The highest value of hrDeviceIndex for hrPartitionTable entries Integer without leading 0s hrPartitionTable zhrmInfPartLastDynamRefresh 1 3 6 1 4 1 169 3 180 1 7 4 read only DisplayString The system time at which hrPartitionTable values controlled by the d startup parameter or the zhrmDynamRefresh Now object were last refreshed month DD YYYY HH...

Page 450: ...the subagent was last started Integer without leading 0s Computed by Host Resources Subagent zhrmInfFSTable Group Objects Objects describing the status and usage of the hrFSTable Refer to zhrmTableInfo Group Maintenance later in this section for information on how object values are maintained zhrmInfFSEntries 1 3 6 1 4 1 169 3 180 1 8 1 read only Gauge The current number of entries in the hrFSTabl...

Page 451: ...4 1 169 3 180 1 8 6 read only Counter The number of subagent accesses of hrFSTable objects to handle Get requests since the subagent was last started Integer without leading 0s Computed by Host Resources Subagent zhrmInfFSGetNextCounter 1 3 6 1 4 1 169 3 180 1 8 7 read only Counter The number of subagent accesses of hrFSTable objects to handle GetNext requests since the subagent was last started I...

Page 452: ...tStableRefresh zhrmInfNetGetCounter zhrmInfNetGetNextCounter zhrmInfNetSetCounter 05 22 95 10 15 23 2 101 102 May 22 1995 09 59 48 May 21 1995 17 20 46 0 1 0 Time zhrmInfPrnEntries zhrmInfPrnFirstIndex zhrmInfPrnLastIndex zhrmInfPrnLastDynamRefresh zhrmInfPrnLastStableRefresh zhrmInfPrnGetCounter zhrmInfPrnGetNextCounter zhrmInfPrnSetCounter 05 22 95 10 16 07 2 501 502 May 22 1995 09 59 48 May 21 ...

Page 453: ... a critically high level Several objects in this group let you control whether the subagent sends traps when device utilization is too high The zhrmThreshold group consists of a two groups one describing RAM and one describing disks Each group contains several scalar objects as well as a table whose entries describe devices whose utilization is excessive Objects in the zhrmThreshold group are iden...

Page 454: ... of Value zhrmThrRam Group Objects Objects describing the status and usage of RAM with entries in the hrStorageTable Refer to zhrmThreshold Group Maintenance later in this section for information on how object values are maintained zhrmThrRAMTotal 1 3 6 1 4 1 169 3 180 2 1 1 read only Gauge The total number of megabytes of RAM in the system Integer without leading 0s The value of hrMemorySize expr...

Page 455: ... storage area at or above which zhrmThrRAMTable entries are created and a trap generated if zhrmThrRAMTrap Enable is set to 1 A value of 1 through 100 90 by default A value of 100 suppresses trap generation regardless of the value of zhrmThr RAMTrapEnable and zhrmThrRAM Tableentry creation Set at startup by using the h startup parameter Can be changed by setting the value of this MIB object zhrmTh...

Page 456: ...geDescr for the device zhrmThrRAMAllocationUnits 1 3 6 1 4 1 169 3 180 2 1 7 1 3 read only INTEGER 1 2147483647 The number of bytes allocated by the entry when storage is requested Integer without leading 0s indicating the page size The value of hrStorageAllocation Units for the device zhrmThrRAMSize 1 3 6 1 4 1 169 3 180 2 1 7 1 4 read only INTEGER 1 2147483647 The capacity of the entry in number...

Page 457: ...intenance later in this section for information on how object values are maintained zhrmThrDiskTotal 1 3 6 1 4 1 169 3 180 2 2 1 read only Gauge The total number of megabytes of writable disk in the system Integer without leading 0s Sum of hrStorageSize values for all entries in the hrStorageTable expressed as megabytes zhrmThrDiskUse 1 3 6 1 4 1 169 3 180 2 2 2 read only Gauge The total number of...

Page 458: ...writable disk at or above which zhrmThrDiskTable entries are created and a trap generated if zhrmThrDiskTrap Enable is set to 1 A value of 1 through 100 90 by default A value of 100 suppresses trap generation regardless of the value of zhrmThrDiskTrap Enable and zhrmThrDiskTable entry creation Set at startup by using the h startup parameter Can be changed by setting the value of this MIB object zh...

Page 459: ...cated by the entry when storage is requested 2048 indicating one page The value of hrStorageAllocation Units for the device zhrmThrDiskSize 1 3 6 1 4 1 169 3 180 2 2 7 1 4 read only INTEGER 1 2147483647 The capacity of the entry in number of allocation units Integer without leading 0s The number describes the pages formatted The value of hrStorageSize for the device zhrmThrDiskUsed 1 3 6 1 4 1 169...

Page 460: ...1C 2048 316470 311818 0 05 22 95 10 21 15 2 DSM2 P 4220 1 2048 146726 145449 0 zhrmThreshold Group Maintenance Most zhrmThreshold group values are derived from hrStorage group values as Table 11 13 describes Values in the zhrmThreshold group are refreshed immediately after hrStorage group values are refreshed Refer to hrStorage Group Maintenance on page 11 34 for information about when hrStorage g...

Page 461: ...vUnavail group consists of several scalar objects and one table the zhrmDevUnTable Objects in the zhrmDevUnavail group are identified by a check mark in the following list iso 1 identified organization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 zhrm 180 zhrmDevUnavail 3 zhrmDevUnCurrTime 1 zhrmDevUnUp 2 zhrmDevUnDown 3 zhrmDevUnOther 4 zhrmDevUnTrapEnable 5 zhrmDevUnTab...

Page 462: ...viceTable having specified status zhrmDevUnOther 1 3 6 1 4 1 169 3 180 3 4 read only Gauge The total number of devices for which the value of hrDeviceStatus is 1 unknown 3 warning or 4 testing Integer without leading 0s Sum of entries in hrDeviceTable having specified status zhrmDevUnTrapEnable 1 3 6 1 4 1 169 3 180 3 5 read write INTEGER devUnTrapsDisabled 0 devUnTrapsEnabled 1 When set to 1 devU...

Page 463: ...6 1 2 read only OBJECT IDENTIFIER One of the following device types defined by RFC 1514 that characterizes the entry hrDeviceProcessor hrDeviceNetwork hrDevicePrinter hrDeviceDiskStorage hrDeviceTape hrDeviceDiskStorage For CPUs 1 3 6 1 2 1 25 3 1 3 For printers 1 3 6 1 2 1 25 3 1 5 For disks 1 3 6 1 2 1 25 3 1 6 For tape drives 1 3 6 1 2 1 25 3 1 18 For network devices 1 3 6 1 2 1 25 3 1 4 For OS...

Page 464: ...oler collector Printers have name form printer id Spooler collectors used as pseudo printers have name form node name collector process name group name The value of hrDeviceDescr for qualifying devices For disks name type of disk volume disk type For tapes tape drive name For network devices network device For a loop back device NOIOP For OSS fileset Table 11 14 zhrmDevUnavail Group Objects Suppor...

Page 465: ...cedure Calls Reference Manual for a complete The value of hrDeviceID for qualifying devices zhrmDevUnStatus 1 3 6 1 4 1 169 3 180 3 6 1 5 read only INTEGER unknown 1 running 2 warning 3 testing 4 down 5 The current state of the device represented by the entry One of these values unknown warning testing down The value of hrDeviceStatus for qualifying devices zhrmDevUnErrors 1 3 6 1 4 1 169 3 180 3 ...

Page 466: ... 3 6 1 4 1 169 3 180 0 6 down 1 zhrmDevUnavail Group Maintenance Most zhrmDevUnavail group values are derived from hrDevice group values as Table 11 14 describes Values in the zhrmDevUnavail group are refreshed immediately after hrDevice group values are refreshed Refer to hrDevice Group Maintenance on page 11 50 for information about when hrDevice group values are refreshed The value of zhrmDevUn...

Page 467: ...oup consists of a series of scalar objects Objects in the zhrmSaProcess group are identified by a check mark in the following list iso 1 identified organization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 zhrm 180 zhrmSaProcess 4 zhrmSaProcCurrTime 1 zhrmSaProcVersion 2 zhrmSaProcName 3 zhrmSaPaid 4 zhrmSaPID 5 zhrmSaCreatTime 6 zhrmSaCpuTime 7 zhrmSaPri 8 zhrmSaHomeTerm...

Page 468: ...pecified in the TACL NAME option when the subagent was started zhrmSaPaid 1 3 6 1 4 1 169 3 180 4 4 read only DisplayString The process access ID PAID of the subagent process group number user number The group and user numbers associated with the user who started the subagent zhrmSaPID 1 3 6 1 4 1 169 3 180 4 5 read only DisplayString The process ID PID of the subagent process CPU number PIN numbe...

Page 469: ...y the subagent Integer without leading 0s Internal library routine zhrmGetPDUsCounter 1 3 6 1 4 1 169 3 180 4 13 read only Counter The number of Get requests received from the SNMP agent since starting Integer without leading 0s Computed by Host Resources Subagent zhrmGetNextPDUsCounter 1 3 6 1 4 1 169 3 180 4 14 read only Counter The number of GetNext requests received from the SNMP agent since s...

Page 470: ...BackupNow 1 3 6 1 4 1 169 3 180 4 18 read write INTEGER autoProcessPairControl 0 forceBackupTakeover 1 A switch that causes the subagent s backup process to take over and a new backup process to be created when set to 1 One of these values is displayed autoProcessPairControl forceBackupTakeover When setting these values use 0 or 1 At startup the subagent sets this value to 0 autoProcessPairControl...

Page 471: ... the subagent starts this object is assigned the subagent priority specified at invocation When a request is received from an SNMP manager to enable or disable software group value maintenance When one of the refresh timers s or d runs down or when the value of zhrmStableRefreshNow or zhrmDynamicRefreshNow is set to 1 A change from 1 to 0 deletes all the software group values A change from 0 to 1 ...

Page 472: ...efresh group are identified by a check mark in the following list iso 1 identified organization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 zhrm 180 zhrmRefresh 5 zhrmRefreshCurrtime 1 zhrmDynamRefreshInterval 2 zhrmStableRefreshInterval 3 zhrmLastDynamRefreshTime 4 zhrmLastStableRefreshTime 5 zhrmDynamRefreshCnt 6 zhrmStableRefreshCnt 7 zhrmDynamRefreshNow 8 zhrmStableR...

Page 473: ...d to the s startup parameter when the subagent was started Integer without leading 0s Subagent s startup parameter zhrmLastDynamRefreshTime 1 3 6 1 4 1 169 3 180 5 4 read only DisplayString The system time at which MIB values controlled by the d startup parameter or the zhrmDynam RefreshNow object were last refreshed month DD YYYY HH MM SS Guardian procedure JULIANTIMESTAMP zhrmLastStableRefreshTi...

Page 474: ... read only Counter The number of times since the subagent was started that MIB values controlled by the s startup parameter or the zhrmStableRefresh Now object were refreshed Integer without leading 0s Computed by Host Resources Subagent zhrmDynamRefreshNow 1 3 6 1 4 1 169 3 180 5 8 read write INTEGER autoDynamicRefresh 0 forceDynamicRefresh 1 When set to 1 force DynamicRefresh MIB objects whose v...

Page 475: ...ps group of the subagent s MIB Variable bindings accompanied by a check mark are defined in this group Variable bindings not accompanied by a check mark are defined in the zhrmThreshold group iso 1 identified organization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 zhrm 180 zhrmTraps 7 zhrmTrapDeviceStateIndex 1 zhrmTrapDeviceDescr 2 zhrmTrapDeviceStatus 3 zhrmTrapDevice...

Page 476: ...y the h and i startup parameters As RAM or disk utilization fluctuates these thresholds are deactivated and reactivated and traps generated When RAM or disk utilization reaches the high threshold value a trap is generated In addition the high threshold is deactivated so that oscillations around it do not cause repeated trap generation When RAM or disk utilization drops to the low threshold value a...

Page 477: ...Between Threshold Values and Trap Generation enterprise The object identifier for the SNMP agent indicating the origin of the trap 1 3 6 1 4 1 169 3 155 1 agent address The Internet address of the system on which the SNMP agent forwarding the trap is installed generic trap A 16 bit number set to 6 to signify that the trap is enterpriseSpecific specific trap A 16 bit number set to 0 time stamp The ...

Page 478: ...able or the hrPartitionTable for the device that the trap describes Integer numbered sequentially starting at 1 The value of zhrmDevUnIndex for the device zhrmTrapDeviceDescr 1 3 6 1 4 1 169 3 180 7 2 not accessible DisplayString SIZE 0 64 A description of the type of device that the trap describes For printers the name of a printer or Spooler collector Printers have names of the form printer id S...

Page 479: ...or falls below a low threshold represented by the value of zhrmThrDiskLowValue in the zhrmThreshold group Refer to Thresholds and Traps on page 11 100 for an explanation of the relationship between thresholds and trap generation Table 11 19 describes the MIB objects constituting the variable bindings of this trap Table 11 18 Variable Bindings in the zhrmRAMThreshold Trap Object and Attributes Defi...

Page 480: ...le INTEGER 1 2147483647 Index value that points to the entry in the hrStorageTable for the device that the trap describes Integer numbered sequentially starting at 1 The value of zhrmThrDiskIndex for the device zhrmTrapStorageDescr 1 3 6 1 4 1 169 3 180 7 5 not accessible DisplayString SIZE 0 64 Description of the type of storage represented by the entry The name and type of the disk volume disk t...

Page 481: ...anual for information on ZEMS data definitions Subsystem ID The subsystem ID that the Host Resources Subagent uses to identify itself as the source of event messages is Tokens in ZHRM Event Messages This subsection lists the tokens that the subagent includes in the event messages it generates ZHRMDDL Data Definition Language DDL definitions from which the language specific definitions are derived ...

Page 482: ...ition file See the EMS Manual for more information on these tokens and related data definitions Table 11 21 ZHRM Tokens in ZHRM Event Messages Token Contents ZHRM TKN ERR TEXT Additional error text ZHRM TKN FILE NAME Name of file related to event ZHRM TKN FS ERR File system error code ZHRM TKN SUBJ HRM SA Host Resources Subagent subject token Table 11 22 ZSPI Tokens in ZHRM Event Messages Token Co...

Page 483: ...vent sender ZEMS TKN PIN PIN of event sender ZEMS TKN SUBJECT MARK Event subject marker ZEMS TKN SUPPRESS DISPLAY Display don t display event flag ZEMS TKN USERID User ID of event sender ZEMS TKN CHANGE REASON Object state change reason private enumerations ZHRM VAL CR PROCESS NOMEM ZHRM VAL CR PROCESS SIGABRT ZHRM VAL CR PROCESS SIGFPE ZHRM VAL CR PROCESS SIGILL ZHRM VAL CR PROCESS SIGSEGV ZHRM V...

Page 484: ...you can follow to solve the problem reported by the event message An example of the formatted message 001 ZHRM EVT HRM SA TERMINATED The Host Resources Subagent terminated normally ZHRM TKN SUBJ HRM SA identifies the subject of the event always the Host Resources Subagent process The DDL heading of this token Host Resources Subagent process and the token s value the name of the process are inserte...

Page 485: ...ification of the agent process name rerun the subagent using the a startup parameter to specify the proper name Sample Message 95 03 10 16 34 20 COMM HMSA TANDEM HRM D21 000001 Object Unavailable Host Resources Subagent process COMM HMSA event number Process Terminated cause Process stopped 002 ZHRM EVT HRM SA STARTED The Host Resources Subagent process has started Value of ZEMS TKN CHANGE REASON ...

Page 486: ...wing reason ZHRM VAL HRM SA DEFINED is the previous state The DDL AS clause of this value not running is inserted in the message text following previous state ZHRM VAL HRM SA STARTED is the current state The DDL AS clauses of this value started is inserted in the message text following current state Cause The Host Resources Subagent process has started Effect The process is ready for service Recov...

Page 487: ...ause of this value Process I O error is inserted in the message text following event number ZHRM VAL TF IO identifies the type of transient fault that occurred For this event the DDL heading of the value IO error is inserted in the message text following fault type Unconditional Tokens ZEMS TKN EVENTNUMBER ZEMS TKN TXFAULT TYPE ZHRM TKN SUBJ HRM SA Value 1 Subagent process name 2 ZHRM EVT HRM SA I...

Page 488: ...subagent cannot function Recovery Investigate the reported error code and subcode and then correct the condition they describe If the error code is 14 file does not exist the subagent could not open the SNMP agent process and you should ensure that the SNMP agent is running or that you specified the correct agent process name when starting the subagent For more detailed information including recov...

Page 489: ... The subagent process ran out of memory The most likely causes are a problem of internal resource management or insufficient swap space Effect This error can prevent a part of the subagent from functioning The subagent might be able to correct the situation or might subsequently fail In the latter case additional events would be generated Recovery Stop the subagent if necessary Try using another d...

Page 490: ...bagent process and the token s value the name of the process are inserted in the message text ZHRM EVT HRM SA PROG ERR is the event number 5 The DDL AS clause of this value Process Internal Error is inserted in the message text following event number ZHRM VAL TF PROG identifies the type of transient fault that occurred For this event the DDL heading of the value Internal error is inserted in the m...

Page 491: ...h as Event Management Service EMS logs If your local operating procedures require contacting the GCSC supply your system number and the numbers and versions of all related products as well Sample Message 95 03 10 16 34 20 COMM HMSA TANDEM HRM D21 000005 Transient Fault Host Resources Subagent process COMM HMSA event number Process Internal Error fault type Internal error error detail Invalid State...

Page 492: ...rates events including the Host Resources Subagent can have its events translated into traps by the EMS Trap Subagent which uses an event filter known as a routing distributor filter to determine where to route trap messages The filter contains a destination statement that identifies the SNMP agent as the routing destination The filter can also contain specifications for selecting events to conver...

Page 493: ...r collects traps from TCP IP processes specified when you invoke it The UDP User Datagram Protocol port used for trap receipt from each TCP IP process is typically port 162 but this port number is configurable In addition to collecting traps from network devices the Trap Multiplexer can collect traps sent to the SNMP agent from SNMP subagents when a TCP IP process from which the Trap Multiplexer c...

Page 494: ...S Messages on page 12 21 Figure 12 1 Trap Multiplexer Functions and Components SNMP Agent TCP IP TCP IP Management Applications Template Files ZTMXTMPL ZTMXMIB Subagent Functions Manager Functions Event Management Service EMS Trap Multiplexer Event Viewers Subagents Legend Trap PDUs Request Response PDUs EMS Event Messages Compaq NonstopTM Kernel System Primary or Alternate Collector Trap Generati...

Page 495: ... Details about each of the objects in these groups can be found in ztmxPDUStatistics Group on page 12 12 and ztmxProcess Group on page 12 16 Related Documents The following documents provide information related to the Trap Multiplexer The EMS Manual describes the Event Management Service EMS EMS is a collection of processes tools and interfaces that provide event message collection and distributio...

Page 496: ... installation information Ensure that the EMS file named ZTMXTMPL is installed in the system template file When you use the SYSGEN utility to generate your system this file is automatically installed in the system template file Otherwise you must manually install it Refer to the EMS Manual for more information Load the ASN 1 source code for the Trap Multiplexer s MIB onto any SNMP manager you want...

Page 497: ... Group Name Default Behavior SNMP agent process name a ZSNMP on the same system as the Trap Multiplexer specified at startup Trap Multiplexer process Priority n ztmxProcPri ztmxProcess group Priority is 145 Backup process creation b No backup process Backup process takeover ztmxSwitchToBackupNow ztmxProcess group Backup process takes over if primary process fails Run independent of SNMP agent x Tr...

Page 498: ...SNMP agent is ZSNMP the following is an example of starting the Trap Multiplexer so that it receives traps on port 162 from the TCP IP processes ZTC0 and ZTC1 RUN SNMPTMUX NAME ZTMX t ZTC0 ZTC1 The following is an example of starting the Trap Multiplexer so that it receives traps on port 162 from one or more TCP IP processes with IP addresses RUN SNMPTMUX NAME ZTMX t ZTC0 ZTC1 192 168 10 31 The Tr...

Page 499: ... you want the Trap Multiplexer to receive SNMP manager requests If not specified ZSNMP on the same system as the Trap Multiplexer you specify is assumed b backup cpu number specifies that the Trap Multiplexer is to run as a process pair and optionally specifies a backup CPU number 0 through 15 identifying the CPU in which you want the backup process to run If the primary process fails the backup p...

Page 500: ... the File Utility Program FUP to give ownership of the Trap Multiplexer program file SNMPTMUX to a super user ID Then secure SNMPTMUX so that a user who does not have a super group user ID can execute it and set the PROGID so that the owner ID of SNMPTMUX is used as the creator accessor ID when the program is run Refer to the File Utility Program FUP Reference Manual for more information t tcpip p...

Page 501: ... copy of the log file you can also use the l startup parameter Use of this startup parameter slows Trap Multiplexer processing time because a high volume of trace information is produced In addition the Trap Multiplexer might miss some traps l log file causes the Trap Multiplexer to write a formatted trace of its activities to a C language compatible disk file file code 180 which you can convert t...

Page 502: ...resses are associated with the specified TCP IP process Only a TCP IP process name the TCP IP process name is associated with all subnets for the TCP IP subsystem Only an IP address the IP address is associated with the default TCP IP process ZTC0 You can also use PARAMs with the t parameter to specify additional TCP IP processes You must specify both PARAMs Otherwise the PARAMs are ignored Syntax...

Page 503: ...TC1 192 168 10 42 192 168 10 43 RUN SNMPTMUX NAME ZTMUX t 192 168 12 4 Using Only PARAMs PARAM ZSMP TCPIP NAME ztc2 PARAM ZSMP TCPIP ADDR 192 168 10 44 RUN SNMPTMUX NAME ZTMUX Using Both t Startup Parameter and PARAMs PARAM ZSMP TCPIP NAME ZTC1 PARAM ZSMP TCPIP ADDR 192 168 10 44 RUN SNMPTMUX NAME ZTMUX T ZTC0 ZTC1 192 168 10 31 PARAM ZSMP TCPIP NAME ZTC3 PARAM ZSMP TCPIP ADDR 192 168 10 44 RUN SN...

Page 504: ...entified by a check mark in the following list iso 1 identified organization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 ztmx 185 ztmxPDUStatistics 1 ztmxUdpStatsCurrTime 1 ztmxUdpInDatagrams 2 ztmxInDecodeErrors 3 ztmxInGetPdus 4 ztmxInGetNextPdus 5 ztmxInSetPdus 6 ztmxInGetResponsePdus 7 ztmxInTrapPdus 8 ztmxTrapStatistics 9 ztmxTrapStatsCurrTime 1 ztmxInColdStartTraps...

Page 505: ... Version 1 PDUs Integer without leading 0s Trap Multiplexer ztmxInGetPdus 1 3 6 1 4 1 169 3 185 1 4 read only Counter The total number of Get PDUs received by the Trap Multiplexer Integer without leading 0s Trap Multiplexer ztmxInGetNextPdus 1 3 6 1 4 1 169 3 185 1 5 read only Counter The total number of GetNext PDUs received by the Trap Multiplexer Integer without leading 0s Trap Multiplexer ztmx...

Page 506: ...ived by the Trap Multiplexer These standard SNMP traps signify that the sending entity has reinitialized most likely because of a routine restart Integer without leading 0s Trap Multiplexer ztmxInLinkDownTraps 1 3 6 1 4 1 169 3 185 1 9 4 read only Counter The total number of linkDown traps received by the Trap Multiplexer These standard SNMP traps signify that the sending entity has experienced a ...

Page 507: ...eighborossTrap s 1 3 6 1 4 1 169 3 185 1 9 7 read only Counter The total number of egpNeighborLoss traps received by the Trap Multiplexer These standard SNMP traps signify that the sending entity no longer has a peer relationship with an EGP External Gateway Protocol neighbor Integer without leading 0s Trap Multiplexer ztmxInEnterpriseSpecificTra ps 1 3 6 1 4 1 169 3 185 1 9 8 read only Counter Th...

Page 508: ...ganization 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 ztmx 185 ztmxProcess 2 ztmxProcCurrTime 1 ztmxProcVersion 2 ztmxProcName 3 ztmxProcPaid 4 ztmxProcPrimPID 5 ztmxProcBkupPID 6 ztmxProcCreatTime 7 ztmxProcCpuTime 8 ztmxProcPri 9 ztmxProcHomeTerm 10 ztmxProcHeapInitial 11 ztmxProcHeapCurrent 12 ztmxProcEmsCollector 13 ztmxProcAgent 14 ztmxProcAgentSessionStatus 15 ztm...

Page 509: ...c characters The name specified in the TACL NAME option when the Trap Multiplexer was started ztmxProcPaid 1 3 6 1 4 1 169 3 185 2 4 read only DisplayString The process access ID PAID of the Trap Multiplexer process group number user number The group and user numbers associated with the user who started the Trap Multiplexer ztmxProcPrimPID 1 3 6 1 4 1 169 3 185 2 5 read only DisplayString The proc...

Page 510: ...lexer startup Integer without leading 0s Internal library routine ztmxProcHeapCurrent 1 3 6 1 4 1 169 3 185 2 12 read only Gauge The number of bytes of memory buffer space currently in use by the Trap Multiplexer Integer without leading 0s Internal library routine ztmxProcEmsCollector 1 3 6 1 4 1 169 3 185 2 13 read only DisplayString The name of the EMS collector process to which event messages a...

Page 511: ...ving traps Each TCP IP process name has the following form tcpip proc name The TCP IP process names specified in the t startup parameter If not specified the name is ZTC0 ztmxSwitchToBackupNow 1 3 6 1 4 1 169 3 185 2 18 read write INTEGER autoProcessPairControl 0 forceBackupTakeover 1 A switch that causes the Trap Multiplexer backup process to take over and a new backup process to be created when ...

Page 512: ...e Trap Multiplexer starts this object is assigned the priority specified at invocation ztmxProcEmsWriteTotal 1 3 6 1 4 1 169 3 185 2 20 read only Counter The total number of attempts to write an event message converted from a trap to the EMS collector Integer without leading 0s Trap Multiplexer ztmxProcEmsWriteErrors 1 3 6 1 4 1 169 3 185 2 21 read only Counter The total number of write operations...

Page 513: ...on about using the t parameter and PARAMs see Using the t and PARAM Startup Parameters on page 12 10 EMS Messages This subsection describes the EMS events generated by the Trap Multiplexer subsystem abbreviation ZTMX Event Summary The Trap Multiplexer generates events that fall into two categories Trap events These events describe each trap received Process events These events highlight Trap Multi...

Page 514: ...N TRAP VARBIND DATATYPE data type of varbind value of variable binding value of varbind ZSPI TKN ENDLIST end of first varbind list ZSPI TKN DATALIST start of last varbind list ZTMX TKN TRAP VARBIND OID OID of varbind ZTMX TKN TRAP VARBIND DATATYPE data type of varbind value of variable binding value of varbind ZSPI TKN ENDLIST end of last varbind list ZSPI TKN ENDLIST end of outer list Figure 12 2...

Page 515: ...ZTMX TKN TRAP COMMUNITY The community name associated with the trap originator from the community field of the trap PDU ZTMX TKN TRAP ENTERPRISE The enterprise identifier of the trap originator from the enterprise field of the trap PDU ZTMX TKN TRAP NETADDR The IP address of the trap originator from the agent addr field of the trap PDU ZTMX TKN TRAP GENERIC The predefined trap type in the generic ...

Page 516: ...SMI OID ZTMX TNM SMI IPADDR ZTMX TNM SMI COUNTER ZTMX TNM SMI GAUGE ZTMX TNM SMI TICKS ZTMX TNM SMI OPAQUE One of the following tokens ZTMX TKN TRAP NULL ZTMX TKN TRAP INTEGER ZTMX TKN TRAP OCTETSTRING ZTMX TKN TRAP OID ZTMX TKN TRAP IPADDR ZTMX TKN TRAP COUNTER ZTMX TKN TRAP GAUGE ZTMX TKN TRAP TIMETICKS ZTMX TKN TRAP OPAQUE The value of the varbind The exact token that appears depends on the val...

Page 517: ...fic files The complete set of SPI definition files is usually located in the ZSPIDEF subvolume of the NonStop Kernel installation volume See the SPI Programming Manual for information on the ZSPI data definitions and data definition files in general See the EMS Manual for information on ZEMS data definitions Table 12 6 Trap Multiplexer Process Event Messages Number Event Standard Event 101 ZTMX EV...

Page 518: ...X Tokens in ZTMX Event Messages page 1 of 2 Token Contents ZTMX TKN ERR TEXT Additional error text ZTMX TKN EVENTNUMBER The event number of a trap event ZTMX TKN FILE NAME Name of file related to event ZTMX TKN FS ERR File system error code ZTMX TKN SUBJ TMX Trap Multiplexer subject token ZTMX TKN TRAP COMMUNITY Community value in a trap PDU ZTMX TKN TRAP ENTERPRISE Enterprise value in a trap PDU ...

Page 519: ...N TRAP SMI OID Value of a varbind with a data type of OBJECT IDENTIFIER ZTMX TKN TRAP SMI OPAQUE Value of a varbind with a data type of Opaque ZTMX TKN TRAP SMI TIMETICKS Value of a varbind with a data type of TimeTicks ZTMX TKN TRAP SPECIFIC Specific trap type in specific trap field of a trap PDU ZTMX TKN TRAP TIMETICKS Timestamp value in a trap PDU ZTMX TKN TRAP VARBIND COUNT Number of varbinds ...

Page 520: ...TKN NODENUM System number of event sender ZEMS TKN PIN PIN of event sender ZEMS TKN SUBJECT MARK Event subject marker ZEMS TKN SUPPRESS DISPLAY Display do not display event flag ZEMS TKN USERID User ID of event sender ZEMS TKN CHANGE REASON Object state change reason private enumerations ZTMX VAL CR PROCESS NOMEM ZTMX VAL CR PROCESS SIGABRT ZTMX VAL CR PROCESS SIGFPE ZTMX VAL CR PROCESS SIGILL ZTM...

Page 521: ... ZTMX TKN TRAP COMMUNITY ZTMX TKN TRAP ENTERPRISE ZTMX TKN TRAP NETADDR ZTMX TKN TRAP GENERIC ZTMX TKN TRAP SPECIFIC ZTMX TKN TRAP TIMETICKS ZTMX TKN TRAP VARBIND COUNT Value 2 Trap Multiplexer process name 1 ZTMX EVT TRAP trap type Copy of BER encoded trap 3 Version number in trap 4 Community string in trap 5 Enterprise OID in trap 6 IP address of trap origin 7 Generic trap type in trap 8 Specifi...

Page 522: ...rap originator from the community field of the trap PDU In the message text it follows the string Community ZTMX TKN TRAP ENTERPRISE is the enterprise identifier of the trap originator from the enterprise field of the trap PDU In the message text it follows the string Enterprise ZTMX TKN TRAP NETADDR is the IP address of the trap originator from the agent addr field of the trap PDU In the message ...

Page 523: ... SMI NULL is the value of a varbind with a data type of NULL In the message text it follows the string value ZTMX TKN TRAP SMI INTEGER is the value of a varbind with a data type of INTEGER In the message text it follows the string value ZTMX TKN TRAP SMI OCTETSTRING is the value of a varbind with a data type of OCTET STRING In the message text it follows the string value ZTMX TKN TRAP SMI OID is t...

Page 524: ...ap signifying that the sending entity has reinitialized most likely because of a restart due to an error condition and its configuration might have changed Effect The effect is specific to the product that generated the trap Recovery The recovery actions required are specific to the product that generated the trap If necessary contact your SNMP site expert for assistance with determining how to in...

Page 525: ...rd SNMP trap signifying that the sending entity has reinitialized most likely because of a routine restart but its configuration will not have changed Effect The effect is specific to the product that generated the trap Recovery The recovery actions required are specific to the product that generated the trap If necessary contact your SNMP site expert for assistance with determining how to interpr...

Page 526: ...P trap signifying that the sending entity has experienced a failure in one of its communication links Effect The effect is specific to the product that generated the trap Recovery The recovery actions required are specific to the product that generated the trap If necessary contact your SNMP site expert for assistance with the tools that might be used to identify the source and nature of the probl...

Page 527: ...a linkUp trap A linkUp trap is a standard SNMP trap signifying that one of the sending entity s communication links has become activated Effect The effect is specific to the product that generated the trap Recovery This message is intended for monitoring programs If necessary contact your SNMP site expert for assistance with determining how to interpret and handle the trap Unconditional Tokens ZEM...

Page 528: ...ure trap is a standard SNMP trap signifying that the sending entity has received a request that failed authentication Effect The effect is specific to the product that generated the trap Recovery The recovery actions required are specific to the product that generated the trap If necessary contact your SNMP site expert for assistance with the tools that might be used to identify the source and nat...

Page 529: ...ap is a standard SNMP trap signifying that the sending entity no longer has a peer relationship with an EGP Exterior Gateway Protocol neighbor Effect The effect is specific to the product that generated the trap Recovery The recovery actions required are specific to the product that generated the trap If necessary contact your SNMP site expert for assistance with the tools that might be used to id...

Page 530: ...seSpecific trap This trap indicates that the sending entity has experienced some enterprise defined event Effect The effect is specific to the product that generated the trap Recovery The recovery actions required are specific to the product that generated the trap If necessary contact your SNMP site expert for assistance with the tools that might be used to identify the source and nature of the p...

Page 531: ... 6 Specific trap 2 Time ticks 741158 varbind 1 OID 1 3 6 1 4 1 169 3 180 7 4 type INTEGER value 1071 varbind 2 OID 1 3 6 1 4 1 169 3 180 7 5 type OCTET STRING value OPER P 4500 2 varbind 3 OID 1 3 6 1 4 1 169 3 180 2 2 3 type INTEGER value 81 Process Event Message Descriptions Token lists Tokens listed as unconditional always appear in the event message Tokens listed as conditional are included on...

Page 532: ...e token s value the name of the process are inserted in the message text ZTMX EVT TMX TERMINATED is the event number 101 The DDL AS clause of this value Process Terminated appears in the message text following event number Unconditional Tokens ZTMX TKN SUBJ TMX ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT USER Value 1 Trap Multiplexer ...

Page 533: ...ry is successful an event announcing the takeover is generated Recovery Examine the event logs for related events Often event message 103 ZTMX EVT TMX IO ERR is generated prior to this event refer to the message contents for a description of the associated problem If you can determine the cause of the termination correct it and if necessary restart the Trap Multiplexer process If the termination r...

Page 534: ...RTED is the event number 1022 The DDL AS clause of this value Process Started is inserted in the message text following event number ZTMX VAL CR PROCESS STARTED is the change reason The DDL AS clause of this value Process started is inserted in the message text following reason ZTMX VAL TMX DEFINED is the previous state The DDL AS clause of this value not running appears in the message text follow...

Page 535: ...Process Started reason Process started previous state not running current state started user content undefined 103 ZTMX EVT TMX IO ERR The Trap Multiplexer process encountered an I O error ZTMX TKN SUBJ TMX identifies the subject of the event always the Trap Multiplexer process The DDL heading of this token SNMP Trap Multiplexer and the token s value the name of the process are inserted in the mes...

Page 536: ...red an I O error The cause is most likely the assignment of an incorrect agent process name at Trap Multiplexer startup or a stopped SNMP agent process Effect The Trap Multiplexer cannot function Recovery Investigate the reported error code and subcode and then correct the condition they describe If the error code is 14 file does not exist the Trap Multiplexer could not open the SNMP agent process...

Page 537: ...ent number 1044 The DDL AS clause of this value Process No Memory Space is inserted in the message text following event number ZTMX VAL TF MEM identifies the type of transient fault that occurred For this event the DDL heading of the value Memory full is inserted in the message text Cause The Trap Multiplexer process ran out of memory The most likely cause is a problem of internal resource managem...

Page 538: ...y full 105 ZTMX EVT TMX PROG ERR The Trap Multiplexer process experienced an internal or logic error ZTMX TKN SUBJ TMX identifies the subject of the event always the Trap Multiplexer process The DDL heading of this token SNMP Trap Multiplexer and the token s value the name of the process are inserted in the message text ZTMX EVT TMX PROG ERR is the event number 105 The DDL AS clause of this value ...

Page 539: ...elevant information as follows Descriptions of the problem and accompanying symptoms Details from the message or messages generated Supporting documentation such as Event Management Service EMS logs If your local operating procedures require contacting the GCSC supply your system number and the numbers and versions of all related products as well Sample Message 96 07 26 11 43 07 COMM ZTMX TANDEM T...

Page 540: ...on This subsection describes a sample application that demonstrates how a management application can extract information from events created from traps received by the Trap Multiplexer Application Components The sample application is in a C language program that uses Subsystem Programmatic Interface SPI procedures to retrieve the values of tokens from event traps As Figure 12 3 indicates the appli...

Page 541: ...amined later in this section you will notice that it specifies several compiler pragmas and includes several library files and DDL files for use during compilation To compile the filter source invoke EMF after loading the DDL definitions used by the filter In the following example the filter source code is in a file named TMXF and EMF compiles it into a file named TMXFO PUSH dummy LOAD KEEP 1 LOAD...

Page 542: ... your current system is assumed filter name is the name of the file containing the EMS compiled version of the filter shown in Figure 12 4 If you do not specify a filter name TMXFO in your current subvolume is assumed The following command starts the application which has been compiled into a file named TMUXAX The Trap Multiplexer is sending trap events to an alternate EMS collector ACOL and the E...

Page 543: ...the EMS consumer distributor and processes the response This general purpose function is called from various functions whenever a SPI command is ready for processing The spi_cmd_load_filter function builds a SPI command that identifies the filter object file and then calls send_spi_cmd to process the command Example 12 2 Sample Application Output Waiting for the next Event VersionNumber 0 Communit...

Page 544: ...re calls used by the application are included 3 Functions defined by the application are declared 4 The C language versions of the DDL files defining trap event tokens are included Figure 12 4 Sample Application Control Flow main Identify EMS collector and filter names Convert names to EMS format Create EMS consumer distributor process Open distributor process for SPI interactions spi_cmd_set_sour...

Page 545: ...e for SNMP data is declared Most values are allocated storage by using compatible ZSPI data types Values that the application treats as strings OCTET STRING OBJECT IDENTIFIER IpAddress and Opaque values are stored in a 1024 byte buffer named t_buffer The following table summarizes the SPI and C types you can use when declaring storage for trap data Trap Data SPI Data Type C Wide Model Data Type SN...

Page 546: ...d 21 The value of ZTMX TKN TRAP COMMUNITY the community name in the trap PDU is extracted and displayed after insert_null is called 22 The value of ZTMX TKN TRAP ENTERPRISE the enterprise name in the trap PDU is extracted and displayed after insert_null is called 23 The value of ZTMX TKN TRAP NETADDR the IP address of the trap originator is extracted and displayed after insert_null is called 24 Th...

Page 547: ...lector name is formatted for use by EMS procedures 38 The filter name is resolved to a fully qualified file name 39 The filter name is formatted for use by EMS procedures 40 The subsystem ID structures are initialized 41 The buffer for holding a SPI response is allocated by using ZCOM_VAL_MAX_RSP_BUFLEN to define the largest supported buffer 5120 bytes 42 An EMS distributor process is started 43 T...

Page 548: ...stem Note zspidef location ssv0 may vary according to system configuration pragma WIDE 1 pragma INSPECT pragma SYMBOLS pragma NOMAP pragma NOLMAP pragma RUNNABLE pragma XMEM include stdio h nolist 2 include string h nolist include stdlib h nolist include memory h nolist include tal h nolist include CEXTDECS DEBUG EMSGETTKN FILE_CLOSE_ FILE_OPEN_ FILE_GETINFO_ FILENAME_RESOLVE_ FILENAME_TO_OLDFILEN...

Page 549: ...t ccval for cc return from writeread short ibuflen ZCOM_VAL_MAX_RSP_BUFLEN short used_len short spi_ret_code Determine how much buffer was used spi_err SSGETTKN short spi_buf buffer ZSPI_TKN_USEDLEN token id char used_len token value if spi_err ZSPI_ERR_OK DEBUG Send the used part to the distributor ccval WRITEREADX distr file number char spi_buf buffer used_len write count ZCOM_VAL_MAX_RSP_BUFLEN...

Page 550: ...f buffer ZEMS_TKN_CONNECT_SRC_COLL token id coll_name token value if spi_err ZSPI_ERR_OK DEBUG send the command to the distributor send_spi_cmd spi_buf distr spi_cmd_set_source pragma PAGE spi_cmd_load_filter builds a SPI command that loads a filter into the distributor and passes one filter parameter Input SPI buffer filter name and distributor file number Return None void spi_cmd_load_filter cha...

Page 551: ...fer skip the length b_ptr pt_buffer len point to the end of array b_ptr 0 insert a null to print as a string return pt_buffer insert_null pragma PAGE print_octetstring this routine prints an octet string variable Nonprintable chars are replaced with Input pointer to the buffer length and title to be displayed Return None void print_octetstring char buffer int buflen char title 9 static char printb...

Page 552: ...r trap_buf ZEMS_VAL_BUFLEN ztmx_val_ssid_def tmpssid char t_buffer 1024 temp buffer for string manipulation char pt_buffer t_buffer pointer to the temp buffer short len short ibuflen ZEMS_VAL_BUFLEN malloc memory for the event buffer event_buf malloc ZEMS_VAL_BUFLEN 12 if event_buf NULL DEBUG setmem trap_buf sizeof trap_buf 0 initialise the trap buffer begin an infinite loop that collects and disp...

Page 553: ...ported n continue if tmpssid z_number ZSPI_SSN_ZTMX printf A non Trap Multiplexer event has been reported n continue check whether the event obtained is a trap event spi_err EMSGETTKN short event_buf buffer 18 ZEMS_TKN_EVENTNUMBER token id char evt_num token value 1 index if spi_err ZSPI_ERR_OK DEBUG if evt_num ZTMX_EVT_TRAP_COLDSTART evt_num ZTMX_EVT_TRAP_WARMSTART evt_num ZTMX_EVT_TRAP_LINKDOWN ...

Page 554: ...ctetstring pt_buffer len Community spi_err EMSGETTKN short event_buf 22 ZTMX_TKN_TRAP_ENTERPRISE enterprise char t_buffer 1 index if spi_err ZSPI_ERR_OK DEBUG pt_buffer insert_null t_buffer len printf Enterprise s n pt_buffer spi_err EMSGETTKN short event_buf 23 ZTMX_TKN_TRAP_NETADDR net address char t_buffer 1 index if spi_err ZSPI_ERR_OK DEBUG pt_buffer insert_null t_buffer len printf Network Ad...

Page 555: ...rr ZSPI_ERR_OK DEBUG printf Timeticks d n t_timeticks enter the data list to get the next token spi_err EMSGETTKN short event_buf 27 ZSPI_TKN_DATALIST if spi_err ZSPI_ERR_OK DEBUG spi_err EMSGETTKN short event_buf 28 ZTMX_TKN_TRAP_VARBIND_COUNT varbind count char t_varbind_count 1 index if spi_err ZSPI_ERR_OK DEBUG printf Varbind Count d n t_varbind_count for i 1 i t_varbind_count i 29 enter the d...

Page 556: ...BUG switch t_varbind_datatype 33 case ZTMX_TNM_SMI_NULL printf Type NULL n spi_err EMSGETTKN short event_buf ZTMX_TKN_SMI_NULL t_null 1 printf Value d n t_null break case ZTMX_TNM_SMI_INTEGER printf Type INTEGER n spi_err EMSGETTKN short event_buf ZTMX_TKN_SMI_INTEGER char t_integer 1 printf Value d n t_integer break case ZTMX_TNM_SMI_OCTETSTRING printf Type OCTETSTRING n spi_err EMSGETTKN short e...

Page 557: ...TNM_SMI_COUNTER printf Type COUNTER n spi_err EMSGETTKN short event_buf ZTMX_TKN_SMI_COUNTER char t_counter 1 printf Value d n t_counter break case ZTMX_TNM_SMI_GAUGE printf Type GAUGE n spi_err EMSGETTKN short event_buf ZTMX_TKN_SMI_GAUGE char t_gauge 1 printf Value d n t_gauge break case ZTMX_TNM_SMI_TICKS printf Type TIMETICKS n spi_err EMSGETTKN short event_buf ZTMX_TKN_SMI_TIMETICKS char t_ti...

Page 558: ... int argc char argv 34 short error short startup_msg_actual_len startup_msg_type ci_startup char cptr int ccval 0 define proc_name_len 40 char proc_name proc_name_len char whoami opt short err_detail short proc_len char startup_default_str char coll_name 0 default collector name char filt_name tmxfo default event filter define file_name_Dxx_maxlen 36 char filt_name_Dxx file_name_Dxx_maxlen D serie...

Page 559: ... length startup_default_str defaults short strlen startup_default_str length if error printf FILENAME_RESOLVE_ returned d n error exit 1 this will convert an external filename into an internal filename for passing it to the EMS routines error FILENAME_TO_OLDFILENAME_ coll_name_Dxx file name 37 file_name_len length short coll_name_Cxx old filename if error printf FILENAME_TO_OLDFILENAME_ returned d...

Page 560: ...sid z_number ZSPI_SSN_ZEMS emsssid z_version ZEMS_VAL_VERSION cptr strncpy tmxssid u_z_filler z_filler ZSPI_VAL_TANDEM 8 tmxssid z_number ZSPI_SSN_ZTMX tmxssid z_version ZTMX_VAL_VERSION malloc some memory for spi buffers spi_buf malloc ZCOM_VAL_MAX_RSP_BUFLEN 41 if spi_buf NULL DEBUG Initialize the startup message structure error get_startup_msg ci_startup startup_msg_actual_len ci_startup param ...

Page 561: ...ILE_GETINFO_ distr short error if error 0 error 70 printf WRITEREADX returned error d n error exit 1 We can now close the distributor FILE_CLOSE_ distr 45 Prepare to reopen the distributor using spi interface proc_name proc_len 0 strcat proc_name ZSPI ccval FILE_OPEN_ proc_name file name short proc_len strlen ZSPI length short distr file number if ccval printf FILE_OPEN_ returned d n ccval exit 1 ...

Page 562: ...Trap Multiplexer Subagent Manager SNMP Configuration and Management Manual 424777 006 12 70 Application Source Code ...

Page 563: ...enced Packet Exchange IPX SPX IPXPROTO processes provide support for NetWare protocols IPX SPX NCP RIP and SAP enabling connectivity over a local area network LAN between NonStop Kernel systems and products using the protocols The subagent supports one of the groups in Novell s Management Information Base MIB as well as several groups defined by HP containing objects that help you manage IPXPROTO ...

Page 564: ...g an SNMP manager As Figure 13 2 illustrates the subagent interacts with one or more SNMP agent processes to receive and respond to manager requests SNMP requests arriving over the LAN are routed using the TCP IP network protocol Managers that reside on NonStop Kernel systems can transmit requests to SNMP agents using interprocess communications The subagent sends Event Management System EMS event...

Page 565: ...xpand with IPXPROTO processes SNMP agent processes and an EMS process running on remote nodes Figure 13 2 IPX SPX Subagent Interactions IPXPROT O Processes TLAM D series or SLSA G series IPXMG R SCP SCF LAN NonStopTM IPX SPX TCP IP SNMP Agents IPX SPX Subagent EM S Collector Telnet Workstation Manager Station NonStopTM Manager Legend IPX and SCF Messages SNMP Messages VST142 vsd ...

Page 566: ...bjects that support IPXPROTO process management are located in two groups The ipxSystem group defined by Novell provides information about the basic IPX protocol stack This group consists of one table the ipxBasicSysTable whose entries characterize IPX packet handling statistics for IPXPROTO processes The subagent provides read only access to all the objects in the ipxSystem group The zipx group d...

Page 567: ...rom the zipx group tables is also available using SCF commands as described in zipx Group on page 13 23 Each IPXPROTO process the subagent is configured to monitor has an entry in the six tables in the ipxSystem and zipx groups and in a table in the zisa group the tdmNwSaIPXPROTONamesTable The entries are created and linked by means of an index the subagent derives when an entry for an IPXPROTO pr...

Page 568: ...st time after startup when the subagent accesses the table to process an SNMP request ipxBasicSysTable tdmNwInfoTable tdmNwIPXTable tdmNwSPXTable tdmNwNCPTable tdmNwServerTable Subsequently table values are refreshed when a table is accessed only if the number of minutes associated with the subagent s refresh timer have elapsed since the last time an object in the table was accessed For example if...

Page 569: ... sets the values of two objects in the tdmNwSaIPXPROTONames Table The value of tdmNwSaIpxProtoState is set to disconnected The value of tdmNwSaIpxProtoStateReason is set to resourceproblem The timeout value is not configurable Connections Between Subagent and Other Processes The IPX SPX Subagent communicates with various processes One or more IPXPROTO processes One or more SNMP agent processes One...

Page 570: ...ocesses named in the startup line and sets the value of their MIB state objects to connected if a connection could be established After startup you can establish additional process connections using Set commands on objects in the zisa group to add processes If you do not set the state of any new process to connected the subagent attempts to establish a connection when its keep alive timer runs dow...

Page 571: ...value called the refresh rate is the frequency at which the subagent refreshes data describing IPXPROTO processes Updating the tdmNwServerTable which can be quite large is the principal factor in CPU time utilization Setting the value of tdmNwSaRefreshNow to forceDynamicRefresh increases CPU time utilization while values are updated Running the subagent with a backup process increases CPU time uti...

Page 572: ...s is connected to or disconnected from the subagent process The tdmNwSaBackupStateReason provides the reason for the value of tdmNwSaBackupState The tdmNwSaSwitchToBackupNow object can be assigned the value forceBackupTakeover to cause the subagent backup process to take over and a new backup process to be created First Failure Data Capture The IPX SPX Subagent is instrumented to send messages to ...

Page 573: ...ition files for any manager from which subagent requests will be sent The MIB definitions are contained in three files Two files contain Novell MIB definitions If Novell definitions are already represented in a manager s MIB view do not install either of the files Otherwise install IPXMIB on managers that will be communicating with SNMP agents provided by various vendors or IPXMIBA on managers tha...

Page 574: ...in startup parameters Refer to Starting and Stopping the Subagent for information on configuration using startup parameters Refer to subsequent subsections for information on settable MIB objects Table 13 1 IPX SPX Subagent Configuration Summary Subagent Attribute Startup Parameter MIB Object Default Value SNMP agent connections a tdmNwSaAgentName tdmNwSaAgentState tdmNwSaAgentStateReason ZSNMP on...

Page 575: ...hich IPXSA resides You can omit it if it is named in your TACL PMSEARCHLIST By default the installation program puts IPXSA into dsv ZIPXPRO subagent process identifies the IPX SPX Subagent process You can specify from one through five alphanumeric characters but the first character must be alphabetic HP suggests that you name the subagent process ZISA If you omit the NAME option the subagent canno...

Page 576: ... 15 Specifying 1 is equivalent to omitting the b startup parameter no backup process is started The integers 0 through 15 identify CPUs If the specified CPU is not available the subagent attempts to start the backup process at the rate specified by the k startup parameter If you do not include the NAME option to name the subagent process the subagent cannot start a backup process After startup you...

Page 577: ...ection set the value of tdmNwSaProtoName to identify an IPXPROTO process To activate or deactivate an IPXPROTO process connection set the value of tdmNwSaIpxProtoState to connected or disconnected respectively keep alive interval specifies how often you want the subagent to try to establish connections with agent IPXPROTO EMS collector or backup processes with which connections have failed The kee...

Page 578: ...which the statistics were last sampled by the subagent To stop the subagent process provide its name in the TACL STOP command STOP ZISA Troubleshooting the Subagent This subsection contains several suggestions for handling problems you might encounter while using the IPX SPX Subagent EMS Event Messages Whenever the subagent behaves unexpectedly or an error condition arises be sure to check for EMS...

Page 579: ... and port conflicts Section 2 Installing and Configuring the SNMP Agent provides complete information on agent startup options Another common cause for startup problems is that a SNMP agent process specified at startup is already in use by another IPX SPX Subagent process Only one IPX SPX Subagent can communicate with a particular agent at any time Timeouts You may experience these kinds of timeou...

Page 580: ... Subagent supports the objects in one of the five groups defined by Novell the ipxSystem group This group contains a table whose entries each represent a single instance of the IPX SPX protocol stack The IPX SPX Subagent supports the objects identified by a check mark in the following list which shows all the groups in Novell s MIB iso 1 org 3 dod 6 internet 1 private 4 enterprises 1 novell 23 mib...

Page 581: ...SaIpxProtoBasicSys Instance in the tdmNwSa IPXPROTONamesTable Assigned by subagent ipxBasicSysExistState 1 3 6 1 4 1 23 2 5 1 1 1 2 read only INTEGER off 1 on 2 The value 0 is always returned Calculated by IPXPROTO process ipxBasicSysNetNumber 1 3 6 1 4 1 23 2 5 1 1 1 3 read only OCTET STRING SIZE 4 The network number portion of the IPX address of this system Calculated by IPXPROTO process ipxBasi...

Page 582: ...ect checksums Calculated by IPXPROTO process ipxBasicSysInDelivers 1 3 6 1 4 1 23 2 5 1 1 1 11 read only Counter The total number of IPX packets delivered locally including packets from local applications Calculated by IPXPROTO process ipxBasicSysNoRoutes 1 3 6 1 4 1 23 2 5 1 1 1 12 read only Counter The number of times no route to a destination was found Calculated by IPXPROTO process ipxBasicSys...

Page 583: ...ly Counter The total number of IPX packets transmitted Calculated by IPXPROTO process ipxBasicSysConfigSockets 1 3 6 1 4 1 23 2 5 1 1 1 17 read only INTEGER The configured maximum number of IPX sockets that can be open at one time Calculated by IPXPROTO process ipxBasicSysOpenSocketFails 1 3 6 1 4 1 23 2 5 1 1 1 18 read only Counter The number of IPX socket open calls that failed Calculated by IPX...

Page 584: ...rds are not taken into account ipxBasicSysInBadChecksums Yes See Table 13 2 ipxBasicSysInDelivers Yes See Table 13 2 ipxBasicSysNoRoutes Yes See Table 13 2 ipxBasicSysOutRequests Partial The value of ipxAdvForwPackets is not taken into account ipxBasicSysOutMalformedRequests See Table 13 2 ipxBasicSysOutDiscards Partial The values of ipxAdvSysOutFiltered and ipxAdvSysOutCompressDiscards are not ta...

Page 585: ...wNCP 4 tdmNwNCPTable 1 tdmNwServer 5 tdmNwServerTable 1 MIB Objects This subsection contains five tables Table 13 4 through Table 13 8 which describe the MIB objects in each of the five zipx tables The zipx tables are indexed by instance identifiers that have corresponding values in the ipxBasicSysTable and the ipxNwSaIPXPROTONamesTable Instance identifiers are assigned by the subagent when new en...

Page 586: ...oPrimaryCPU 4 tdmNwInfoBackupCPU 5 tdmNwInfoIOPortName 6 tdmNwInfoIOPortType 7 tdmNwInfoIOPortAddress 8 tdmNwInfoQIOLimit 9 tdmNwInfoQIOUsage 10 tdmNwInfoResetTime 11 tdmNwInfoSampleTime 12 tdmNwInfoNumberOfOpens 13 tdmNwInfoVersion 14 Table 13 4 tdmNwInfoEntry Objects Supported by the Subagent page 1 of 3 Object and Attributes Definition Description of Value tdmNwInfoEntryInstanceID 1 3 6 1 4 1 1...

Page 587: ...ing Integers of 0 through 15 identify CPUs 1 indicates no backup CPU exists Value obtained using a mechanism equivalent to the SCF INFO PROCESS DETAIL command tdmNwInfoIOPortName 1 3 6 1 4 1 169 3 164 1 1 1 6 read only DisplayString SIZE 0 50 The name of the TLAM port or the SLSA LIF that provides LAN access for the IPXPROTO process line port for TLAM or LIF_name protocol for SLSA obtained using a...

Page 588: ... command with the RESET option YYYY MM DD hh mm ss obtained using a mechanism equivalent to the SCF STATS PROCESS command tdmNwInfoSampleTime 1 3 6 1 4 1 169 3 164 1 1 1 12 read only DisplayString SIZE 0 25 The time at which the statistics were last sampled by the subagent YYYY MM DD hh mm ss tdmNwInfoNumberOfOpens 1 3 6 1 4 1 169 3 164 1 1 1 13 read only Counter The current number of openers of t...

Page 589: ...sCnt 5 tdmNwIPXOpenSocketFailureCnt 6 tdmNwIPXFindRouteFailureCnt 7 tdmNwIPXDroppedCnt 8 tdmNwIPXTotalErrors 9 Table 13 5 tdmNwIPXEntry Objects Supported by the Subagent page 1 of 2 Object and Attributes Definition Description of Value tdmNwIPXEntryInstanceId 1 3 6 1 4 1 169 3 164 2 1 1 1 read only INTEGER The unique identifier of the instance of an IPXPROTO process This value which serves as the ...

Page 590: ... 1 169 3 164 2 1 1 6 read only Counter The number of times an IPX socket was unavailable Integer value obtained using a mechanism equivalent to the SCF STATS PROCESS command tdmNwIPXFindRouteFailureCnt 1 3 6 1 4 1 169 3 164 2 1 1 7 read only Counter The number of times the IPXPROTO process was unable to find a route to the network Integer value obtained using a mechanism equivalent to the SCF STAT...

Page 591: ... tdmNwSPXMaxConn 3 tdmNwSPXMaxResend 4 tdmNwSPXKeepAliveTimer 5 tdmNwSPXInboundPacketCnt 6 tdmNwSPXOutboundPacketCnt 7 tdmNwSPXOpenSocketsCnt 8 tdmNwSPXSendFailureCnt 9 tdmNwSPXBadIncomingPacketCnt 10 tdmNwSPXSuppressedPacketCnt 11 tdmNwSPXTotalErrors 12 Table 13 6 tdmNwSPXEntry Objects Supported by the Subagent page 1 of 3 Object and Attributes Definition Description of Value tdmNwSPXEntryInstanc...

Page 592: ...the remote SPX endpoint Integer value between 1 and 60 obtained using a mechanism equivalent to the SCF INFO PROCESS DETAIL command tdmNwSPXInboundPacketCnt 1 3 6 1 4 1 169 3 164 3 1 1 6 read only Counter The total number of inbound packets received by the SPX layer Integer value obtained using a mechanism equivalent to the SCF STATS PROCESS command tdmNwSPXOutboundPacketCnt 1 3 6 1 4 1 169 3 164 ...

Page 593: ... tdmNwNCPOpenCnt 6 tdmNwSPXBadIncomingPacketCnt 1 3 6 1 4 1 169 3 164 3 1 1 10 read only Counter The number of times SPX received a bad packet Integer value obtained using a mechanism equivalent to the SCF STATS PROCESS command tdmNwSPXSuppressedPacketCnt 1 3 6 1 4 1 169 3 164 3 1 1 11 read only Counter The number of times a connection request has not reached the LAN Integer value obtained using a...

Page 594: ...d using a mechanism equivalent to the SCF STATS PROCESS command tdmNwNCPOutboundPacketCnt 1 3 6 1 4 1 169 3 164 4 1 1 3 read only Counter The total number of outbound packets sent from the NCP layer Integer value obtained using a mechanism equivalent to the SCF STATS PROCESS command tdmNwNCPInboundPacketErrors 1 3 6 1 4 1 169 3 164 4 1 1 4 read only Counter The total number of times the NCP layer ...

Page 595: ...mNwServerInstanceId as Figure 13 4 illustrates The value of the server identifier is derived using the values of the server name address and type objects tdmNwNCPMessageCnt 1 3 6 1 4 1 169 3 164 4 1 1 7 read only Counter The number of times a user request was received by the NCP layer Integer value obtained using a mechanism equivalent to the SCF STATS PROCESS command tdmNwNCPTotalErrors 1 3 6 1 4...

Page 596: ... tdmNwServerName 3 tdmNwServerAddress 4 Figure 13 4 Derivation of tdmNwServerTable Index Values tdmNwServerTable tdmNwSaIPXPROTONamesTable tdmNwSaIpxProtoBasicSysInstance IPXPROT O Process Novell Servers Novell LAN tdmNwServerTable Indexes 2 1 2 2 2 3 RAPTO R D_BEEF 1 2 2 2 2 2 1 3 RAPTOR RAPTOR D_BEEF 0x0000cafe 000000000001 0451 0x0000cafe 000000000001 8060 0xdeadbeef 000000000001 0451 tdmNwServ...

Page 597: ... 6 1 4 1 169 3 164 5 1 1 2 read only INTEGER The unique identifier of the instance of the tuple tdmNwServer Name tdmNwServer Address and tdmNw ServerType This identifier in combination with the value of tdmNw ServerEntryInstanceI dserve as the index to entries in the tdmNwServerTable Assigned by subagent tdmNwServerName 1 3 6 1 4 1 169 3 164 5 1 1 3 read only DisplayString SIZE 0 48 The name of th...

Page 598: ...169 3 164 5 1 1 5 read only INTEGER The type of the server Some well known server types include Unknown 0 User 1 User Group 2 Print Queue 3 File Server 4 Job Server 5 Gateway 6 Print Server 7 Archive Queue 8 Archive Server 9 Job Queue 10 Administration 11 Remote Bridge Server 36 Advertising Print Server 71 NetWare 386 263 HP ODBC Server 1140 HP Telserv Server 1479 reserved by HP 1480 1488 reserved...

Page 599: ...of a subtree named tdmNwSubagent which contains a group and two tables iso 1 org 3 dod 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 zisa 196 tdmNwSubagent 1 tdmNwSaConfig 1 tdmNwSaAgentNamesTable 2 tdmNwSaIPXPROTONamesTable 3 MIB Objects This subsection contains three tables Table 13 9 through Table 13 11 which describe the MIB objects in the group and tables in the tdmNwSubage...

Page 600: ... 6 internet 1 private 4 enterprises 1 tandem 169 nonstopsystems 3 zisa 196 tdmNwSubagent 1 tdmNwSaConfig 1 tdmNwSaProcessName 1 tdmNwSaProcessVersion 2 tdmNwSaProcessPriority 3 tdmNwSaProcessPAID 4 tdmNwSaPrimaryPID 5 tdmNwSaBackupPID 6 tdmNwSaBackupCPU 7 tdmNwSaBackupState 8 tdmNwSaBackupStateReason 9 tdmNwSaSwitchToBackupNow 10 tdmNwSaEmsCollectorName 11 tdmNwSaEmsCollectorState 12 tdmNwSaEmsCol...

Page 601: ...ocess accessor ID PAID of the subagent process group user where group and user have a value from 0 through 255 The value is returned by a PROCESS_GETINFO_ procedure call tdmNwSaPrimaryPID 1 3 6 1 4 1 169 3 196 1 1 5 read only DisplayString SIZE 0 15 The process ID PID of the subagent s primary process cpu pin returned by a PROCESSHANDLE_ GETMINE_ procedure call tdmNwSaBackupPID 1 3 6 1 4 1 169 3 1...

Page 602: ... 1 3 6 1 4 1 169 3 196 1 1 11 read write DisplayString SIZE 0 20 The process name of the EMS collector to which the subagent sends its EMS events system ems collector where system and ems collector are alphanumeric strings starting with a letter The default value is 0 but it can be changed with the c startup parameter or from a manager tdmNwSaEmsCollectorState 1 3 6 1 4 1 169 3 196 1 1 12 read wri...

Page 603: ... pass between subagent accesses of the following tables before the subagent refreshes the table s values ipxBasicSysTable tdmNwInfoTable tdmNwIPXTable tdmNwSPXTable tdmNwNCPTable tdmNwServerTable The value can be set at startup by using the r startup parameter or from a manger The default value is 10 A value of 0 causes the subagent to refresh data values by retrieving new data from an IPXPROTO pr...

Page 604: ... 10 tdmNwSaAgentNamesEntry Objects Supported by the Subagent Object and Attributes Definition Description of Value tdmNwSaAgentName 1 3 6 1 4 1 169 3 196 1 2 1 1 read write DisplayString SIZE 0 20 The name of a SNMP agent process system process tdmNwSaAgentState 1 3 6 1 4 1 169 3 196 1 2 1 2 read write INTEGER disconnected 1 connected 2 The state of the connection between the subagent and the SNMP...

Page 605: ...teReason 4 Table 13 11 tdmNwSaIPXPROTONamesEntry Objects Supported by the Subagent page 1 of 2 Object and Attributes Definition Description of Value tdmNwSaIpxProtoName 1 3 6 1 4 1 169 3 196 1 3 1 1 read write DisplayString SIZE 0 15 The name of the IPXPROTO process system process tdmNwSaIpxProtoBasicSysInstance 1 3 6 1 4 1 169 3 196 1 3 1 2 read only INTEGER The unique identifier of the instance ...

Page 606: ...you do not set the state object associated with a new entry to connected the subagent attempts to establish a connection when its keep alive timer runs down Entries in the zisa group tables cannot be deleted to deactivate an entry set the value of its state object to disconnected Values in the zisa group tables are updated whenever an event occurs that causes them to change tdmNwSaIpxProtoStateRea...

Page 607: ...files are usually located in the ZSPIDEF subvolume of the NonStop Kernel operating system installation volume The Table 13 12 IPX SPX Subagent Event Messages Number Event Standard Event 1001 ZISA EVT SUBAGENT AVAILABLE Object Available 1002 ZISA EVT SUBAGENT UNAVAILABLE Object Unavailable 1003 ZISA EVT AGENT AVAILABLE Object Available 1004 ZISA EVT AGENT UNAVAILABLE Object Unavailable 1005 ZISA EV...

Page 608: ...ibed where they appear in the event message descriptions later in this section CONSTANT ZISA VAL VERSION VALUE VERSION D30 CONSTANT ZSPI SSN ZISA VALUE 196 DEFINITION ZISA VAL SSID TACL SSID 02 z filler TYPE character 8 VALUE is ZSPI VAL TANDEM 02 z owner TYPE ZSPI DDL CHAR8 REDEFINES z filler 02 z number TYPE ZSPI DDL INT VALUE IS ZSPI SSN ZISA 02 z version TYPE ZSPI DDL UINT VALUE is ZISA VAL VE...

Page 609: ...live invalidprocessname incorrectprocessname resourceproblem ZISA TKN REFRESH RATE The refresh interval ZISA TKN KEEPALIVE RATE The keep alive interval ZISA TKN MEM ALLOC SIZE The number of bytes the subagent tried to allocate unsuccessfully Table 13 14 ZSPI Tokens in ZISA Event Messages Token Contents ZSPI TKN MAX FIELD VERSION The latest version of any extensible structured token in the EMS buff...

Page 610: ...RSN SUBAGENT KEEP ZISA VAL CHRSN INVALID PROC ZISA VAL CHRSN INCORR PROC ZISA VAL CHRSN RESOURCE PROB ZISA VAL CHRSN PROCESS STARTED Private enumerations for Transient Fault event 1012 ZISA VAL CR PROCESS STOPPED ZISA VAL CR PROCESS SIGILL ZISA VAL CR PROCESS SIGABRT ZISA VAL CR PROCESS SIGFPE ZISA VAL CR PROCESS SIGSEGV ZISA VAL CR PROCESS SIGSTK ZISA VAL CR PROCESS SIGTIMEOUT ZISA VAL CR PROCESS...

Page 611: ...ted message test or if they contain ZISA defined values The event message text that is generated when the contents of the event message are displayed according to the standard event message template defined in the file ZEMSTMPL n shows where text appears that is derived from a token in the token list For a complete specification of the message examine the standard event templates in SEMSTMPL Descr...

Page 612: ...s is inserted in the message text following reason ZISA VAL STATE DISCONNECTED is the previous state The DDL AS clause of this value disconnected appears in the message text following previous state Unconditional Tokens ZISA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT USER ZISA TKN OBJ STATE ZISA TKN OBJ STATE REASON Valu...

Page 613: ...A TKN OBJ STATE token ZISA VAL reason is one of the following values assigned to the ZISA TKN OBJ STATE REASON token ZISA VAL OPERATOR REQUEST ZISA VAL SUBAGENT KEEPALIVE Cause A subagent process has started successfully Effect The subagent is available for processing requests Recovery Informational message only no corrective action is needed Sample Message 96 01 30 16 50 50 COMM ZISA TANDEM IPXSA...

Page 614: ... the message text following cause ZISA VAL STATE CONNECTED is the previous state The DDL AS clause of this value connected appears in the message text following previous state ZISA VAL STATE DISCONNECTED is the current state The DDL AS clause of this value disconnected appears in the message text following current state Unconditional Tokens ZISA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE RE...

Page 615: ...Object unavailable IPX SPX SNMP subagent process COMM ZISA event number subagent unavailable cause operatorrequest previous state connected current state disconnected user content undefined 1003 ZISA EVT AGENT AVAILABLE The subagent has successfully connected to a SNMP agent process Unconditional Tokens ZISA TKN AGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STA...

Page 616: ... clause of this value disconnected appears in the message text following previous state ZISA VAL STATE CONNECTED is the current state The DDL AS clause of this value connected appears in the message text following current state ZEMS TKN CONTENT USER is assigned the value undefined in the message text following user content ZISA VAL CONNECTED is the value assigned to the ZISA TKN OBJ STATE token ZI...

Page 617: ...ect and the token s value the name of the SNMP agent process are inserted in the message text ZISA EVT AGENT UNAVAILABLE is the event number 1004 The DDL AS clause of this value agent unavailable appears in the message text following event number Unconditional Tokens ZISA TKN AGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT USER ZISA...

Page 618: ...gned the value undefined in the message text following user content ZISA VAL DISCONNECTED is the value assigned to the ZISA TKN OBJ STATE token ZISA VAL reason is one of the following values assigned to the ZISA TKN OBJ STATE REASON token ZISA VAL OPERATOR REQUEST ZISA VAL INVALID PROCESSNAME ZISA VAL INCORRECT PROCESSNAME ZISA VAL RESOURCE PROBLEM Cause The cause depends on the reason for the dis...

Page 619: ...cified a syntactically incorrect value incorrect processname A SNMP agent process was stopped and a non agent process by the same name was started When the subagent attempted to reconnect with the stopped agent process the name of the process running did not identify a SNMP agent process resource problem A SNMP agent process failed Change Reason Recovery operatorrequest No action is required becau...

Page 620: ...llowing DDL AS clauses is inserted in the message text following reason ZISA VAL STATE DISCONNECTED is the previous state The DDL AS clause of this value disconnected appears in the message text following previous state Unconditional Tokens ZISA TKN BACKUP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT USER ZISA TKN OBJ STATE ZISA TKN OB...

Page 621: ...f the following values assigned to the ZISA TKN OBJ STATE REASON token ZISA VAL OPERATOR REQUEST ZISA VAL SUBAGENT KEEPALIVE Cause The subagent s backup process has successfully started Effect If the primary subagent process fails the backup process takes over as the primary subagent process and a new backup process is created Recovery Informational message only no corrective action is needed Samp...

Page 622: ... inserted in the message text following reason ZISA VAL STATE CONNECTED is the previous state The DDL AS clause of this value connected appears in the message text following previous state Unconditional Tokens ZISA TKN BACKUP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT USER ZISA TKN OBJ STATE ZISA TKN OBJ STATE REASON Value 1 IPX SPX ...

Page 623: ...cting the situation depends on the reason for the stoppage Sample Message 96 01 30 16 50 50 COMM ZISA TANDEM IPXSA D30 001006 Object unavailable backup process resource object COMM ZISA event number backup unavailable cause operatorrequest previous state connected current state disconnected user content undefined Change Reason Cause operatorrequest The value of tdmNwSaBackupState object was delibe...

Page 624: ...L AS clauses is inserted in the message text following reason ZISA VAL STATE DISCONNECTED is the previous state The DDL AS clause of this value disconnected appears in the message text following previous state Unconditional Tokens ZISA TKN EMSCOLLECTOR ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT USER ZISA TKN OBJ STATE ZISA TKN OBJ ST...

Page 625: ...ken ZISA VAL reason is one of the following values assigned to the ZISA TKN OBJ STATE REASON token ZISA VAL OPERATOR REQUEST ZISA VAL SUBAGENT KEEPALIVE Cause The subagent has successfully connected with an EMS collector process Effect The subagent can send EMS event messages to the EMS collector process Recovery Informational message only no corrective action is needed Sample Message 96 01 30 16 ...

Page 626: ...ge text following cause ZISA VAL STATE CONNECTED is the previous state The DDL AS clause of this value connected appears in the message text following previous state Unconditional Tokens ZISA TKN EMSCOLLECTOR ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT USER ZISA TKN OBJ STATE ZISA TKN OJB STATE REASON Value 1 EMS collector process nam...

Page 627: ...URCE PROBLEM Cause The cause depends on the reason for the disconnection Effect The subagent cannot send additional EMS events to the EMS collector until a connection is re established Change Reason Cause operatorrequest The value of tdmNwSaEmsCollectorState object for the EMS collector process was deliberately set to disconnected invalid processname A Set operation on tdmNwSaEmsCollectorName spec...

Page 628: ... operatorrequest No action is required because the stoppage was deliberate invalid processname Resubmit the Set request using the correct syntax for a NonStop Kernel process name incorrect processname Start an EMS collector process using a unique process name resource problem Try to set the value of tdmNwSaEmsCollectorState to connected If the operation fails refer to the EMS Manual for other idea...

Page 629: ...he DDL AS clause of this value connected appears in the message text following current state ZEMS TKN CONTENT USER is assigned the value undefined in the message text following user content ZISA VAL CONNECTED is the value assigned to the ZISA TKN OBJ STATE token ZISA VAL reason is one of the following values assigned to the ZISA TKN OBJ STATE REASON token ZISA VAL OPERATOR REQUEST ZISA VAL SUBAGEN...

Page 630: ...bject and the token s value the name of the IPXPROTO process are inserted in the message text ZISA EVT EMSCOLL UNAVAILABLE is the event number 1010 The DDL AS clause of this value ipxproto unavailable appears in the message text following event number Unconditional Tokens ZISA TKN IPXPROTO ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN CONTENT U...

Page 631: ...following values assigned to the ZISA TKN OBJ STATE REASON token ZISA VAL OPERATOR REQUEST ZISA VAL INVALID PROCESSNAME ZISA VAL INCORRECT PROCESSNAME ZISA VAL RESOURCE PROBLEM Cause The cause depends on the reason for the disconnection Token Value DDL AS Clause ZISA VAL CHRSN OPERATOR RQST operatorrequest ZISA VAL CHRSN INVALID PROC invalid processname ZISA VAL CHRSN INCORR PROC incorrect process...

Page 632: ...d the token s value the name of the subagent process are inserted in the message text Change Reason Recovery operatorrequest No action is required because the stoppage was deliberate invalid processname Resubmit the Set request using the correct syntax for a NonStop Kernel process name incorrect processname Resubmit the Set request using the name of an existing IPXPROTO process resource problem Tr...

Page 633: ...gent allocates memory for various operations including responding to SNMP requests and adding a new entry to the tdmNwSaIPXPROTONamesTable the tdmNwSaAgentNamesTable and the tdmNwServerTable Effect The operation could not be completed Recovery Stop the subagent if necessary try using another disk as a swap device If the problem persists contact your service provider and provide all relevant inform...

Page 634: ... trapped appears in the message text following event number ZISA VAL TF PROG characterizes the type of transient fault that occurred The DDL AS clause of this value Internal error appears in the message text following fault type ZEMS TKN CONTENT USER is assigned the value undefined in the message text following user content Unconditional Tokens ZISA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN TXFAU...

Page 635: ...om the message or messages generated Supporting documentation such as EMS logs If your local operating procedures require contacting the GCSC supply your system number and the numbers and versions of all related products as well Sample Message 96 01 30 16 50 50 COMM ZISA TANDEM IPXSA D30 001012 Transient Fault IPX SPX SNMP subagent process COMM ZISA event number process trapped fault type Internal...

Page 636: ...IPX SPX Subagent G Series SNMP Configuration and Management Manual 424777 006 13 74 1012 ZISA EVT PROCESS TRAPPED ...

Page 637: ...nt to be monitored and managed through SNMP The interaction between the SNMP agent the Ethernet Subagent and the TCP IP subsystem whose Ethernet interfaces are being monitored is illustrated in Figure 14 1 Architectural Overview of the Ethernet Subagent on page 14 2 The Ethernet Subagent and Its Managed Resources Each Ethernet Subagent monitors the Ethernet interfaces for one HP TCP IP subsystem W...

Page 638: ...eives and authenticates requests for information regarding Ethernet interfaces SNMP Agent forwards authenticated requests to subagent SNMP Agent responds to requests and also sends traps to manager Subagent gets required information from SLSA subsystem using SRL routines SPI message SNMP request response messages SLSA SRL calls SNMP traps Subagent returns responses and linkUp linkDown Trap message...

Page 639: ... system 1 interfaces 2 at 3 ip 4 icmp 5 tcp 6 udp 7 egp 8 cmot 9 transmission 10 dot3 7 snmp 11 The Ethernet Subagent MIB The Ethernet Subagent MIB supports private MIB objects that Provide information about the subagent process itself such as The name of the subagent process The processor in which the subagent s primary process is running Allow you to control certain aspects of the subagent s beh...

Page 640: ... 1 process objects zesaAgentState 2 zesaProcessName 3 zesaProcessVersion 4 zesaProgramFile 5 zesaProcessPriority 6 zesaProcessGroupID 7 zesaProcessUserID 8 zesaPrimaryCPU 9 zesaPrimaryPIN 10 zesaBackupCPU 11 zesaBackupPIN 12 zesaBackupState 13 zesaSwitchtoBackupNow 14 zesaEmsCollectorName 15 zesaEmsCollectorState 16 zesaKeepAliveTimer 17 zesaRefreshNow 18 zesaRefreshTimer 19 zesaTcpIpProcess 20 ze...

Page 641: ...manager to display the names rather than only numeric object identifiers of MIB objects Once the MIB definition files have been compiled you can start the Ethernet Subagent Before Starting the Ethernet Subagent The SNMP agent must be running before you start the Ethernet Subagent Start the SNMP agent with the RUN command as described in Section 2 Installing and Configuring the SNMP Agent For examp...

Page 642: ...sides You can omit it if ETHSA resides on your current subvolume By default the DSM SCM program puts ETHSA into SYSTEM subvolume identifies the subvolume on which ETHSA resides You can omit it if it is named in your TACL PMSEARCHLIST By default the DSM SCM program puts ETHSA into SYSTEM eth tr subagent process identifies the Ethernet Subagent process You can specify from one through five alphanume...

Page 643: ...imary EMS collector on the local node k keep alive timer specifies the time interval in seconds between attempts by the Ethernet Subagent to reconnect to a TCP IP SNMP agent backup or EMS collector process that is in the disconnected state Note Each of the Ethernet Subagent startup parameters corresponds to one of its private zesa MIB objects as indicated in the following syntax diagram and descri...

Page 644: ... is ZTC0 Stopping the Ethernet Subagent Issue a TACL STOP command to stop an Ethernet Subagent process For example STOP ZESA Initiating Backup Process Takeover The Ethernet Subagent can be run as a process pair to achieve basic fault tolerance The support includes a persistent subagent process and checkpointing of the startup parameters To run the Ethernet Subagent as a process pair and have the b...

Page 645: ...f subagent process zesaProcessName Version of subagent process object file zesaProcessVersion Name of subagent program file zesaProgramFile Current process priority of subagent process zesaProcessPriority Group ID under which subagent was started zesaProcessGroupID User ID under which subagent was started zesaProcessUserID Processor in which the subagent s primary process is running zesaPrimaryCPU...

Page 646: ...rtup parameter With this default value Current process priority of subagent process zesaProcessPriority None determined by operating system Processor in which subagent s backup process is running or will start zesaBackupCPU b 1 no backup process The zesaBackupState object must be set to disabled 3 before the zesaBackupCPU object can be set State of the subagent s backup process zesaBackupState Non...

Page 647: ...tup Rate at which cached values for MIB objects are refreshed zesaRefreshTimer r 60 seconds TCP IP process whose Ethernet interfaces are being monitored zesaTcpIpProcess t ZTC0 on the same node as the subagent zesaTcpIpState must be set to disabled 3 before the zesaTcpIpProcess object can be set State of the connection to the monitored TCP IP process zesaTcpIpState None in normal circumstances val...

Page 648: ...layString SIZE 0 49 The fully qualified NonStop Kernel process name of this subagent node process seq no identifying the process name specified for the TACL NAME option when the Ethernet Subagent was started and the sequence number assigned to the process by the NonStop Kernel zesaProcessVersion 1 3 6 1 4 1 169 3 217 4 read only DisplayString SIZE 0 32 The version of the Ethernet Subagent process ...

Page 649: ...ter After startup the value can be set by an SNMP manager A value of 1 indicates the backup is not configured Setting this object is permitted only if zesaBackupState is set to disabled 3 Once zesaBackupCPU has been set to a new value zesaBackupState must be set to enabled 4 for the new value to take effect zesaBackupPIN 1 3 6 1 4 1 169 3 217 12 read only INTEGER 0 255 The process identification n...

Page 650: ...c startup parameter After startup the value can be set by an SNMP manager Setting this object is permitted only if zesaEmsCollectorState is disabled 3 zesaEmsCollectorState 1 3 6 1 4 1 169 3 217 16 read write INTEGER The state of the connection between the Ethernet Subagent and the EMS collector Following are valid values for the state of the connection connected 1 disconnected 2 disabled 3 enable...

Page 651: ...ER 0 32000 The cache update interval in seconds for MIB objects A value in the range 0 to 32000 specified for the r startup parameter The default is 60 seconds After startup the value can be set by an SNMP manager Value 0 disables cache timing so that updates occur to objects only when zesaRefreshNow is set to forceDynamicRefresh 1 zesaTcpIpProcess 1 3 6 1 4 1 169 3 217 20 read write DisplayString...

Page 652: ...t Subagent and the TCP IP process whose Ethernet interfaces are being monitored The settable values for this object are disabled 3 enabled 4 The following states are set by the subagent to reflect the running state of the TCP IP resource interface connected 1 disconnected 2 zesaSCPProcess 1 3 6 1 4 1 169 3 217 22 read only DisplayString SIZE 0 15 The name of the SCP process used for SPI requests s...

Page 653: ...ubagent State Object Resource Object Pairs The operational state of this resource object Is indicated or controlled by this state object Which may contain one of the following states zesaAgentName zesaAgentState Connected 1 Disconnected 2 zesaBackupCPU zesaBackupPIN zesaBackupState Connected 1 Disconnected 2 Disabled 3 Enabled 4 zesaTcpIpProcess zesaTcpIpState Connected 1 Disconnected 2 Disabled 3...

Page 654: ...scribed in Event Message Descriptions on page 14 33 An SNMP general error is returned if the Ethernet Subagent receives a Set Enabled request against a state object that is in the Connected state Modifying the Value of a Resource Object To modify the value of a resource object 1 Set the value of the resource object s associated state object to Disabled 2 Set the resource object to a new value Figu...

Page 655: ...eTimer object Ethernet Like Statistics dot3Group The Ethernet Subagent supports the dot3StatsTable within the dot3 Ethernet like Statistics group as defined in RFC 1643 Definitions of Managed Objects for the Ethernet like Interface Types iso 1 identified organization 3 dod 6 internet 1 mgmt 2 mib II 1 transmission 10 dot3 7 dot3StatsTable 2 dot3StatsEntry 1 dot3StatsIndex 1 dot3StatsAlighmentError...

Page 656: ...dentified by a particular value of this index is the same interface as identified by the same value of ifIndex for the ifTable that is managed by the TCP IP Subagent This object is supported for E4SA GESA and G4SA It is an integer ranging from 1 to the number of interfaces associated with the TCP IP subsystem This value is updated as each interface associated with the TCP IP subsystem is obtained ...

Page 657: ...StatsType for G4SA dot3StatsSingleCollisionFrames 1 3 6 1 2 1 10 7 2 4 read only Counter Number of successfully transmitted frames on a particular interface for which transmission is inhibited by exactly one collision This object is supported for GESA and G4SA but not for E4SA The value is obtained from the dot3StatsSingle CollisionFrames field of the structure LMCLGESATxStatsType for GESA the Sin...

Page 658: ... structure LMCLGESATxStatsType the multipleCollisionFrames field of the structure LMCLG4SATxStatsType for G4SA For E4SA the value 0 is returned when this object is accessed dot3StatsSQETestErrors 1 3 6 1 2 1 10 7 2 6 read only Counter Number of times a heartbeat error occurred This object is supported for E4SA and G4SA but not for GESA The value is obtained from the TXheartbeat field of the struct...

Page 659: ...redTransmissions of the structure LMCLG4SATxStatsType for G4SA dot3StatsLateCollisions 1 3 6 1 2 1 10 7 2 8 read only Counter Number of frames that had their transmission aborted because a collision occurred before completion of the retry process This object is supported for E4SA GESA and G4SA The value is obtained from the TXlatecol field of the structure LME4SATypeStatsType for E4SA the dot3Stat...

Page 660: ...ect is supported for the E4SA GESA and G4SA The value is obtained from the TXcolfail field of the structure LME4SATypeStatsType for E4SA the dot3StatsExcessiveCollisions field of the structure LMCLGESATxStatsType for GESA the excessiveCollisions field of the structure LMCLG4SATxStatsType for G4SA Table 14 5 dot3StatsTable Objects Supported by Ethernet Subagent page 5 of 7 Object and Attributes Def...

Page 661: ... structure LMCLG4SATxStatsType for G4SA For E4SA the value 0 is returned when this object is accessed dot3StatsCarrierSenseErrors 1 3 6 1 2 1 10 7 2 11 read only Counter Number of frames that had their transmission aborted because carrier sense was lost This object is supported for E4SA GESA and G4SA The value is obtained from the TXcslost field of the structure LME4SATypeStatsType for E4SA the do...

Page 662: ...ong 1 3 6 1 2 1 10 7 2 13 read only Counter Number of frames discarded because the length of the frame was greater than the maximum frame size This object is supported for E4SA GESA and G4SA The value is obtained from the RX2big field of the structure LME4SATypeStatsType for E4SA the dot3StatsFrameTooLong field of the structure LMCLGESARxStatsType for GESA the pktTooLong field of the structure LMC...

Page 663: ...upported for GESA and G4SA dot3StatsSQETestErrors Partial See Table 14 5 dot3StatsSQETestErrors is supported for E4SA and G4SA dot3StatsDeferredTransmissions Yes See Table 14 5 dot3StatsLateCollisions Yes See Table 14 5 dot3StatsExessiveCollisions Yes See Table 14 5 dot3StatsInternalMacTransmitErrors Partial See Table 14 5 dot3StatsCarrierSenseErrors Yes See Table 14 5 dot3StatsFrameTooLongs Yes S...

Page 664: ...atus is UP the subagent gets PIF statistics by issuing the SRL routine LM_Get_Statistics_ on the corresponding PIF The subagent then maps the obtained statistics to the Ethernet MIB tabular objects If the LIF type is Ethernet and the status is STOPPED zeros are assigned to all the Ethernet MIB tabular objects When the refresh timer times out the subagent updates the dot3StatsTable If a SUBNET is d...

Page 665: ...for information on configuring trap destinations The Ethernet Subagent monitors the status of the Ethernet interfaces at the time interval specified in its zesaRefereshTimer object Whenever the status of an Ethernet interface changes the Ethernet Subagent sends a trap The Ethernet Subagent only sends traps to broadcast type trap destinations Table 14 7 describes traps the Ethernet Subagent generat...

Page 666: ...OBJ AVAIL Object Available The configured SNMP agent process zesaAgentName has transitioned into the connected state 3004 AGENT OBJ UNAVAIL Object Unavailable The configured SNMP agent process has transitioned into the disconnected state 3005 BACKUP OBJ AVAIL Object Available The Ethernet Subagent backup process has transitioned into the connected state 3006 BACKUP OBJ UNAVAIL Object Unavailable T...

Page 667: ...CP IP process interface has transitioned from a connected state into a disconnected or disabled state 3011 SRL CALL FAILED Transient Fault A Shared Resource Library SRL call to the SLSA has failed 3012 INTERNAL FAULT Object Unavailable The Ethernet Subagent process has terminated after detecting an internal fault condition 3013 CONFIGURATION INVALID Object Unavailable The startup parameters passed...

Page 668: ...AL NUMBER VALUE 217 CONSTANT ZESA VAL VERSION VALUE VERSION G06 CONSTANT ZESA VAL EXTERNAL SSID VALUE TANDEM 217 G06 DEFINITION ZESA VAL SSID TACL SSID 02 z filler TYPE character 8 VALUE IS ZESA VAL OWNER 02 z owner TYPE ZSPI DDL CHAR8 REDEFINES z filler 02 z number TYPE ZSPI DDL INT VALUE IS ZESA VAL NUMBER 02 z version TYPE ZSPI DDL UINT VALUE IS ZESA VAL VERSION END Table 14 9 ZESA Tokens in ZE...

Page 669: ... examine the message template source file SESATMPL The message templates for standard formatted messages are defined in the EMS Manual Descriptions of listed tokens or values Table 14 10 ZEMS Tokens in ZESA Event Messages Token Contents ZEMS TKN CONTENT STANDARD Type of standard event ZEMS TKN CONTENT USER Type of user defined event for the Ethernet Subagent the value is always ZEMS VAL NULL ZEMS ...

Page 670: ...ing of this token Ethernet SNMP subagent is inserted in the message text following Object available zesaProcessName is the Ethernet Subagent process name specified for the subagent s zesaProcessName MIB object ZESA EVT SUBAGENT AVAIL is the event number 3001 The DDL AS clause of this value subagent process available appears in the message text following event number Unconditional Tokens ZEMS TKN S...

Page 671: ... Because the Ethernet Subagent process has not defined this as a private event the DDL AS clause undefined always appears in the message text following user content Cause The Ethernet Subagent process completed process initialization after initial startup or after a takeover by the backup process Effect The startup configuration or last saved configuration in the case of a takeover by the backup i...

Page 672: ... of this token Ethernet SNMP subagent is inserted in the message text following Object unavailable zesaProcessName is the Ethernet Subagent process name specified for the subagent s private zesaProcessName MIB object Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYMPTOM STRING ZEMS TK...

Page 673: ...cessName is the name of the underlying process whose failure caused the Ethernet Subagent process to go out of service The name of the Ethernet Subagent process specified in the subagent s private zesaProcessName MIB object is inserted in the message text following underlying object This information is displayed only if the value of the ZEMS TKN CHANGE REASON is ZEMS VAL UNDERLYING FAILED Value of...

Page 674: ...gent Otherwise contact your service provider and provide all relevant information as follows Descriptions of the problem and accompanying symptoms The saveabend file if generated Details from the message or messages generated Supporting documentation such as Event Management Service EMS logs If your local operating procedures require contacting the GCSC supply your system number and the numbers an...

Page 675: ...UNDERLYING UP indicates the reason the SNMP agent process has become available The DDL AS clause associated with this value underlying serv up is inserted in the message text following reason indicating that the interface with the SNMP agent process is available because an underlying resource on which it depends has become available Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN AGENT ZEMS TK...

Page 676: ...appears in the message text following user content Cause The Ethernet Subagent reacquired its connection to the configured SNMP agent process Effect Requests can now be made against the MIB objects supported by the Ethernet Subagent Recovery Informational message only no corrective action is needed Sample Message 98 07 08 12 21 51 NOVA ZESA TANDEM ETHSA G06 003003 Object available agent interface ...

Page 677: ...reason the SNMP agent process has become unavailable The DDL AS clause underlying serv failed is inserted in the message text following cause indicating that an underlying service on which the SNMP agent depends has failed Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN AGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN UNDERLYING OBJ NAME...

Page 678: ...nternal context text indicates where in the subsystem or application code the fault occurred ZEMS VAL NULL indicates the type of subsystem defined event Because the Ethernet Subagent process has not defined this as a private event the DDL AS clause undefined always appears in the message text following user content Cause The Ethernet Subagent lost its connection to the configured SNMP agent proces...

Page 679: ...ng of this token backup process is inserted in the message text following Object available zesaProcessName is the Ethernet Subagent process name specified for the subagent s private zesaProcessName MIB object ZESA EVT BACKUP OBJ AVAIL is the event number 3005 The DDL AS clause of this value backup process available appears in the message text following event number Unconditional Tokens ZEMS TKN SU...

Page 680: ... message text following user content Value of ZEMS TKN CHANGE REASON Associated Text DDL AS Clause and Meaning ZEMS VAL UNDERLYING UP underlying serv up indicates that the backup Ethernet Subagent process is available because an underlying resource on which it depends has become available ZEMS VAL OPERATOR INITIATED operator initiated indicates that an operator has brought the backup Ethernet Suba...

Page 681: ... checkpointed configuration Recovery Informational message only no corrective action is needed Sample Messages 98 07 08 11 31 36 NOVA ZESA TANDEM ETHSA G06 003005 Object available backup process NOVA ZESA 384566222 event number backup process available reason underlying serv up previous state disconnected current state connected user content undefined 98 07 08 11 30 55 NOVA ZESA TANDEM ETHSA G06 0...

Page 682: ...06 The DDL AS clause of this value backup process unavailable appears in the message text following event number Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN BACKUP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYMPTOM STRING ZEMS TKN USER CONTENT Value 1 ZESA TKN BACKUP 2 zesaProcessName 3 ZESA EVT BACKUP OBJ UNAVAIL 4 ZEMS VAL reason 5...

Page 683: ... is displayed only if the value of the ZEMS TKN CHANGE REASON is ZEMS VAL UNDERLYING FAILED code location internal context text indicates where in the subsystem or application code the fault occurred Value of ZEMS TKN CHANGE REASON Associated Text DDL AS Clause and Meaning ZEMS VAL UNDERLYING FAILED underlying serv failed indicates that an underlying service on which the backup Ethernet Subagent p...

Page 684: ... If it is not available or there are insufficient resources to run a backup process disable the backup set zesaBackupState Disabled 3 set the zesaBackupCPU to an available processor and reenable the backup set zesaBackupState Enabled 4 Sample Message 98 07 08 30 54 34 NOVA ZESA TANDEM ETHSA G06 003006 Object unavailable backup process NOVA ZESA 384566222 event number backup process unavailable cau...

Page 685: ...S clause associated with this value is inserted in the message text following reason Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN EMSCOLLECTOR ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN USER CONTENT Value 1 ZESA TKN EMSCOLLECTOR 2 zesaEmsCollectorName 3 ZESA EVT EMSCOLL AVAIL 4 ZEMS VAL reason 5 ZESA VAL STATE state 6 ZESA VAL STATE C...

Page 686: ...ntent Cause The subagent acquired or reacquired its connection to the configured EMS collector process zesaEmsCollectorName Effect Subsequent events generated by the subagent will be sent to the configured EMS collector Recovery Informational message only no corrective action is needed Value of ZEMS TKN STATE PREVIOUS Associated Text DDL AS Clause ZESA VAL STATE CONNECTED connected indicates a nor...

Page 687: ...fied for the subagent s private zesaEmsCollectorName MIB object ZESA EVT EMSCOLL UNAVAIL is the event number 3008 The DDL AS clause of this value emscollector interface unavailable appears in the message text following event number Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN EMSCOLLECTOR ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYM...

Page 688: ...or process specified for the subagent s private zesaEmsCollectorName MIB object is inserted in the message text following underlying object Value of ZEMS TKN CHANGE REASON Associated Text DDL AS Clause and Meaning ZEMS VAL UNDERLYING FAILED underlying serv failed indicates that an underlying service on which the interface with the EMS collector process depends has failed ZEMS VAL OPERATOR INITIATE...

Page 689: ...MS collector interface is returned to a connected state The subagent attempts to reacquire the EMS collector connection whenever the subagent attempts to generate an event message and based at the rate indicated by its zesaKeepAliveTimer object Recovery Check the operating state of the EMS collector process zesaEmsCollectorName Sample Messages 98 07 08 11 31 35 NOVA ZESA TANDEM ETHSA G06 003008 Ob...

Page 690: ...d with this value is inserted in the message text following reason Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN TCPIP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN USER CONTENT Value 1 ZESA TKN TCPIP 2 zesaTcpIpProcess 3 ZESA EVT TCPIP OBJ AVAIL 4 ZEMS VAL reason 5 ZESA VAL STATE state 6 ZESA VAL STATE CONNECTED 7 ZEMS VAL NULL Condition...

Page 691: ...are rebuilt using SPI responses from the TCP IP process zesaTcpIpProcess When the update sequence is complete as indicated by zesaRefreshNow value autoDynamicRefresh 0 SNMP requests made against the MIB objects will return current values Recovery Informational message only no corrective action is needed Value of ZEMS TKN STATE PREVIOUS Associated Text DDL AS Clause ZESA VAL STATE CONNECTED connect...

Page 692: ... EVT TCPIP OBJ UNAVAIL ZESA TKN TCPIP identifies the subject of the event the TCP IP process The DDL heading of this token tcpip resource is inserted in the message text following Object unavailable Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN TCPIP ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYMPTOM STRING ZEMS TKN USER CONTENT Value ...

Page 693: ... process whose failure caused the interface between the Ethernet Subagent and the TCP IP process to go out of service The name of one of the following processes is inserted in the message text following underlying object Value of ZEMS TKN CHANGE REASON Associated Text DDL AS Clause and Meaning ZEMS VAL UNDERLYING FAILED underlying serv failed indicates that an underlying service on which the TCP I...

Page 694: ... the SNMP agent process zesaAgentName If the underlying object is the SNMP agent process zesaAgentName the subagent has lost its connection to the agent process and has temporarily disconnected the TCP IP interface to conserve resources Effect Values for the MIB objects supported by the Ethernet Subagent are not computed SNMP requests for these MIB objects receive an SNMP ERR GEN ERROR response Pr...

Page 695: ...ause underlying serv failed previous state connected current state disconnected underlying object NOVA ZSNMP symptom string T0326G06_25JUN98_ETHSA user content undefined 3011 ZESA EVT SRL CALL FAILED ZESA TKN SUBAGENT identifies the subject of the event the Ethernet Subagent process The DDL heading of this token Ethernet SNMP subagent is inserted in the message text following Transient Fault Uncon...

Page 696: ... internal context text indicates where the fault occurred ZEMS VAL NULL indicates the type of subsystem defined event Because the Ethernet Subagent process has not defined this as a private event the DDL AS clause undefined always appears in the message text following user content Cause A shared resource library SRL call failed Effect Old values in the MIB are retained and the MIB does not get ref...

Page 697: ...sage text following event number ZEMS VAL INTERNAL FAILED indicates that an internal error was encountered The DDL AS clause associated with this value internal failed is inserted in the message text following cause Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASON ZEMS TKN STATE PREVIOUS ZEMS TKN STATE CURRENT ZEMS TKN SYMPTOM STRING ZEMS TKN...

Page 698: ... DDL AS clause undefined always appears in the message text following user content Cause The Ethernet Subagent internal consistency checking logic has detected a program logic error Effect The Ethernet Subagent terminates Recovery Contact your service provider and provide all relevant information as follows Descriptions of the problem and accompanying symptoms The saveabend file if generated Detai...

Page 699: ...available zesaProcessName is the Ethernet Subagent process name specified for the subagent s private zesaProcessName MIB object ZESA EVT CONFIGURATION INVALID is the event number 3013 The DDL AS clause of this value startup configuration invalid appears in the message text following event number Unconditional Tokens ZEMS TKN SUBJECT MARK ZESA TKN SUBAGENT ZEMS TKN EVENTNUMBER ZEMS TKN CHANGE REASO...

Page 700: ...startup params ZEMS VAL NULL indicates the type of subsystem defined event Because the Ethernet Subagent process has not defined this as a private event the DDL AS clause undefined always appears in the message text following user content Cause The startup parameters passed to the subagent process contain invalid definitions or the specified agent process was not found Effect The Ethernet Subagent...

Page 701: ...r the subagent primary role using the last known configuration parameters Any transactions that were in progress at the time of the primary failure are lost The new primary attempts to restart a backup process in the former primary processor according to the zesaKeepAliveTimer interval Recovery If the cause was a processor failure change the backup processor zesaBackupCPU to a currently active pro...

Page 702: ...events translated into traps by the EMS Trap Subagent The EMS Subagent uses an event filter known as a routing distributor to determine where to route trap messages The filter contains a destination statement that identifies the SNMP agent as the routing destination The filter can also contain specifications for selecting events to convert into traps Refer to Section 9 EMS Trap Subagent for more i...

Page 703: ... Part V Appendices Part V consists of the following appendices which provide reference information Appendix A SCF Command Syntax Summary for the NonStop Agent Appendix B SCF Error Messages for the NonStop Agent Appendix C Unsolicited SNMP Agent Messages ...

Page 704: ...Part V Appendices SNMP Configuration and Management Manual 424777 006 ...

Page 705: ...ault PROCESS with the ASSUME PROCESS command you can omit the NonStop agent process name and period and just specify object name For example ASSUME PROCESS ZSNMP INFO ENDPOINT END1 STATUS ENDPOINT END1 ABORT Command The ABORT command causes the specified object configuration to become inactive The object is not available for use by the NonStop agent until it is restarted This is a sensitive comman...

Page 706: ...n object This is a sensitive command ENDPOINT Object PROCESS Object ADD ENDPOINT agent process endpoint name NETWORK node tcpip process HOSTADDR ip address ADD PROFILE agent process profile name COMMUNITY community name HOSTADDR ip address ACCESS READONLY READWRITE ADD TRAPDEST agent process trapdest name COMMUNITY community name NETWORK node tcpip process HOSTADDR ip address ALTER ENDPOINT agent ...

Page 707: ...INFO Command The INFO command displays the current attribute values for an object This is a nonsensitive command ENDPOINT Object ALTER PROFILE agent process profile name COMMUNITY community name HOSTADDR ip address ACCESS READONLY READWRITE ALTER TRAPDEST agent process trapdest name COMMUNITY community name NETWORK node tcpip process HOSTADDR ip address DELETE ENDPOINT agent process endpoint name ...

Page 708: ... Command The START command activates an object for use in a NonStop agent operations environment This is a sensitive command ENDPOINT Object PROFILE Object TRAPDEST Object INFO PROCESS agent process SUB NONE ALL ONLY DETAIL INFO PROFILE agent process profile name DETAIL INFO TRAPDEST agent process trapdest name DETAIL NAMES PROCESS agent process SUB NONE ALL ONLY START ENDPOINT agent process endpo...

Page 709: ...t STOP Command The STOP command causes an object to become inactive The object is not available for use by the NonStop agent until it is restarted This is a sensitive command ENDPOINT Object PROFILE Object TRAPDEST Object STATUS ENDPOINT agent process endpoint name STATUS PROCESS agent process SUB NONE ALL ONLY STATUS PROFILE agent process profile name STATUS TRAPDEST agent process trapdest name S...

Page 710: ...S command or stops a previously requested trace operation This is a sensitive command PROCESS Object VERSION Command The VERSION command displays the version number product name product number and release date of the NonStop agent product This is a nonsensitive command PROCESS Object TRACE PROCESS agent process STOP trace option trace option is COUNT count PAGES pages RECSIZE size SELECT METHOD 3 ...

Page 711: ...For example SCF E20211 Invalid object type Common Error Messages SCF provides a pool of error messages called common errors that can be used by all subsystems These errors always have negative error numbers Each error message is preceded by the name of the subsystem in which the error is encountered and a single character type code E for critical or W for noncritical For example SNMP E 00005 Comma...

Page 712: ...effect and recovery information for this error is provided later in this appendix The error number is a positive number Example of a Common Error In contrast the following error can also be returned by the NonStop agent but the error number and text is common to all subsystems using SCF Many other subsystems might use this same 00005 error number and text The error number is a negative number Type...

Page 713: ...pply the following information If the error caused SCF to terminate reenter SCF 1 Enter a LOG command to collect the following displays into a single file for example LOG PROBLEM 2 Enter a LISTPM command to collect information about the product versions of the SCF components a list of the product modules on your system and information about any product modules running when the error occurred LISTP...

Page 714: ...retry the ADD or ALTER command First STOP and DELETE or STOP and ALTER the existing ENDPOINT object whose configuration you want to override SNMP Error 00002 Cause You tried to define a PROFILE object with the same COMMUNITY attribute value as an existing PROFILE object definition Two PROFILE objects cannot define the same community Effect The ADD or ALTER command is not executed Recovery Either R...

Page 715: ...ic Internet address SNMP Error 00006 Cause You attempted to start an object but a resource on which the object relies is not available Effect If you were trying to start a TRAPDEST object the object enters the STARTING state The NonStop agent cannot send traps to the trap destination until the underlying resource becomes available Each time the NonStop agent receives or generates a trap it attempt...

Page 716: ...sponding file system error number Then refer to the Guardian Procedure Errors and Messages Manual for a description of file system errors and possible recovery actions SNMP Error 00009 Cause You tried to define an invalid dotted decimal format Internet address for the HOSTADDR attribute Effect The ADD or ALTER command is not executed Recovery Redefine the object and specify a valid Internet addres...

Page 717: ...rap Destinations on page 2 38 Table C 1 Traps Generated by SNMP Agent Generic Trap Type Reason for Generating Trap authenticationFailure The SNMP agent received a request that could not be authenticated for one or more of these reasons The request is associated with a community not configured into the authentication table The request originates from an address not defined for a configured communit...

Page 718: ...l program fault was detected 003 STATE CHANGE The state of a SNMP agent object changed 004 OSS ERROR The SNMP agent process was unable to either decode an SNMP request or encode an SNMP response 005 SOCKET ERROR An error occurred when the SNMP agent was communicating with HP TCP IP software through the sockets library 006 EVT CONFIG ERROR The SNMP agent was started with an incorrect configuration ...

Page 719: ...ogram FUP to give ownership of the SNMP agent program file SNMPAGT to a super group user Then secure the program file so that a user who is not a super group user can execute it and set the PROGID so that the owner ID of SNMPAGT is used as the creator accessor ID when the program is run Alternatively a user who is not a super group user can restart the SNMP agent if the PORT startup parameter is a...

Page 720: ...nds and lets the backup take over Recovery Contact your service provider and provide all relevant information as follows Descriptions of the problem and accompanying symptoms Details from the message or messages generated Supporting documentation such as Event Management Service EMS logs and the Saveabend file of the affected process If your local operating procedures require contacting the HP Glo...

Page 721: ...ecific location within the function OSS function name is the name of an Open Systems Solutions Inc OSS ASN 1 function used to encode and decode SNMP messages This function called by method name generated the error OSS err num is an encoding or decoding error returned by the specified function For values see Table C 3 Cause One of the errors listed in Table 6 3 was returned to the SNMP agent by an ...

Page 722: ...e for encoding 1 No The user provided output buffer is too small This error can be an encoding or decoding error 2 Yes An invalid encoding value was passed This error can be an encoding or decoding error 3 Yes A protocol data unit PDU number passed to the encoder has no corresponding PDU number generated by the ASN 1 compiler This error can be an encoding or decoding error 4 No The input data cont...

Page 723: ...No A bad OBJECT IDENTIFIER was encountered The first element must be 0 ccit 1 iso or 2 joint iso ccit The second element must be 0 standard 1 registration authority 2 member body or 3 identified organization 11 Yes An unexpected NULL pointer was passed to the encoder 12 Yes A value having more than the allowed precision was found in a time type 13 Yes A type with a length or count field before it ...

Page 724: ...e to a socket error mnemonic Then consult the TCP IP and IPX SPX Programming Manual to interpret the socket error If necessary contact your service provider and provide all relevant information as follows Descriptions of the problem and accompanying symptoms Details from the message or messages generated The socket error mnemonic to which socket err num translated Supporting documentation such as ...

Page 725: ...AD IPC PDU RCVD process name identifies a subagent process function name is the name of a function used internally by the SNMP agent location number is a numeric identifier for a specific location within the function explanatory text is information describing the problem Cause A subagent constructed and sent the SNMP agent an interprocess communication IPC PDU that the agent cannot decode This pro...

Page 726: ... contained decodable but erroneous data Effect The SNMP agent discards the message Recovery The manager developer must check the construction of the PDU 012 ZSMP EVT NO SUCH TRAPDEST trapdest name is the name of the trap destination process name is the name of the subagent process Cause A subagent process tried to send a trap to a trap destination that was not configured within the SNMP agent Effe...

Page 727: ...loper needs to correct the problem and then restart the agent 014 ZSMP EVT GUARDIAN ERROR method name is the name of a function used internally by the SNMP agent location number is a numeric identifier for a specific location within the function explanatory text is information including the Guardian procedure the returned error and in some cases a brief descriptive text Cause A Guardian procedure ...

Page 728: ...c procedure and returned error number If necessary contact your service provider and provide all relevant information as follows Descriptions of the problem and accompanying symptoms Details from the message or messages generated Supporting documentation such as Event Management Service EMS logs and the Saveabend file of the affected process If your local operating procedures require contacting th...

Page 729: ...or more SNMP managers agent process The process that represents an instance of the running SNMP agent ALRFMT The object file that the ZNFMT process uses to format Syshealth problem report alarm data into readable text application layer The layer in the Internet suite of protocols that describes end user service technologies ASN 1 See Abstract Syntax Notation One authentication The process of deter...

Page 730: ...g a community SNMP messages always contain a community name If the community name corresponds to a community known to the receiving SNMP entity the receiving entity accepts the message connection A logical binding between two or more users of a service Also the path between two protocol modules that provides reliable stream delivery service connectionless Characterized by the absence of logical co...

Page 731: ...ternal representation of an Internet address comprising the ASCII value of each of the four octets separated by periods for instance 133 50 85 43 Each octet value is a number in the range 0 to 255 inclusive expressed either in decimal with no prefix or in hexadecimal preceded by the characters 0X with X in either uppercase or lowercase letters For example two other valid ways to express this examp...

Page 732: ...ols and interfaces that provide event message collection and distribution on NonStop systems Exterior Gateway Protocol A reachability protocol used by gateways in a two level internet filter An EMS object that distributors can be configured to use to select events to route filterManagement group A table of entries in the ONS MIB used to inhibit traps for an entire subsystem or for a particular eve...

Page 733: ...es the value of the next instance of a MIB object It could access the next object in the MIB or it could access the next entry in a MIB table GetNextRequest PDU An SNMP PDU used to issue a GetNext request GetRequest PDU An SNMP PDU used to issue a Get request GetResponse PDU An SNMP PDU used to respond to Get GetNext and Set requests heterogeneous Consisting of components following different proto...

Page 734: ...largest internet in existence Internet A large collection of connected networks that use the Internet suite of protocols and function as a single cooperative virtual network The Internet provides universal connectivity and three levels of network service unreliable connectionless packet delivery reliable full duplex stream delivery and application level services like electronic mail that build on ...

Page 735: ...t Protocol IP group The group in MIB II supported by the TCP IP Subagent that provides information about the IP layer of a TCP IP subsystem being managed LAN See local area network leaf In an object tree a node without subordinates lexicographic ordering The ordering exhibited by object identifiers which are expressed as integers Lexicographic ordering extends to object instance identifiers since ...

Page 736: ...ed nodes manager station A device on which a manager runs management process A process through which an application issues commands to a subsystem A management process can be part of a subsystem or it can be associated with more than one subsystem in the latter case the management process is logically part of each subsystem MIB See Management Information Base MIB II The current standard for the co...

Page 737: ...agents network management variable A MIB object Network Operation Console The system responsible for managing one or more nodes on an internet network nnm group A group of scalar objects in the NonStop NET MASTER Trap MIB that is used as variable bindings in the traps created from NonStop NET MASTER events NMMTRAP An NCL procedure of the NonStop NET MASTER Trap Subagent which contains procedures f...

Page 738: ...d for HP problem management products ONSDB The Enscribe file that contains the ONS statistics database ONSFLTOA The event filter file for the ZNSDES distributor process ONSFLTOG The event filter file for the ZNSDG distributor process ONSFLTOS The event filter file for the ZONS remote operations ONS Trap Subagent The SNMP subagent that collects EMS events from the HP system event log 0 and translat...

Page 739: ...DWRITE proprietary A protocol suite controlled by a vendor and developed so that the vendor s computers can communicate with each other protocol A set of rules used by computers to communicate with each other protocol data unit A unit of information encoded according to specific protocol rules usually containing both protocol control and user data The five PDUs supported by the SNMP agent are GetR...

Page 740: ... associate it with the previous PDU and provide information about the status of the response error codes error status and a list of additional information RFC See Request for Comments RMS See Rule Management Services root The unlabeled top of an object tree routing distributor filter An event filter used by the EMS Trap Subagent to specify where to route trap messages The filter contains a destina...

Page 741: ...P IP based internets SNMP is the most widely used network management protocol in the industry SLSA See ServerNet LAN Systems Access SLSA subsystem SNMP See Simple Network Management Protocol SNMP agent See Agent SNMPAGT The name of the executable file for the SNMP agent SNMP control file A file named SNMPCTL in which the SNMP agent maintains values for its current configuration and persistent MIB ...

Page 742: ...control and collect information about many SNMP subsystems SCF is the primary configuration management facility for the SNMP agent Subsystem Control Point A process through which management applications including SCF control subsystems Subsystem Programmatic Interface A set of procedures and associated definition files and a standard message protocol used to define common message based interfaces ...

Page 743: ...P manager This trap has values for all eight objects defined in the EMS Trap MIB TLAM See Tandem LAN Access Method token In SPI a distinguishable unit in an SPI message The SNMP agent and subagents use values supplied in tokens to derive MIB object values Transmission Control Protocol The Internet standard transport protocol that provides a reliable full duplex connection oriented stream service u...

Page 744: ...IB II supported by the TCP IP Subagent that provides information about the UDP layer of a TCP IP subsystem being managed User Datagram Protocol The internet standard protocol that allows an application program on one machine to send a datagram to an application program on another machine UDP uses the Internet protocol to deliver datagrams The important difference between UDP and IP is that UDP mes...

Page 745: ... s private MIB that describes request response connections between the SNMP agent and SNMP managers zagInProcess group The group in the SNMP agent s private MIB that provides information about the SNMP agent s process objects zagInProfile group The group in the SNMP agent s private MIB that defines the criteria the SNMP agent uses to determine whether to accept or reject incoming requests from SNM...

Page 746: ...ly high levels ZHRMTMPL The name of the file containing the compiled EMS message template used by the Host Resources Subagent to format event messages it generates for display zhrmTrapDeviceStateChange trap A trap generated by the Host Resources Subagent that identifies a CPU printer disk network device or tape drive that might require operator attention ZSMPMIB The file that defines the objects c...

Page 747: ...t name 4 13 TRAPDEST object name 4 17 Attribute conflicts 5 2 between NonStop agent configurations 5 2 COMMUNITY SCF error 00002 5 2 B 4 Attribute conflicts continued HOSTADDR SCF error 00001 5 2 B 4 See also individual object entries SUBSYS SCF error 00003 5 2 within a subsystem configuration 5 2 Attributes ACCESS PROFILE object 5 9 COMMUNITY PROFILE object 5 8 TRAPDEST object 5 11 displaying cur...

Page 748: ...ontinued configuring through SNMP 3 30 example of configuring multiple host request response connections 2 37 example of configuring multiple host trap connections 2 44 example of configuring single host request response connections 2 36 example of configuring single host trap connections 2 42 managing configuration definitions through SNMP 2 18 3 35 prerequisites 2 1 request response connections ...

Page 749: ...ynamically generated TRAPDEST objects 4 18 5 12 E EMS See Event Management Service EMS collector configuring for NonStop agent 4 5 5 15 EMS filters compiling 7 4 creating 7 3 EMS filters continued example of compilation 7 4 example source code 7 3 for troubleshooting 7 2 ems group trapContentStandard 9 14 10 16 trapCritical 9 16 10 18 trapEventNumber 9 13 10 15 trapGenerationtime 9 15 10 17 trapPr...

Page 750: ...numbered SCF generated B 1 SCF 4 24 5 2 B 1 B 6 See also Attribute conflicts and individual message entries subsystem generated B 1 error return code from closeagent procedure 10 20 error return code from openagent call 10 18 error return code from sendtrap procedure 10 19 Error status badValue 7 6 genErr 7 6 noSuchName 7 6 tooBig 7 6 Ethernet Token Ring Subagent backup takeover 14 8 converting ev...

Page 751: ...PDU 1 7 GetResponse PDU 1 8 Guardian error in method C 11 H HELP command 4 24 B 3 Help facility SCF 4 24 4 25 SCF error message help B 3 Heterogeneous Glossary 5 HMSAINI 11 15 Host Resources Subagent agent process name 11 14 architectural overview 11 1 configuration 11 10 controlling processes and devices in MIB 11 15 disabling software groups 11 21 dynamic object refresh rate 11 14 enabling Guard...

Page 752: ...01 5 2 B 4 ENDPOINT object 4 8 Internet address invalid SCF error 00009 B 6 invalid wildcard specification SCF error 00005 B 5 PROFILE object 4 12 TRAPDEST object 4 16 hrDevice group hrDeviceDescr 11 40 hrDeviceErrors 11 41 hrDeviceID 11 40 hrDeviceIndex 11 39 hrDeviceStatus 11 41 hrDeviceTable 11 39 hrDeviceType 11 39 hrDiskStorageAccess 11 43 hrDiskStorageCapacity 11 44 hrDiskStorageMedia 11 44 ...

Page 753: ...orLoad 11 42 hrProcessorTable 11 41 hrStorage group hrMemorySize 11 30 hrStorageAllocationFailures 11 32 hrStorageAllocationUnits 11 31 hrStorageDescr 11 31 hrStorageIndex 11 30 hrStorage group continued hrStorageSize 11 32 hrStorageTable 11 30 hrStorageType 11 30 hrStorageUsed 11 32 RFC compliance 11 34 value maintenance 11 34 hrStorageAllocationFailures 11 32 hrStorageAllocationUnits 11 31 hrSto...

Page 754: ...enchs 8 53 icmpInTimeExcds 8 53 icmpInTimestampReps 8 53 icmpInTimestamps 8 53 icmpOutDestUnreachs 8 54 icmpOutEchoReps 8 55 icmpOutEchos 8 54 ICMP group continued icmpOutErrors 8 54 icmpOutMsgs 8 53 icmpOutParmProbs 8 54 icmpOutRedirects 8 54 icmpOutSrcQuenchs 8 54 icmpOutTimeExcds 8 54 icmpOutTimestampReps 8 55 icmpOutTimestamps 8 55 RFC compliance 8 55 icmpInDestUnreachs 8 52 icmpInEchoReps 8 5...

Page 755: ...s 2 6 NonStop NET MASTER Trap Subagent dependencies 10 3 steps 10 4 TCP IP Subagent 8 11 Trap Multiplexer Installation continued dependencies 12 4 steps 12 4 Instance Glossary 6 Interface layer Glossary 6 Interfaces group ifDescr 8 32 ifIndex 8 31 ifInDiscards 8 35 ifInErrors 8 35 ifInNUcastPkts 8 35 ifInOctets 8 35 ifInUcastPkts 8 35 ifInUnknownProtos 8 36 ifLastChange 8 35 ifMtu 8 33 ifNumber 8 ...

Page 756: ...pReasmFails 8 44 ipReasmOKs 8 43 ipReasmReqds 8 43 ipRouteDest 8 45 ipRouteIfIndex 8 45 ipRouteInfo 8 47 ipRouteMask 8 47 IP group continued ipRouteMetric1 5 8 46 ipRouteNextHop 8 46 ipRouteproto 8 47 ipRouteType 8 46 RFC compliance 8 48 ipAddrTable maintenance 8 50 ipAdEntAddr 8 44 ipAdEntBcastAddr 8 45 ipAdEntIfIndex 8 44 ipAdEntNetMask 8 44 IPC interface to NonStop agent 1 3 1 9 2 3 2 9 2 10 3 ...

Page 757: ...tion 13 9 MIB objects 13 4 Novell MIB Objects 13 18 overview 13 2 refresh interval 13 15 resetting counters 13 16 RFC compliance 13 10 standard EMS tokens 13 47 standard SPI tokens 13 47 starting 13 13 IPX SPX Subagent continued startup parameters 13 12 startup problems 13 16 state reason object 13 8 stopping 13 16 subsystem ID 13 46 tdmNwInfo group 13 4 tdmNwIPX group 13 4 tdmNwNCP group 13 5 tdm...

Page 758: ...top agent SNMP group 3 6 System group 3 3 Modifying table row entries 3 30 N NAME run option for Host Resources Subagent 11 13 for NonStop agent 2 8 for Trap Multiplexer 12 7 NAMES command objects for which supported 5 1 syntax 5 25 NCL See Network Control Language NETWORK attribute ENDPOINT object 4 8 TRAPDEST object 4 16 Network Control Language 10 1 Glossary 8 Network element Glossary 9 Network...

Page 759: ...iguration 10 9 EMS Trap MIB 10 14 EMSMIBA 10 3 GENTRAP 10 3 installation 10 3 messages 10 18 NMMTRAP 10 3 NonStop NET MASTER Trap Subagent continued RFC compliance 10 3 starting 10 13 stopping 10 13 TESTSEND 10 3 trap PDU 10 14 NonStop TCPIPv6 8 16 NonStop TCP IP 8 4 8 15 NonStop TCP IPv6 2 23 8 1 Nonstop TCP IPv6 2 11 2 14 not accessible Glossary 9 Novell MIB definitions 13 11 null object defined...

Page 760: ...llustration 4 11 PROCESS object 4 6 5 30 PROCESS object state transition illustration 4 7 PROFILE object 4 14 5 31 PROFILE object state transition illustration 4 15 STARTED state ENDPOINT object 4 9 5 26 PROCESS object 4 6 5 29 Object states continued PROFILE object 4 14 5 30 TRAPDEST object 4 17 5 31 STARTING state ENDPOINT object 4 10 5 26 PROCESS object 4 4 TRAPDEST object 4 17 5 31 STOPPED sta...

Page 761: ...5 8 5 10 ALTER command 5 16 attribute conflict SCF error 00002 5 2 B 4 COMMUNITY attribute 4 12 default object definition 4 14 default values 2 29 defined 4 12 DELETE command 5 19 HOSTADDR attribute 4 12 PROFILE object continued INFO command 5 23 invalid wildcard specification in HOSTADDR B 5 naming conventions 4 12 START command 5 26 state transition illustration 4 15 states 4 14 5 30 5 31 STATUS...

Page 762: ...or TCP group 8 60 for UDP group 8 63 RFC1514 11 9 RFC1514A 11 9 RMS See Rule Management Services Root on object tree 1 10 RowStatus Value Definitions 3 24 Rule Management Services Glossary 13 RUN command for starting Host Resources Subagent 11 13 for starting NonStop agent 2 14 for starting TCP IP Subagent 8 12 for starting Trap Multiplexer 12 6 role in troubleshooting 7 5 used to start PTrace 6 3...

Page 763: ...CE command 5 35 5 37 TRAPDEST object 4 16 4 20 VERSION command 5 37 5 38 SCP 4 2 Security for starting Host Resources Subagent 11 12 for starting Trap Multiplexer 12 6 SELECT command PTrace 6 10 sendtrap description 10 12 failures 10 19 Sensitive SCF commands 4 23 5 1 Set operation errors 7 6 SetRequest PDU 1 7 SNMP information protocol 1 9 message protocol 1 6 packets IPC encoded 1 8 SNMP group R...

Page 764: ...chNames 3 9 snmpOutPkts 3 7 snmpOutSetRequests 3 9 snmpOutTooBigs 3 8 snmpOutTraps 3 9 snnpInTooBigs 3 7 Socket Glossary 14 Socket error in method C 8 SPI 4 2 See Subsystem Programmatic Interface START command ENDPOINT object syntax 5 26 objects for which supported 5 1 PROFILE object syntax 5 26 TRAPDEST object syntax 5 27 when underlying resource is unavailable B 5 STARTED state ENDPOINT object 4...

Page 765: ...14 SUBSYS attribute attribute conflict SCF error 00003 5 2 Subsystem Control Facility command summary 2 17 role in troubleshooting 7 5 Subsystem Control Point SCP 4 2 Subsystem object hierarchy 4 4 Subsystem Programmatic Interface SPI 4 2 Subsystem how SCF determines 4 22 Subtree on object tree 1 10 Swapping extended memory 2 11 sysContact 3 4 sysDesc 3 4 sysLocation 3 5 sysName 3 5 sysObjectID 3 ...

Page 766: ...t response connections 2 34 routing for IPX SPX 13 2 TCP IP continued trace facility 7 4 trap connections 2 38 TCP IP process default set with TCPIP PROCESS NAME 5 6 5 11 through which NonStop agent can be reached 4 8 through which NonStop agent sends traps 4 16 TCP IP Subagent architectural overview 8 1 backup cpu number 8 14 backup takeover 8 10 cache refresh timers 8 9 converting events to trap...

Page 767: ...mNwSaSwitchToBackupNow 13 10 13 14 tdmNwServerTable 13 9 13 34 tdmNwServerTable Entries 13 33 tdmNwSPXTable 13 5 tdmNwSPXTable Entries 13 29 tdmNwSubagent subtree 13 37 Template Glossary 15 TESTSEND 10 3 TLAM See Tandem LAN Access Method TRACE command objects for which supported 5 1 syntax 5 35 Trace files described 6 1 opening 6 6 Trace operation 5 35 5 37 Trace records displaying by record numbe...

Page 768: ...cation in HOSTADDR B 5 naming conventions 4 16 naming conventions for wildcard support 4 17 NETWORK attribute 4 16 resource not available B 5 START command 5 27 states 4 17 5 31 state transition illustration 4 20 STATUS command 5 31 TRAPDEST object continued STOP command 5 34 use 2 38 trapEventNumber 9 13 10 15 trapGenerationtime 9 15 10 17 trapProcess 9 15 10 17 Traps agent address field 1 8 auth...

Page 769: ...e bindings 1 7 VERSION command objects for which supported 5 1 syntax 5 37 Version number 1 7 Version number displaying 5 37 VOLUME command SCF general 4 22 W WAN See wide area network Well known port Glossary 17 wide area network Glossary 17 Wildcard support ENDPOINT object HOSTADDR 0 5 7 object name 4 9 PROCESS object name 4 6 PROFILE object HOSTADDR 0 5 9 object name 4 13 TRAPDEST object HOSTAD...

Page 770: ...group zagInPfAccess 3 17 zagInPfCommunity 3 17 zagInPfHostAddr 3 17 zagInPfName 3 16 zagInPfRowStatus 3 16 zagInPfState 3 17 zagInProfile group continued zagInProfileEntry 3 16 zagInProfileTable 3 16 zagInProfileEntry 3 16 zagInProfileTable 3 16 zagInTdCommunity 3 19 zagInTdHostAddr 3 19 zagInTdName 3 18 zagInTdNetwork 3 19 zagInTdRowStatus 3 18 zagInTdState 3 19 zagInTdType 3 19 zagInternal group...

Page 771: ...nfCpuLastStableRefresh 11 67 zhrmInfCpuSetCounter 11 68 zhrmInfCpuTable 11 67 zhrmInfCpuTable group zhrmInfCpuEntries 11 67 zhrmInfCpuFirstIndex 11 67 zhrmInfCpuGetCounter 11 68 zhrmInfCpuGetNextCounter 11 68 zhrmInfCpuLastDynamRefresh 11 67 zhrmInfCpuLastIndex 11 67 zhrmInfCpuLastStableRefresh 11 67 zhrmInfCpuSetCounter 11 68 zhrmInfDevEntries 11 65 zhrmInfDevFirstIndex 11 66 zhrmInfDevGetCounter...

Page 772: ...11 68 zhrmInfNetGetCounter 11 69 zhrmInfNetGetNextCounter 11 69 zhrmInfNetLastDynamRefresh 11 69 zhrmInfNetLastIndex 11 68 zhrmInfNetTable group continued zhrmInfNetLastStableRefresh 11 69 zhrmInfNetSetCounter 11 69 zhrmInfParLastIndex 11 73 zhrmInfPartEntries 11 73 zhrmInfPartFirstIndex 11 73 zhrmInfPartGetCounter 11 74 zhrmInfPartGetNextCounter 11 74 zhrmInfPartLastDynamRefresh 11 73 zhrmInfPart...

Page 773: ...rmRefreshCurrTime 11 97 zhrmStableRefreshCnt 11 98 zhrmStableRefreshInterval 11 97 zhrmStableRefreshNow 11 98 zhrmRefreshCurrTime 11 97 zhrmSaCpuTime 11 92 zhrmSaCreatTime 11 92 zhrmSaHeapCurrent 11 93 zhrmSaHeapInitial 11 93 zhrmSaHomeTerm 11 93 zhrmSaIniFile 11 93 zhrmSaPaid 11 92 zhrmSaPID 11 92 zhrmSaPri 11 92 zhrmSaProcCurrTime 11 92 zhrmSaProcess group value maintenance 11 95 zhrmEnableSoftw...

Page 774: ...d 11 83 zhrmThreshold group zhrmThrDisk 11 81 zhrmThrDiskTable 11 83 zhrmThrRam 11 78 zhrmThrRAMTable 11 80 zhrmThrRam 11 78 zhrmThrRam group zhrmThrRAMHighValue 11 79 zhrmThrRAMLowValue 11 79 zhrmThrRAMPercentUse 11 78 zhrmThrRAMTotal 11 78 zhrmThrRAMTrapEnable 11 79 zhrmThrRAMUse 11 78 zhrmThrRAMAllocationFailures 11 81 zhrmThrRAMAllocationUnits 11 80 zhrmThrRAMDescr 11 80 zhrmThrRAMHighValue 11...

Page 775: ...llectorState 13 40 tdmNwSaEmsCollectorStateReason 13 40 tdmNwSaIPXPROTONamesTable 13 4 3 tdmNwSaKeepAliveTimer 13 41 tdmNwSaPrimaryPID 13 39 zisa group continued tdmNwSaProcessName 13 39 tdmNwSaProcessPAID 13 39 tdmNwSaProcessPriority 13 39 tdmNwSaProcessVersion 13 39 tdmNwSaRefreshNow 13 41 tdmNwSaRefreshTimer 13 41 tdmNwSaSwitchToBackupNow 13 40 ZISA EVT AGENT AVAILABLE 1003 13 53 AGENT UNAVAILA...

Page 776: ...upPID 12 17 ztmxProcCpuTime 12 17 ztmxProcCreatTime 12 17 ztmxProcCurrTime 12 17 ztmxProcEmsCollector 12 17 ztmxProcEmsWriteErrors 12 20 ztmxProcEmsWriteTotal 12 20 ztmxProcess group value maintenance 12 20 ztmxProcAgent 12 17 ztmxProcAgentSessionStatus 12 17 ztmxProcBkupPID 12 17 ztmxProcCpuTime 12 17 ztmxProcCreatTime 12 17 ztmxProcCurrTime 12 17 ztmxProcEmsCollector 12 17 ztmxProcEmsWriteErrors...

Page 777: ...n 8 16 8 21 ztsaProgramFile 8 16 8 21 ztsaRefreshNow 8 9 8 10 8 18 8 24 ztsaScpProcess 8 17 8 25 ztsaStatsCache 8 10 8 16 8 19 8 25 ztsaStatusCache 8 9 8 16 8 19 8 25 ztsaSubnetAddr 8 17 8 27 ztsaSubnetName 8 17 8 27 ztsaSubnetStatus 8 17 8 27 ztsaSubnetTable 8 26 ztsaSwitchToBackupNow 8 10 8 18 8 23 ztsaTcpIpName 8 17 8 26 ztsaTcpIpProcess 8 17 8 19 ztsaTcpIpState 8 17 8 19 8 26 ztsaTcpIpStatus 8...

Page 778: ...Index SNMP Configuration and Management Manual 424777 006 Index 32 Special Characters ...

Reviews: