14 display 命令参考

在本章中,您将了解如何使用 display 命令。

如果从 SQL 的角度考虑并查看选项,您将会意识到 display 命令是多么强大和灵活。display 命令是一个从 ACSLS 数据库报告信息的强大工具。正如 SQL SELECT 语句那样,使用 display 可以指定:

  • 您要显示的数据库表(ACSLS 对象)。

  • 通配符。

  • 选择对象时对象必须满足的条件。

  • 要报告的字段以及报告顺序。

  • 显示输出的排序顺序。

  • 只显示符合选择标准的对象的计数。

结果是一个 query 工具,使用它可以定制您要显示的内容以及显示方式。通过 display 命令获得的信息比通过 ACSLS query 命令获得的信息多。例如,display volume 可提供对只能通过定制 volrpt 获得的卷信息的访问权限。display lsmdisplay drive 则提供 LSM 和磁带机序列号。

这些 display 命令包括:

  • display cap

    根据选定的选项显示特定 CAP 信息。

  • display cell

    根据选定的选项显示特定单元信息。

  • display drive

    根据选定的选项显示特定磁带机信息。

  • display lock

    根据用户 ID 显示特定锁定信息。

  • display lsm

    根据选定的选项显示特定 LSM 信息。

  • display panel

    根据选定的选项显示特定库面板信息。

  • display pool

    根据选定的选项显示特定暂存池信息。

  • display port

    根据选定的选项显示特定端口信息。

  • display volume

    根据选定的选项显示特定卷信息。

使用 display 命令选项

display 命令可显示不同磁带库组件的各个信息字段。使用 display 命令可选择显示输出的顺序和格式。

所显示的信息可能会包括多列和长行。要避免换行,您可以调整用于显示的终端窗口的大小。cmd_proc -lq 窗口可能是最佳选择。

可将通配符、数字或字母范围以及选择列表与 display 命令结合使用。

使用通配符

  • 通配符 * 可用于替代:某些 display 操作数;复合显示操作数中的一个或多个子字段;或位于卷 ID 的开头或结尾。它必须匹配一个或多个字符。

  • 许多 ACSLS 磁带库组件有多个字段构成的主键。

    例如:

    • LSM 的主键是 acs,lsm

    • 磁带机的主键是 acs,lsm,panel,drive

  • 在使用通配符替代包含多个字段的主键时,可以指定星号 (*) 替代键中的所有字段,也可以用通配符替代单个键字段。如果指定 (*) 替代某些键字段,并使用通配符替代其他字段,则指定所有键字段。

  • 不要对 vol_id 使用星号 (*)。使用下划线 (_) 匹配 vol_id 中的单个字符。下划线与位置有关,表示单个字符。可在 vol_id 中多次使用它来表示多个字符。

示例

使用 * 字符的有效通配符示例:

  • display drive *(显示所有磁带机)

  • display drive 0,1,*,*(显示 LSM 0,1 中的所有磁带机)

  • display volume *100(显示以 100 结尾的所有卷)

  • display drive * -volume RB0001(显示包含卷 RB0001 的磁带机)

使用 * 字符的无效通配符示例:

  • display drive 0,1,*(在选择 LSM 0,1 中的所有磁带机时必须指定替代面板位置和磁带机位置的星号)

  • display cap * *(选择所有 CAP 时只能使用一个星号)

  • display volume 1*111(不允许嵌入的星号。使用 display volume 1_111)。

使用范围

  • 范围用 ’-’ 表示(连字符或短划线)。

  • 使用范围的规则如下:

    • 不允许使用负数,卷起始 LSM 除外。

    • 允许 <n 和 >n。<n 是小于 n 的所有数字。>n 是大于 n 的所有数字。

    • 可使用多个数字或范围,用空格分隔。

    • 卷范围可以是字母数字。

示例

有效范围的示例如下:

  • display volume * -drive 0,1,2,2-5(显示 acs 0、lsm 1、面板 2、磁带机 2 至 5 中的所有卷)

  • display lsm * -state online -free_cells >50 -type 9730(显示处于联机状态并且空闲单元计数超过 50 的所有 9730 个 lsm)

无效范围的示例如下:

  • display drive 0,1,1,1-*(* 在范围中无效)

  • display volume * -drive 0,1,?,1-5(? 在范围中无效)

格式

display type arg ...[ -selection ...] [ [ -c ] | [ -f field ...] [ -s sort_field ...] [ -n n ] ]

选项

  • type

    指定要显示的对象。有效类型包括:cap、cell、drive、lock、LSM、panel、pool、port 和 volume。

  • 参数

    (参数)指定对象类型的标识符。仅返回匹配一个或多个标识符的对象。

  • -selection

    指定其他选择标准。要被选定,组件必须与每个选择标准的至少一个选择标识符匹配。

  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field、-s sort_field-n n 选项互斥。

  • -f field

    指定要返回的信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。每个 display 命令的默认排序顺序将在每个命令下方介绍。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。

    某个类型的所有返回的字段都是有效的 sort_field。

  • -n n

    指定要显示的对象的最大数目。

