本章介绍 VM Client 磁带管理接口 (VM Client Tape Management Interface, VMTMI)。
TapePlex 是指由 StorageTek 软件管理的复合资源,包括实际磁带的磁带库资源和虚拟卷的 VSM 资源。
TapePlex 定义为由单个 HSC CDS 管理的硬件。VM Client 提供对单个 TapePlex 的访问。VM Client 使用 TCP/IP 将事务路由到在 z/OS 上执行的 HSC 服务器。可以将多个主机上的多个 HSC 实例定义为服务器以提供冗余。VM Client 与 HSC 服务器之间的事务使用基于 XML 的 API(称为 XAPI)。VM Client 软件将磁带管理接口事务转换为 XAPI 格式以供服务器解释,并将这些事务的输出转换为 TMI 格式进行响应。
由于磁带管理接口现在与一个客户机组件交互,该组件与 z/OS 上的 HSC(以及 VTCS)衔接,因此在以前的发行版中支持的某些 TMI 命令不再受支持。在某些情况下,无法在客户机/服务器环境中支持命令功能,在将来的发行版中可能会支持其他命令。
VM Client 7.3 不支持以下 TMI 命令:
DEFSCR
和 DEFPOOL
这些功能由 ELS 7.0 中引入的 HSC POOLPARM
/VOLPARM
功能所取代。有关此功能的更多信息,请参阅出版物《Configuring HSC and VTCS》。
QEJECT
QREQUEST
SETOPER
VM Client 不支持操作员响应,因此,就像发出 SETOPER
命令一样处理所有命令。以前会生成 WTOR 消息的条件将作为错误消息返回。
STOP
此外,VM Client 也不支持使用 TAPEREQ
查找关键字(包括作业名称、步骤名称、程序名称和数据集名称)来选择介质和录制技术值。
对磁带管理系统 (tape management system, TMS) 与 VM Client 之间的接口进行大体说明的主题包括:
TMS 责任
此部分介绍 TMS 提供的服务。
TMS 决策点
此部分介绍 TapePlex 交互在哪些方面协助 TMS 服务利用 TapePlex 管理的资源。
返回 TMS 的 TapePlex 信息
此部分介绍由于 TapePlex 交互而返回的信息。
用户间通信工具 (Inter-user Communications Vehicle, IUCV) 注意事项
此部分介绍与 IUCV 宏一起使用的参数。
TMS 与 VM Client 交互
此部分介绍涉及到 TMS 与 VM Client 交互的各种情况。
后面几部分详细介绍了这些主题。
磁带管理系统有三个主要功能:
用户界面
磁带资源分配
操作员界面
通常,最终用户通过从磁带管理系统 (Tape Management System, TMS) 请求服务来间接地请求 TapePlex 工具。此类请求由 TMS 传送到 VM Client,然后再到 TapePlex 服务器。仅当最终用户使用 VM 特殊消息 (Special Message, SMSG) 工具直接发出 VM Client 命令或者直接调用 VMTMI 时,才会在最终用户与 VM Client 之间发生直接交互。有关示例,请参见分发的 VMTMI SAMPLE。
TMS 控制下的资源包括:
传送装置
TMS 通常拥有支持自动卷识别 (Automatic Volume Recognition, AVR) 的传送装置,还会将传送装置分配给请求磁带服务的用户。TMS 可以确定磁带传送装置对于分配请求的可用性。TMS 还了解所有传送装置支持的介质类型和密度。在必要时,VM Client 会帮助 TMS 选择 TapePlex 控制的传送装置。
数据集
TMS 将数据集映射到磁带卷,并且可能会将外部标签映射到内部标签。TapePlex 不包含此类信息。
擦写卷
TMS 对卷的擦写状态具有最终裁定权。这种状态还包括擦写子池成员资格。为自动执行挂载处理以使 TMS 生成“非特定”挂载(未指定 VOLSER 的擦写卷请求),TapePlex 还会保留自己的擦写状态信息。TMS 擦写状态列表不被视为所有可用擦写卷的列表,而是视为可用擦写卷总数的一部分。
特定卷
TMS 控制哪些用户有权访问任何特定卷。TapePlex 根据经授权的操作员或 TMS 的请求处理它所控制的卷。
通过 VM Client 为 TMS 提供 TapePlex 服务时,TapePlex 服务器会影响 TMS 决策。TapePlex 服务器在以下几方面影响 TMS 决策:
当 TMS 初始化时,让 TMS 与 VM Client 计算机建立 IUCV 路径,以确定 VM Client 和 TapePlex 服务器是否都在运行且正在通信。如果在 TMS 启动时 VM Client 计算机未在运行,则在 VM Client 和 TapePlex 初始化后尽快建立 IUCV 路径。可以为每个事务建立和断开连接,但是这样会导致不必要的处理。要高效地使用 IUCV,必须在整个 TMS 通信会话过程中建立并维护一条路径。
返回的 TapePlex 信息包括:
LSM 状态为联机或脱机。联机表明可以执行自动挂载。脱机表明只能执行手动挂载。
ACS 状态为已连接或已断开连接。已断开连接表明无法从该主机上访问 ACS,任何活动都必须从其他主机上进行处理。
用于擦写卷管理的 VOLSER
如果请求选择擦写卷,将返回在 TapePlex 控制数据集中标记为擦写的 VOLSER。这一选择会导致将卷标记为非擦写。
虚拟磁带机和虚拟卷的磁带库表示法
使用 VM Client,TMS 可以访问虚拟磁带机和虚拟卷。磁带管理接口将每个 VTSS 映射到一个 ACS ID 和一组 LSM ID,以使 TMS 可以像处理实际卷一样来处理虚拟磁带机和虚拟卷。VM Client 提供 VTSS 到 ACS 的映射,并确保表示 VTSS 的 ACS ID 不会与实际 ACS 重叠。不允许对虚拟卷执行卷移动操作,例如 EJECT
、MOVE
和 ENTER
。
用户间通信工具 (inter-user communication vehicle, IUCV) 是 IBM 提供的通信接口。
注:
VMTMI SAMPLE
是一个程序样例,说明了如何使用 VM Client 磁带管理接口。可以通过 MAINTSTK
用户 ID 找到该样例。要使用 IUCV 发出请求,请执行以下步骤:
使用 IUCV CONNECT
函数与 VM Client 服务机建立连接。
只有经授权的虚拟机才能向 VM Client 服务机发出命令。要获得许可,发出 TMI 或 VM Client 命令的虚拟机必须得到适当的权限,而这些权限通过启动时在 SMCPARMS
或 SMCCMDS
文件中向 VM Client 服务机发出的 VM Client AUTHorize
命令或者从以前授权的虚拟机来授予。
此外,还必须通过虚拟机的 CP 目录条目中的 IUCV 控制语句来授权虚拟机访问 CP。此操作通常由系统程序员或管理员来完成。确保 OPTION MAXCONN
指定足够多的路径供您使用。
要建立此 IUCV 连接(路径),应发出带有以下参数的 IUCV 宏:
IUCV CONNECT, PRMLIST=addr, * address of IUCV parm list USERID=addr, * address of CL8 ’userid’ USERDATA=addr, * address of CL16 ’ddname’ PRMDATA=NO * no parm data in IPARML
其中:
userid
指示 VM Client 服务机的名称。
ddname
指示请求建立连接的 VM Client IUCV 接口的名称。它是一个 16 字节的区域,如下所示:
DC CL8'SLSTLMS' ddname DC CL8' ' reserved
在执行此函数时,要检查 PSW 条件代码。如果条件代码为 0,应保存从 IPARML 区域传递到宏的路径 ID。程序必须等待 VM Client 服务机到 IUCV ACCEPT
待定连接,然后才能发送任何消息。如果未返回 "connection complete
" 或 "path severed
",表明 VM Client 未处于活动状态、未完全初始化或者 IUCV CONNECT
请求者指定的参数无效。
使用 IUCV SEND
函数向 VM Client 服务机发送消息。为 IUCV 宏指定以下参数:
IUCV SEND, PATHID=adpid, TYPE=2WAY, BUFLEN=buflen, RBUF=reply, RLEN=reply length
其中:
adpid
是包含 IUCV 路径 ID 的数据区的地址。
TYPE=2WAY 指定应该收到 IUCV 回复。
buflen
是“缓冲区”的长度。
reply
是包含回复的缓冲区的地址。
reply length
是回复缓冲区的长度。
用完与 VM Client 服务机的连接后,使用 IUCV SEVER
函数释放此路径。
此接口不支持以下 IUCV 参数:
TYPE=1WAY
IUCV REPLY
必须由 VM Client 发出。
TRGCLS=TRGCLS
被 VM Client 忽略。
DATA=PRMMSG CP
不允许发生 SEND
。
PRMMSG=
address
CP 不允许发生 SEND
。
PRTY=YES
CP 使用此参数改为排队等待 VM Client 服务机的处理。VM Client 服务机不对消息进行任何特殊处理。
其他所有 IUCV 参数均可根据需要使用。
IUCV 参数列表 (IUCV parameter list, IPARML) 中有三个字段特别值得一提:
USERID=
此参数指定运行 VM Client 的服务机的名称。Oracle 建议使您的用户 ID 可改变而不是硬编码,以便于更改。
USERDTA=
此参数指定服务机中接收 TMS 通信 (ACSINT
) 的进程的名称。它必须为 SLSTLMS
。
UWORD=
此参数指定中断时将会出现在 R0 中的一个词。它对于建立到通用数据区的可寻址性很有用。其中包含一个区域,列出了待定请求、路径状态以及在不同例程中引用的配置值。
有关 IUCV 接口以及上方所列参数的其他信息,请参阅 IBM 出版物《VM/SP System Facilities for Programming》或《VM/XA CP Programming Services》。
VM Client 与磁带管理系统 (tape management system, TMS) 之间需要几个接口点:
TMS 到 VM Client 初始连接
磁带机分配
操作员消息处理
TMS 在 VM Client 与用户之间提供了一个前端系统,用于维护分配、数据集和擦写池服务。VM Client 为 TMS 提供挂载/卸载处理和擦写卷选择,并影响这些卷和磁带机在 TapePlex 控制下的分配。
一个调用宏 (ACSRQ) 准备对用户间通信工具 (Inter-User Communications Vehicle, IUCV) 进行调用,以便在 TMS 与 VM Client 之间通信。IUCV 调用本身由 TMS 执行。
以下磁带管理系统工具支持通信:
分配时的一个接口,提供设备类型和擦写状态信息
处理消息时的一个接口,处理通常向操作员显示的消息
传送装置磁带机地址以及相应介质和位置信息的列表
IUCV 中断处理程序
TMS 完全负责磁带机分配,而 VM Client 和 TapePlex 可以在此过程中提供协助,方法是呈现磁带机的列表,按满足特定卷和擦写卷挂载的适合程度的顺序列出磁带机。
下一部分介绍 TMS 分配接口与 VM Client 之间的交互。
TMS 服务机从虚拟机接收挂载卷的请求,然后调用分配接口例程。
如果未与 VM Client 服务机建立 IUCV 路径,则磁带管理系统会尝试建立一个。如果尝试失败,则不会发生分配协助,一个返回代码会指明这种情况,还可能会设置一个标志,以告知消息接口:无法进行操作员消息处理,因为未执行特殊分配。
TMS 分配接口使用 IUCV 消息向 VM Client 服务机发送请求:
ACSRQ QDRLIST,VOLSER=voladr
替代请求为:
ACSRQ QDRLIST,VOLSER=voladr,COUNT=,LIST=
以上请求包括 COUNT=
和 LIST=
参数。这两个参数描述了 TMS 认为符合条件的一系列设备。该信息将会传递到 VM Client。
TMS VM CLIENT | ACSRQ QCONFIG | ICUV SEND <==============> IUCV RECEIVE | Format lists of | drives and status Select drive <==============> IUCV REPLY |
分配接口等待 IUCV REPLY
VM Client 例程收集数据,设置响应的格式,并发出 IUCV REPLY
。IUCV REPLY
由 SLX
宏进行映射。
TMS IUCV 支持函数通知正在等待的分配进程:已收到响应。
分配接口例程随后重新设置回复的格式以使其形成一个磁带机首选项列表(与 TMS 有关的格式),将回复与 TMS 管理的可用磁带机进行比较,然后离开接口。
如果需要选择擦写卷,则发出:
ACSRQ SELSCR,DRIVE=drivadr
此命令将返回 VOLSER,并在控制数据集中将该卷标记为非擦写,或者指明没有可用的擦写卷。
TMS VM CLIENT | ACSRQ SELSCR | ICUV SEND <==============> IUCV RECEIVE | Select VOLSER and | mark nonscratch Store VOLSER <==============> IUCV REPLY |
此部分介绍 TMS 消息接口与 VM Client 之间的交互。“操作员消息对话”部分概述了 MOUNT
请求的处理。其他消息接口点请求(例如 DISMOUNT
、SCRATCH
)都经过相似的一系列事件,因此不再分别介绍。TMS 可能会根据过程的完成情况禁止或更改消息。
在响应 TMS 检测到的要求卸载卷的情况(例如,挂载的卷不是请求的卷)或者 TMS 总是在使用卷后将其卸载时,发出 DISMOUNT
请求。
SCRATCH
请求由 TMS 发出,目的是使“工作”卷返回到擦写状态。服务器上的 HSC 控制数据集将会更新,以反映这些更改。
消息接口代码确定请求针对磁带机。
消息接口可能会使用 IUCV 消息向 VM Client 服务机发送请求以获取位置信息。
ACSRQ QVOLUME,VOLSER=voladr
消息接口等待 IUCV REPLY
VM Client 确定卷的状态、添加位置数据,并发出 IUCV REPLY
。如果从分配例程保留了卷状态信息,则可以省略前四个步骤。
如果卷在 TapePlex 中,则操作员消息接口会使用 IUCV 消息向服务机发送请求,指定要挂载的卷和要使用的磁带机。
ACSRQ MOUNT,VOLSER=volser,DRIVE=drivadr,PROTECT=
消息接口等待 IUCV REPLY
VM Client MOUNT
例程请求服务器执行挂载、设置成功/失败响应的格式,并发出回复。起源消息的 IUCV REPLY
由 SLX
宏映射。
注:
如果MOUNT
请求定向到的传送装置(磁带机)包含一个取消装入的卷,则会先卸载该卷再执行请求的挂载。TMS IUCV 支持例程通知正在等待的消息接口:已收到响应。
消息接口例程检查回复以确定挂载是否成功,设置适当的返回代码,然后离开接口。
当连接到虚拟机的 StorageTek 磁带机分离后或虚拟机注销后,会向 VM 系统操作员发出 DETACH
消息。如果磁带机变为分离状态而磁带库或虚拟卷仍处于挂载状态,则 TMS 可能不会得到通知,不会向 VM Client 服务机发出正常的 DISMOUNT
消息。
要妥善处理卸载,VM PROP
(PRogrammable OPerator) 工具应拦截某些消息并相应地处理。
注:
与 TMS 计算机一样,PROP
计算机也必须由 VM Client 服务机授予对命令的权限。使用 PROP RTABLE
调用的函数必须包含可用 VM Client 服务机的名称。提供了 SMCPROP EXEC
、LOGTAPE SAMPLE
和 RTABLE SAMPLE
作为示例。在使用 EXEC 时,可以使其保持不变,也可以对其进行修改以适应环境。应将这些例程的执行顺序设置为与以下顺序类似:
PROP
检测到 DETACH
消息并调用一个例程 (SMCPROP EXEC
) 以检查之前是否在磁带机上挂载了磁带库(或虚拟)卷(使用 SMCPROP EXEC
保存)。如果是这样,则执行以下命令:
CP SMSG vmclientuser DISMOUNT DRIVE cuu
SMCPROP EXEC
使用 CP SMSG
接口向 VM Client 服务机发出命令。
VM Client 收到卸载请求。
如果卷在磁带机上,则正常处理卸载,完成整个过程。例如:
PROP | VM CLIENT | Receive msg: | .SLS#124I MOUNT OF vvvvv1 ON | DRIVE cuu - COMPLETE | Save volume and transport address | | Receive msg: | TAPE cuu DETACHED ... | | Use drive address to get saved | volume. | | If a volume was previously saved | for the transport, issue dismount: | CP SMSG smcuser DISMOUNT DRIVE cuu ====> Receive dismount request | | Process dismount | DISMOUNT OF vvvvv1 FROM | DRIVE cuu COMPLETE |
如果磁带机已重新分配且发出了挂载请求,则 VM Client 将在磁带机上查找之前的卷,并自动开始该卷的卸载处理。完成这一自动卸载过程后,将会挂载新卷。例如:
PROP | VM CLIENT Receive msg: | .SLS#124I MOUNT OF vvvvv1 ON | DRIVE cuu - COMPLETE | | Save volume and transport address | Receive msg: | TAPE cuu DETACHED ... | | Receive mount for vvvvv2 | from TMS Use transport address to get | save volume. | | Issue msg: | .SLS##81I VOLUME vvvvv1 | FOUND MOUNTED | ON DRIVE cuu | ATTEMPTING DISMOUNT. | | Process automatic dismount | of vvvvvv1 | | Process mount of vvvvv2| Issue dismount: | CP SMSG smcuser DISMOUNT DRIVE cuu ======> Receive dismount for vvvvv1 | from PROP| Receive msg: | .SLS0124I MOUNT OF vvvvv2 ON | DRIVE cuu - COMPLETE | | Save volume and transport address. | |
磁带管理系统接口使用 ACSRQ
调用宏准备 IUCV
消息,此消息中包含对 VM Client 的请求。ACSRQ
宏将控制权返还给其调用方后,TMS 例程必须发出 IUCV SEND
。
用于与磁带库交互的请求类型包括:
查询信息
设置环境参数
卷处理
通过 ACSRQ
宏指令调用所有 VM Client 请求。一般来说,指定要执行的函数的名称、要发送的数据区的地址 (ACSINT
) 以及所需的其他关键字参数。
ACSRQ
宏会构建 ACS 接口块 (ACSINT
) 并(可选)为 IUCV SEND
构建 IPARML
。引用已构建的 IPARML 的 IUCV
指令应根据 ACSRQ
宏进行编码。收到 ACSINT
后,将在 VM Client 中调用适当的例程,并使用 IUCV REPLY
将信息返回发送者。
IBM 出版物《VM/SP System Facilities for Programming》和《VM/XA CP Programming Services》中所述的 IUCV
限制适用。由于数据区的大小,不支持 PRMMSG
,也不支持 BUFLIST
和 ANSLIST
。
TMS VM CLIENT
|
ASRQ xxxxxxx |
ICUV SEND <==============> IUCV RECEIVE
WAIT | Process Request
<==============> IUCV REPLY
(External Interrupt) |
Check return code |
Process reply |
有关回复区域的映射,请参见SLX 宏映射。
下面是 ASRQ
宏的语法:
Function
为以下几项之一:
DISMOUNT
EJECT
MOUNT
MOVE
QCAP
QCONFIG
QDRIVES
QDRLIST
QSCRATCH
QVOLUME
QVOLUSE
SCRATCH
SELSCR
Parameter
为以下几项之一:
,ACCT1=
acct1addr
,ACCT2=
acct2taddr
,CAP=
capidaddr
,COL=
coladdr
,COUNT=
countaddr
,DRIVE=
driveaddr
,HOSTID=
hostidaddr
,IPARML=YES
,LIST=
listaddr
,LSM=
lsmidaddr
,MEDIA=
medaddr
,MGMTCLS=
mgmtcls
,NOTIFY=INSDEL/NOINSDEL
,PAN=
paneladdr
,PATHID=
pathadr
,PROTECT=YES
,RECTECH=
recaddr
,ROW=
rowaddr
,RSPADDR=
bufadr
,RSPLEN=
buflen
,SCRATCH=
YES
,SUBPOOL=
subpooladdr
,TEXT=
textaddr
,TOLSM=
lsmidaddr
,TOPAN=
paneladdr
,USER=
useridaddr
,VOLSER=
voladdr
磁带管理接口 (tape management interface, TMI) 使用户可以从 VM Client 请求查询信息、卷移动和擦写卷控制服务,它包括允许指定介质和录制技术的请求。
可以使用介质和录制技术信息的请求包括:
MOUNT
QDRLIST
QSCRATCH
SELSCR
下面几页将对这些请求进行介绍。
TMI 直接使用 MEDia
和 RECtech
参数为请求确定介质和录制技术值。
注:
如果指定了DSECT=YES
,则其他任何函数或参数均无效。将会构建 ACSINT DSECT
。DISMOUNT
请求会导致从特定磁带机中移除磁带。磁带库磁带将会移至 LSM 单元(由 HSC 选择),并且可用于满足将来的请求。虚拟卷仍驻留在 VTSS 中,并且使用 MGMTCLAS
定义来确定迁移、复制和缓冲区驻留策略。
DISMOUNT
请求成功与否取决于卷是否已收到 REWIND/UNLOAD CCW
。如果磁带机尚未收到 REWIND/UNLOAD CCW
,则 DISMOUNT
请求将会中止。
DISMOUNT
请求可能会取消之前对同一磁带机的 MOUNT
请求。
ACINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
DRIVE=
driveaddr
指定应从中卸载卷的磁带机。此参数是必需参数。
driveaddr
是 2 字节磁带机规格的地址 (ccua
)。指定 RX 类型的数据地址或包含该数据地址的寄存器编号。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
VOLSER=
voladdr
(可选)指定要卸载的卷的 VOLSER
。
voladdr
是 6 个字符的卷标签的地址,它是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果挂载的卷具有不同的 VOLSER
,将会发生错误。
与请求关联的所有磁带移动都已完成后,会生成 DISMOUNT
请求的响应。响应包含回复标头和消息文本元素。回复标头中的原因代码 (SLXSRC
) 是一个二进制消息编号,指示 DISMOUNT
请求完成后发出的 HSC 消息。消息文本元素包含由原因代码指定的完整消息文本。
有关 SLX
宏的信息,请参见SLX 宏映射。
EJECT
请求发起从磁带库中移除一个或多个(最多 500 个)磁带的操作。磁带从 LSM 单元移至最高优先级的 CAP 或移至在请求中指定的 CAP,以便操作员可以检索到它们。
如果请求的是弹出虚拟卷或未在控制数据集中定义的卷,那么将此请求视为无效。
响应的长度可能差别很大,具体取决于在请求中指定的卷数。QCONFIG
请求的响应中有几个值可用来确定特定 EJECT
请求的适当应答缓冲区长度。这些值包括:
SLXZEJC1
包含单个卷的 EJECT
响应的长度。当 EJECT
请求指定了 VOLSER=
或 COUNT=1
时,对应答缓冲区长度使用此值。
SLXXVOLL
包含单个卷信息元素的长度,SLXXMSGL
包含单个消息文本元素的长度。如果 EJECT
请求指定了 COUNT=n
,则使用以下公式计算应答缓冲区长度:(((n-1)*(SLXXVOLL+SLXXMSGL))+SLXZEJC1)
。
当在请求列表中指定了最大 VOLSER 数(500 个)时,SLXZEJCT
包含 EJECT
响应的长度。当无法使用以上公式且当请求者有条件投入大量的存储(大约 78KB)来满足请求时,对应答缓冲区长度使用此值。
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
CAP=
capidaddr
(可选)指定用于满足请求的 CAP 的地址。
capidaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
格式为 AALLCC
00
,其中 AA
是 ACS 编号(00-99,十进制),LL
是 LSM 编号(00-99,十进制),CC
是十进制的 CAP 编号。这些标识符始终后跟 00
。
COUNT=
countaddr
(可选)指定一个 2 字节字段的地址,该字段包含由 LIST
参数指定的列表中的 VOLSER 数。
countaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
COUNT
必须与 LIST
参数一起使用,而与 VOLSER
参数互斥。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
LIST=
listaddr
(可选)指定元素列表的地址。
listaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。此列表中的每个元素都是 6 字节 VOLSER。
此参数的特殊形式 LIST=*
向 ACSRQ
表明:列表已附加至 ACSINT
数据区,无需移动。
LIST
必须与 COUNT
参数一起使用,而与 VOLSER
参数互斥。
LSMID=
lsmidaddr
(可选)指定从中弹出卷的 LSMid 的地址。如果 CAP 不在指定的 LSM 中,则请求失败。如果用户未指定 LSM,则 HSC 会在列表中第一个卷的 ACS 中选择一个 CAPid。LSMid 的格式为 AALL
,其中 AA
是 ACS 编号(十进制),LL
是 LSM 编号(十进制)。例如,0102 表示 ACS 编号为 01,LSM 编号为 02。
lsmidaddr
是 RX 类型的数据地址或包含 LSMid 地址的寄存器编号。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
SEQ=NO|YES
(可选)指定 CAP 弹出处理是按顺序还是按与起始位置的距离填充 CAP 单元。
NO
指定 EJECT
进程按起始位置对请求的卷排序。EJECT
按照卷起始位置与 CAP 的距离填充 CAP 或磁带盒(针对 SL8500),也就是说,最先弹出最靠近 CAP 的卷。
YES
指定 EJECT
进程从最高的可用 CAP 单元开始在 CAP 中放置磁带,按顺序继续下去。
注:
SEQ
参数对于所有 LSM 类型均有效,但是主要用于 SL8500 环境。如果其他 LSM 类型需要按顺序操作,则必须编写代码 SEQ=YES
。TEXT=
textaddr
(可选)指定与请求关联的 32 个字符的文本字符串。
textaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
USERID=
userisaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
VOLSER=
voladdr
(可选)指定 6 字符卷标签的地址。
voladdr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
VOLSER
与 LIST
和 COUNT
参数互斥。要么指定 VOLSER
,要么指定 LIST
和 COUNT
。
EJECT
请求的响应包含一个回复标头和一个卷信息元素,对于在请求中指定的每个 VOLSER,还会包含一个消息文本元素。卷信息元素和消息文本元素出现的顺序与请求中的 VOLSER 相同。
有关 SLX 宏的信息,请参见SLX 宏映射。
MOUNT
请求会导致将磁带挂载到特定磁带机上。
ACSRQ MOUNT
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
DRIVE=
driveaddr
指定要将磁带挂载到的磁带机,它是 2 字节磁带机规格的地址 (ccua
)。此参数是必需参数。
driveaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
MEDIA=
medaddr
(可选)指定一个 8 字节字符字段的地址,该字段包含要挂载的磁带的介质类型。
如果未指定 MEDIA,则挂载下一个兼容的擦写磁带,而不考虑介质类型。
medaddr
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
MGMTCLAS=
mgmtclas
(可选)指定一个包含管理类的向左对齐且用空格填补的八字符字段的地址。
mgmtclas
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
如果未指定 MGMTCLS
但是指定了 SUBPOOL
,则可以根据 VM Client POOLmap
命令来设置 MGMTCLS
。
IPARM=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
PROTECT=YES
(可选)指定应该对卷进行写保护。如果未指定 PROTECT=YES
,则拇指滚轮的物理位置确定是否对卷进行写保护。
仅当与 VOLSER
一起使用时,PROTECT=YES
才有效。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
SCRATCH=YES
(可选)指定请求针对非特定(擦写)卷。此时选择了一个擦写卷 VOLSER 并将其挂载到指定的传送装置上。
必须指定 SCRATCH=YES
或 VOLSER
。
SUBPOOL=
subpoolname
(可选)指定一个 13 字符字段的地址,该字段包含擦写子池的名称。
subpoolname
是 RX 类型的数据地址或包含该数据地址的寄存器编号。SCRPOOL
(子池索引)不再受支持,您必须使用 SUBPOOL
参数来选择擦写池。
仅当指定 SCRATCH=YES
时,SUBPOOL
才有效。如果指定了 SUBPOOL
但是未指定 MGMTCLS
,则可以根据 VM Client POOLmap
命令来设置 MGMTCLS
。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
VOLSER=
voladdr
(可选)指定 6 字符卷标签的地址。
voladdr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
必须指定 VOLSER
或 SCRATCH=YES
。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSER
或 SCRATCH=YES
。
MOVE
请求会导致将卷移至 ACS 中的特定位置。
使用 MOVE
函数可将单个卷移至 ACS 中的其他位置。所移动的卷的目标可以是同一个 LSM 也可以是不同的 LSM。
MOVE
函数可实现卷移动并改进磁带管理控制。
如果请求的是移动虚拟卷或未在控制数据集中定义的卷,那么系统将此请求视为无效。
ACSRQ MOVE
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
IPARML=YES
(可选)指定请求者已建立到 IUCV
IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV 路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
VOLSER=
volseraddr
(可选)指定 6 字符卷标签的地址。
voladdr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
必须指定 VOLSER
或 SCRATCH=YES
。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSER
或 SCRATCH=YES
。
LSM=
lsmaddr
(可选)指定 LSMid 的地址。LSMid 的格式为 AALL
,其中 AA
是 ACS 编号(十进制),LL
是 LSM 编号(十进制)。例如,0110 表示 ACS 编号为 01,LSM 编号为 10。
lsmaddr
是 RX 类型的 LSMid 地址或包含该 LSMid 地址的寄存器 (2) - (12)。
COL
、PAN
和 ROW
参数必须伴随着 LSM
参数。如果未指定 VOL
,则必须指定此参数。
PAN=
paneladdr
(可选)指定面板编号的地址。面板编号的格式为 pp
,其中 pp
是一个十进制数字。
paneladdr
是 RX 类型的面板地址或包含面板编号地址的寄存器 (2-12)。
如果指定了 LSM
,则必须指定 PAN
。
ROW=
rowaddr
(可选)指定行编号的地址。行编号的格式为 rr
,其中 rr
是一个十进制数字。
rowaddr
是 RX 类型的行地址或包含行编号地址的寄存器 (2-12)。
如果指定了 LSM
,则必须指定 ROW
。
COL=
columnaddr
(可选)指定列编号的地址。列编号的格式为 cc
,其中 cc
是一个十进制数字。
coladdr
是 RX 类型的列地址或包含列编号地址的寄存器 (2-12)。
如果指定了 LSM
,则必须指定 COL
。
TOLSM=
lsmaddr
指定将卷移至的 LSMid 的地址。LSMid 是两个十六进制字节,格式为 AALL
,其中 AA
是 ACS 编号(00-FF,十六进制),LL
是 LSM 编号(LL
是 00-17,十六进制)。此参数是必需参数。
lsmaddr
是 RX 类型的 LSMid 地址或包含该 LSMid 地址的寄存器 (2) - (12)。
TOPAN=
paneladdr
(可选)指定面板编号的地址。此参数是必需参数。
paneladdr
是 RX 类型的面板地址或包含面板编号地址的寄存器 (2-12)。
与请求关联的所有磁带移动都已完成后,会生成 MOVE
请求的响应。响应包含回复标头和消息文本元素,如果请求成功,还会包含一个卷信息元素。回复标头中的原因代码 (SLXSRC
) 是一个二进制消息编号,指示 MOVE
请求完成后发出的 HSC 消息。消息文本元素包含由原因代码指定的完整消息文本。
有关 SLX 宏的信息,请参见SLX 宏映射。
借助此请求可查询 CAP 的容量和状态。
ACSRQ QCAP
请求包括以下参数:
ACSID=
acsidaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
CAP=
capidaddr
(可选)指定用于满足请求的 CAP 的地址。
capidaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
capidaddr
的格式为 AALLCC
00
,其中 AA
是 ACS 编号(十进制),LL
是 LSM 编号(十进制),CC
是 CAP 编号。这些标识符始终后跟 00
。
如果指定了 CAP
,则返回有关指定 CAP 的信息。
COUNT=
countaddr
(可选)指定一个 2 字节字段的地址,该字段包含由 LIST
参数指定的列表中的 CAPID 数。
countaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
COUNT
必须与 LIST
参数一起使用。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV
IPARML
的可寻址性并且已初始化 IPARML
。
LIST=
listitemaddr
(可选)指定要查询的 CAP 列表的地址。
listitemaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果指定了 LIST
,则返回有关列表中所有 CAP 的信息。
LSM=
lsmidaddr
(可选)指定 LSMid 的地址。LSMid 的格式为 AALL
,其中 AA
是 ACS 编号(00-FF,十六进制),LL
是 LSM 编号(LL
是 00-17,十六进制)。例如,0102 表示 ACS 编号为 01,LSM 编号为 02。所有值均采用十六进制格式。
lsmidaddr
是 RX 类型的 LSMid 地址或包含该 LSMid 地址的寄存器 (2) - (12)。
如果指定了 LSM
,则返回有关特定 LSM 的数据。如果未指定 ACSID
、LSM
、CAP
或者 LIST
和 COUNT
,则返回有关所有 CAP 的数据。
PATHID=
pathidaddr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV 应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
借助 QCONFIG
请求可获取有关 TapePlex 配置的摘要信息,以及针对其他 TMS 接口请求建议的应答缓冲区长度。
QCONFIG
请求应该是建立 IUCV
连接后发出的第一个请求,因为其响应包含针对每种类型的 TMS 接口请求建议的应答缓冲区长度(响应长度)。
QCONFIG
响应的长度可能会随发行版发生变化。TMS 应使用以下技巧获取针对 QCONFIG
请求建议的应答缓冲区长度:
在应答缓冲区长度为 16(十进制)的情况下,发出 QCONFIG
请求。此请求的响应包含一个截断到 16 个字节的回复标头。标头中的返回代码为 4,它表明应答缓冲区太小,无法包含整个响应。偏移量为 12(十进制)的 SLXCRLN
一词包含针对 QCONFIG
请求建议的应答缓冲区长度。
使用建议的应答缓冲区长度,重新发出 QCONFIG
请求。
ACSRQ QCONFIG
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufaddr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
借助 QDRIVES
请求可获取与磁带库或与特定 ACS 关联的所有传送装置和 LSM 的详细信息。
ACSRQ QDRIVES
请求包括以下参数:
ACSID=
acsidaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
QDRIVES
响应包含回复标头、“磁带机信息”段和“LSM 信息”段。对于磁带库或 ACS 中的每个传送装置,“磁带机信息”段包含一个磁带机信息元素。对于磁带库或 ACS 中的每个 LSM,“LSM 信息”段包含一个 LSM 信息元素。
有关 SLX
宏的信息,请参见SLX 宏映射。
借助 QDRLIST
请求可获取为后续 MOUNT
请求指定磁带库传送装置的 TapePlex 建议。
VM Client 给出建议的方法是,返回磁带机信息元素的列表,对这些元素进行排序,以使第一个元素描述可使用的最优传送装置,第二个元素描述可使用的次优传送装置,依此类推。
如果 QDRLIST
请求指定的是一个特定磁带(即,指定了 VOLSER
),则对磁带机信息元素排序后,应使列出的第一个传送装置所在的 LSM 距离包含该磁带的 LSM 最近(或是同一个 LSM)。列出的最后一个传送装置所在的 LSM 距离包含该磁带的 LSM 最远。只有与该磁带在同一个 ACS 中的传送装置才会在“磁带机信息”段中表示出来。
如果 QDRLIST
请求指定的是擦写卷(即,指定了 SCRATCH=YES
),则对磁带机信息元素排序后,应使列出的第一个传送装置所在的 LSM 包含最多的擦写卷。列出的最后一个传送装置所在的 LSM 包含最少的擦写卷。所有 ACS 中的所有传送装置都会在“磁带机信息”段中表示出来。
如果请求针对特定虚拟卷,将返回该卷所在的或可从中撤回该卷的 VTSS 中的磁带机。如果请求针对虚拟擦写卷,将返回支持所请求的管理类的 VTSS 中的磁带机。
对磁带机信息元素排序时,VM Client 将忽略传送装置是已挂载卷还是在脱机 LSM 或 ACS 中。
可以随 QDRLIST
请求提供可选的传送装置地址列表。如果提供了一个列表,VM Client 在构建响应时会将其用作一个筛选器。仅当列表中存在磁带机的传送装置地址时,此磁带机信息元素才会包含在响应中。
ACSRQ QDRLIST
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
COUNT=
countaddr
(可选)指定一个 2 字节字段的地址,该字段包含由 LIST
参数指定的列表中的 CAPID 数。
countaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
COUNT
必须与 LIST
参数一起使用。
MEDIA=
medaddr
(可选)指定一个 8 字节字符字段的地址,该字段包含要挂载的磁带的介质类型。
如果未指定 MEDIA
,则挂载下一个兼容的擦写磁带,而不考虑介质类型。
medaddr
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
RECTECH=
recaddr
(可选)指定一个 8 字节字段的地址,该字段包含用于在磁带表面上录制数据轨道的录制技术。
如果未指定 RECtech
,则根据已指定的 MEDia
类型来选择传送装置。
recaddr
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
有关有效录制技术值的列表,请参见录制技术 (RECtech
)。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
LIST=
listaddr
(可选)指定元素列表的地址。
listaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
此列表中的每个元素都是 2 字节磁带机地址 (ccua
)。
此参数的特殊形式 LIST=*
向 ACSRQ
表明:列表已附加至 ACSINT
数据区,无需移动。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
SCRATCH=YES
(可选)指定请求针对非特定(擦写)卷。此时选择了一个擦写卷 VOLSER
并将其挂载到指定的传送装置上。
必须指定 SCRATCH=YES
或 VOLSER
。
SUBPOOL=
subpoolname
(可选)指定一个 13 字符字段的地址,该字段包含擦写子池的名称。
subpoolname
是 RX 类型的数据地址或包含该数据地址的寄存器编号。SCRPOOL
(子池索引)不再受支持,您必须使用 SUBPOOL
参数来选择擦写池。
仅当指定 SCRATCH=YES
时,SUBPOOL
才有效。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
VOLSER=
voladdr
(可选)指定 6 字符卷标签的地址。
voladdr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
必须指定 VOLSER
或 SCRATCH=YES
。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSER
或 SCRATCH=YES
。
借助 QSCRATCH
请求可获取与磁带库或与特定 ACS 关联的所有 LSM 的详细信息。该信息包括每个 LSM 中的擦写卷数。
当磁带库及其关联的控制数据集由多个 HSC 共享时,报告的擦写卷总数可能不同于实际总数,因为可能未计入其他处理器上最近的擦写卷活动。但是,每个 HSC 都根据控制数据集每五分钟刷新一次其擦写卷总数,所以差异应该很小。
ACSRQ QSCRATCH
请求包括以下参数:
ACSID=
acsidaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
MEDIA=
medaddr
(可选)指定一个 8 字节字符字段的地址,该字段包含请求的擦写磁带的介质类型。
如果未指定 MEDia
,则选择擦写磁带时不考虑介质类型。
medaddr
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
有关有效介质类型值的列表,请参见介质类型 (MEDia
)。
RECTECH=
recaddr
(可选)指定一个 8 字节字段的地址,该字段包含用于在磁带表面上录制数据轨道的录制技术。
此参数为可选参数。如果未指定 RECtech
,则根据已指定的 MEDia
类型来选择擦写磁带。
recaddr
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
有关有效录制技术值的列表,请参见录制技术 (RECtech
)。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
SUBPOOL=
subpoolname
(可选)指定一个 13 字符字段的地址,该字段包含擦写子池的名称。
subpoolname
是 RX 类型的数据地址或包含该数据地址的寄存器编号。SCRPOOL
(子池索引)不再受支持,您必须使用 SUBPOOL
参数来选择擦写池。
仅当指定 SCRATCH=YES
时,SUBPOOL
才有效。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
借助 QVOLUME
请求可获取一个或多个(最多 500 个)磁带的当前磁带库状态。
响应的长度可能差别很大,具体取决于在请求中指定的卷数。QCONFIG
请求的响应中有几个值可用来确定特定 QVOLUME
请求的适当应答缓冲区长度。这些值包括:
SLXZQVOL
包含单个卷的 QVOLUME
响应的长度。当 QVOLUME
请求指定了 VOLSER
或 COUNT=1
时,对应答缓冲区长度使用此值。
SLXXVOLL
包含单个卷信息元素的长度。如果 QVOLUME
请求指定了 COUNT=n
,则使用以下公式计算应答缓冲区长度:(((n-1)*SLXXVOLL)+SLXZQVOL)
。
当在请求列表中指定了最大 VOLSER 数(500 个)时,SLXZVOL
包含 QVOLUME
响应的长度。当无法使用以上公式且当请求者有条件投入大量的存储(大约 16 KB)来满足请求时,对应答缓冲区长度使用此值。
ACSRQ QVOLUME
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
COUNT=
countid
(可选)指定一个 2 字节字段的地址,该字段包含由 LIST
参数指定的列表中的 CAPID
数。
countaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
COUNT
必须与 LIST
参数一起使用。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
LIST=
listaddr
(可选)指定元素列表的地址。
listaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
此列表中的每个元素都是 2 字节磁带机地址 (ccua
)。
此参数的特殊形式 LIST=*
向 ACSRQ
表明:列表已附加至 ACSINT
数据区,无需移动。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
VOLSER=
voladdrid
(可选)指定 6 字符卷标签的地址。
voladdr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
必须指定 VOLSER
或 SCRATCH=YES
。此参数指定要挂载的卷的 VOLSER
。必须指定 VOLSER
或 SCRATCH=YES
。
借助 QVOLUSE
请求可获取已挂载卷的当前状态。
ACSRQ QVOLUSE
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
SCRATCH
请求会导致在服务器控制数据集中将卷置于擦写状态。
指定的磁带必须已在磁带库中。SCRATCH
请求不会导致任何磁带移动。但是,在 SCRATCH
请求处理过程中,必须选择要更改其状态的磁带(即,必须获得磁带的独占使用权)。因此,如果磁带已挂载到磁带机上,则 SCRATCH
请求会失败。
ACSRQ SCRATCH
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
VOLSER=
voladdr
(可选)指定 6 字符卷标签的地址。
voladdr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
必须指定 VOLSER
或 SCRATCH=YES
。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSER
或 SCRATCH=YES
。
SELSCR
请求会导致服务器选择一个磁带库擦写卷并在控制数据集中为其消除擦写状态。
不会发生任何卷移动。
如果 ACSID
和 DRIVE
两者均未指定,则 HSC 将在所有磁带库 LSM 中搜索,并从包含最多擦写卷的 LSM 中选择一个擦写卷。如果指定了 ACSID
,则 HSC 将从指定 ACS 中容纳最多磁带的 LSM 中选择一个擦写卷。如果指定了 DRIVE
且磁带机在自动模式 LSM 中,则 HSC 将从最近的 LSM 中选择一个擦写卷。
ACSRQ SELSCR
请求包括以下参数:
ACSID=
acsidaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
ACSDRIVE=
driveaddr
(可选)指定 2 字节磁带机规格的地址 (ccua
)。
driveaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
DRIVE
与 ACSID
互斥。它指定擦写卷应该靠近的磁带机。
MEDIA=
medaddr
(可选)指定一个 8 字节字符字段的地址,该字段包含选定擦写磁带的介质类型。如果未指定 MEDia
,则选择擦写磁带时不考虑介质类型。
medaddr
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
有关有效介质类型值的列表,请参见介质类型 (MEDia
)。
RECTECH=
recaddr
(可选)指定一个 8 字节字段的地址,该字段包含用于在磁带表面上录制数据轨道的录制技术。
如果未指定 RECtech
,则根据已指定的 MEDia
类型来选择擦写磁带。
recaddr
是 RX 类型的数据地址或包含该数据地址的寄存器 (2) - (12)。
有关有效录制技术值的列表,请参见录制技术 (RECtech
)。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV
IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG 在 SLXZDISM
中返回的值。
SUBPOOL=
subpoolname
(可选)指定一个 13 字符字段的地址,该字段包含擦写子池的名称。
subpoolname
是 RX 类型的数据地址或包含该数据地址的寄存器编号。SCRPOOL
(子池索引)不再受支持,您必须使用 SUBPOOL
参数来选择擦写池。
仅当指定 SCRATCH=YES
时,SUBPOOL
才有效。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
UNSCRATCH
请求会导致在控制数据集中为卷消除擦写状态。
如果请求为其消除擦写状态的卷未在控制数据集中定义,那么将此请求视为无效。
对于实际卷,UNSCRATCH
请求不会导致任何磁带移动。但是,在 UNSCRATCH
请求处理过程中,必须选择要更改其状态的卷(即,必须获得卷的独占使用权)。因此,如果卷已挂载到实际或虚拟磁带机上,则 UNSCRATCH
请求会失败(请参见注意事项)。
ACSRQ UNSCRATCH
请求包括以下参数:
ACSINT=
acsintaddr
指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。
acsintaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ
在填充数据时引用此地址处的 ACSINT
。
HOSTID=
hostidaddr
(可选)指定一个向左对齐且用空格填补的八字符主机 ID 的地址。如果未指定此参数,则使用执行请求的主机 ID。
hostidaddr
是 RX 类型的主机 ID 地址或包含该主机 ID 地址的寄存器 (2) - (12)。
IPARML=YES
(可选)指定请求者已建立到 IUCV
IPARML
的可寻址性并且已初始化 IPARML
。
PATHID=
pathadr
(可选)指定磁带库服务机的 2 字节 IUCV
路径 ID 的地址。
pathadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND PATHID
语句中。
仅当指定 IPARML=YES
时,PATHID
才有效。如果未指定 PATHID
,则后续 IUCV SEND
必须指定它。
RSPADDR=
bufadr
(可选)指定 IUCV
应答缓冲区的地址。
bufadr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSBUF
语句中。
仅当指定 IPARML=YES
时,RSPADDR
才有效。如果未指定 RSPADDR
,则后续 IUCV SEND
必须指定它。
RSPLEN=
buflen
(可选)指定 IUCV
应答缓冲区长度的地址。
buflen
是 RX 类型的 2 字节字段地址或包含该数据地址的寄存器编号。该数据用在 IUCV SEND ANSLEN
语句中。
仅当指定 IPARML=YES
时,RSPLEN
才有效。如果未指定 RSPLEN
,则后续 IUCV SEND
必须指定它。响应长度必须至少为 QCONFIG
在 SLXZDISM
中返回的值。
USER=
useridaddr
(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。
useridaddr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
如果未指定 USER
,则使用执行请求的用户 ID。
VOLSER=
voladdr
(可选)指定 6 字符卷标签的地址。
voladdr
是 RX 类型的数据地址或包含该数据地址的寄存器编号。
必须指定 VOLSER
或 SCRATCH=YES
。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSER
或 SCRATCH=YES
。
此部分介绍 SLX 宏的接口数据区。
回复始终以标头开头。标头可能后跟一个或多个“段”。每个段都是由特定类型的“元素”(例如,卷信息元素)构成的一个表。如果回复标头在双字边界上对齐,则保证所有后续段和元素也在双字边界上开始。
尽管没有回复将会包含所有类型的段,但是在回复标头中为每个可能的段类型都定义了一个段目录(数字/偏移量/长度)。段目录在标头中出现的顺序与段在标头后面实际排列的顺序无关。
段目录中的数字指定回复中实际存在该类型的元素数。如果某个段目录中的数字不为零,则该段目录中的偏移量指定从回复标头开头到该类型的第一个(或唯一一个)元素的偏移量。如果某个段目录中的数字大于一,则必须使用该段目录中的长度(指定该类型的单个元素的长度)来访问该类型的第二个元素以及后续元素。例如,偏移量加上长度得出第二个元素的偏移量,再加上长度得出第三个元素的偏移量,依此类推。每个段中的元素数是可变的。下面几个表显示了对于给定的请求将返回哪些回复段。
下表提供了 SLS 宏参数矩阵:
回复段 |
标题 |
配置 |
CAP | 卷 |
磁带机 |
LSM | 消息文本 |
---|---|---|---|---|---|---|---|
|
1 |
NA |
NA |
NA |
NA |
NA |
1 |
|
1 |
NA |
NA |
* |
NA |
NA |
* |
|
1 |
NA |
NA |
1(如果是擦写卷) |
NA |
NA |
1 |
|
1 |
NA |
NA |
1(如果成功) |
NA |
NA |
1 |
|
1 |
NA |
1+ |
NA |
NA |
NA |
NA |
|
1 |
1 |
NA |
NA |
NA |
NA |
NA |
|
1 |
NA |
NA |
NA |
1+ |
1+ |
NA |
|
1 |
NA |
NA |
1(如果不是擦写卷) |
1+ |
NA |
NA |
|
1 |
NA |
NA |
NA |
NA |
NA |
NA |
|
1 |
NA |
NA |
NA |
NA |
NA |
NA |
|
1 |
NA |
NA |
NA |
NA |
NA |
NA |
|
1 |
NA |
NA |
* |
NA |
NA |
NA |
|
1 |
NA |
NA |
* |
NA |
NA |
NA |
|
1 |
NA |
NA |
NA |
NA |
1+ |
NA |
|
1 |
NA |
NA |
1 |
NA |
NA |
NA |
|
1 |
NA |
NA |
NA |
NA |
NA |
NA |
注:
1 等于 1 且只等于 1。
*(EJECT 和 QVOLUME)受 SLX 回复区域中包含的卷信息元素数(最多 500 个)的限制。
1+ 表示从 1 到 n 的数字,具体取决于磁带库的配置。
以下示例显示了 SLX 记录格式的输出:
SLX - VM CLIENT EXTERNAL INTERFACE REPLY FUNCTION: MAPS A REPLY AREA RETURNED BY ONE OF THE FOLLOWING VM CLIENT REQUESTS: DISMOUNT - DISMOUNT A VOLUME EJECT - EJECT A VOLUME FROM THE LIBRARY MOUNT - MOUNT A VOLUME MOVE - MOVE A VOLUME QCAP - RETURN CAP SUMMARY QCONFIG - RETURN CONFIGURATION SUMMARY QDRIVES - RETURN DRIVE AND LSM INFORMATION QDRLIST - RETURN DRIVE INFORMATION, ORDERED BY PREFERENCE QSCRATCH - RETURN LSM INFORMATION, ORDERED BY PREFERENCE QVOLUME - RETURN VOLUME INFORMATION SCRATCH - CHANGE A VOLUME’S STATUS TO ’SCRATCH’ SELSCR - SELECT A SCRATCH VOLUME SPECIAL CONSIDERATIONS: A REPLY ALWAYS BEGINS WITH A HEADER. THE HEADER MAY BE FOLLOWED BY ONE OR MORE ”SECTIONS”. EACH SECTION IS A TABLE OF ”ELEMENTS” OF A PARTICULAR TYPE (E.G. VOLUME INFORMATION ELEMENT). IF THE REPLY HEADER IS ALIGNED ON A DOUBLEWORD BOUNDARY, THEN ALL SUBSEQUENT SECTIONS AND ELEMENTS ARE GUARANTEED TO ALSO BEGIN ON DOUBLEWORD BOUNDARIES. A SECTION DIRECTORY (NUMBER/OFFSET/LENGTH) IS DEFINED IN THE REPLY HEADER FOR EACH POSSIBLE SECTION TYPE, EVEN THOUGH NO REPLY WILL EVER CONTAIN ALL TYPES OF SECTIONS. THE ORDER IN WHICH THE SECTION DIRECTORIES APPEAR WITHIN THE HEADER HAS NO RELATIONSHIP TO THE ORDER IN WHICH SECTIONS ARE PHYSICALLY ARRANGED AFTER THE HEADER. A SECTION DIRECTORY’S NUMBER SPECIFIES HOW MANY ELEMENTS OF THAT TYPE ARE ACTUALLY PRESENT IN THE REPLY. IF A SECTION DIRECTORY’S NUMBER IS NONZERO, THEN THAT SECTION DIRECTORY’S OFFSET SPECIFIES THE OFFSET, FROM THE START OF THE REPLY HEADER, TO THE FIRST (OR ONLY) ELEMENT OF THAT TYPE. IF A SECTION DIRECTORY’S NUMBER IS GREATER THAN ONE, THEN THAT SECTION DIRECTORY’S LENGTH, WHICH SPECIFIES THE LENGTH OF A SINGLE ELEMENT OF THAT TYPE, MUST BE USED TO ACCESS THE SECOND AND SUBSEQUENT ELEMENTS OF THAT TYPE: ADD THE LENGTH TO THE OFFSET TO GET THE OFFSET TO THE SECOND ELEMENT; ADD IN THE LENGTH AGAIN TO GET THE OFFSET TO THE THIRD ELEMENT; AND SO ON. HEADER DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE SLX 0 (0) AREA 1 SLXRPLY REPLY HEADER 0 (0) CHARACTER 3 SLXHID HEADER IDENTIFIER 3 (3) A-ADDR 1 SLXCMDRC RETURN CODE: 0 (00) CONST SLXROK REQUEST PROCESSED SUCCESSFULLY 4 (04) CONST SLXRWARN REQUEST SUCCESSFUL WITH WARNING SLXSRC WILL PROVIDE THE SPECIFIC REASON FOR THE WARNING DEC HEX TYPE LENGTH LABEL DESCRIPTION 8 (08) CONST SLXRBADP REQUEST FAILED; THE REQUEST BLOCK (MAPPED BY ACSINT) CONTAINED INVALID DATA (E.G., INCOMPATIBLE OPTIONS); SLXSRC (REASON CODE) WILL PROVIDE THE OFFSET OF THE ACSINT FIELD FOUND TO BE IN ERROR. DEC HEX TYPE LENGTH LABEL DESFRIPTION 12 (0C) CONST SLXRIERR REQUEST FAILED; AN UNRECOVERABLE INTERNAL ERROR OCCURRED WHILE PROCESSING THE REQUEST. DEC HEX TYPE LENGTH LABEL DESCRIPTION 16 (10) CONST SLXRFAIL REQUEST FAILED; SLXSRC WILL PROVIDE THE SPECIFIC REASON FOR THE FAILURE. 20 (14) CONST SLXRNHSC REQUEST FAILED - HSC NOT AVAILABLE 44 (2C) CONST SLXRBADL REQUEST FAILED; REPLY AREA PROVIDED BY REQUESTOR WAS TOO SMALL TO CONTAIN ALL REPLY DATA ASSOCIATED WITH THE REQUEST. IF FIELD SLXCRLN IS NON-ZERO, IT CONTAINS THE LENGTH VALUE THAT SHOULD BE SPECIFIED FOR THE REPLY AREA FOR THIS REQUEST. 48 (30) CONST SLXRNVCI VCIRQST AND VCIRESP NOT SUPPORTED. EITHER VTCS IS NOT INSTALLED - OR - IS NOT AT THE REQUIRED LEVEL TO SUPPORT THE PGMI VCI RESPONSES. DEC HEX TYPE LENGTH LABEL 4 (04) A-ADDR 1 SLXVERS REPLY VERSION CODE: 7 (07) CONST 3 SLXVCODE THIS IS VERSION 9 OF THE REPLY AREA. 5 (5) HEXSTRING 4 -RESERVED- RESERVED. 8 (8) SIGNED-FWORD SLXSRC REASON CODE FOR FAILED OPERATION. 32818 (8032) CONST SLXTINTR PGMI TASK INTERRUPTED. 32822 (8036) CONST SLXSANF SEARCH ARGUMENT NOT FOUND. 32826 (803A) CONST SLXMSTT MISMATCHED TOKEN TYPES. 32832 (8040) CONST SLXTRNF TOKEN AREA NOT FOUND. 32848 (8050) CONST SLXSFUL REPLY AREA FULL. 32849 (8051) CONST SLXDVMM MEDIA INCOMPATIBLE WITH DEVICE TYPE. 12 (C) SIGNED-FWORD 4 SLXCRLN IF RETURN CODE (SLXCMDRC) IS 2C (SLXRBADL), THEN THIS FIELD CONTAINS EITHER THE MINIMUM ACCEPTABLE REPLY AREA LENGTH FOR THE REQUEST, OR 0 IF THE MINIMUM LENGTH COULDN’T BE DETERMINED. OTHERWISE (I.E., RETURN CODE ISN’T 2C), THIS FIELD CONTAINS THE ACTUAL LENGTH OF THIS REPLY. 16 (10) SIGNED-FWORD 4 SLXPEOFF PARAMETER ERROR OFFSET IF SLSXRC <> 0 THEN THIS POINTS TO AN ELEMENT IN A LIST WHERE PROCESSING STOPPED WHEN THE REQUEST WAS ”QCAP”. 20 (14) LENGTH SLXHL TO MAKE COMPATIBLE WITH MVS CODE CONFIGURATION SUMMARY SECTION DIRECTORY DEC HEX TYPE LENGTH LABEL DESCRIPTION 20 (14) SIGNED-FWORD 4 SLXXCFGN NUMBER OF CONFIGURATION ELEMENTS PRESENT IN THIS REPLY. 24 (18) SIGNED-FWORD 4 SLXXCFGO OFFSET TO CONFIGURATION SECTION, FROM START OF REPLY, OR 0 IF REPLY DOESN’T CONTAIN ANY CONFIGURATION ELEMENTS. 28 (1C) SIGNED-FWORD 4 SLXXCFGL LENGTH OF A CONFIGURATION ELEMENT. VOLUME INFORMATION SECTION DIRECTORY DEC HEX TYPE LENGTH LABEL DESCRIPTION 32 (20) SIGNED-FWORD 4 SLXXVOLN NUMBER OF VOLUME ELEMENTS PRESENT IN THIS REPLY. 36 (24) SIGNED-FWORD 4 SLXXVOLO OFFSET TO VOLUME SECTION, FROM START OF REPLY, OR 0 IF REPLY DOESN’T CONTAIN ANY VOLUME ELEMENTS. 40 (28) SIGNED-FWORD 4 SLXXVOLL LENGTH OF A VOLUME ELEMENT. DRIVE INFORMATION SECTION DIRECTORY DEC HEX TYPE LENGTH LABEL DESCRIPTION 44 (2C) SIGNED-FWORD 4 SLXXDRVN NUMBER OF DRIVE ELEMENTS PRESENT IN THIS REPLY. 48 (30) SIGNED-FWORD 4 SLXXDRVO OFFSET TO DRIVE SECTION, FROM START OF REPLY, OR 0 IF REPLY DOESN’T CONTAIN ANY DRIVE ELEMENTS. 52 (34) SIGNED-FWORD 4 SLXXDRVL LENGTH OF A DRIVE ELEMENT. LSM INORMATION SECTION DIRECTORY DEC HEX TYPE LENGTH LABEL DESCRIPTION 56 (38) SIGNED-FWORD 4 SLXXLSMN NUMBER OF LSM ELEMENTS PRESENT IN THIS REPLY 60 (3C) SIGNED-FWORD 4 SLXXLSMO OFFSET TO LSM SECTION, FROM START OF REPLY, OR 0 IF REPLY DOESN’T CONTAIN ANY LSM ELEMENTS. 64 (40) SIGNED-FWORD 4 SLXXLSML LENGTH OF AN LSM ELEMENT. MESSAGE TEXT SECTION DIRECTORY WARNING: THIS DIRECTORY DOES NOT EXIST WHEN THE VALUE IN THE REPLY VERSION NUMBER FIELD, SLXVERS, IS LESS THAN 2. DEC HEX TYPE LENGTH LABEL DESCRIPTION 68 (44) SIGNED-FWORD 4 SLXXMSGN NUMBER OF MESSAGE ELEMENTS PRESENT IN THIS REPLY. 72 (48) SIGNED-FWORD 4 SLXXMSGO OFFSET TO MESSAGE SECTION, FROM START OF REPLY, OR 0 IF REPLY DOESN’T CONTAIN ANY MESSAGE ELEMENTS. 76 (4C) SIGNED-FWORD 4 SLXXMSGL LENGTH OF A MESSAGE ELEMENT QCAP INFORMATION SECTION DIRECTORY DEC HEX TYPE LENGTH LABEL DESCRIPTION 80 (50) SIGNED-FWORD 4 SLXXCAPN NUMBER OF CAP ELEMENTS PRESENT IN THIS REPLY. 84 (54) SIGNED-FWORD 4 SLXXCAPO OFFSET TO CAP SECTION FROM START OF REPLY. 88 (58) SIGNED-FWORD 4 SLXXCAPL LENGTH OF A CAP ELEMENT. CONFIGURATION SUMMARY ELEMENT THIS ELEMENT APPEARS IN THE REPLY TO A QCONFIG REQUEST AND SUPPLIES SUMMARY INFORMATION ABOUT THE LIBRARY AND ABOUT REPLY LENGTHS NECESSARY FOR OTHER TYPES OF REQUESTS. 0 (0) STRUCTURE SLXSCFG CONFIGURATION SUMMARY ELEMENT. 0 (0) CHARACTER 3 SLXLID ELEMENT IDENTIFIER. 3 (3) HEXSTRING 1 -RESERVED- RESERVED. 4 (4) CHARACTER 8 SLXLHNAM HOST NAME. 12 (C) SIGNED-FWORD 4 SLXLHHBT HOST PULSE VALUE. 16 (10) SIGNED-FWORD 4 SLXLRSTM RESERVE TIMEOUT LIMIT. 20 (14) CHARACTER 8 SLXLQNAM ENQ MAJOR NAME. 28 (1C) CHARACTER 8 SLXLEJPS EJECT COMMAND PASSWORD (ENCRYPTED) 36 (24) CHARACTER 1 SLXLCMPF COMMAND PREFIX CHARACTER. 37 (25) A-ADDR 1 SLXLSCLB LIBRARY DEFAULT SCRATCH LABE L TYPE CODE: 1 (01) CONST SLXLLBSL STANDARD (SL). 2 (02) CONST SLXLLBAL ASCII (AL). 3 (03) CONST SLXLLBNL NON-LABELED (NL). 4 (04) CONST SLXLLBNS NON-STANDARD LABEL (NSL) 38 (26) A-ADDR 1 SLXLSMF SMF RECORD TYPE 39 (27) HEXSTRING 1 -RESERVED- RESERVED. 40 (28) SIGNED-FWORD 4 SLXQMDR LARGEST NUMBER OF DRIVES IN ANY ACS. 44 (2C) SIGNED-FWORD 4 SLXQDRCT NUMBER OF DRIVES IN THE LIBRARY. 48 (30) SIGNED-FWORD 4 SLXQACNT NUMBER OF ACSS IN THE LIBRARY. 52 (34) SIGNED-FWORD 4 SLXQLCNT NUMBER OF LSMS IN THE LIBRARY. 56 (38) SIGNED-FWORD 4 SLXZVOL MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A QVOLUME REQUEST THAT SPECIFIES THE LARGEST SUPPORTED NUMBER OF VOLUMES (500). 60 (3C) SIGNED-FWORD 4 SLXZQDRV MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A QDRIVES REQUEST. 64 (40) SIGNED-FWORD 4 SLXZQDRL MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A QDRLIST REQUEST. 68 (44) SIGNED-FWORD 4 SLXQVOL MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A QVOLUME REQUEST THAT SPECIFIES ONLY 1 VOLUME. 72 (48) SIGNED-FWORD 4 SLXZGSCR MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A SELSCR REQUEST. 76 (4C) SIGNED-FWORD 4 SLXZMDM MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A MOUNT REQUEST. 80 (50) SIGNED-FWORD 4 SLXZQSCR MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A QSCRATCH REQUEST. 84 (54) SIGNED-FWORD 4 SLXZDISM MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A DISMOUNT REQUEST. 88 (58) SIGNED-FWORD 4 SLXZEJCT MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO AN EJECT REQUEST THAT SPECIFIES THE LARGEST SUPPORTED NUMBER OF VOLUMES (500). 92 (5C) SIGNED-FWORD 4 SLXZSCR MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A SCRATCH REQUEST. WARNING: THE REMAINING FIELDS OF THIS ELEMENT ARE AVAILABLE FOR VERSION(S) 3 AND ABOVE. DEC HEX TYPE LENGTH LABEL DESCRIPTION 108 (6C) SIGNED-FWORD 4 SLXZMOVE MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO AN MOVE REQUEST. 112 (70) SIGNED-FWORD 4 SLXZEJC1 MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO AN EJECT REQUEST FOR ONLY 1 VOLUME. WARNING: THE REMAINING FIELDS OF THIS ELEMENT ARE AVAILABLE FOR VERSION(S) 6 AND ABOVE. DEC HEX TYPE LENGTH LABEL DESCRIPTION 116 (74) A-ADDR 4 SLXQUCSA MVS -- ADDRESS OF SLSUXCSA. 120 (78) SIGNED-FWORD 4 -RESERVED- RESERVED. 124 (7C) SIGNED-FWORD 4 SLXQLCAP NUMBER OF CAPS IN LIBRARY. 128 (80) SIGNED-FWORD 4 SLXEXLM0 ExLM R15 132 (84) SIGNED-FWORD 4 SLXEXLM1 ExLM R1 136 (88) SIGNED-FWORD 4 SLXEXLM2 ExLM R2 140 (8C) SIGNED-FWORD 4 SLXZQCAP MAXIMUM LENGTH OF REPLY DATA RETURNED IN RESPONSE TO A QCAP REQUEST. 156 (9C) SIGNED-FWORD 4 -RESERVED- RESERVED FUTURE USE. 160 (A0) SIGNED-HWORD 2 SLXHSCV HSC VERSION NUMBER 162 (A2) HEXSTRING 6 -RESERVED- 168 (A8) CONST SLXSCFGL LENGTH OF A CONFIGURATION ELEMENT. QDSN INFORMATION ELEMENT THIS ELEMENT APPEARS IN THE REPLY TO A QDSN REQUEST AND SUPPLIES SUMMARY INFORMATION ABOUT THE CURRENT REFERENCED DATASETS USED BY THE HSC. DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE SLXDSNIM DATASET INFORMATION MAP. 0 (0) CHARACTER 3 SLXQDID SECTION IDENTIFIER. 3 (03) BITSTRING 1 SLXDSFLG DATASET TYPE. 1 (01) CONST SLXDSPRM CDS PRIMARY. 2 (02) CONST SLXDSSEC CDS SECONDARY. 3 (03) CONST SLXDSSBY CDS STANDBY. 4 (04) CONST SLXDSVAT VOLUME ATTRIBUTES. 5 (05) CONST SLXDSUAT UNIT ATTRIBUTES. 6 (06) CONST SLXDSTRQ TAPEREQS. 7 (07) CONST SLXDSPLB PARMLIB. 8 (08) CONST SLXDSJNP PRIMARY JOURNAL. 9 (09) CONST SLXDSJNA ALTERNATE JOURNAL. 9 (09) CONST SLXDSMAX MAX NUMBER OF QDS RETURNED. 4 (04) CHARACTER 44 SLXDSNAM DATASET NAME. 48 (30) CHARACTER 8 SLXDSMBR MEMBER NAME. 56 (38) CHARACTER 6 SLXDSVOL VOLUME NAME. 62 (3E) CHARACTER 8 SLXDSUNT UNIT NAME. 70 (46) CHARACTER 2 -RESERVED- RESERVED. 72 (48) CHARACTER 96 -RESERVED- RESERVED. 168 (A8) AREA 8 -RESERVED- ALIGN 168 (A8) LENGTH SLXDSNEL LENGTH OF ONE DATASET ENTRY. CAP INFORMATION ELEMENT THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LIBRARY CAP DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE SLXSCAP 0 (0) CHARACTER 4 SLXCID SECTION IDENTIFIER. 4 (4) HEXSTRING 1 SLXCACS ACS ADDRESS. 5 (5) HEXSTRING 1 SLXCLSM LSM ADDRESS. 6 (6) HEXSTRING 1 SLXCCAP CAP NUMBER. 7 (7) HEXSTRING 1 -RESERVED- RESERVED. 8 (8) AREA 2 SLXCSTAT CAP STATUS. 8 (8) BITSTRING 1 SLXCSTB1 CAP STATUS. 1... .... X’80’ SLXCSTCA CAP IS ACTIVE. .1.. .... X’40’ SLXCSTNR CAP NEEDS RECOVERY. ..1. .... X’20’ SLXCSTAM CAP IS IN AUTOMATIC MODE. ...1 .... X’10’ SLXCSTCL CAP IS LINKED. .... 1... X’08’ SLXCSTCO CAP IS ONLINE. 9 (9) BITSTRING 1 SLXCSTB2 CAP MODE. 1... .... X’80’ SLXCSTIE CAP IS ENTERING. .1.. .... X’40’ SLXCSTID CAP IS DRAINING. ..1. .... X’20’ SLXCSTIJ CAP IS EJECTING. ...1 .... X’10’ SLXCSTIC CAP IS CLEANING. .... 1... X’08’ SLXCSTII CAP IS IDLE . 10 (A) BITSTRING 1 SLXTYPE TYPE OF CAP. 1... .... X’80’ SLXCTPC PRIORITY CAP .... ...1 X’01’ SLXCTCIM CIMARRON .... ..1. X’02’ SLXCTCLP CLIPPER. .... ..11 X’03’ SLXCTTWS STANDARD CLIPPER .... .1.. X’04’ SLXCTTWO OPTIONAL CLIPPER .... .1.1 X’05’ SLXCTTIM (9740/TimberWolf) 12 (C) SIGNED-HWORD 2 SLXCCELL CELLS IN CAP. 14 (E) HEXSTRING 1 SLXCNROW ROWS. 15 (F) HEXSTRING 1 SLXCNCOL COLUMNS. 16 (10) HEXSTRING 1 SLXCCMAG MAGAZINES. 17 (11) HEXSTRING 1 SLXCCMGC CELLS IN MAGAZINE. DEC HEX TYPE LENGTH LABEL DESCRIPTION 18 (12) CHARACTER 8 SLXCJOB JOBNAME OF OWNER. 26 (1A) HEXSTRING 6 -RESERVED- ALIGN TO DOUBLE WORD 32 (20) CONST SLXSCAPL LENGTH OF A CAP ELEMENT. VOLUME INFORMATION ELEMENT THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE VOLUME AND IS REPEATED FOR EACH VOLUME ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS: QDRLIST - RETURN DRIVE INFORMATION, ORDERED BY PREFERENCE QVOLUME - RETURN VOLUME INFORMATION SELSCR - SELECT A SCRATCH VOLUME EJECT - EJECT VOLUMES DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE SLXSVOL VOLUME INFORMATION ELEMENT. 0 (0) CHARACTER 3 SLXVID ELEMENT IDENTIFIER. 3 (3) BITSTRING 1 SLXVSTA VOLUME STATUS: 1... .... X’80’ SLXVILB VOLUME IS IN LIBRARY . .1.. .... X’40’ SLXVOHST VOLUME IS IN USE BY ANOTHER HOST . ..1. .... X’20’ SLXVSCR VOLUME IS CONSIDERED SCRATCH . ...1 .... X’10’ SLXVMAL VOLUME IS IN MANUAL-MODE LSM. .... 1... X’08’ SLXVDSC VOLUME IS IN DISCONNECTED ACS. .... .1.. X’04’ SLXVMNT VOLUME IS MOUNTED ON A DRIVE. .... ..1. X’02’ SLXVERR VOLUME IS ’ERRANT’ (I.E., ITS LOCATION WITHIN THE LIBRARY IS UNCERTAIN). .... ...1 X’01’ SLXVTV VOLUME IS A VTCS VIRTUAL VOLUME 4 (4) CHARACTER 6 SLXVSER VOLUME SERIAL. 10 (A) A-ADDR 1 SLXVLC VOLUME LOCATION CODE: 0 (0) CONST SLXVUNK LOCATION DATA UNAVAILABLE (SLXVLOC IS 0). 1 (1) CONST SLXVCEL LOCATION DATA DESCRIBES A CELL. 2 (02) CONST SLXVDRV LOCATION DATA DESCRIBES A DRIVE. 11 (B) AREA 5 SLXVLOC VOLUME LOCATION DATA: 11 (B) A-ADDR 1 SLXVACS ACS ID. 12 (C) A-ADDR 1 SLXVLSM LSM ID. 13 (D) A-ADDR 3 SLXVPNL CELL’S PANEL ID, ROW ID, COLUMN ID. 13 (D) A-ADDR 2 SLXVDRIV DRIVE ADDRESS (0CUU). 15 (F) BITSTRING 1 SLXVSTA2 MORE VOLUME STATUS: EQU X’E0’ RESERVED. ...1 .... X’10’ SLXVMLMU VOLUME MEDIA TYPE CAME FROM LMU. EQU X’08’ RESERVED. .... .1.. X’04’ SLXVMUNR VOLUME MEDIA TYPE UNREADABLE. .... ..1. X’02’ SLXVMVLA VOLUME MEDIA TYPE CAME FROM VOLATTR. .... ...1 X’01’ SLXVMDFL VOLUME MEDIA TYPE DEFAULT ASSIGNED. 16 (10) AREA 8 SLXVTSSN VTSS NAME 16 (10) SIGNED-FWORD 4 SLXVDATI HI-WORD OF TOD AT INSERTION. 20 (14) SIGNED-FWORD 4 SLXVDATL HI-WORD OF TOD LAST SELECTION. 24 (18) SIGNED-FWORD 4 SLXVSCNT SELECTION COUNT. 28 (1C) SIGNED-FWORD 4 SLXVDATD HI-WORD OF TOD LAST MOUNT. 32 (20) CHARACTER 8 SLXVMED TYPE OF MEDIA. DEC HEX TYPE LENGTH LABEL DESCRIPTION 40 (28) CONST SLXSVOLN LENGTH OF A VOLUME ELEMENT. 40 (28) CONST SLXSVOLL LENGTH OF A VOLUME ELEMENT. DRIVE INFORMATION ELEMENT THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LIBRARY TAPE DRIVE AND IS REPEATED FOR EACH DRIVE ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS: QDRIVES - RETURN DRIVE AND LSM INFORMATION QDRLIST - RETURN DRIVE INFORMATION, ORDEREDBY PREFERENCE DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE SLXSDRV DRIVE INFORMATION ELEMENT. 0 (0) CHARACTER 3 SLXDID ELEMENT IDENTIFIER 3 (3) BITSTRING 1 SLXDSTA LIBRARY STATUS: ...1 .... X’10’ SLXDMANU LSM IS IN MANUAL MODE. .... 1... X’08’ SLXDDISC ACS IS DISCONNECTED. 4 (4) A-ADDR 1 SLXQDEAC ACS ID. 5 (5) A-ADDR 1 SLXQDELS LSM ID. 6 (6) A-ADDR 2 SLXQDECU DRIVE ADDRESS (0CUU). 8 (8) CHARACTER 8 SLXQDRT RECORDING TECHNIQUE OF DRIVE 16 (10) CONST SLXSDRVL LENGTH OF A DRIVE ELEMENT. LSM INFORMATION ELEMENT THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LSM (LIBRARY STORAGE MODULE) AND IS REPEATED FOR EACH LSM ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS: QDRIVES - RETURN DRIVE AND LSM INFORMATION QSCRATCH - RETURN LSM INFORMATION, ORDERED BY PREFERENCE DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE SLXSLSM LSM INFORMATION ELEMENT 0 (0) CHARACTER 3 SLXMID ELEMENT IDENTIFIER. 3 (3) BITSTRING 1 SLXMSTAT LIBRARY STATUS: ...1 .... X’10’ SLXMANUL LSM IS IN MANUAL MODE .... 1... X’08’ SLXMDISC ACS IS DISCONNECTED. 4 (4) A-ADDR 1 SLXMACS ACS ID. 5 (5) A-ADDR 1 SLXMLSM LSM ID. 6 (6) SIGNED-FWORD 1 SLXMADJN NUMBER OF ADJACENT LSMS. 7 (7) A-ADDR 1 SLXMADJ(4) LIST OF LSM IDS OF ADJACENT LSMS (ONLY THE FIRST N IDS ARE VALID, WHERE N IS THE VALUE IN SLXMADJN). 11 (B) HEXSTRING 1 -RESERVED- RESERVED. 12 (C) SIGNED-FWORD 4 SLXMNSCR NUMBER OF SCRATCH VOLUMES IN THIS LSM. 16 (10) SIGNED-FWORD 4 SLXMTCEL TOTAL CELLS IN LSM. 20 (14) SIGNED-FWORD 4 SLXMFCEL FREE CELLS IN LSM. 24 (18) CONST SLXSLSML LENGTH OF AN LSM ELEMENT. MESSAGE TEXT ELEMENTTHIS ELEMENT SUPPLIES THE COMPLETE TEXT OF THE MESSAGE WHOSE BINARY MESSAGE ID NUMBER IS REPORTED IN HEADER FIELD SLXSRC. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:DISMOUNT - DISMOUNT A VOLUMEMOUNT - MOUNT A VOLUMEMOVE - MOVE A VOLUMEEJECT - EJECT VOLUMES DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE SLXSMSG MESSAGE TEXT ELEMENT. 0 (0) CHARACTER 3 SLXGID ELEMENT IDENTIFIER. 3 (3) CHARACTER 125 SLXGTEXT TEXT OF THE MESSAGE WHOSE NUMBER IS IN FIELD SLXSRC OF THE REPLY HEADER. 0 (0) STRUCTURE SLXSMSG 128 (80) CONST SLXSMSGL LENGTH OF A MESSAGE ELEMENT.
下表提供了对 SLX 宏的交叉引用:
名称 |
长度 |
偏移值 |
---|---|---|
|
000001 |
04 |
|
000001 |
06 |
|
000002 |
0C |
|
000001 |
10 |
|
000001 |
11 |
|
000004 |
00 |
|
000008 |
12 |
|
000001 |
05 |
|
000001 |
03 |
|
000001 |
0F |
|
000001 |
0E |
|
000004 |
0C |
|
NA |
20 |
|
000002 |
08 |
|
000001 |
08 |
|
000001 |
09 |
|
NA |
80 |
|
NA |
10 |
|
NA |
08 |
|
NA |
10 |
|
NA |
40 |
|
NA |
80 |
|
NA |
08 |
|
NA |
20 |
|
NA |
40 |
|
NA |
01 |
|
NA |
02 |
|
NA |
80 |
|
NA |
05 |
|
NA |
04 |
|
NA |
03 |
|
000001 |
0A |
|
NA |
08 |
|
000003 |
00 |
|
NA |
10 |
|
000001 |
03 |
|
NA |
09 |
|
NA |
08 |
|
NA |
09 |
|
000008 |
30 |
|
000044 |
04 |
|
NA |
A8 |
|
NA |
07 |
|
NA |
01 |
|
NA |
03 |
|
NA |
02 |
|
000001 |
03 |
|
NA |
06 |
|
NA |
05 |
|
000008 |
3E |
|
NA |
04 |
|
000006 |
38 |
|
NA |
8051 |
|
000008 |
B0 |
|
000004 |
80 |
|
000004 |
84 |
|
000004 |
88 |
|
000003 |
00 |
|
000125 |
03 |
|
000003 |
00 |
|
NA |
14 |
|
000002 |
A0 |
|
NA |
B0 |
|
000001 |
24 |
|
000008 |
1C |
|
000004 |
0C |
|
000008 |
04 |
|
000003 |
00 |
|
NA |
02 |
|
NA |
03 |
|
NA |
04 |
|
NA |
01 |
|
NA |
20 |
|
000008 |
14 |
|
000004 |
10 |
|
000001 |
25 |
|
000001 |
26 |
|
000001 |
04 |
|
000001 |
07 |
|
000001 |
06 |
|
NA |
10 |
|
NA |
08 |
|
000004 |
14 |
|
000003 |
00 |
|
000001 |
05 |
|
000004 |
0C |
|
000001 |
03 |
|
NA |
803A |
|
000004 |
10 |
|
NA |
28 |
|
NA |
1C |
|
000004 |
10 |
|
000004 |
30 |
|
000001 |
04 |
|
000002 |
06 |
|
000001 |
05 |
|
000003 |
00 |
|
000004 |
2C |
|
000008 |
08 |
|
000004 |
00 |
|
000004 |
08 |
|
NA |
00 |
|
NA |
18 |
|
NA |
FFFF |
|
000002 |
0C |
|
000004 |
04 |
|
000006 |
0E |
|
000004 |
7C |
|
000004 |
34 |
|
000004 |
28 |
|
000004 |
74 |
|
NA |
2C |
|
NA |
08 |
|
NA |
3C |
|
NA |
34 |
|
NA |
10 |
|
NA |
0C |
|
NA |
18 |
|
NA |
14 |
|
NA |
30 |
|
NA |
00 |
|
000001 |
00 |
|
NA |
38 |
|
NA |
04 |
|
NA |
8036 |
|
NA |
20 |
|
NA |
A8 |
|
NA |
10 |
|
NA |
8050 |
|
000004 |
00 |
|
NA |
18 |
|
NA |
80 |
|
000004 |
08 |
|
NA |
EE |
|
NA |
00 |
|
NA |
10 |
|
NA |
FF |
|
000001 |
09 |
|
000004 |
04 |
|
000001 |
08 |
|
NA |
28 |
|
NA |
28 |
|
NA |
8032 |
|
NA |
24 |
|
NA |
8040 |
|
000001 |
0B |
|
NA |
01 |
|
NA |
07 |
|
000004 |
1C |
|
000004 |
10 |
|
000004 |
14 |
|
000002 |
0D |
|
NA |
02 |
|
NA |
08 |
|
NA |
02 |
|
000001 |
04 |
|
000003 |
00 |
|
NA |
80 |
|
000001 |
0A |
|
000005 |
0B |
|
000001 |
0C |
|
NA |
10 |
|
NA |
01 |
|
000008 |
20 |
|
NA |
10 |
|
NA |
04 |
|
NA |
04 |
|
NA |
02 |
|
NA |
40 |
|
000003 |
0D |
|
000004 |
18 |
|
NA |
20 |
|
000006 |
04 |
|
000001 |
03 |
|
000001 |
0F |
|
000008 |
10 |
|
NA |
01 |
|
NA |
00 |
|
000004 |
58 |
|
000004 |
50 |
|
000004 |
54 |
|
000004 |
1C |
|
000004 |
14 |
|
000004 |
18 |
|
000004 |
34 |
|
000004 |
2C |
|
000004 |
30 |
|
000004 |
40 |
|
000004 |
38 |
|
000004 |
3C |
|
000004 |
4C |
|
000004 |
44 |
|
000004 |
48 |
|
000004 |
7C |
|
000004 |
74 |
|
000004 |
78 |
|
000004 |
64 |
|
000004 |
5C |
|
000004 |
60 |
|
NA |
B0 |
|
000004 |
70 |
|
000004 |
68 |
|
000004 |
6C |
|
000004 |
88 |
|
000004 |
80 |
|
000004 |
84 |
|
000004 |
28 |
|
000004 |
20 |
|
000004 |
24 |
|
000004 |
60 |
|
000004 |
64 |
|
000004 |
54 |
|
000004 |
58 |
|
000004 |
70 |
|
000004 |
48 |
|
000004 |
4C |
|
000004 |
6C |
|
000004 |
8C |
|
000004 |
40 |
|
000004 |
3C |
|
000004 |
98 |
|
000004 |
90 |
|
000004 |
50 |
|
000004 |
44 |
|
000004 |
5C |
|
000004 |
68 |
|
000004 |
94 |
|
000004 |
38 |
借助 ACSINT 可以在 TMS 与 ACS 服务机之间传递信息。它由 ACSRQ 宏在指定了 DSECT=YES
时构建,并且使用 IUCV 发送。
注:
以下 DSECT 包括一些不受 VM Client 支持的参数。包括它们只是为了说明完整性和兼容性。以下示例显示了 ACSINT 记录格式的输出:
ACSINT - TMS INTERFACE REQUEST PARAMETER LIST FUNCTION: THIS DEFINES THE DATA PASSED TO THE TMS VIA IUCV IT DEFINES THE VARIOUS FUNCTIONS THAT CAN BE REQUESTED AND THE STRUCTURE PASSED. DEC HEX TYPE LENGTH LABEL DESCRIPTION 0 (0) STRUCTURE ACSINT TMS INTERFACE PARAMETER LIST: 0 (0) CHARACTER 4 ACSIHDR PARAMETER LIST IDENTIFIER. ’ACSI’(C1C3E2C9)CHAR CONST ACSIID 4 (4) SIGNED-FWORD 4 ACSILEN PARAMETER LIST LENGTH. 8 (8) A-ADDR 1 ACSIVER PARAMETER LIST VERSION NUMBER. 7 (07) CONST ACSIVN CURRENT VERSION. 9 (9) A-ADDR 1 ACSIRT FUNCTION CODE: 0 (00) CONST ACSINOOP NOOP - NO OPERATION. 1 (01) CONST ASCIRS01 RESERVED - MVS ONLY. 2 (02) CONST ASCIRS02 RESERVED - MVS ONLY. 3 (03) CONST ASCIRS03 RESERVED - MVS ONLY. 4 (04) CONST ASCISTOP STOP - STOP AN INTERRUPTABLE PGMI TASK. 5 (05) CONST ACSISOPR SETOPER - SET OPERATOR INTERACTION MODE. 20 (14) CONST ACSIQCNF QCONFIG - RETURN CONFIGURATION SUMMARY. 21 (15) CONST ACSIQDRV QDRIVES - RETURN DRIVE AND LSM INFO. 22 (16) CONST ACSIQDRL QDRLIST - RETURN DRIVE INFORMATION, X . 23 (17) CONST ACSIQSCR QSCRATCH - RETURN SCRATCH COUNT INFO. 24 (18) CONST ACSIQVOL QVOLUME - RETURN VOLUME INFORMATION. 25 (19) CONST ACSIQEJT QEJECT - RETURN EJECT STATUS. 26 (1A) CONST ACSIQCAP QCAP - QUERY CAP STATUS. 27 (1B) CONST ACSIQVLU QVOLUSE - RETURN MOUNTED VOLUMES. 28 (1C) CONST ACSIQRQS QREQUEST - RETURN PENDING REQUESTS. 29 (1D) CONST ACSIQDSN QDSN - QUERY DATASET. 40 (29) CONST ACSIMNT MOUNT - MOUNT VOLUME. 41 (29) CONST ACSIMOVE MOVE - MOVE A CARTRIDGE TO AN LSMID X. 42 (2A) CONST ACSIDSM DISMOUNT - DISMOUNT VOLUME. 43 (2B) CONST ACSIEJCT EJECT - EJECT A VOL FROM THE LIBRARY. 60 (3C) CONST ACSISSCR SELSCR - SELECT A SCRATCH VOLUME. 61 (3D) CONST ACSISCRA SCRATCH - CHANGE VOL STATUS TO ’SCRATCH’. 62 (3E) CONST ACSIUNSC UNSCRATCH- CHANGE VOLUME STATUS TO NOT X. 63 (3F) CONST ACSIDSCR DEFSCR - SPECIFY NO. OF SCRATCH POOLS. 64 (40) CONST ACSIDPOL DEFPOOL - SPECIFY A SCRATCH POOL’S VOLSER RANGE. 10 (A) BITSTRING 1 ACSIFLG1 FLAG BYTE 1: (PGMI CONTROL 1) 1 1... .... X’80’ ACSIF180 RESERVED MVS OPTION=SYNC .1.. .... X’40’ ACSIVUSR USER= SPECIFIED; ACSIUSER CONTAINS NAME ..1. .... X’20’ ACSIMANO DIALOG=OFF SPECIFIED. ...1 .... X’10’ ACSIWTOR DIALOG=ON SPECIFIED. .... 1... X’08’ ACSINDEL NOTIFY=INSDEL SPECIFIED. .... .1.. X’04’ ACSINNDL NOTIFY=NOINSDEL SPECIFIED. .... ..1. X’02’ ACSIACC1 ACCT1= SPECIFIED ACCOUNTING TOKEN. .... ...1 X’01’ ACSIACC2 ACCT2= SPECIFIED ACCOUNTING TOKEN. 11 (B) HEXSTRING 1 ACSIFLG2 FLAG BYTE 2: (PGMI CONTROL 2). 12 (C) BITSTRING 1 ACSIFLG3 FLAG BYTE 3: (MOVEMENT CONTROL 1). 1... .... X’80’ ACSIVHST ACSIHOST CONTAINS HOST_ID. .1.. .... X’40’ ACSIVACS ACSIACS CONTAINS AN ACSID. ..1. .... X’20’ ACSIVLSM ACSILSMI CONTAINS LSMID. ...1 .... X’10’ ACSIVCAP ACSICAP CONTAINS CAP_ID. .... 1... X’08’ ACSIF308 RESERVED FUTURE USE. .... .1.. X’04’ ACSIVVOL ACSIVOLS CONTAINS A VOLSER. .... ..1. X’02’ ACSIVLST ACSILOFF CONTAINS LIST OFFSET. .... ...1 X’01’ ACSIVCNT ACSICNT CONTAINS LIST COUNT. 13 (D) BITSTRING 1 ACSIFLG4 FLAG BYTE 4: (MOVEMENT CONTROL 2). 1... .... X’80’ ACSIVTLM ACSITLSM CONTAINS TO LSM_ID. .1.. .... X’40’ ACSIVTPN ACSITPAN CONTAINS TO PANEL. ..1. .... X’20’ ACSIF420 RESERVED FUTURE USE. ...1 .... X’10’ ACSIF410 RESERVED FUTURE USE. .... 1... X’08’ ACSIVPAN ACSIPAN CONTAINS PANEL NUMBER .... .1.. X’04’ ACSIVROW ACSIROW CONTAINS ROW NUMBER. .... ..1. X’02’ ACSIVCOL ACSICOL CONTAINS COLUMN NUMBER. .... ...1 X’01’ ACSIVDRV ACSIDRIV CONTAINS DRIVE DEVICE NUMBER. 14 (E) HEXSTRING 1 ACSIFLG5 FLAG BYTE 5: (MOVEMENT CONTROL 3). 15 (F) BITSTRING 1 ACSIFLG6 FLAG BYTE 6: (MISCELLANOUS CONTROL 1). 1... .... X’80’ ACSIPROT PROTECT=YES SPECIFIED. .1.. .... X’40’ ACSISCR SCRATCH=YES SPECIFIED. ..1. .... X’20’ ACSIVSCP ACSIPOOL CONTAINS SCRATCH POOL NUMBER. ...1 .... X’10’ ACSISUBN ACSISUBP CONTAINS SUBPOOL NAME. .... 1... X’08’ ACSIVTKN ACSITKNO CONTAINS TOKEN NUMBER. .... .1.. X’04’ ACSIVTXT ACSITEXT CONTAINS TEXT STRING. .... ..1. X’02’ ACSIF602 RESERVED FUTURE USE. .... ...1 X’01’ ACSIF601 RESERVED FUTURE USE. 16 (10) HEXSTRING 1 ACSIFLG7 FLAG BYTE 7: (MISCELLANOUS CONTROL 2). 17 (11) A-ADDR 1 ACSILABT SCRATCH LABEL TYPE LTYPE= PARAMETER. .... .... X’00’ ACSILLDT LDT (LIBRARY DEFAULT TYPE). .... ...1 X’01’ ACSILSL SL (STANDARD LABEL). .... ..1. X’02’ ACSILAL AL (ANSI LABEL). .... ..11 X’03’ ACSILNL NL (NON-LABELED). .... .1.. X’04’ ACSILNS NSL (NON-STANDARD LABEL). 18 (12) CHARACTER 8 ACSIUSER USER NAME USED TO ASSOCIATE CONSOLE ID. 26 (1A) CHARACTER 8 ACSIACT1 ACCOUNTING TOKEN 1. 34 (22) CHARACTER 8 ACSIACT2 ACCOUNTING TOKEN 2. 42 (2A) HEXSTRING 2 -RESERVED- RESERVE SLACK BYTES. 44 (2C) SIGNED-FWORD 4 -RESERVED- RESERVED MVS. 48 (30) HEXSTRING 4 ACSITKNO PASS THROUGH TOKEN NUMBER. 52 (34) A-ADDR 4 -RESERVED- RESERVED MVS. 56 (38) SIGNED-HWORD 2 ACSICNT COUNT FROM COUNT= PARAMETER. 58 (3A) SIGNED-HWORD 2 ACSILOFF OFFSET, FROM START OF PARAMETER LIST, TO START OF THE ELEMENT LIST AREA. 60 (3C) CHARACTER CHARACTER 6 ACSIVOLS VOLSER FROM VOLSER= PARAMETER. 66 (42) CHARACTER 8 ACSIHOST ASSOCIATED HOST FROM HOSTID= PARAMETER. 74 (4A) AREA 4 ACSIALC ACS / LSM / CAP IDENTIFICATION. 74 (4A) HEXSTRING 1 ACSIACS ACS ID NUMBER (AA). 74 (4A) HEXSTRING 2 ACSILSMI LSM ID NUMBER (AA0L). 74 (4A) HEXSTRING 4 ACSICAP CAP ID NUMBER (AA0LCC00). 74 (4A) HEXSTRING 3 -RESERVED- 77 (4D) HEXSTRING 1 -RESERVED- NOT IMPLEMENTED (ALWAYS X’00’) . 78 (4E) HEXSTRING 1 ACSIPAN PANEL FROM PAN= PARAMETER. 79 (4F) HEXSTRING 1 ACSIROW ROW FROM ROW= PARAMETER. 80 (50) HEXSTRING 1 ACSICOL COLUMN FROM COL= PARAMETER. 81 (51) HEXSTRING 1 ACSITPAN TO PANEL FROM TOPAN= PARAMETER. 82 (52) HEXSTRING 2 ACSITLSM TO LSM FROM TOLSM= PARAMETER. 84 (54) A-ADDR 2 ACSIDRIV DRIVE DEVICE NUMBER FROM DRIVE= PARAMETER. 86 (56) A-ADDR 1 ACSIPOOL SCRATCH POOL NUMBER, SCRPOOL= PARAMETER. 87 (57) CHARACTER 32 ACSITEXT TEXT ASSOCIATED WITH REQUEST. 119 (77) CHARACTER 13 ACSISUBP NAME FROM SUBPOOL= KEYWORD. TAPEREQ INPUT KEY VALUES.THE FOLLOWING VALUES ARE USED AS THE KEY IN SEARCHING THE CURRENT TAPEREQ PARAMETER FILE. DEC HEX TYPE LENGTH LABEL DESCRIPTION 132 (84) BITSTRING 1 ACSIFLG8 FLAG BYTE 8: (TAPEREQ CONTROL 1). 1... .... X’80’ ACSIFJOB ACSIJOBN PRESENT. .1.. .... X’40’ ACSIFSTP ACSISTEP PRESENT. ..1. .... X’20’ ACSIFPGM ACSIPGMN PRESENT. ...1 .... X’10’ ACSIFDSN ACSIDSN PRESENT. .... 1... X’08’ ACSIFEXP ACSIEXPD PRESENT. .... .1.. X’04’ ACSIFRET ACSIRETP PRESENT. .... ..1. X’02’ ACSIFVOL ACSIVOLT PRESENT. 133 (85) OFFSET ACSITRI TAPEREQ INPUT VALUES. 133 (85) CHARACTER 8 ACSIJOBN STRING TO MATCH TAPEREQ JOBNAME VALUE. 141 (8D) CHARACTER 8 ACSISTEP STRING TO MATCH TAPEREQ STEPNAME VALUE. 149 (95) CHARACTER 8 ACSIPGMN STRING TO MATCH TAPEREQ PROGNAME VALUE. 157 (9D) CHARACTER 44 ACSIDSN STRING TO MATCH TAPEREQ DSN VALUE. 201 (C0) HEXSTRING 3 ACSIEXPD VALUE TO MATCH TAPEREQ EXPDT VALUE 204 (CC) HEXSTRING 2 ACSIRETP VALUE TO MATCH TAPEREQ RETPD VALUE. 206 (CE) CHARACTER 1 ACSIVOLT STRING TO MATCH TAPEREQ VOLTYPE VALUE. 74 (4A) LENGTH ACSITRIL TAPEREQ OUTPUT VALUES. THE FOLLOWING VALUES ARE USED AS OVERRIDE (OR SPECIFIC) VALUES TO THE VALUES FOUND IN THE CURRENT TAPEREQ PARAMETER FILE. 207 (CF) BITSTRING 1 ACSIFLG9 FLAG BYTE 9: (TAPEREQ CONTROL 2). 1... .... X’80’ ACSIFREC ACSIRECT PRESENT. .1.. .... X’40’ ACSIFMED ACSIMED PRESENT. 208 (D0) CHARACTER 8 ACSIRECT RECORDING TECHNIQUE. 216 (D8) CHARACTER 8 ACSIMED MEDIA. 224 (E0) HEXSTRING 256 -RESERVED- RESERVED FOR FUTURE PARM EXPANSION. 480 (1E0) AREA 8 -RESERVED- ALIGNMENT. 480 (1E0) LENGTH ACSIHLN LENGTH OF FIXED AREA. 480 (1E0) AREA 1 ACSILIST ELEMENT LIST DESIGNATED BY LIST= PARAMETER BEGINS HERE (FIELD ACSICNT CONTAINS THE NUMBER OF ELEMENTS IN THIS LIST). 2 (02) CONST ACSILDRL LENGTH OF EACH ELEMENT (DRIVE DEVICE NUMBER) IN THE LIST USED BY THE QDRLIST FUNCTION. 1500 (5DC) CONST ACSIMDRL MAXIMUM NUMBER OF ELEMENTS ALLOWED IN THE LIST USED BY THE QDRLIST FUNCTION. 6 (06) CONST ACSILVSL LENGTH OF EACH ELEMENT (VOLSER) IN THE LIST USED BY THE QVOLUME FUNCTION. 500 (1F4) CONST ACSIMVSL MAXIMUM NUMBER OF ELEMENTS ALLOWED IN THE LIST USED BY THE QVOLUME AND EJECT. 12 (0C) CONST ACSILPOL LENGTH OF EACH ELEMENT (VOLSER RANGE PAIR) IN THE LIST USED BY THE DEFPOOL FUNCTION. 250 (FA) CONST ACSIMPOL MAXIMUM NUMBER OF ELEMENTS ALLOWED IN THE LIST USED BY THE DEFPOOL FUNCTION. 4 (04) CONST ACSILCAP LENGTH OF EACH ELEMENT (CAP IDENTIFIER) IN THE LIST USED BY THE QCAP FUNCTION. 500 (1F4) CONST ACSIMCAP MAXIMUM NUMBER OF ELEMENTSALLOWED IN THE LIST USED BY THE QCAP FUNCTION. 4 (04) CONST ACSILTOK LENGTH OF EACH ELEMENT (UNIQUE TOKEN) IN THE LIST USED BY THE QCAP FUNCTION. 500 (1F4) CONST ACSIMTOK MAXIMUM NUMBER OF ELEMENTS ALLOWED IN THE LIST USED BY THE QEJECT/STOP FUNCTIONS.
下表提供了对 ACSINT 宏的交叉引用:
名称 |
长度 |
偏移值 |
---|---|---|
|
NA |
02 |
|
NA |
01 |
|
000001 |
4A |
|
000008 |
1A |
|
000008 |
22 |
|
000004 |
4A |
|
000004 |
4A |
|
000002 |
38 |
|
000001 |
50 |
|
NA |
40 |
|
000002 |
54 |
|
NA |
3F |
|
NA |
2A |
|
000044 |
9D |
|
NA |
2B |
|
000003 |
C9 |
|
NA |
10 |
|
NA |
08 |
|
NA |
80 |
|
000001 |
0A |
|
000001 |
0B |
|
000001 |
0C |
|
000001 |
0D |
|
000001 |
0E |
|
000001 |
0F |
|
000001 |
10 |
|
000001 |
84 |
|
000001 |
CF |
|
NA |
40 |
|
NA |
40 |
|
NA |
80 |
|
000008 |
D8 |
|
NA |
28 |
|
NA |
29 |
|
NA |
FA |
|
NA |
1F4 |
|
NA |
04 |
|
NA |
40 |
|
NA |
02 |
|
NA |
80 |
|
NA |
08 |
|
NA |
10 |
|
NA |
20 |
|
NA |
01 |
|
NA |
02 |
|
000004 |
00 |
|
NA |
1E0 |
|
000008 |
42 |
|
NA |
’CVAL’ |
|
000008 |
85 |
|
000001 |
11 |
|
NA |
02 |
|
NA |
04 |
|
NA |
02 |
|
000001 |
1E0 |
|
NA |
00 |
|
NA |
03 |
|
NA |
04 |
|
000002 |
3A |
|
NA |
0C |
|
NA |
01 |
|
000002 |
4A |
|
NA |
04 |
|
NA |
06 |
|
NA |
20 |
|
NA |
1F4 |
|
NA |
5DC |
|
NA |
40 |
|
NA |
04 |
|
NA |
40 |
|
NA |
04 |
|
NA |
10 |
|
NA |
1F4 |
|
NA |
08 |
|
NA |
04 |
|
NA |
00 |
|
000001 |
4E |
|
000008 |
95 |
|
000001 |
56 |
|
NA |
80 |
|
NA |
1A |
|
NA |
14 |
|
NA |
16 |
|
NA |
15 |
|
NA |
1D |
|
NA |
19 |
|
NA |
1C |
|
NA |
01 |
|
000001 |
08 |
|
NA |
80 |
|
NA |
20 |
|
NA |
02 |
|
NA |
07 |
|
000006 |
3C |
|
000001 |
CE |
|
NA |
08 |
|
NA |
04 |
|
NA |
20 |
|
NA |
08 |
|
NA |
80 |
|
000001 |
4F |
|
NA |
01 |
|
NA |
02 |
|
NA |
03 |
|
000001 |
09 |
|
NA |
40 |
|
NA |
3D |
|
NA |
05 |
|
NA |
3C |
|
000008 |
8D |
|
NA |
04 |
|
NA |
10 |
|
000013 |
77 |
|
000032 |
57 |
|
000004 |
30 |
|
000002 |
52 |
|
000001 |
51 |
|
NA |
85 |
|
NA |
4A |
|
NA |
3E |
|
000008 |
12 |
|
NA |
40 |
|
NA |
10 |
|
NA |
01 |
|
NA |
02 |
IUB 描述了由于 IUCV 操作而产生的未处理的 IUCV 请求。请求和最终状态均包含在 IUB 数据结构中。IUB 是供设备管理使用的 IOBLOK 结构的 IUCV 对等结构。
下表提供了对 IUB IUCV 请求块的交叉引用:
名称 |
长度 |
偏移值 |
---|---|---|
|
NA |
02 |
|
NA |
01 |
|
000001 |
4A |
|
000008 |
1A |
|
000008 |
22 |
|
000004 |
4A |
|
000004 |
4A |
|
000002 |
38 |
|
000001 |
50 |
|
NA |
40 |
|
000002 |
54 |
|
NA |
3F |
|
NA |
2A |
|
000044 |
9D |
|
NA |
2B |
|
000003 |
C9 |
|
NA |
10 |
|
NA |
08 |
|
NA |
80 |
|
000001 |
0A |
|
000001 |
0B |
|
000001 |
0C |
|
000001 |
0D |
|
000001 |
0E |
|
000001 |
0F |
|
000001 |
10 |
|
000001 |
84 |
|
000001 |
CF |
|
NA |
40 |
|
NA |
20 |
|
NA |
04 |
|
NA |
40 |
|
NA |
02 |
|
NA |
80 |
|
NA |
08 |
|
NA |
10 |
|
NA |
20 |
|
NA |
01 |
|
NA |
02 |
|
000004 |
00 |
|
NA |
1E0 |
|
000008 |
42 |
|
NA |
’CVAL’ |
|
000008 |
85 |
|
000001 |
11 |
|
NA |
02 |
|
NA |
04 |
|
NA |
02 |
|
000001 |
1E0 |
|
NA |
00 |
|
NA |
03 |
|
NA |
04 |
|
000002 |
3A |
|
NA |
0C |
|
NA |
01 |
|
000002 |
4A |
|
NA |
04 |
|
NA |
06 |
|
NA |
20 |
|
NA |
1F4 |
|
NA |
80 |
|
000008 |
D8 |
|
NA |
28 |
|
NA |
29 |
|
NA |
FA |
|
NA |
1F4 |
|
NA |
1F4 |
|
NA |
08 |
|
NA |
04 |
|
NA |
00 |
|
000001 |
4E |
|
000008 |
95 |
|
000001 |
56 |
|
NA |
80 |
|
NA |
1A |
|
NA |
14 |
|
NA |
16 |
|
NA |
15 |
|
NA |
1D |
|
NA |
19 |
|
NA |
1C |
|
NA |
01 |
|
000001 |
08 |
|
NA |
80 |
|
NA |
20 |
|
NA |
02 |
|
NA |
07 |
|
000006 |
3C |
|
000001 |
CE |
|
NA |
08 |
|
NA |
04 |
|
NA |
20 |
|
NA |
08 |
|
NA |
80 |
|
NA |
5DC |
|
NA |
40 |
|
NA |
04 |
|
NA |
40 |
|
NA |
04 |
|
NA |
10 |
|
000001 |
4F |
|
NA |
01 |
|
NA |
02 |
|
NA |
03 |
|
000001 |
09 |
|
NA |
40 |
|
NA |
3D |
|
NA |
05 |
|
NA |
3C |
|
000008 |
8D |
|
NA |
04 |
|
NA |
10 |
|
000013 |
77 |
|
000032 |
57 |
|
000004 |
30 |
|
000002 |
52 |
|
000001 |
51 |
|
NA |
85 |
|
NA |
4A |
|
NA |
3E |
|
000008 |
12 |
|
NA |
40 |
|
NA |
10 |
|
NA |
01 |
|
NA |
02 |
下表提供了对 IUB 的交叉引用:
名称 |
长度 |
偏移值 |
---|---|---|
|
000001 |
31 |
|
NA |
10 |
|
000016 |
10 |
|
000001 |
20 |
|
000004 |
44 |
|
000001 |
21 |
|
000004 |
34 |
|
000040 |
78 |
|
000008 |
78 |
|
000008 |
80 |
|
000008 |
88 |
|
000008 |
90 |
|
000008 |
98 |
|
000004 |
0C |
|
000001 |
30 |
|
000001 |
32 |
|
NA |
20 |
|
000004 |
2C |
|
NA |
24 |
|
NA |
A0 |
|
NA |
08 |
|
NA |
40 |
|
000004 |
3C |
|
000040 |
50 |
|
000008 |
50 |
|
000008 |
58 |
|
000008 |
60 |
|
000008 |
68 |
|
000008 |
70 |
|
000016 |
00 |
|
NA |
80 |
|
NA |
08 |
|
NA |
20 |
|
NA |
40 |
|
NA |
80 |
|
000004 |
28 |