ZHONE-DISMAN-PING-MIB

TEXTUAL-CONVENTION

Used to report the result of an operation: responseReceived(1) - Operation completes successfully. unknown(2) - Operation failed due to unknown error. internalError(3) - An implementation detected an error in its own processing that caused an operation to fail. requestTimedOut(4) - Operation failed to receive a valid reply within the time limit imposed on it. unknownDestinationAddress(5) - Invalid destination address. noRouteToTarget(6) - Could not find a route to target. interfaceInactiveToTarget(7) - The interface to be used in sending a probe is inactive without an alternate route existing. arpFailure(8) - Unable to resolve a target address to a media specific address. maxConcurrentLimitReached(9) - The maximum number of concurrent active operations would have been exceeded if the corresponding operation was allowed. unableToResolveDnsName(10) - The DNS name specified was unable to be mapped to an IP address. invalidHostAddress(11) - The IP address for a host has been determined to be invalid. Examples of this are broadcast or multicast addresses.

OBJECT-IDENTITY

OBJECT-IDENTITY

OBJECT-TYPE

The maximum number of concurrent active ping requests that are allowed within an agent implementation. A value of 0 for this object implies that there is no limit for the number of concurrent active requests in effect.

OBJECT-TYPE

This object contains an appropriate value to be used for zhonePingCtlIndex when creating entries in the zhonePingCtlTable. The value 0 indicates that no unassigned entries are available. To obtain the zhonePingCtlIndex value for a new entry, the manager issues a management protocol retrieval operation to obtain the current value of this object. After each retrieval, the agent should modify the value to the next unassigned index. After a manager retrieves a value the agent will determine through its local policy when this index value will be made available for reuse.

OBJECT-TYPE

Defines the ping Control Table for providing, via SNMP, the capability of performing ping operations at a remote host. The results of these operations are stored in the zhonePingResultsTable.

OBJECT-TYPE

None

OBJECT-TYPE

When used in conjunction with such a security policy all entries in the table belonging to a particular user (or group) will have the same value for this initial index. For a given user's entries in a particular table, the object identifiers for the information in these entries will have the same subidentifiers (except for the 'column' subidentifier) up to the end of the encoded owner index.

OBJECT-TYPE

Specifies the type of host address to be used at a remote host for performing a ping operation.

OBJECT-TYPE

Specifies the host address to be used at a remote host for performing a ping operation. The host address type is determined by the object value of corresponding zhonePingCtlTargetAddressType. A value for this object MUST be set prior to transitioning its corresponding zhonePingCtlEntry to active(1) via zhonePingCtlRowStatus.

OBJECT-TYPE

Specifies the size of the data portion to be transmitted in a ping operation in octets. A ping request is usually an ICMP message encoded into an IP packet. An IP packet has a maximum size of 65535 octets. Subtracting the size of the ICMP or UDP header (both 8 octets) and the size of the IP header (20 octets) yields a maximum size of 65507 octets.

OBJECT-TYPE

Specifies the time-out value, in seconds, for a remote ping operation.

OBJECT-TYPE

Specifies the number of times to perform a ping operation at a remote host.

OBJECT-TYPE

Reflects the desired state that a zhonePingCtlEntry should be in: enabled(1) - Attempt to activate the test as defined by this zhonePingCtlEntry. disabled(2) - Deactivate the test as defined by this zhonePingCtlEntry. Refer to the corresponding zhonePingResultsOperStatus to determine the operational state of the test defined by this entry.

OBJECT-TYPE

The content of this object is used together with the corresponding zhonePingCtlDataSize value to determine how to fill the data portion of a probe packet. The option of selecting a data fill pattern can be useful when links are compressed or have data pattern sensitivities. The contents of zhonePingCtlDataFill should be repeated in a ping packet when the size of the data portion of the ping packet is greater than the size of zhonePingCtlDataFill.

OBJECT-TYPE

The number of seconds to wait before repeating a ping test as defined by the value of the various objects in the corresponding row. A single ping test consists of a series of ping probes. The number of probes is determined by the value of the corresponding zhonePingCtlProbeCount object. After a single test completes the number of seconds as defined by the value of zhonePingCtlFrequency MUST elapse before the next ping test is started. A value of 0 for this object implies that the test as defined by the corresponding entry will not be repeated.

OBJECT-TYPE

None

OBJECT-TYPE

The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row.

OBJECT-TYPE

The value of this object determines when and if to generate a notification for this entry: probeFailure(0) - Generate a zhonePingProbeFailed notification subject to the value of zhonePingCtlTrapProbeFailureFilter. The object zhonePingCtlTrapProbeFailureFilter can be used to specify the number of successive probe failures that are required before a zhonePingProbeFailed notification can be generated. testFailure(1) - Generate a zhonePingTestFailed notification. In this instance the object zhonePingCtlTrapTestFailureFilter can be used to determine the number of probe failures that signal when a test fails. testCompletion(2) - Generate a zhonePingTestCompleted notification. The value of this object defaults to zero, indicating that none of the above options have been selected.

OBJECT-TYPE

The value of this object is used to determine when to generate a zhonePingProbeFailed NOTIFICATION. Setting zhonePingCtlTrapGeneration to probeFailure(0) implies that a zhonePingProbeFailed NOTIFICATION is generated only when the number of successive probe failures as indicated by the value of zhonePingCtlTrapPrbefailureFilter fail within a given ping test.

OBJECT-TYPE

The value of this object is used to determine when to generate a zhonePingTestFailed NOTIFICATION. Setting zhonePingCtlTrapGeneration to testFailure(1) implies that a pingTestFailed NOTIFICATION is generated only when the number of ping failures within a test exceed the value of zhonePingCtlTrapTestFailureFilter.

OBJECT-TYPE