显示长度超过 80 个字符的行时在行模式下启动 cmd_proc

以多视窗处理 (curses) 模式启动的 cmd_proc 命令无法显示长度超过 80 个字符的行,如果 cmd_proc 窗口尝试显示长度超过 80 个字符的行,则会挂起。

因此,在显示许多可选字段时,最好以行模式启动 cmd_proc(使用 –l 选项)。示例:display drive * -f volume type state serial_num wwn 使用按照 cmd_proc –l 方式启动的 cmd_proc

命令

本部分讨论 display 命令。

display cap

display cap 命令根据选定的选项显示特定 CAP 信息。

注:

在具有 4.70 及更高版本固件的 SL3000 和 SL8500 上。为防止在将其他模块添加到 SL3000 或安装其他 CAP 时 CAP ID 发生变化,磁带库将在其配置信息中返回所有可能的 CAP 位置。未安装的 CAP 将在 CAP 状态中报告为 "not installed"。

ACSLS 仅对实际安装了 CAP 的 CAP 位置添加数据库记录。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display cap cap_id ...][ -availability cap_availability ...][ -status cap_status ...][-priority cap_priority ...] [ -state cap_state ...] [ -manual | -automatic ] [ -condition cap_condition ...] [ [ -c ] | [ -f field ...] [ -s sort_field ...] [ -n n ] ]

字段

用于 display cap 的字段包括:

  • 关键字字段:acs、lsm、cap

  • 默认字段:acs、lsm、cap、status、priority、state、mode、size、availability

  • 可用字段:acs、lsm、cap、status、priority、state、desired_state、mode、size、condition、availability

选项

  • cap_id

    指定要显示的 CAP。cap_id 的格式为:acslsmcap

    可在任何 cap_id 子字段中使用通配符 *,或使用它表示所有子字段。但是,如果它表示所有 cap_id(示例:display cap * 或 display cap *,*,*),则不允许使用其他 cap_id(数字或 *)。数字范围适用于 cap_id 的任何子字段。

  • availability cap_availability

    指定一个或多个 cap 可用性作为其他选择标准。CAP 可用性包括:lib_not_partn、cap_shared、cap_dedicated、dedicated_other、not_installed

    作为 dedicated_othernot_installed 的 CAP 未在 ACSLS 数据库中定义。仅当 CAP 的可用性自从配置以来发生更改时才会看到这些值。重新配置以移除这些 CAP。

  • -status cap_status

    指定一个或多个 CAP 状态作为其他选择标准。CAP 状态包括:audit、available、eject、enter、insert_magazines

  • -priority cap_priority

    指定一个或多个 CAP 优先级。数字范围规则适用。CAP 数字范围:0-16。

  • -state cap_state

    指定一个或多个 CAP 状态。CAP 状态包括:diagnostic、offline、offline_pending、online、recovery

  • -manual

    以手动模式选择 CAP。

  • -automatic

    以自动模式选择 CAP。

  • -condition cap_condition

    指定要选择的一个或多个 CAP 条件。有效条件包括:inoperative、maint_requiredoperative

    注:

    仅当磁带机、LSM 或 ACS 变为联机时,才会清除 inoperative 或 maint_required 条件。因此,CAP 条件 inoperativemaint_required 可能不准确。
  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field、-s sort_field 和 -n n 选项互斥。

  • -f field

    指定要返回的信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。

    以下是 query cap 没有报告的新 CAP 字段。

    • desired_state

      ACS、端口、LSM、磁带机或 CAP 的所需状态是所需组件的可用性。执行显式 vary 操作时 ACSLS 将设置所需状态。(这是从 cmd_procACSAPI client 命令生成的 vary。它不是 ACSLS 由于磁带库状态更改而在内部生成的 vary。)

      ACS、端口、LSM、磁带机或 CAP 的当前状态(指定为“状态”)是受所需状态限制的组件的当前可用性。当磁带机变为联机时,其所需状态为联机。但是,其当前状态可能是脱机,因为磁带机无效或位于脱机或未就绪的 LSM 中。ACS、端口、LSM、磁带机或 CAP 的当前状态在 querydisplay 命令的结果中也称为组件的“状态”。

      此时,根据可用性,不会维护 CAP 的当前状态。

      逻辑磁带库以及逻辑磁带库中的磁带机的可用性也由为基础物理磁带库和逻辑磁带库设置的所需状态控制。如果物理磁带库和逻辑磁带库的所需状态都为联机,逻辑磁带库和逻辑磁带机的当前状态将反映基础物理磁带库和磁带机的当前状态。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。

    某个类型的所有返回的字段都是有效的 sort_field

  • -n n

    指定要显示的对象的最大数目。

