rfc1628.txt

很多RFC的中文文档

单位“百分比”
最大权限：只读
当前状态
描述
“在输出链路上，目前已经占用的UPS功率容量百分比，也就是，实际功率容量/负荷
的百分比和VA/负载的百分比两者中较大的那个。”
：：= { upsOutputEntry 5 }

-- 旁路集合

upsBypass对象标识符 ：：= { upsObjects 5 }

upsBypassFrequency 对象类型
语法：非负
单位“0.1Hz”
最大权限：只读
当前状态
描述
“当前旁路频率。”
 ：：= { upsBypass 1 }

upsBypassNumLines 对象类型
语法：非负
最大权限：只读
当前状态
描述
“在该设备中启用的旁路链路编号。该表示值显示了在旁路列表中的行号。”
 ：：= { upsBypass 2 }

upsBypassTable 对象类型
语法：UpsBypassEntry的序列
最大权限：无权访问
当前状态
描述
“旁路列表表示值的队列。由upsBypassNumLines的值给定的表示值编号。”
 ：：= { upsBypass 3 }

upsBypassEntry 对象类型
语法：UpsBypassEntry
最大权限：无权访问
当前状态
描述
“包含了应用于实际旁路输出信息的表示值。”
索引{ upsBypassLineIndex }
 ：：= { upsBypassTable 1 }

UpsBypassEntry ：：= 序列{
UpsBypassLineIndexPositive：整数，
upsBypassVoltage：非负，
upsBypassCurrent：非负，
upsBypassPower：非负
}

upsBypassLineIndex 对象类型
语法：PositiveInteger
最大权限：无权访问
当前状态
描述
“旁路链路标识符。”
 ：：= { upsBypassEntry 1 }

upsBypassVoltage 对象类型
语法：非负
单位“均方根伏特”
最大权限：只读
当前状态
描述
“当前旁路电压。”
 ：：= { upsBypassEntry 2 }

upsBypassCurrent 对象类型
语法：非负
单位“0.1均方根安培”
最大权限：只读
当前状态
描述
“当前旁路电流。”
 ：：= { upsBypassEntry 3 }

upsBypassPower 对象类型
语法：非负
单位“瓦”
最大权限：只读
当前状态
描述
“当前由旁路输入的实际动力。”
 ：：= { upsBypassEntry 4 }

--报警类。

UpsAlarm对象标识符 ：：= { upsObjects 6 }

upsAlarmsPresent 对象类型
语法：32位量规
最大权限：只读
当前状态
描述
“当前激活的报警情况编号。”
 ：：= { upsAlarm 1 }

upsAlarmTable 对象类型
语法：UpsAlarmEntry的序列
最大权限：无权访问
当前状态
描述
“报警列表表示值队列。在某一时刻，根据起作用的报警条件数量的不同，表中可能包
含零行、一行或多行。最初，在代理启动时，本列表是空的。当代理检测到一种情况后就会
在表中增加一行，当此种情况消失后就删掉此行。代理创建第一行时，将upsAlarmId的值
设为1，然后每增加一行就把此值加1。当要超过upsAlarmId的最大值时，就返回到1或
是比1大的首个未使用的值。因此经过多次操作，此表可能变的很松散，比如只包含95、
100、101和203行条目，且这些条目不一定是按照时间顺序排列的，因为 upsAlarmId可
能已经循环回来了。
用AutonomousType(对象标识符)命名为upsAlarmDescr的报警，允许单个表反映那些
众所周知的报警还有那些由特殊实现定义的报警，例如，记录于文档中企业为设备定义的
MIB。没有两行的upsAlarmDescr值是相同的，因为每一种报警定义一种情况。为了满足
这些需求，应当特别注意报警情况的定义，以确保系统不会同时进入同一种情况多次。
UpsAlarmsPresent的值反映了在任意给定时刻的列表中的行号。”
 ：：= { upsAlarm 2 }

upsAlarmEntry 对象类型
语法：UpsAlarmEntry
最大权限：无权访问
当前状态
描述
“包含了应用于实际报警的信息的表示值。”
索引{ upsAlarmId }
 ：：= { upsAlarmTable 1 }

UpsAlarmEntry ：：=序列{
upsAlarmId PositiveInteger，
upsAlarmDescr AutonomousType，
upsAlarmTimeTimeStamp
}

upsAlarmId 对象类型
语法：PositiveInteger
最大权限：无权访问
当前状态
描述
“各种报警情况的唯一标识符。该值必须保持恒定不变。”
：：= { upsAlarmEntry 1 }