The value of this object is used to either report or select the implementation method to be used for calculating a ping response time. The value of this object MAY be selected from zhonePingImplementationTypeDomains. Additional implementation types SHOULD be allocated as required by implementers of the ZHONE-DISMAN-PING-MIB under their enterprise specific registration point and not beneath zhonePingImplementationTypeDomains.

OBJECT-TYPE

The purpose of this object is to provide a descriptive name of the remote ping test.

OBJECT-TYPE

Specifies the type of the source address, zhonePingCtlSourceAddress, to be used at a remote host when performing a ping operation.

OBJECT-TYPE

Use the specified IP address (which must be given in numeric form, not as a hostname) as the source address in outgoing probe packets. On hosts with more than one IP address, this option can be used to force the source address to be something other than the primary IP address of the interface the probe packet is sent on. If the IP address is not one of this machine's interface addresses, an error is returned and nothing is sent. A zero length octet string value for this object disables source address specification. The address type (InetAddressType) that relates to this object is specified by the corresponding value of zhonePingCtlSourceAddressType.

OBJECT-TYPE

Setting this object to an interface's ifIndex prior to starting a remote ping operation directs the ping probes to be transmitted over the specified interface. A value of zero for this object means that this option is not enabled.

OBJECT-TYPE

The purpose of this object is to optionally enable bypassing the route table. If enabled, the remote host will bypass the normal routing tables and send directly to a host on an attached network. If the host is not on a directly-attached network, an error is returned. This option can be used to perform the ping operation to a local host through an interface that has no route defined (e.g., after the interface was dropped by routed).

OBJECT-TYPE

Specifies the value to store in the Differentiated Services (DS) Field in the IP packet used to encapsulate the ping probe. The DS Field is defined as the Type of Service (TOS) octet in a IPv4 header or as the Traffic Class octet in a IPv6 header. The value of this object must be a decimal integer in the range from 0 to 255. This option can be used to determine what effect an explicit DS Field setting has on a ping response. Not all values are legal or meaningful. A value of 0 means that the function represented by this option is not supported. DS Field usage is often not supported by IP implementations and not all values are supported. Refer to RFC 2474 for guidance on usage of this field.

OBJECT-TYPE

This object allows entries to be created and deleted in the zhonePingCtlTable. Deletion of an entry in this table results in all corresponding (same zhonePingCtlOwnerIndex and zhonePingCtlTestName index values) zhonePingResultsTable entries being deleted. A value MUST be specified for zhonePingCtlTargetAddress prior to a transition to active(1) state being accepted. Activation of a remote ping operation is controlled via zhonePingCtlAdminStatus and not by changing this object's value to active(1). Transitions in and out of active(1) state are not allowed while an entry's zhonePingResultsOperStatus is active(1) with the exception that deletion of an entry in this table by setting its RowStatus object to destroy(6) will stop an active ping operation. The operational state of a ping operation can be determined by examination of its zhonePingResultsOperStatus object. NOTE: ROWS ARE AUTO-DELETED UP ON COMPLETION REGARDLESS OF OUTCOME

OBJECT-TYPE

Defines the Ping Results Table for providing the capability of performing ping operations at a remote host. The results of these operations are stored in the zhonePingResultsTable and the zhonePingPastProbeTable. An entry is added to the zhonePingResultsTable when an zhonePingCtlEntry is started by successful transition of its zhonePingCtlAdminStatus object to enabled(1). An entry is removed from the zhonePingResultsTable when its corresponding zhonePingCtlEntry is deleted.

OBJECT-TYPE

Defines an entry in the zhonePingResultsTable. The zhonePingResultsTable has the same indexing as the zhonePingCtlTable in order for a zhonePingResultsEntry to correspond to the zhonePingCtlEntry that caused it to be created.

OBJECT-TYPE

Reflects the operational state of a zhonePingCtlEntry: enabled(1) - Test is active. disabled(2) - Test has stopped.

OBJECT-TYPE

This objects indicates the type of address stored in the corresponding zhonePingResultsIpTargetAddress object.

OBJECT-TYPE

This objects reports the IP address associated with a zhonePingCtlTargetAddress value when the destination address is specified as a DNS name. The value of this object should be a zero length octet string when a DNS name is not specified or when a specified DNS name fails to resolve.

OBJECT-TYPE

The minimum ping round-trip-time (RTT) received. A value of 0 for this object implies that no RTT has been received.

OBJECT-TYPE

The maximum ping round-trip-time (RTT) received. A value of 0 for this object implies that no RTT has been received.

OBJECT-TYPE

The current average ping round-trip-time (RTT).

OBJECT-TYPE

Number of responses received for the corresponding zhonePingCtlEntry and zhonePingResultsEntry. The value of this object MUST be reported as 0 when no probe responses have been received.

OBJECT-TYPE

The value of this object reflects the number of probes sent for the corresponding zhonePingCtlEntry and zhonePingResultsEntry. The value of this object MUST be reported as 0 when no probes have been sent.

OBJECT-TYPE

This object contains the sum of the squares for all ping responses received. Its purpose is to enable standard deviation calculation. The value of this object MUST be reported as 0 when no ping responses have been received.

OBJECT-TYPE

Date and time when the last response was received for a probe.

OBJECT-IDENTITY

OBJECT-IDENTITY

OBJECT-IDENTITY

OBJECT-IDENTITY

Indicates that an implementation is using the Internet Control Message Protocol (ICMP) 'ECHO' facility.

OBJECT-IDENTITY

Indicates that an implementation is using the UDP echo port (7).

OBJECT-IDENTITY

Indicates that an implementation is an SNMP query to calculate a round trip time.

OBJECT-IDENTITY

Indicates that an implementation is attempting to connect to a TCP port in order to calculate a round trip time.