示例

  • 显示 (display) 所有 CAP 数据:

    display cap *

  • 显示 (display) ACS 1、LSM 1、CAP 1 的 CAP 数据:

    display cap 1,1,1

  • 显示 (display) LSM 1、0 中所有手动模式 CAP:

    display cap 1,0,* -manual

  • 显示 (display) 脱机暂挂状态中的所有 CAP:

    display cap * -state offline_pending

display cell

display cell 命令根据选定的选项显示有关单元的特定信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display cell cell_loc ...[ -status cell_status ...] [ [ -c ] | [ -f field ...] [ -s sort_field ...] [ -n n ] ]

字段

用于 display cell 的字段包括:

  • 关键字字段:acslsmpanelrowcolumn

  • 默认字段:acslsmpanelrowcolumnstatus

  • 可用字段:acslsmpanelrowcolumnstatus

选项

  • -status cell_status

    指定一个或多个单元状态作为其他选择标准。有效单元状态:empty、full、inaccessible、reserved

    可在任何 cell_id 子字段中使用通配符 *,或使用它表示所有子字段。但是,如果它表示所有 cell_id(示例:display cell *display cell_id *,*,*,*),则不允许使用其他 cell_id(数字或 *)。数字范围适用于 cell_id 的任何子字段。

  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field、-s sort_field-n n 选项互斥。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。

    某个类型的所有返回的字段都是有效的 sort_field

  • -n n

    指定要显示的对象的最大数目。

示例

显示具有预留状态的单元的信息:

display cell * -status reserved

display drive

display drive 命令根据选定的选项显示特定的磁带机信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display drive drive_id ...[ -status drive_status ...][-state drive_state ...] [ -type drive_type ...][ -volume vol_id ...] [ -lock lock_id...] [ -serial drive_serial_num ...] [ -condition drive_condition ...][[ -c ] | [ -f field ...] [ -s sort_field ...] [ -n n ] ]

字段

用于 display drive 的字段包括:

  • 关键字字段:acs、lsm、panel、drive

    默认字段:acs、lsm、panel、drive、status、state、volume、type

  • 可用字段:acs、lsm、panel、drive、status、state、volume、type、lock、desired_state、serial_num、condition、wwn、last_dismount_time、error