upsAlarmDescr 对象类型
语法：AutonomousType
最大权限：只读
当前状态
描述
“报警描述对象参照系。参照的对象不应该容易受到外界影响，但更多的时候是用于提
供报警情况的唯一描述。”
 ：：= { upsAlarmEntry 2 }

upsAlarmTime 对象类型
语法：TimeStamp
最大权限：只读
当前状态
描述
“当检测到报警时，sysUpTime的值。如果在代理启动时检测到报警，并且推测在代
理启动之前就已经存在，upsAlarmTime的值就等于0。”
 ：：= { upsAlarmEntry 3 }

--周知报警情况

upsWellKnownAlarms对象标识符 ：：= { upsAlarm 3 }

upsAlarmBatteryBad对象标识符
当前状态
描述
“已经检测到有1块或多块电池需要更换。”
 ：：= { upsWellKnownAlarms1 }

upsAlarmOnBattery对象标识符
当前状态
描述
“UPS由电池供电。”
 ：：= { upsWellKnownAlarms2 }

upsAlarmLowBattery对象标识符
当前状态
描述
“电池剩余运行时间小于等于upsConfigLowBattTime。”
 ：：= { upsWellKnownAlarms3 }

upsAlarmDepletedBattery对象标识符
当前状态
描述
“如果市电中断，UPS将不能支持当前负荷。”
 ：：= { upsWellKnownAlarms4 }

upsAlarmTempBad对象标识符
当前状态
描述
“温度超标。”
 ：：= { upsWellKnownAlarms5 }

upsAlarmInputBad对象标识符
当前状态
描述
“输入状态超标。”
 ：：= { upsWellKnownAlarms6 }

upsAlarmOutputBad对象标识符
当前状态
描述
“输出状态超标(不同于OutputOverload)。”
 ：：= { upsWellKnownAlarms7 }

upsAlarmOutputOverload对象标识符
当前状态
描述
“输出负荷超过UPS额定输出。”
 ：：= { upsWellKnownAlarms8 }

upsAlarmOnBypass对象标识符
当前状态
描述
“当前，UPS正处于旁路状态。”
 ：：= { upsWellKnownAlarms9 }

upsAlarmBypassBad对象标识符
当前状态
描述
“旁路超标。”
 ：：= { upsWellKnownAlarms 10 }

upsAlarmOutputOffAsRequested对象标识符
当前状态
描述
“UPS按请求停机，也就是，输出中断。”
 ：：= { upsWellKnownAlarms 11 }

upsAlarmUpsOffAsRequested对象标识符
当前状态
描述
“根据命令已经关闭整个UPS。”
 ：：= { upsWellKnownAlarms 12 }

upsAlarmChargerFailed对象标识符
当前状态
描述
“在UPS充电器子系统中检测到未校正的问题。”
 ：：= { upsWellKnownAlarms 13 }

upsAlarmUpsOutputOff对象标识符
当前状态
描述
“UPS输出处于中断状态。”
 ：：= { upsWellKnownAlarms 14 }

upsAlarmUpsSystemOff对象标识符
当前状态
描述
“UPS系统出于中断状态。”
 ：：= { upsWellKnownAlarms 15 }

upsAlarmFanFailure对象标识符
当前状态
描述
“已经检测到一个或更多的UPS中的风扇失效。”
 ：：= { upsWellKnownAlarms 16 }

upsAlarmFuseFailure对象标识符
当前状态
描述
“已经检测到一个或更多的保险丝失效。”
 ：：= { upsWellKnownAlarms 17 }

upsAlarmGeneralFault对象标识符
当前状态
描述
“已经检测到在UPS中的一个一般性失效。”
 ：：= { upsWellKnownAlarms 18 }

upsAlarmDiagnosticTestFailed对象标识符
当前状态
描述
“最近诊断测试结果显示有失效。”
 ：：= { upsWellKnownAlarms 19 }

upsAlarmCommunicationsLost对象标识符
 当前状态
 描述
“在代理和UPS之间的通讯中出现了问题。”
 ：：= { upsWellKnownAlarms 20 }

upsAlarmAwaitingPower对象标识符
当前状态
描述
“UPS输出中断，UPS正等待输入动力的返回。”
 ：：= { upsWellKnownAlarms 21 }

upsAlarmShutdownPending对象标识符
当前状态
描述
“正在进行upsShutdownAfterDelay脉冲分频。”
 ：：= { upsWellKnownAlarms 22 }

upsAlarmShutdownImminent对象标识符
当前状态
描述
“在5秒钟内，UPS会关闭对负载的动力；它既可以用于定时关机，也可能由于电池
电量太低而关机。”
 ：：= { upsWellKnownAlarms 23 }

