本章介绍如何：
创建定制卷报告
创建卷移动统计信息报告
可以使用 volrpt 实用程序创建卷报告；有关更多信息，请参见volrpt。$ACS_HOME/data/external/volrpt/owner_id.volrpt 是一个样例输入文件，可运行它并将其用作创建定制卷报告的模板。还可以将定制的卷报告保存在 $ACS_HOME/data/external/volrpt 目录中。使用此过程创建用于 volrpt 实用程序的输入文件，以创建定制卷报告。
要创建定制卷报告，请完成以下步骤：
以 acsss 身份登录。
打开 UNIX 命令工具。
更改为定制卷报告目录：
cd /home/ACSSS/data/external/volrpt
将卷报告样例文件复制到新的定制文件。
cp owner_id.volrpt my.volrpt
my.volrpt 是要分配给新文件的名称。
使用文本编辑器（如 vi）编辑 my.volrpt 文件，以指定要在定制报告中查看的字段和格式。
您可以指定样例文件中列出的任何字段。
每个条目的格式为：field_name field_length delimiter_length
您可以根据需要指定任意大小的字段长度和分隔符。只是应确保在输出报告时，您指定的所有字段都在一行上。
样例文件中提供了详细的编辑说明。
编辑完文件后保存它。
通过在输入文件中指定字段、字段长度和分隔符长度可创建定制报告，如以下示例所示。
################################################################ # # FIle name: owner_id.volrpt # # This file describes the report layout for volrpt invoked with # the -f option. # volrpt -f <filename> # # The format of a line is: # field_namefield_lengthdelimiter_length # # The field length is the number of characters which will be printed for # the field. The delimiter length is the number of spaces that will be # printed after the field. If you leave out the lengths, or specify a # value of -1, the default values will be used. Default delimiters are # always 2. ere are the fields and their default lengths. # # ACCESS_COUNT 5 2 # ACCESS_DATE 15 2 # CELL_ID 14 2 # DRIVE_ID 10 2 # ENTRY_DATE 15 2 # LABEL_ATTR 5 2 # LOCK_ID 5 2 # LOCK_TIME 15 2 # MAX_USE 5 2 # MEDIA_TYPE 7 2 # OWNER_ID 20 2 # POOL_ID 5 2 # VOLUME_ID 6 2 # VOL_STATUS 17 2 # VOLUME_TYPE 4 2 # # Revision History: # xx/xx/xx Name Changes # ################################################################ VOLUME_ID 6 2 MEDIA_TYPE 7 2 DRIVE_ID 12 2 CELL_ID 14 2 OWNER ID -1 0
从该输入文件可生成所示的定制报告。除此之外，在以下示例中所示的定制报告还可以用于报告卷的所有者。
使用输入文件的定制卷报告示例：
2014-06-30 13:22:07 TOTAL VOLUMES:2 SEQUENCE: sort by volume identifier Volume Media Home Owner Label Type Drive ID Location ID RB1400 3480 Not-in-drv 0, 1, 1, 0, 0 cray RB1401 DD3A 0, 0, 1, 0 0, 1, 2, 0, 0 cray
以下 volrpt 包括 ACS 0 和 1、缺失和已弹出的卷，并显示卷状态。
输入 volrpt 选项：
volrpt -f my.volrpt -a 0 1 -i
这些控制语句用于选择和格式化输出。
定制卷报告控制语句示例：
CELL_ID 14 2 VOLUME_ID 6 2 VOL_STATUS 17 0 POOL_ID 5 2 ACCESS_COUNT 5 1 LOCK_ID 5 1 OWNER_ID 20 0
显示缺失和已弹出的卷的定制 volrpt 示例：
VOLUME REPORT UTILITY 2014-06-03 15:27:48 TOTAL VOLUMES: 61 SEQUENCE: sort by volume identifier Home Volume Volume Pool Times Lock Owner Location--- Label Status ID Mount ID ID------------ 1, 0, 0, 0, 0 ABC001 VOLUME_HOME 0 2 0 presc 0,-1, 0, 0, 0 ABC002 VOLUME_ABSENT 0 0 0 0,-1, 0, 0, 0 ABC003 VOLUME_ABSENT 0 0 0 1, 3, 0, 0, 3 ABC004 VOLUME_MISSING 0 0 0 1, 3, 0, 0, 4 ABC005 VOLUME_MISSING 4 0 28001 tom 1, 3, 0, 0, 5 ABC006 VOLUME_MISSING 0 0 0 0,-1, 0, 0, 0 ABC007 VOLUME_ABSENT 0 0 0 1, 0, 0, 0, 7 ABC008 VOLUME_HOME 0 0 0 0,-1, 0, 0, 0 ABC009 VOLUME_ABSENT 0 0 0 0,-1, 0, 0, 0 ABC010 VOLUME_ABSENT 0 0 0 presc 1, 0, 0, 0,10 ABC011 VOLUME_HOME 0 0 0 1, 0, 0, 0,12 ABC012 VOLUME_HOME 0 0 2371 abc012 1, 0, 0, 0,13 ABC013 VOLUME_HOME 0 0 28001 1, 0, 0, 0,14 ABC014 VOLUME_HOME 0 0 28001 0,-1, 0, 0, 0 ABC015 VOLUME_ABSENT 1 0 29712 0,-1, 0, 0, 0 ABC016 VOLUME_EJECTED 1 0 29712 0,-1, 0, 0, 0 ABC017 VOLUME_ABSENT 1 0 29712 0,-1, 0, 0, 0 ABC018 VOLUME_ABSENT 1 0 29712 1, 0, 0, 0,19 ABC019 VOLUME_HOME 1 0 0 1, 0, 0, 0,20 ABC020 VOLUME_HOME 1 0 0 0,-1, 0, 0, 0 ABC021 VOLUME_ABSENT 0 0 0 0,-1, 0, 0, 0 ABC022 VOLUME_ABSENT 4 0 0
可以使用卷统计信息日志文件 (acsss_stats.log) 记录卷移动统计信息。这些统计信息包含每次 ACSLS 检测到卷的位置发生更改时记录的条目。ACSLS 记录装入、弹出、挂载、卸载的条目，以及每次审计检测到卷的位置发生更改（通常通过手动移动）的条目。
使用 LIB_VOL_STATS 变量启用或禁用卷统计信息日志记录。
指定卷统计信息日志文件的最大大小。
指定卷统计信息日志文件的滚动文件数。
stats_report 实用程序使用 acsss_stats.log 报告所有挂载和磁带机使用情况。
卷统计信息日志文件包含收集模式条目，指出是启用还是禁用卷统计信息日志记录以及卷统计信息条目。
卷统计信息日志文件条目示例：
2014-06-30 08:53:00 CONFIG Library volume statistics on. 2014-06-30 09:23:08 EJECT U01120 Home 0,0,1,3,5 Cap 1,0,0 Client Host Id 129.81.15.25 2014-06-30 10:36:05 ENTER PB0444 Home 0,0,4,3,5 Cap 0,0,0 Client Host Id 129.81.15.25 2014-06-30 10:42:48 MOUNT PB0478 Home 0,0,1,35,1 Drive 0,0,1,0 Client Host Id Local 2014-06-30 10:43:19 DISMOUNT PB0478 Home 0,0,1,35,1 Drive 0,0,1,0 Client Host Id Local 2014-06-30 10:43:19 AUDIT RB0478 0,0,1,35,1 STATUS_VOLUME_NOT_FOUND Client Host Id JBHUTTO 2014-06-30 10:43:19 AUDIT PB0444 0,0,1,32,1 STATUS_VOLUME_FOUND Client Host Id JBHUTTO 2014-06-30 10:45:00 CONFIG Library volume statistics off. 2015-01-16 09:51:07 ACSCR 0A1235 Home 0,0,5,14,14 STATUS_VOLUME_NOT_FOUND Client Host Id Local 2015-01-16 09:40:13 ACSCR 0A123A Home 0,0,5,14,15 STATUS_VOLUME_FOUND Client Host Id Local
在上例中，收集模式条目显示从 2014 年 6 月 30 日上午 8:53 开始收集统计信息，并在当天上午 10:45 结束收集。这些收集开始和停止时间包括此收集期间的卷统计信息条目。
卷统计信息条目的格式为：
yyyy-mm-dd hh:mm:ss command
vol_id home_loc function_loc client_host_ID
其中：
yyyy-mm-dd 是条目的年份、月份和日期。支持四位数的年份格式。可使用 acsss_config 指定日期格式。
hh:mm:ss 是条目的小时、分钟和秒。
command 是移动了卷或（审计）检测到卷已移动的 ACSLS 命令或客户机请求。
MOUNT 是挂载请求。
DISMOUNT 是卸载请求。
ENTER 是手动或自动模式装入请求。
EJECT 是弹出请求。
AUDIT 是审计请求。
ACSMV 是移动请求。
ACSCR 是卷恢复活动。此活动由 ACSLS 处理自动生成。
vol_id 是卷标识符。
home_loc 是卷的起始（存储单元）位置。
function_loc 是按以下方式使用卷的请求的卷位置：
mount 或 dismount 请求
位置是传送装置 ID。
enter 或 eject 请求
位置是 CAP ID。
audit 请求指定审计检测到了以下错误之一：
STATUS_VOLUME_FOUND
审计发现卷所在的位置与数据库中指定的位置不一致。
STATUS_VOLUME_NOT_FOUND
审计未在数据库中指定的位置中找到卷。
Volume Recovery activity
位置可以是单元 ID 或传送装置 ID，表示卷恢复检测到了以下情况之一：
STATUS_VOLUME_FOUND
找到的卷未记录在数据库中，并且正在添加它。
STATUS_VOLUME_NOT_FOUND
在任何记录的位置中未找到数据库中的卷，并且正在删除它。
client_host_ID 是以下之一：
对于客户机应用程序请求，它是主机 IP 地址。
对于 cmd_proc 命令，如果在启动了 cmd_proc 的 shell 环境中设置了环境变量 LIBVOLSTATS_CMD_PROC_ID（只能包含 ASCII 字符），该条目是环境变量值的前 12 个字符。
对于 cmd_proc 命令，如果环境变量 LIBVOLSTATS_CMD_PROC_ID 未设置或包含非 ASCII 字符，则条目是 Local。