选项

  • drive_id

    按以下格式显示 drive_idacs、lsm、panel、drive

    可在任何 drive_id 子字段中使用通配符 *,或使用它表示所有子字段。但是,如果它表示所有 drive_id(示例:display drive *display drive_id *,*,*,*),则不允许使用其他 drive_id(数字或 *)。数字范围适用于 drive_id 的任何子字段。

  • -status drive_status

    显示以下一个状态作为其他选择标准:available、in_use、reserved

    可能的方案:执行 query drive all 并得到一条消息,指示该磁带机正在使用中。然后执行 display drive * 并获得一条消息,表明磁带机已预留。这表示:磁带机的预留状态表示正在处理挂载请求,并且正在将卷挂载到磁带机。同时,将磁带机视为正在使用中。

  • -state drive_state

    显示一个或多个磁带机的以下状态:diagnostic、online、offline、recovery

  • -type drive_type

    按传输类型显示磁带机。

  • -volume vol_id

    显示挂载到所选磁带机上的卷。vol_id 可以是 6 个字母数字字符串,也可以是指定磁带卷或卷 ID 范围的通配符字符串。

  • -lock lock_id

    按锁定 ID 显示已锁定磁带机上的磁带机信息。

  • -serial drive_serial_num

    指定磁带机序列号。

  • -condition drive_condition

    显示指定的磁带机的条件。有效条件包括:operative、inoperativemaint_required

    注:

    仅当磁带机、LSM 或 ACS 变为联机时,才会清除 inoperative 或 maint_required 条件。因此,磁带机条件 inoperative 或 maint_required 可能不准确。
  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field-s sort_field-n n 选项互斥。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。

    某个类型的所有返回的字段都是有效的 sort_field。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表由空格分隔。以下是 query drive 未报告的新磁带机字段描述的列表。

    • desired_state

      ACS、端口、LSM、磁带机或 CAP 的所需状态是所需组件的可用性。执行显式 vary 操作时 ACSLS 将设置所需状态。(这是从 cmd_procACSAPI client 命令生成的 vary。它不是 ACSLS 由于磁带库状态更改而在内部生成的 vary。)

      ACS、端口、LSM、磁带机或 CAP 的当前状态(指定为“状态”)是受所需状态限制的组件的当前可用性。当磁带机变为联机时,其所需状态为联机。但是,其当前状态可能是脱机,因为磁带机无效或位于脱机或未就绪的 LSM 中。ACS、端口、LSM、磁带机或 CAP 的当前状态在 querydisplay 命令的结果中也称为组件的“状态”。

      逻辑磁带库以及逻辑磁带库中的磁带机的可用性也由为基础物理磁带库和逻辑磁带库设置的所需状态控制。如果物理磁带库和逻辑磁带库的所需状态都为联机,逻辑磁带库和逻辑磁带机的当前状态将反映基础物理磁带库和磁带机的当前状态。

    • serial_num

      ACSLS 只能在磁带机向磁带库报告其序列号以及磁带库向 ACSLS 报告其序列号时报告磁带机序列号。只有新型磁带库和磁带机才向 ACSLS 报告磁带机序列号。这包括 T9840、T9940、T10000、LTO、DLT 7000、SDLT 和更新的磁带机。SCSI 连接的磁带库、L5500、支持 T10000 磁带机的 9310 以及更新的磁带库向 ACSLS 报告序列号。

      ACSLS 报告磁带机“砖”上的序列号,不是磁带机托盘上的序列号。

      磁带机砖上的序列号是磁带机向磁带库报告以及通过 SL Console 和 ACSLS 向您报告的序列号。它也是通过 SCSI/光纤数据路径报告的序列号(例如,向备份应用程序报告)。

      磁带机托盘使用自己的序列号进行标记。磁带机托盘标签中的序列号通过 StorageTek 授予服务许可等。磁带机托盘上的编号用于进行激活,因此可更换磁带机(磁带机“砖”)而无需更新已激活的序列号。

      磁带机托盘和磁带机砖之间很少进行通信。这是通过一些就绪/未就绪指示符显示的。磁带机托盘本质上是没有任何智能卡的磁带机的电源。

    • wwn

      磁带机的全局名称。WWN 有 8 个字节(二进制)。它显示为 16 个十六进制字符(0-9 和 A-F),十六进制字符(字节)对之间使用点作为分隔符。

      所显示的 WWN 是节点的 WWN。第一个端口(端口 A)的 WWN 大一个数字。如果磁带机有两个端口,则端口 B 的 WWN 大两个数字。

      磁带机的 WWN 可用于 SL3000 磁带库以及具有 3.94 和更高版本固件的 SL8500 磁带库。

    • last_dismount_time

      上次从磁带机卸载磁带的日期和时间。ACSLS 使用此时间对报告给 query mount 的磁带机进行排序。首先按 LSM 与被挂载的卷的接近度(最少直通),然后按最早 last_dismount_time 来列出磁带机。按 earliest last_dismount_time 排序可使磁带机的使用达到平衡。

      从磁带机卸载磁带时将向 ACSLS 报告这些统计信息。以下统计信息字段是仅针对以下磁带库和磁带机报告的:

      磁带库:

      • 所有 SL3000。

      • 具有 4.13 和更高版本固件的 SL8500。

      磁带机:

      • 具有 1.42 及更高版本磁带机固件的 T9840A、T9840C 和 T9840D。(由于内存限制,不支持 T9840B。)

      • 具有 1.42 及更高版本磁带机固件的 T9940A 和 T9940B。

      • 具有 1.38 及更高版本磁带机固件的 T10000A 和 T10000B。

    • error-(需要磁带机维护)

      当前仅针对 T10000 磁带机报告。值包括:

      • none-没有磁带机错误报告。

      • maint_reqd-磁带机需要维护。

        只有在磁带机确定要使磁带机无效并且应使其脱机时才会报告此值。您应该打电话要求服务。

        磁带机主要错误情况:

      在这些情况中,磁带机和磁带库将等待人工干预。

表 14-1 等待人工干预的磁带机和磁带库

卸载故障 磁带卡在磁带机中

磁带机导销脱钩故障

只有在提取介质后,磁带机才会指示磁带机错误。

磁带机 IPL 故障

磁带机停止与磁带库通信。


  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。例如,按内部数字磁带机类型对 drive type 排序,而不是按显示的文本排序。

    某个类型的所有返回的字段都是有效的 sort_field

  • -n n

    指定要显示的对象的最大数目。

示例

  • 显示面板 0,1,1 中的所有磁带机。

    display drive 0,1,1,*

  • 显示 LSM 0,1 中的所有磁带机。

    display drive 0,1,*,*

  • 用最多 56 行显示 ACS 1 中的所有磁带机,按面板和磁带机排序:

    display drive 1,*,*,* -s panel drive -n 56

  • 显示 ACS 1、LSM 1 的磁带机数据以及可用状态:

    display drive 1,1,*,* -status available

  • 显示所有磁带机的磁带机类型、序列号和全局名称 (world wide name, wwn):

    display drive * -f type serial_num wwn

  • 显示所有磁带机的所需状态:

    display drive * -f state desired_state 
    

display lock

display lock 命令根据选定的选项按 lock_id 显示特定的锁定信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display lock lock_id ...[ -user user_id ...] [ [ -c ] | [ -f field ...] [ -s sort_field ...] [ -n n ] ]

字段

用于 display lock 的字段包括:

  • 关键字字段:lock_id

  • 默认字段:lock_iduser_id

  • 可用字段:lock_iduser_id