upsAlarmTestInProgress对象标识符
当前状态
描述
“由测试集合启动和表示的在线测试。通过其他特订的实现机制启动的测试能够在报警
列表中表示测试的存在，如果愿意的话，通过在MIB文档说明中的对象标识符宏来实现，
并且超出来该对象标识符的范围。”
 ：：= { upsWellKnownAlarms 24 }

-- 测试集合

upsTest对象标识符 ：：= { upsObjects 7 }

upsTestId 对象类型
语法：对象标识符
最大权限：读写
当前状态
描述
“测试用对象标识符来命名，定义了一种初始化测试的标准机制，包括本文档种标识的
众所周知的测试，以及那些特殊实现引入的测试，例如，企业为设备定义的MIB。
设置此参数初始化那些命名的测试。设置此参数需要在同一SNMP消息中包括
upsTestSpinLock 。
如果不能执行测试，设置请求将被拒绝，同时提示一个适当的错误消息。这些错误消息
可能是在一个测试已经在处理时，另一个测试又试图开始。当前或最近测试的状态值保留在
upsTestResultsSummary中。如果把upsTestId 参数值设为upsTestAbortTestInProgress，
则运行中的测试将会被放弃。
如果一个测试正在进行，则读操作的返回值是此测试的名称。如果没有测试正在处理，
则返回最近一次执行的测试名称。如果根本没有运行测试，则返回的是
upsTestNoTestsInitiated 的值。”
 ：：= { upsTest 1 }

--在TestAndIncr的语法中对象的语义的更多信息见[6]

upsTestSpinLock 对象类型
语法：TestAndIncr
最大权限：读写
当前状态
描述
“测试子系统的自旋锁。自旋锁用途如下。
在开始测试前，管理工作站应该采用如下方法确认没有测试在进行：
 try_again：
get (upsTestSpinLock)
while (upsTestResultsSummary == inProgress) {
/*循环，当其他管理器正在进行测试时*/
short delay
get (upsTestSpinLock)
}
lock_value = upsTestSpinLock
/*如果没有测试进行，则开始测试*/
set (upsTestSpinLock = lock_value，upsTestId = requested_test)
if (error_index == 1) { /* (upsTestSpinLock failed) */
/*如果控制权限没有问题，那么会在开始我们的测试之前终止和其他管理器的联系*/
goto try_again
}
if (error_index == 2) { /* (upsTestId) */
/*不能完成测试*/
give up
}
/*测试成功开始*/
/*通过轮训ups的TestResultsSummary，来等候测试完成*/
get (upsTestSpinLock，upsTestResultsSummary，upsTestResultsDetail)
while (upsTestResultsSummary == inProgress) {
short delay
get (upsTestSpinLock，upsTestResultsSummary，upsTestResultsDetail)
}
/*当测试完成时，取回所有的测试结果*/
/*如果ups的TestSpinLock == lock_value + 1，那么就是我们的测试*/
/*结果(和其他管理器不同的)*/
在代理初始化时，ups的TestSpinLock的初始值应该是1。”
 ：：= { upsTest 2 }

upsTestResultsSummary 对象类型
语法：整数{
donePass(1)，
doneWarning(2)，
doneError(3)，
aborted(4)，
inProgress(5)，
noTestsInitiated(6)
 }
 最大权限：只读
 当前状态
 描述
“当前或最近的UPS诊断测试结果。donePass(1)、doneWarning(2)和doneError(3)
的值显示测试完成，或者是成功、有报警、或有差错。如果upsTestId的值为
upsTestAbortTestInProgress，则测试返回值aborted (4)，表明此次测试放弃。没有得出结
论的测试用inProgress(5)标明。值noTestsInitiated(6)说明没有以前的测试结果，例如从网
络管理子系统上一次重新初始化后没有运行测试，以及系统的非易失性存储器中没有保存测
试结果等情况。”
 ：：= { upsTest 3 }

upsTestResultsDetail 对象类型
语法：DisplayString (SIZE (0..255))
最大权限：只读
当前状态
描述
“有关ups的TestResultsSummary附加信息。如果没有附加信息可用，返回长度为
零的字符串。”
 ：：= { upsTest 4 }

upsTestStartTime 对象类型
语法：TimeStamp
最大权限：只读
当前状态
描述
“在线测试时，启动sysUpTime的值，或者，如果测试是非在线的，可以设置测试时
间。如果upsTestResultsSummary的值不是由时间激活的(6)，则upsTestStartTime的值是
0。”
 ：：= { upsTest 5 }