选项

  • lock_id

    显示数字 lock_id

    可在任何 lock_id 子字段中使用通配符 *,或使用它表示所有子字段。但是,如果它表示所有 lock_id(示例:display lock *display lock_id *,*,*),则不允许使用其他 lock_id(数字或 *)。数字范围适用于 lock_id 的任何子字段。

  • user_id

    指定锁定卷或传送装置的用户名(示例:acsss)。user_id 在 80 个字符后换行。

  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field-s sort_field 和 -n n 选项互斥。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。

    某个类型的所有返回的字段都是有效的排序字段。

  • -n n

    指定要显示的对象的最大数目。

示例

  • 显示 lock_id 2 的锁定信息:

    display lock 2

display lsm

display lsm 命令根据选定的选项显示特定 LSM 信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display lsm lsm_id ...[ -status lsm_status ...][-state lsm_state ...] [ -free_cells cell_count ...][ -type lsm_type ...] [ -serial lsm_serial_num ...][ -condition lsm_condition ] [ -door_open | -door_closed ] [ [ -c ] |[ -f field ...] [ -s sort_field ...][ -n n ] ]

字段

用于 display lsm 的字段包括:

  • 关键字字段:acs、lsm

  • 默认字段:acs、lsm、status、state、free_cell

  • 可用字段:acs、lsm、status、state、desired_state、free_cells、type、serial_num、activity、condition、door_status

  • lsm_id

    按以下格式显示 lsm ID:acslsm

    可在任何 lsm_id 子字段中使用通配符 *,或使用它表示所有子字段。但是,如果它表示所有 lsm_id(示例:display lsm *display lsm_id *,*),则不允许使用其他 lsm_id(数字或 *)。数字范围适用于 lsm_id 的任何子字段。

  • -status lsm_status

    指定要选择的一个或多个 LSM 状态。有效状态包括:auditnormal

  • -state lsm_state

    指定要选择的一个或多个 LSM 状态。有效状态包括:diagnostic、online、offline、offline_pending、recovery

  • -free_cells cell_count

    按空闲单元数选择 LSM。

  • -type lsm_type

    按类型显示 LSM。

  • -serial lsm_serial_num

    显示选定 LSM 的序列号。

    通过 SL8500 6.0+ 和 SL3000 3.0+ 固件,磁带库将报告获得许可的序列号。(要获取 SL8500 磁带库编号,可将 LSM 编号加 1,然后除以 4。)

  • -condition lsm_condition

    显示选定 LSM 的条件。有效条件包括:operativeinoperativemaint_required

    注:

    仅当磁带机、LSM 或 ACS 变为联机时,才会清除 inoperativemaint_required 条件。因此,LSM 条件 inoperativemaint_required 可能不准确。
  • -door_open

    显示门打开的 LSM。

  • -door_closed

    显示门关闭的 LSM。

  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field、-s sort_field-n n 选项互斥。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。以下是 query lsm 未报告的新 LSM 字段。

    • desired_state

      ACS、端口、LSM、磁带机或 CAP 的所需状态是所需组件的可用性。执行显式 vary 操作时 ACSLS 将设置所需状态。(这是从 cmd_procACSAPI client 命令生成的 vary。它不是 ACSLS 由于磁带库状态更改而在内部生成的 vary。)

      ACS、端口、LSM、磁带机或 CAP 的当前状态(指定为“状态”)是受所需状态限制的组件的当前可用性。当磁带机变为联机时,其所需状态为联机。但是,其当前状态可能是脱机,因为磁带机无效或位于脱机或未就绪的 LSM 中。ACS、端口、LSM、磁带机或 CAP 的当前状态在 querydisplay 命令的结果中也称为组件的“状态”。

      逻辑磁带库以及逻辑磁带库中的磁带机的可用性也由为基础物理磁带库和逻辑磁带库设置的所需状态控制。如果物理磁带库和逻辑磁带库的所需状态都为联机,逻辑磁带库和逻辑磁带机的当前状态将反映基础物理磁带库和磁带机的当前状态。

    • serial_num

      ACSLS 报告的 LSM 的序列号是记录在 SL3000 和 SL8500 磁带库(SL8500 6.00 固件或 SL3000 3.0 固件之前的版本)的 HBC 卡中的磁带库序列号。具有更高版本固件的 SL8500 和 SL3000 磁带库报告框架序列号,这是已激活的序列号。

      SL8500 和 SL3000 磁带库可通过基本模块框架的序列号激活。此序列号位于框架的 UL 标签上,并记录在磁带库的 HBK 卡中。(制造可重新生成替换 HBK 卡。)对于 SL8500,这些序列号以 516 开头,对于 SL3000,以 571 开头。可通过 SL Console 显示框架序列号("System Detail" -> "Properties" -> "General")。

      将来,磁带库固件将向 ACSLS 报告此框架序列号。只要 LSM 序列号发生更改,ACSLS 就会在 LSM 变为联机时自动更新该序列号。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。

    某个类型的所有返回的字段都是有效的排序字段。

  • -n n

    指定要显示的对象的最大数目。

示例

  • 显示类型为 9714 的磁带库中所有 LSM 的信息:

    display lsm * -type 9714

  • 显示所有 LSM 的类型:

    display lsm * - f type

  • 显示磁带库序列号:

    display lsm * -f serial_num

  • 显示所有 LSM 状态和 desired_state

    display lsm * -f state desired_state 
    

display panel

display panel 命令根据选定的选项显示特定的磁带库面板信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display panel panel_id ...[-type panel_type ...] [ [ -c ] |[ -f field ...] [ -s sort_field ...] [ -n n ] ]

字段

用于 display panel 的字段包括:

  • 关键字字段:acslsmpanel

  • 默认字段:acslsmpaneltype

  • 可用字段:acslsmpaneltype

选项

  • panel_id

    按以下格式显示面板 ID:acs、lsm、panel

    通配符 * 可用于任何 panel_id 子字段,也可用于表示所有子字段。但是,如果它表示所有 panel_id(示例:display panel *display panel_id *,*,*),则不允许使用其他 panel_id(数字或 *)。数字范围适用于 panel_id 的任何子字段。

  • -type panel_type

    指定一个或多个有效的面板类型。

  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field、-s sort_field-n n 选项互斥。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以数字顺序显示。

    某个类型的所有返回的字段都是有效的排序字段。

  • -n n

    指定要显示的对象的最大数目。

示例

显示所有面板的面板数据:

display panel *

display pool

display pool 命令根据选定的选项显示特定的暂存池信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display pool pool_id ...[ -low_water low_water_mark ...| -high_water high_water_mark...][-overflow | -no_overflow ] [ [ -c ] | [ -f field ...][ -s sort_field ...] [ -n n ] ]

字段

用于 display pool 的字段包括:

  • 关键字字段:pool_id

  • 默认字段:pool_id、low_water、high_water、overflow

  • 可用字段:pool_id、low_water、high_water、overflow

选项

  • pool_id

    显示暂存池的池 ID。

    可在任何 pool_id 子字段中使用通配符 *,或使用它表示所有子字段。但是,如果它表示所有 pool_id(示例
    display pool *
    display pool_id *,*,*),则不允许使用其他 pool_id(数字或 *)。数字范围适用于 pool_id 的任何子字段。

  • -low_water low_water_mark

    指定池中暂存磁带的最小数量。如果显示 low_water 标记并附加一个短划线 (-),则表示选定暂存池的磁带库中磁带的数量在指定的 low_water 标记范围内。

  • -high_water high_water_mark

    指定池中暂存磁带的最大数量。如果显示 high_water 标记并附加一个短划线 (-),则表示选定暂存池的磁带库中磁带的数量在指定的 high_water 标记范围内。

  • -overflow

    选择池,如果请求了暂存挂载并且该池是空的,则公共池将满足该请求。

  • -no_overflow

    选择池,如果请求了暂存挂载并且该池是空的,挂载将失败而不会检查公共池是否有可用磁带。

  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field、-s sort_field-n n 选项互斥。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以数字顺序显示。

    某个类型的所有返回的字段都是有效的排序字段。

  • -n n

    指定要显示的对象的最大数目。

示例

  • 显示池 5 的所有信息:

    display pool 5

  • 显示具有溢出的所有池:

    display pool * -overflow

display port

display port 命令根据选定的选项显示特定的端口信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display port port_id ...[ -online | -offline ][ -name port_name ...] [ [ -c ] | [ -f field ...][-s sort_field ...] [ -n n ] ]

字段

用于 display port 的字段包括:

  • 关键字字段:acs、port

  • 默认字段:acs、port、name、state

  • 可用字段:acs、port、name、state、desired_state

选项

  • port_id

    按以下格式显示端口 ID:acsport

    可在任何 port_id 子字段中使用通配符 *,或使用它表示所有子字段。但是,如果它表示所有 port_id(示例:
    display port *display port_id *,*,*),则不允许使用其他 port_id(数字或 *)。数字范围适用于 port_id 的任何子字段。

    • online

      选择并显示处于联机状态的端口。

    • offline

      选择并显示处于脱机状态的端口。

    • name port_name

      指定端口名称。

  • -c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field
    -s
    sort_field-n n 选项互斥。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。以下是 query 端口没有报告的新端口字段。

    • desired_state

      ACS、端口、LSM、磁带机或 CAP 的所需状态是所需组件的可用性。执行显式 vary 操作时 ACSLS 将设置所需状态。(这是从 cmd_procACSAPI client 命令生成的 vary。它不是 ACSLS 由于磁带库状态更改而在内部生成的 vary。)

      ACS、端口、LSM、磁带机或 CAP 的当前状态是受所需状态限制的组件的当前可用性。当磁带机变为联机时,其所需状态为联机。但是,其当前状态可能是脱机,因为磁带机无效或位于脱机或未就绪的 LSM 中。ACS、端口、LSM、磁带机或 CAP 的当前状态在 querydisplay 命令的结果中也称为组件的“状态”。

      逻辑磁带库以及逻辑磁带库中的磁带机的可用性也由为基础物理磁带库和逻辑磁带库设置的所需状态控制。如果物理磁带库和逻辑磁带库的所需状态都为联机,逻辑磁带库和逻辑磁带机的当前状态将反映基础物理磁带库和磁带机的当前状态。

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。

    某个类型的所有返回的字段都是有效的排序字段。

  • -n n

    指定要显示的对象的最大数目。

示例

  • 显示处于联机状态的所有端口:

    display port * -online

display volume

display volume 命令根据选定的选项显示特定的卷信息。

注:

有关指定显示选择标准以及选择要显示的数据的详细信息,请参见使用 display 命令选项

格式

display volume vol_id ...[ -home acs,lsm,panel,row,column...][ -drive drive_loc ...] [-data | -scratch | -clean ]
[ -media
media_type ...] [ -pool pool_id...] [ -standard |
-virtual ] [ -status
vol_status ...] [ -entry entry_date ...] [ -access access_date ...] [ -lock lock_id ...] [ [ -c ] |
[ -f
field ...] [ -s sort_field ...] [ -n n ] ]
[ -max_use
max_use] [ -lock_time lock_time]

字段

用于 display volume 的字段包括:

  • 关键字字段:vol_id

  • 默认字段:vol_id、acs、lsm、panel、row、column、pool、status、media、type

  • 可用字段:vol_id;acs;lsm;panel;row;column;drive_lsmdrive_panel、drive(显示全部三个字段以显示挂载磁带的位置);type;media;pool;label_type;status;entry_date;access_date;access_count;max_use;lock;lock_time;recording_format_family;recording_format_model;encrypt_status;volsafe_status;media_status;warranty_life;end_of_life;load_limit_alert

选项

  • vol_id

    显示选定的卷。

    vol_id 可以是指定盒式磁带的一个或多个包含 1-16 个字母数字的字符串。

    可使用通配符 * 表示所有 vol_id(示例:
    display vol*)或表示一组磁带(示例:display vol_id VAP* 将显示以 VAP 开头的所有磁带)。

    vol_id 可包含任何有效的卷 ID 字符和 *。

  • home home_loc

    按以下格式指定可从其中检索卷信息的卷起始位置:acs、lsm、panel、row、column。它不能与
    -drive 一起使用。

    home_loc 子字段可使用数字范围。必须指定所有 home_loc 子字段。可使用通配符 * 代替一个或多个 drive_loc 子字段。数字范围规则适用于任何子字段或 drive_loc。

  • acs <acs_id>

    指定应检索其卷信息的 ACS。

  • drive drive_loc

    按以下格式指定要从其中检索卷信息的磁带机位置:acslsmpaneldrive。它不能与 -home 一起使用。

    drive_loc 子字段可使用数字范围。必须指定所有 home_loc 子字段。可使用通配符 * 代替一个或多个 drive_loc 子字段。数字范围规则适用于任何子字段或 drive_loc

  • data

    选择数据磁带。

  • scratch

    选择处于暂存模式的磁带。

  • clean

    选择清洗磁带。

  • spent_clean

    按磁带机类型选择报告为已耗尽的清洗磁带。

  • media media_type

    仅选择具有指定的介质类型的磁带。

  • pool pool_id

    从暂存池选择并显示磁带。即使在磁带变为数据磁带后,也会保留暂存池的 ID。

  • standard

    选择具有可扫描的卷 ID label_type 的磁带。它不能与
    -virtual 一起使用。

  • virtual

    选择没有外部卷 ID label_type 并通过 venter 命令装入的磁带。它不能与 -standard 一起使用。

  • status vol_status

    有效输入包括:dismountejectentermounthomein_drivemovemissingabsentejected

  • entry entry_date

    指定磁带装入磁带库的日期和时间。它以 ISO 标准格式输入并显示 (yyyy-mm-dd)。

  • access access_date

    指定上次使用磁带的日期和时间。它以 ISO 标准格式输入并显示 (yyyy-mm-dd)。

  • lock lock_id

    指定卷的锁定 ID。

  • max_use max_use

    指定清洗磁带的最大使用次数。非清洗磁带的 max_use 值为零。

  • lock_time lock_time

    指定上次设置锁定的日期和时间。根据系统默认格式显示。

  • recording_format_family drive_family -recording_format_model drive_model

    指定记录格式磁带机系列和磁带机型号。示例:T10000 和 T10000C

  • c

    (计数)使请求仅显示满足 argselection 标准的对象数。该选项与 -f field
    -s
    sort_field-n n 选项互斥。

  • -f field

    指定信息字段,以及对每个选定的对象返回的顺序。每个显示类型都有可用字段、关键字字段和默认字段列表。如果指定了 -f,则不会显示默认字段,除非它们是关键字字段或已被指定。如果未指定 -f,则返回默认字段。通常首先显示每个类型的关键字字段。但是,您可以在 -f 选项后指定关键字字段,以更改其显示顺序。

    字段列表用空格分隔。以下是 query volume 未报告的新卷字段列表。这些统计信息字段仅针对以下磁带库和磁带机报告:

    以下统计信息字段是仅针对以下磁带库和磁带机报告的:

    磁带库:

    • 所有 SL3000。

    • 具有 4.13 和更高版本固件的 SL8500。

    • 磁带机:

    • 具有 1.42 及更高版本磁带机固件的 T9840A、T9840C 和 T9840D。(由于内存限制,不支持 T9840B。)

    • 具有 1.42 及更高版本固件的 T9940A 和 T9940B。

    • 具有 1.38 及更高版本磁带机固件的 T10000A 和 T10000B。

    • T10000C 和 T10000D 及更高版本磁带机。

  • recording_format_family

    该字段显示上次在此磁带上记录数据的磁带机系列。

  • recording_format_model

    该字段显示上次在此磁带上记录数据的磁带机型号。此信息可用于:

    • 避免将磁带挂载到无法读取磁带上的数据的磁带机(例如,T10000A 无法读取由 T10000B 磁带机记录的数据)或

    • 将数据附加到磁带(例如,T10000B 无法将数据附加到由 T10000A 写入的磁带)。

  • encrypt_status

    该字段显示磁带的加密状态(如果已知)。

  • volsafe_status

    该字段显示是否是 volsafe 磁带。Volsafe 是 StorageTek 的 WORM(Write Once Read Many,一次写入多次读取)磁带。

  • media_status

    如果磁带机报告磁带“可疑”,则应检查该磁带。

  • warranty_lifeend_of_life

    卷的 warranty_lifeend_of_life 百分比是卷的使用次数与其 end_of_life 设置的百分比。这些值的范围是 000.0% 到 100.0% 以上。(warranty_life 小于 end_of_life。)

    该信息可用于标识在将磁带的数据迁移到新磁带后需要弃用的磁带。

  • load_limit_alert

    卷的 load_limit_alert 是一个布尔值,其中 True=1,False=0。如果卷报告 end_of_life 百分比达到了 100%,其 load_limit_alert 将设置为 1。某些磁带机类型仅报告 load_limit_alert

  • -s sort_field

    按指定的顺序对选定字段返回的对象排序。排序是以内部数据库值为依据的,可能并不总是以字母数字顺序显示。例如,按内部数字介质类型对 media type 排序,而不是按 display 的文本排序。

    某个类型的所有返回的字段都是有效的排序字段。

  • -n n

    指定要显示的对象的最大数目。

示例

  • 根据位置显示卷:

    此示例显示起始位置在面板 0,1,9 中的所有卷。

    display volume * -home 0,1,9,*,*

  • 显示全部 9840 个数据卷。

    display volume * -media STK1R

  • 显示 9840 个数据卷及其记录格式(如果已知):

    display volume * -media STK1R -f media recording_format_family recording_format_model

  • 按 ACS 和介质类型显示清洗卷:

    display volume * -home acs,*,*,*,* -media media_type
    -f vol_id acs lsm media max_use access_count

  • 按日期显示卷:

    • 显示在 2011 年装入的所有卷:

      display volume * -entry 2011

    • 显示在 2011 年 1 月装入的所有卷:

      display volume * -entry 2011-01

    • 显示在 2011 年 1 月 27 日装入的所有卷:

      display volume * -entry 2011-01-27

    • 显示在 2011 年 1 月 27 日上午 10:00 到 11:00 之间装入的所有卷:

      display volume * -entry 2011-01-27:10

    • 显示在 2011 年 1 月到 4 月之间装入的所有卷:

      display volume * -entry 2011-01-2011-04

    • 显示在 4 月 10 日上午 6:33 到 6:57:45 之间装入的所有卷(例如,在停机后执行此操作):

      display volume * -entry 2011-04-10:06:33:00-2011-04-10:6:57:45

    • 显示自从 2011 年 2 月 25 日以来装入的所有卷:

      display volume * -entry >2011-02-25

    • 显示按 end_of_life 使用次数排序的 T10000 数据卷:

      display volume * -media T10000T1 T10000TS -f media end_of_life warranty_life -s end_of_life

    • 显示所有卷的保修期和使用期,并按 end_of_life 使用次数排序:

      display volume * -f warranty_life end_of_life -s end_of_life

    • 显示已耗尽的清洗磁带:

      display volume * -spent_clean