9 VM Client 磁带管理接口

本章介绍 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 命令:

  • DEFSCRDEFPOOL

    这些功能由 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 交互的各种情况。

后面几部分详细介绍了这些主题。

TMS 责任

磁带管理系统有三个主要功能:

  • 用户界面

  • 磁带资源分配

  • 操作员界面

用户界面

通常,最终用户通过从磁带管理系统 (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 的请求处理它所控制的卷。

操作员界面

磁带挂载、卸载和擦写池的选择通过 TMS 与操作员之间的消息通信进行处理。VM Client 使用发送给操作员的消息中提供的信息指导挂载、卸载等。

TMS 决策点

通过 VM Client 为 TMS 提供 TapePlex 服务时,TapePlex 服务器会影响 TMS 决策。TapePlex 服务器在以下几方面影响 TMS 决策:

TMS 初始化

当 TMS 初始化时,让 TMS 与 VM Client 计算机建立 IUCV 路径,以确定 VM Client 和 TapePlex 服务器是否都在运行且正在通信。如果在 TMS 启动时 VM Client 计算机未在运行,则在 VM Client 和 TapePlex 初始化后尽快建立 IUCV 路径。可以为每个事务建立和断开连接,但是这样会导致不必要的处理。要高效地使用 IUCV,必须在整个 TMS 通信会话过程中建立并维护一条路径。

磁带机分配

在分配时,VM Client 可以提供有关特定卷的介质和位置以及擦写卷计数的信息。TMS 可以使用查询的结果针对分配请求选择兼容的最佳磁带机。

擦写卷分配

如果 TMS 请求,VM Client 可以在 MOUNT 请求之前提供擦写卷的 VOLSER。在后续挂载时可以拒绝这一选择,也可以应用这一选择。如果不需要该信息,非特定 MOUNT 请求会导致选择擦写卷。

卷移动

当需要对卷执行挂载、卸载或其他移动时,TMS 将决定是由 TapePlex 执行操作还是需要手动操作。VM Client 将返回卷移动请求的状态信息。

使卷返回到擦写状态

TMS 与 TapePlex 擦写状态需要保持同步。最早一次是在卸载时,最后一次是在生成 TMS 擦写卷拉取列表时。可以使用 TMI 请求和 VM Client 命令来协调此活动。

返回 TMS 的 TapePlex 信息

返回的 TapePlex 信息包括:

配置信息

配置信息包括:

  • 最大 ACS 中的最大传送装置数

  • 磁带库控制下的传送装置数

  • ACS 数

  • LSM 数

  • 响应区域大小

卷状态

卷状态信息包括:

  • 卷在单元中

  • 卷在磁带机中

  • 卷不在磁带库中

  • 卷不可访问

  • 卷位置不确定(非正常)

卷位置

卷位置信息包括:

  • ACSid

  • LSMid

  • 面板位置

  • 行位置

  • 列位置

符合条件的磁带机

从 TapePlex 的角度来看,符合条件的磁带机是与卷在同一个 ACS 或 VTSS 中且采用的录制技术与卷兼容的磁带机。不考虑磁带机的实际可用性(可连接性、联机状态)。

移动状态和错误代码

卷移动请求将返回一个代码,指示操作成功与否。如果发生了错误,还会返回一个额外的代码,它对应于向操作员发出的消息。

LSM 和 ACS 状态

LSM 状态为联机或脱机。联机表明可以执行自动挂载。脱机表明只能执行手动挂载。

ACS 状态为已连接或已断开连接。已断开连接表明无法从该主机上访问 ACS,任何活动都必须从其他主机上进行处理。

  • 用于擦写卷管理的 VOLSER

    如果请求选择擦写卷,将返回在 TapePlex 控制数据集中标记为擦写的 VOLSER。这一选择会导致将卷标记为非擦写。

  • 虚拟磁带机和虚拟卷的磁带库表示法

    使用 VM Client,TMS 可以访问虚拟磁带机和虚拟卷。磁带管理接口将每个 VTSS 映射到一个 ACS ID 和一组 LSM ID,以使 TMS 可以像处理实际卷一样来处理虚拟磁带机和虚拟卷。VM Client 提供 VTSS 到 ACS 的映射,并确保表示 VTSS 的 ACS ID 不会与实际 ACS 重叠。不允许对虚拟卷执行卷移动操作,例如 EJECTMOVEENTER

用户间通信工具 (Inter-user Communications Vehicle, IUCV) 注意事项

用户间通信工具 (inter-user communication vehicle, IUCV) 是 IBM 提供的通信接口。

注:

VMTMI SAMPLE 是一个程序样例,说明了如何使用 VM Client 磁带管理接口。可以通过 MAINTSTK 用户 ID 找到该样例。

要使用 IUCV 发出请求,请执行以下步骤:

  1. 使用 IUCV CONNECT 函数与 VM Client 服务机建立连接。

    • 只有经授权的虚拟机才能向 VM Client 服务机发出命令。要获得许可,发出 TMI 或 VM Client 命令的虚拟机必须得到适当的权限,而这些权限通过启动时在 SMCPARMSSMCCMDS 文件中向 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 请求者指定的参数无效。

  2. 使用 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 是回复缓冲区的长度。

  3. 用完与 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》。

TMS 与 VM Client 交互

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 配置不同而异。因此,可在使用这些区域之前对其进行分配。

初始连接对话

在连接时,应发出 QCONFIG 请求,以确定其他请求所需的回复数据区的大小。例如:

示例 9-1 初始连接对话

TMS                                   VM CLIENT
                        |
ICUV CONNECT     <==============>     IUCV ACCEPT
                        |
ACSRQ QCONFIG           |
IUCV SEND        <==============>     IUCV RECEIVE
                        |             Format return data
                 <==============>     IUCV REPLY
Calculate sizes         |
Store in global area    |

磁带机分配

TMS 完全负责磁带机分配,而 VM Client 和 TapePlex 可以在此过程中提供协助,方法是呈现磁带机的列表,按满足特定卷和擦写卷挂载的适合程度的顺序列出磁带机。

下一部分介绍 TMS 分配接口与 VM Client 之间的交互。

分配交互

TMS 服务机从虚拟机接收挂载卷的请求,然后调用分配接口例程。

如果未与 VM Client 服务机建立 IUCV 路径,则磁带管理系统会尝试建立一个。如果尝试失败,则不会发生分配协助,一个返回代码会指明这种情况,还可能会设置一个标志,以告知消息接口:无法进行操作员消息处理,因为未执行特殊分配。

分配对话

  1. 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
                            |             
    
  2. 分配接口等待 IUCV REPLY

  3. VM Client 例程收集数据,设置响应的格式,并发出 IUCV REPLY。IUCV REPLYSLX 宏进行映射。

  4. TMS IUCV 支持函数通知正在等待的分配进程:已收到响应。

  5. 分配接口例程随后重新设置回复的格式以使其形成一个磁带机首选项列表(与 TMS 有关的格式),将回复与 TMS 管理的可用磁带机进行比较,然后离开接口。

  6. 如果需要选择擦写卷,则发出:

    ACSRQ SELSCR,DRIVE=drivadr
    

    此命令将返回 VOLSER,并在控制数据集中将该卷标记为非擦写,或者指明没有可用的擦写卷。

    TMS                                   VM CLIENT
                            |
    ACSRQ SELSCR            |
    ICUV SEND        <==============>     IUCV RECEIVE
                            |             Select VOLSER and 
                            |             mark nonscratch
    Store VOLSER     <==============>     IUCV REPLY
                            |             
    

分配接口的终止

当分配接口例程完成处理时,会将控制权返还给 TMS。

操作消息处理

此部分介绍 TMS 消息接口与 VM Client 之间的交互。“操作员消息对话”部分概述了 MOUNT 请求的处理。其他消息接口点请求(例如 DISMOUNTSCRATCH)都经过相似的一系列事件,因此不再分别介绍。TMS 可能会根据过程的完成情况禁止或更改消息。

在响应 TMS 检测到的要求卸载卷的情况(例如,挂载的卷不是请求的卷)或者 TMS 总是在使用卷后将其卸载时,发出 DISMOUNT 请求。

SCRATCH 请求由 TMS 发出,目的是使“工作”卷返回到擦写状态。服务器上的 HSC 控制数据集将会更新,以反映这些更改。

操作员消息交互

TMS 服务机从虚拟机接收挂载卷的请求。TMS 服务机必须建立 IUCV 路径才能向 VM Client 发送命令。已选择磁带机。

操作员消息对话

  1. 消息接口代码确定请求针对磁带机。

  2. 消息接口可能会使用 IUCV 消息向 VM Client 服务机发送请求以获取位置信息。

    ACSRQ QVOLUME,VOLSER=voladr
    
  3. 消息接口等待 IUCV REPLY

  4. VM Client 确定卷的状态、添加位置数据,并发出 IUCV REPLY。如果从分配例程保留了卷状态信息,则可以省略前四个步骤。

  5. 如果卷在 TapePlex 中,则操作员消息接口会使用 IUCV 消息向服务机发送请求,指定要挂载的卷和要使用的磁带机。

    ACSRQ MOUNT,VOLSER=volser,DRIVE=drivadr,PROTECT=
    
  6. 消息接口等待 IUCV REPLY

  7. VM Client MOUNT 例程请求服务器执行挂载、设置成功/失败响应的格式,并发出回复。起源消息的 IUCV REPLYSLX 宏映射。

    注:

    如果 MOUNT 请求定向到的传送装置(磁带机)包含一个取消装入的卷,则会先卸载该卷再执行请求的挂载。
  8. TMS IUCV 支持例程通知正在等待的消息接口:已收到响应。

  9. 消息接口例程检查回复以确定挂载是否成功,设置适当的返回代码,然后离开接口。

操作员消息接口的终止

当消息接口例程完成处理时,会将控制权返还给磁带管理系统。

PROP 检测到卸载

当连接到虚拟机的 StorageTek 磁带机分离后或虚拟机注销后,会向 VM 系统操作员发出 DETACH 消息。如果磁带机变为分离状态而磁带库或虚拟卷仍处于挂载状态,则 TMS 可能不会得到通知,不会向 VM Client 服务机发出正常的 DISMOUNT 消息。

要妥善处理卸载,VM PROP (PRogrammable OPerator) 工具应拦截某些消息并相应地处理。

注:

与 TMS 计算机一样,PROP 计算机也必须由 VM Client 服务机授予对命令的权限。使用 PROP RTABLE 调用的函数必须包含可用 VM Client 服务机的名称。

提供了 SMCPROP EXECLOGTAPE SAMPLERTABLE SAMPLE 作为示例。在使用 EXEC 时,可以使其保持不变,也可以对其进行修改以适应环境。应将这些例程的执行顺序设置为与以下顺序类似:

  1. PROP 检测到 DETACH 消息并调用一个例程 (SMCPROP EXEC) 以检查之前是否在磁带机上挂载了磁带库(或虚拟)卷(使用 SMCPROP EXEC 保存)。如果是这样,则执行以下命令:

    CP SMSG vmclientuser DISMOUNT DRIVE cuu
    
  2. SMCPROP EXEC 使用 CP SMSG 接口向 VM Client 服务机发出命令。

  3. VM Client 收到卸载请求。

场景 A-正常卸载

如果卷在磁带机上,则正常处理卸载,完成整个过程。例如:

示例 9-2 PROP 检测到卸载场景 A-正常卸载

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
                                   |

场景 B-自动处理卸载

如果磁带机已重新分配且发出了挂载请求,则 VM Client 将在磁带机上查找之前的卷,并自动开始该卷的卸载处理。完成这一自动卸载过程后,将会挂载新卷。例如:

示例 9-3 PROP 检测到卸载场景 B-自动处理卸载

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 宏

磁带管理系统接口使用 ACSRQ 调用宏准备 IUCV 消息,此消息中包含对 VM Client 的请求。ACSRQ 宏将控制权返还给其调用方后,TMS 例程必须发出 IUCV SEND

ACSRQ 请求

用于与磁带库交互的请求类型包括:

  • 查询信息

  • 设置环境参数

  • 卷处理

通过 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,也不支持 BUFLISTANSLIST

TMS                                   VM CLIENT
                        |
ASRQ xxxxxxx            |
ICUV SEND        <==============>     IUCV RECEIVE
WAIT                    |             Process Request
                 <==============>     IUCV REPLY
(External Interrupt)    |
Check return code       |             
Process reply           |

有关回复区域的映射,请参见SLX 宏映射

ACSRQ 宏语法

下面是 ASRQ 宏的语法:

图 9-1 ACSRQ 宏语法

周围的文本说明了 图 9-1 。

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 直接使用 MEDiaRECtech 参数为请求确定介质和录制技术值。

注:

如果指定了 DSECT=YES,则其他任何函数或参数均无效。将会构建 ACSINT DSECT

DISMOUNT

DISMOUNT 请求会导致从特定磁带机中移除磁带。磁带库磁带将会移至 LSM 单元(由 HSC 选择),并且可用于满足将来的请求。虚拟卷仍驻留在 VTSS 中,并且使用 MGMTCLAS 定义来确定迁移、复制和缓冲区驻留策略。

注意事项

DISMOUNT 请求成功与否取决于卷是否已收到 REWIND/UNLOAD CCW。如果磁带机尚未收到 REWIND/UNLOAD CCW,则 DISMOUNT 请求将会中止。

DISMOUNT 请求可能会取消之前对同一磁带机的 MOUNT 请求。

语法

下图显示了 ACSRQ DISMOUNT 请求的语法:

图 9-2 ACSRQ DISMOUNT 请求语法

周围的文本说明了 图 9-2 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

VOLSER=voladdr

(可选)指定要卸载的卷的 VOLSER

voladdr 是 6 个字符的卷标签的地址,它是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果挂载的卷具有不同的 VOLSER,将会发生错误。

请求响应

与请求关联的所有磁带移动都已完成后,会生成 DISMOUNT 请求的响应。响应包含回复标头和消息文本元素。回复标头中的原因代码 (SLXSRC) 是一个二进制消息编号,指示 DISMOUNT 请求完成后发出的 HSC 消息。消息文本元素包含由原因代码指定的完整消息文本。

有关 SLX 宏的信息,请参见SLX 宏映射

EJECT

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)来满足请求时,对应答缓冲区长度使用此值。

语法

下图显示了 ACSRQ EJECT 请求的语法:

图 9-3 ACSRQ EJECT 请求语法

周围的文本说明了 图 9-3 。

参数

ACSINT=acsintaddr

指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。

acsintaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ 在填充数据时引用此地址处的 ACSINT

CAP=capidaddr

(可选)指定用于满足请求的 CAP 的地址。

capidaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

格式为 AALLCC00,其中 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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

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 类型的数据地址或包含该数据地址的寄存器编号。

VOLSERLISTCOUNT 参数互斥。要么指定 VOLSER,要么指定 LISTCOUNT

请求响应

EJECT 请求的响应包含一个回复标头和一个卷信息元素,对于在请求中指定的每个 VOLSER,还会包含一个消息文本元素。卷信息元素和消息文本元素出现的顺序与请求中的 VOLSER 相同。

有关 SLX 宏的信息,请参见SLX 宏映射

MOUNT

MOUNT 请求会导致将磁带挂载到特定磁带机上。

注意事项

如果 MOUNT 请求定向到的磁带机包含一个取消装入的磁带,将发生自动卸载。

语法

下图显示了 ACSRQ MOUNT 请求的语法:

图 9-4 ACSRQ MOUNT 请求语法

周围的文本说明了 图 9-4 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

SCRATCH=YES

(可选)指定请求针对非特定(擦写)卷。此时选择了一个擦写卷 VOLSER 并将其挂载到指定的传送装置上。

必须指定 SCRATCH=YESVOLSER

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 类型的数据地址或包含该数据地址的寄存器编号。

必须指定 VOLSERSCRATCH=YES。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSERSCRATCH=YES

请求响应

与请求关联的所有磁带移动都已完成后,会生成 MOUNT 请求的响应。响应包含回复标头和消息文本元素,如果请求指定了 SCRATCH=YES,还会包含卷信息元素。回复标头中的原因代码 (SLXSRC) 是一个二进制消息编号,指示 MOUNT 请求完成后发出的 HSC 消息。消息文本元素包含由原因代码指定的完整消息文本。当请求指定了 SCRATCH=YES 且描述了挂载的擦写卷时,存在卷信息元素。

MOVE

MOVE 请求会导致将卷移至 ACS 中的特定位置。

注意事项

使用 MOVE 函数可将单个卷移至 ACS 中的其他位置。所移动的卷的目标可以是同一个 LSM 也可以是不同的 LSM。

MOVE 函数可实现卷移动并改进磁带管理控制。

如果请求的是移动虚拟卷或未在控制数据集中定义的卷,那么系统将此请求视为无效。

语法

下图显示了 ACSRQ MOVE 请求的语法:

图 9-5 ACSRQ MOVE 请求语法

周围的文本说明了 图 9-5 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

VOLSER=volseraddr

(可选)指定 6 字符卷标签的地址。

voladdr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

必须指定 VOLSERSCRATCH=YES。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSERSCRATCH=YES

LSM=lsmaddr

(可选)指定 LSMid 的地址。LSMid 的格式为 AALL,其中 AA 是 ACS 编号(十进制),LL 是 LSM 编号(十进制)。例如,0110 表示 ACS 编号为 01,LSM 编号为 10。

lsmaddr 是 RX 类型的 LSMid 地址或包含该 LSMid 地址的寄存器 (2) - (12)。

COLPANROW 参数必须伴随着 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 宏映射

QCAP

借助此请求可查询 CAP 的容量和状态。

注意事项

如果未指定 ACSIDLSMCAP 或者 LISTCOUNT,则返回有关所有 CAP 的数据。

语法

下图显示了 ACSRQ QCAP 请求的语法:

图 9-6 ACSRQ QCAP 请求语法

周围的文本说明了 图 9-6 。

参数

ACSRQ QCAP 请求包括以下参数:

ACSID=acsidaddr

指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。

acsintaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ 在填充数据时引用此地址处的 ACSINT

ACSINT=acsintaddr

指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。

acsintaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ 在填充数据时引用此地址处的 ACSINT

CAP=capidaddr

(可选)指定用于满足请求的 CAP 的地址。

capidaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

capidaddr 的格式为 AALLCC00,其中 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 的数据。如果未指定 ACSIDLSMCAP 或者 LISTCOUNT,则返回有关所有 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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

请求响应

QCAP 请求的响应包含回复标头和 CAP 信息元素,此元素包含有关请求的每个 CAP 的信息。

有关 SLX 宏的信息,请参见SLX 宏映射

QCONFIG

借助 QCONFIG 请求可获取有关 TapePlex 配置的摘要信息,以及针对其他 TMS 接口请求建议的应答缓冲区长度。

注意事项

QCONFIG 请求应该是建立 IUCV 连接后发出的第一个请求,因为其响应包含针对每种类型的 TMS 接口请求建议的应答缓冲区长度(响应长度)。

QCONFIG 响应的长度可能会随发行版发生变化。TMS 应使用以下技巧获取针对 QCONFIG 请求建议的应答缓冲区长度:

  1. 在应答缓冲区长度为 16(十进制)的情况下,发出 QCONFIG 请求。此请求的响应包含一个截断到 16 个字节的回复标头。标头中的返回代码为 4,它表明应答缓冲区太小,无法包含整个响应。偏移量为 12(十进制)的 SLXCRLN 一词包含针对 QCONFIG 请求建议的应答缓冲区长度。

  2. 使用建议的应答缓冲区长度,重新发出 QCONFIG 请求。

语法

下图显示了 ACSRQ QCONFIG 请求的语法:

图 9-7 ACSRQ QCONFIG 请求语法

周围的文本说明了 图 9-7 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

请求响应

QCONFIG 响应包含回复标头和配置摘要元素。QCONFIG 在回复标头中返回各种类型响应元素(例如,卷元素)的长度。

有关 SLX 宏的信息,请参见SLX 宏映射

QDRIVES

借助 QDRIVES 请求可获取与磁带库或与特定 ACS 关联的所有传送装置和 LSM 的详细信息。

注意事项

无。

语法

下图显示了 ACSRQ QDRIVES 请求的语法:

图 9-8 ACSRQ QDRIVES 请求语法

周围的文本说明了 图 9-8 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

请求响应

QDRIVES 响应包含回复标头、“磁带机信息”段和“LSM 信息”段。对于磁带库或 ACS 中的每个传送装置,“磁带机信息”段包含一个磁带机信息元素。对于磁带库或 ACS 中的每个 LSM,“LSM 信息”段包含一个 LSM 信息元素。

有关 SLX 宏的信息,请参见SLX 宏映射

QDRLIST

借助 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 请求的语法:

图 9-9 ACSRQ QDRLIST 请求语法

周围的文本说明了 图 9-9 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

SCRATCH=YES

(可选)指定请求针对非特定(擦写)卷。此时选择了一个擦写卷 VOLSER 并将其挂载到指定的传送装置上。

必须指定 SCRATCH=YESVOLSER

SUBPOOL=subpoolname

(可选)指定一个 13 字符字段的地址,该字段包含擦写子池的名称。

subpoolname 是 RX 类型的数据地址或包含该数据地址的寄存器编号。SCRPOOL(子池索引)不再受支持,您必须使用 SUBPOOL 参数来选择擦写池。

仅当指定 SCRATCH=YES 时,SUBPOOL 才有效。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

VOLSER=voladdr

(可选)指定 6 字符卷标签的地址。

voladdr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

必须指定 VOLSERSCRATCH=YES。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSERSCRATCH=YES

请求响应

QDRLIST 响应始终包含回复标头和“磁带机信息”段。如果指定了 VOLSER,则响应还会包含卷信息元素。

有关 SLX 宏的信息,请参见SLX 宏映射

QSCRATCH

借助 QSCRATCH 请求可获取与磁带库或与特定 ACS 关联的所有 LSM 的详细信息。该信息包括每个 LSM 中的擦写卷数。

注意事项

当磁带库及其关联的控制数据集由多个 HSC 共享时,报告的擦写卷总数可能不同于实际总数,因为可能未计入其他处理器上最近的擦写卷活动。但是,每个 HSC 都根据控制数据集每五分钟刷新一次其擦写卷总数,所以差异应该很小。

语法

下图显示了 ACSRQ QSCRATCH 请求的语法:

图 9-10 ACSRQ QSCRATCH 请求语法

周围的文本说明了 图 9-10 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

SUBPOOL=subpoolname

(可选)指定一个 13 字符字段的地址,该字段包含擦写子池的名称。

subpoolname 是 RX 类型的数据地址或包含该数据地址的寄存器编号。SCRPOOL(子池索引)不再受支持,您必须使用 SUBPOOL 参数来选择擦写池。

仅当指定 SCRATCH=YES 时,SUBPOOL 才有效。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

请求响应

QSCRATCH 响应包含回复标头和对应于每个 LSM 的 LSM 信息元素。

有关 SLX 宏的信息,请参见SLX 宏映射

QVOLUME

借助 QVOLUME 请求可获取一个或多个(最多 500 个)磁带的当前磁带库状态。

注意事项

响应的长度可能差别很大,具体取决于在请求中指定的卷数。QCONFIG 请求的响应中有几个值可用来确定特定 QVOLUME 请求的适当应答缓冲区长度。这些值包括:

  • SLXZQVOL 包含单个卷的 QVOLUME 响应的长度。当 QVOLUME 请求指定了 VOLSERCOUNT=1 时,对应答缓冲区长度使用此值。

  • SLXXVOLL 包含单个卷信息元素的长度。如果 QVOLUME 请求指定了 COUNT=n,则使用以下公式计算应答缓冲区长度:(((n-1)*SLXXVOLL)+SLXZQVOL)

  • 当在请求列表中指定了最大 VOLSER 数(500 个)时,SLXZVOL 包含 QVOLUME 响应的长度。当无法使用以上公式且当请求者有条件投入大量的存储(大约 16 KB)来满足请求时,对应答缓冲区长度使用此值。

语法

下图显示了 ACSRQ QVOLUME 请求的语法:

图 9-11 ACSRQ QVOLUME 请求语法

周围的文本说明了 图 9-11 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

VOLSER=voladdrid

(可选)指定 6 字符卷标签的地址。

voladdr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

必须指定 VOLSERSCRATCH=YES。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSERSCRATCH=YES

请求响应

QVOLUME 响应包含回复标头和对应于在请求中指定的每个 VOLSER 的卷信息元素。卷信息元素出现的顺序与请求中的 VOLSER 相同。

有关 SLX 宏的信息,请参见SLX 宏映射

QVOLUSE

借助 QVOLUSE 请求可获取已挂载卷的当前状态。

注意事项

响应的长度可能差别很大,具体取决于请求返回的卷数。

语法

下图显示了 ACSRQ QVOLUSE 请求的语法:

图 9-12 ACSRQ QVOLUSE 请求语法

周围的文本说明了 图 9-12 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

请求响应

QVOLUSE 响应包含回复标头和对应于请求返回的每个 VOLSER 的卷信息元素。卷信息元素出现的顺序与请求返回的 VOLSER 相同。

有关 SLX 宏的信息,请参见SLX 宏映射

SCRATCH

SCRATCH 请求会导致在服务器控制数据集中将卷置于擦写状态。

注意事项

指定的磁带必须已在磁带库中。SCRATCH 请求不会导致任何磁带移动。但是,在 SCRATCH 请求处理过程中,必须选择要更改其状态的磁带(即,必须获得磁带的独占使用权)。因此,如果磁带已挂载到磁带机上,则 SCRATCH 请求会失败。

语法

下图显示了 ACSRQ SCRATCH 请求的语法:

图 9-13 ACSRQ SCRATCH 请求语法

周围的文本说明了 图 9-13 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

VOLSER=voladdr

(可选)指定 6 字符卷标签的地址。

voladdr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

必须指定 VOLSERSCRATCH=YES。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSERSCRATCH=YES

请求响应

SCRATCH 的响应仅包含回复标头。

有关 SLX 宏的信息,请参见SLX 宏映射

SELSCR

SELSCR 请求会导致服务器选择一个磁带库擦写卷并在控制数据集中为其消除擦写状态。

注意事项

不会发生任何卷移动。

如果 ACSIDDRIVE 两者均未指定,则 HSC 将在所有磁带库 LSM 中搜索,并从包含最多擦写卷的 LSM 中选择一个擦写卷。如果指定了 ACSID,则 HSC 将从指定 ACS 中容纳最多磁带的 LSM 中选择一个擦写卷。如果指定了 DRIVE 且磁带机在自动模式 LSM 中,则 HSC 将从最近的 LSM 中选择一个擦写卷。

语法

下图显示了 ACSRQ SELSCR 请求的语法:

图 9-14 ACSRQ SELSCR 请求语法

周围的文本说明了 图 9-14 。

参数

ACSRQ SELSCR 请求包括以下参数:

ACSID=acsidaddr

指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。

acsintaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ 在填充数据时引用此地址处的 ACSINT

ACSINT=acsintaddr

指定正在发送至 VM Client 服务机的数据区的地址。此参数是必需参数。

acsintaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。ACSRQ 在填充数据时引用此地址处的 ACSINT

ACSDRIVE=driveaddr

(可选)指定 2 字节磁带机规格的地址 (ccua)。

driveaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

DRIVEACSID 互斥。它指定擦写卷应该靠近的磁带机。

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。

请求响应

SELSCR 的响应包含回复标头和卷信息元素。回复标头包含一个返回代码 (SLXCMDRC),指示操作成功与否。卷信息元素描述了选定的卷。

有关 SLX 宏的信息,请参见SLX 宏映射

UNSCRATCH

UNSCRATCH 请求会导致在控制数据集中为卷消除擦写状态。

注意事项

如果请求为其消除擦写状态的卷未在控制数据集中定义,那么将此请求视为无效。

对于实际卷,UNSCRATCH 请求不会导致任何磁带移动。但是,在 UNSCRATCH 请求处理过程中,必须选择要更改其状态的卷(即,必须获得卷的独占使用权)。因此,如果卷已挂载到实际或虚拟磁带机上,则 UNSCRATCH 请求会失败(请参见注意事项)。

语法

下图显示了 ACSRQ UNSCRATCH 请求的语法:

图 9-15 ACSRQ UNSCRATCH 请求语法

周围的文本说明了 图 9-15 。

参数

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 必须指定它。响应长度必须至少为 QCONFIGSLXZDISM 中返回的值。

USER=useridaddr

(可选)指定与请求的控制台 ID 关联的 8 字节用户 ID。

useridaddr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

如果未指定 USER,则使用执行请求的用户 ID。

VOLSER=voladdr

(可选)指定 6 字符卷标签的地址。

voladdr 是 RX 类型的数据地址或包含该数据地址的寄存器编号。

必须指定 VOLSERSCRATCH=YES。此参数指定要挂载的卷的 VOLSER。必须指定 VOLSERSCRATCH=YES

请求响应

UNSCRATCH 的响应仅包含回复标头。

有关 SLX 宏的信息,请参见SLX 宏映射

接口数据区

此部分介绍 SLX 宏的接口数据区。

SLX 宏

回复始终以标头开头。标头可能后跟一个或多个“段”。每个段都是由特定类型的“元素”(例如,卷信息元素)构成的一个表。如果回复标头在双字边界上对齐,则保证所有后续段和元素也在双字边界上开始。

尽管没有回复将会包含所有类型的段,但是在回复标头中为每个可能的段类型都定义了一个段目录(数字/偏移量/长度)。段目录在标头中出现的顺序与段在标头后面实际排列的顺序无关。

段目录中的数字指定回复中实际存在该类型的元素数。如果某个段目录中的数字不为零,则该段目录中的偏移量指定从回复标头开头到该类型的第一个(或唯一一个)元素的偏移量。如果某个段目录中的数字大于一,则必须使用该段目录中的长度(指定该类型的单个元素的长度)来访问该类型的第二个元素以及后续元素。例如,偏移量加上长度得出第二个元素的偏移量,再加上长度得出第三个元素的偏移量,依此类推。每个段中的元素数是可变的。下面几个表显示了对于给定的请求将返回哪些回复段。

下表提供了 SLS 宏参数矩阵:

表 9-1 SLS 宏-参数矩阵

回复段
标题
配置
CAP
磁带机
LSM 消息文本

DISMOUNT

1

NA

NA

NA

NA

NA

1

EJECT

1

NA

NA

*

NA

NA

*

MOUNT

1

NA

NA

1(如果是擦写卷)

NA

NA

1

MOVE

1

NA

NA

1(如果成功)

NA

NA

1

QCAP

1

NA

1+

NA

NA

NA

NA

QCONFIG

1

1

NA

NA

NA

NA

NA

QDRIVES

1

NA

NA

NA

1+

1+

NA

QDRLIST

1

NA

NA

1(如果不是擦写卷)

1+

NA

NA

QEJECT

1

NA

NA

NA

NA

NA

NA

QREQUEST

1

NA

NA

NA

NA

NA

NA

QSCRATCH

1

NA

NA

NA

NA

NA

NA

QVOLUME

1

NA

NA

*

NA

NA

NA

QVOLUSE

1

NA

NA

*

NA

NA

NA

SCRATCH

1

NA

NA

NA

NA

1+

NA

SELSCR

1

NA

NA

1

NA

NA

NA

UNSCRATCH

1

NA

NA

NA

NA

NA

NA


注:

  • 1 等于 1 且只等于 1。

  • *(EJECT 和 QVOLUME)受 SLX 回复区域中包含的卷信息元素数(最多 500 个)的限制。

  • 1+ 表示从 1 到 n 的数字,具体取决于磁带库的配置。

SLX 宏映射

以下示例显示了 SLX 记录格式的输出:

示例 9-4 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 宏的交叉引用:

表 9-2 SLX 宏交叉引用

名称
长度
偏移值

SLXCACS

000001

04

SLXCCAP

000001

06

SLXCCELL

000002

0C

SLXCCMAG

000001

10

SLXCCMGC

000001

11

SLXCID

000004

00

SLXCJOB

000008

12

SLXCLSM

000001

05

SLXCMDRC

000001

03

SLXCNCOL

000001

0F

SLXCNROW

000001

0E

SLXCRLN

000004

0C

SLXCSTAM

NA

20

SLXCSTAT

000002

08

SLXCSTB1

000001

08

SLXCSTB2

000001

09

SLXCSTCA

NA

80

SLXCSTCL

NA

10

SLXCSTCO

NA

08

SLXCSTIC

NA

10

SLXCSTID

NA

40

SLXCSTIE

NA

80

SLXCSTII

NA

08

SLXCSTIJ

NA

20

SLXCSTNR

NA

40

SLXCTCIM

NA

01

SLXCTCLP

NA

02

SLXCTPC

NA

80

SLXCTTIM

NA

05

SLXCTTWO

NA

04

SLXCTTWS

NA

03

SLXCTYPE

000001

0A

SLXDDISC

NA

08

SLXDID

000003

00

SLXDMANU

NA

10

SLXDSFLG

000001

03

SLXDSJNA

NA

09

SLXDSJNP

NA

08

SLXDSMAX

NA

09

SLXDSMBR

000008

30

SLXDSNAM

000044

04

SLXDSNEL

NA

A8

SLXDSPLB

NA

07

SLXDSPRM

NA

01

SLXDSSBY

NA

03

SLXDSSEC

NA

02

SLXDSTA

000001

03

SLXDSTRQ

NA

06

SLXDSUAT

NA

05

SLXDSUNT

000008

3E

SLXDSVAT

NA

04

SLXDSVOL

000006

38

SLXDVMM

NA

8051

SLXEND

000008

B0

SLXEXLM0

000004

80

SLXEXLM1

000004

84

SLXEXLM2

000004

88

SLXGID

000003

00

SLXGTEXT

000125

03

SLXHID

000003

00

SLXHL

NA

14

SLXHSCV

000002

A0

SLXL

NA

B0

SLXLCMPF

000001

24

SLXLEJPS

000008

1C

SLXLHHBT

000004

0C

SLXLHNAM

000008

04

SLXLID

000003

00

SLXLLBAL

NA

02

SLXLLBNL

NA

03

SLXLLBNS

NA

04

SLXLLBSL

NA

01

SLXLOCKD

NA

20

SLXLQNAM

000008

14

SLXLRSTM

000004

10

SLXLSCLB

000001

25

SLXLSMF

000001

26

SLXMACS

000001

04

SLXMADJI

000001

07

SLXMADJN

000001

06

SLXMANUL

NA

10

SLXMDISC

NA

08

SLXMFCEL

000004

14

SLXMID

000003

00

SLXMLSM

000001

05

SLXMNSCR

000004

0C

SLXMSTAT

000001

03

SLXMSTT

NA

803A

SLXMTCEL

000004

10

SLXNORSP

NA

28

SLXNTCB

NA

1C

SLXPEOFF

000004

10

SLXQACNT

000004

30

SLXQDEAC

000001

04

SLXQDECU

000002

06

SLXQDELS

000001

05

SLXQDID

000003

00

SLXQDRCT

000004

2C

SLXQDRT

000008

08

SLXQID

000004

00

SLXQJTC

000004

08

SLXQJTD

NA

00

SLXQJTL

NA

18

SLXQJTN

NA

FFFF

SLXQJTS

000002

0C

SLXQJTT

000004

04

SLXQJTV

000006

0E

SLXQLCAP

000004

7C

SLXQLCNT

000004

34

SLXQMDR

000004

28

SLXQUCSA

000004

74

SLXRBADL

NA

2C

SLXRBADP

NA

08

SLXRBTOK

NA

3C

SLXREOV

NA

34

SLXRFAIL

NA

10

SLXRIERR

NA

0C

SLXRNAUT

NA

18

SLXRNHSC

NA

14

SLXRNVCI

NA

30

SLXROK

NA

00

SLXRPLY

000001

00

SLXRVNV

NA

38

SLXRWARN

NA

04

SLXSANF

NA

8036

SLXSCAPL

NA

20

SLXSCFGL

NA

A8

SLXSDRVL

NA

10

SLXSFUL

NA

8050

SLXSID

000004

00

SLXSLSML

NA

18

SLXSMSGL

NA

80

SLXSRC

000004

08

SLXSTPE

NA

EE

SLXSTPK

NA

00

SLXSTPL

NA

10

SLXSTPN

NA

FF

SLXSTPS

000001

09

SLXSTPT

000004

04

SLXSTPY

000001

08

SLXSVOLL

NA

28

SLXSVOLN

NA

28

SLXTINTR

NA

8032

SLXTPROT

NA

24

SLXTRNF

NA

8040

SLXVACS

000001

0B

SLXVCEL

NA

01

SLXVCODE

NA

07

SLXVDATD

000004

1C

SLXVDATI

000004

10

SLXVDATL

000004

14

SLXVDRIV

000002

0D

SLXVDRV

NA

02

SLXVDSC

NA

08

SLXVERR

NA

02

SLXVERS

000001

04

SLXVID

000003

00

SLXVILB

NA

80

SLXVLC

000001

0A

SLXVLOC

000005

0B

SLXVLSM

000001

0C

SLXVMAL

NA

10

SLXVMDFL

NA

01

SLXVMED

000008

20

SLXVMLMU

NA

10

SLXVMNT

NA

04

SLXVMUNR

NA

04

SLXVMVLA

NA

02

SLXVOHST

NA

40

SLXVPNL

000003

0D

SLXVSCNT

000004

18

SLXVSCR

NA

20

SLXVSER

000006

04

SLXVSTA

000001

03

SLXVSTA2

000001

0F

SLXVTSSN

000008

10

SLXVTV

NA

01

SLXVUNK

NA

00

SLXXCAPL

000004

58

SLXXCAPN

000004

50

SLXXCAPO

000004

54

SLXXCFGL

000004

1C

SLXXCFGN

000004

14

SLXXCFGO

000004

18

SLXXDRVL

000004

34

SLXXDRVN

000004

2C

SLXXDRVO

000004

30

SLXXLSML

000004

40

SLXXLSMN

000004

38

SLXXLSMO

000004

3C

SLXXMSGL

000004

4C

SLXXMSGN

000004

44

SLXXMSGO

000004

48

SLXXQDSL

000004

7C

SLXXQDSN

000004

74

SLXXQDSO

000004

78

SLXXQJTL

000004

64

SLXXQJTN

000004

5C

SLXXQJTO

000004

60

SLXXSDL

NA

B0

SLXXSTPL

000004

70

SLXXSTPN

000004

68

SLXXSTPO

000004

6C

SLXXVCIL

000004

88

SLXXVCIN

000004

80

SLXXVCIO

000004

84

SLXXVOLL

000004

28

SLXXVOLN

000004

20

SLXXVOLO

000004

24

SLXZDEFP

000004

60

SLXZDEFS

000004

64

SLXZDISM

000004

54

SLXZEJCT

000004

58

SLXZEJC1

000004

70

SLXZGSCR

000004

48

SLXZMDM

000004

4C

SLXZMOVE

000004

6C

SLXZQCAP

000004

8C

SLXZQDRL

000004

40

SLXZQDRV

000004

3C

SLXZQDSN

000004

98

SLXZQEJT

000004

90

SLXZQSCR

000004

50

SLXZQVOL

000004

44

SLXZSCR

000004

5C

SLXZSETO

000004

68

SLXZSTOP

000004

94

SLXZVOL

000004

38


ACSINT 请求 DSECT

借助 ACSINT 可以在 TMS 与 ACS 服务机之间传递信息。它由 ACSRQ 宏在指定了 DSECT=YES 时构建,并且使用 IUCV 发送。

注:

以下 DSECT 包括一些不受 VM Client 支持的参数。包括它们只是为了说明完整性和兼容性。

以下示例显示了 ACSINT 记录格式的输出:

示例 9-5 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 宏的交叉引用:

表 9-3 ACSINT 宏交叉引用

名称
长度
偏移值

ACSIACC1

NA

02

ACSIACC2

NA

01

ACSIACS

000001

4A

ACSIACT1

000008

1A

ACSIACT2

000008

22

ACSIALC

000004

4A

ACSICAP

000004

4A

ACSICNT

000002

38

ACSICOL

000001

50

ACSIDPOL

NA

40

ACSIDRIV

000002

54

ACSIDSCR

NA

3F

ACSIDSM

NA

2A

ACSIDSN

000044

9D

ACSIEJCT

NA

2B

ACSIEXPD

000003

C9

ACSIFDSN

NA

10

ACSIFEXP

NA

08

ACSIFJOB

NA

80

ACSIFLG1

000001

0A

ACSIFLG2

000001

0B

ACSIFLG3

000001

0C

ACSIFLG4

000001

0D

ACSIFLG5

000001

0E

ACSIFLG6

000001

0F

ACSIFLG7

000001

10

ACSIFLG8

000001

84

ACSIFLG9

000001

CF

ACSIFMED

NA

40

ACSIFMED

NA

40

ACSIFREC

NA

80

ACSIMED

000008

D8

ACSIMNT

NA

28

ACSIMOVE

NA

29

ACSIMPOL

NA

FA

ACSIMTOK

NA

1F4

ACSIFRET

NA

04

ACSIFSTP

NA

40

ACSIFVOL

NA

02

ACSIF180

NA

80

ACSIF308

NA

08

ACSIF410

NA

10

ACSIF420

NA

20

ACSIF601

NA

01

ACSIF602

NA

02

ACSIHDR

000004

00

ACSIHLN

NA

1E0

ACSIHOST

000008

42

ACSID

NA

’CVAL’

ACSIJOBN

000008

85

ACSILABT

000001

11

ACSILAL

NA

02

ACSILCAP

NA

04

ACSILDRL

NA

02

ACSILIST

000001

1E0

ACSILLDT

NA

00

ACSILNL

NA

03

ACSILNS

NA

04

ACSILOFF

000002

3A

ACSILPOL

NA

0C

ACSILSL

NA

01

ACSILSMI

000002

4A

ACSILTOK

NA

04

ACSILVSL

NA

06

ACSIMANO

NA

20

ACSIMCAP

NA

1F4

ACSIMDRL

NA

5DC

ACSIVTPN

NA

40

ACSIVTXT

NA

04

ACSIVUSR

NA

40

ACSIVVOL

NA

04

ACSIWTOR

NA

10

ACSIMVSL

NA

1F4

ACSINDEL

NA

08

ACSINNDL

NA

04

ACSINOOP

NA

00

ACSIPAN

000001

4E

ACSIPGMN

000008

95

ACSIPOOL

000001

56

ACSIPROT

NA

80

ACSIQCAP

NA

1A

ACSIQCNF

NA

14

ACSIQDRL

NA

16

ACSIQDRV

NA

15

ACSIQDSN

NA

1D

ACSIQEJT

NA

19

ACSIQRQS

NA

1C

ACSIVDRV

NA

01

ACSIVER

000001

08

ACSIVHST

NA

80

ACSIVLSM

NA

20

ACSIVLST

NA

02

ACSIVN

NA

07

ACSIVOLS

000006

3C

ACSIVOLT

000001

CE

ACSIVPAN

NA

08

ACSIVROW

NA

04

ACSIVSCP

NA

20

ACSIVTKN

NA

08

ACSIVTLM

NA

80

ACSIROW

000001

4F

ACSIRS01

NA

01

ACSIRS02

NA

02

ACSIRS03

NA

03

ACSIRT

000001

09

ACSISCR

NA

40

ACSISCRA

NA

3D

ACSISOPR

NA

05

ACSISSCR

NA

3C

ACSISTEP

000008

8D

ACSISTOP

NA

04

ACSISUBN

NA

10

ACSISUBP

000013

77

ACSITEXT

000032

57

ACSITKNO

000004

30

ACSITLSM

000002

52

ACSITPAN

000001

51

ACSITRI

NA

85

ACSITRIL

NA

4A

ACSIUNSC

NA

3E

ACSIUSER

000008

12

ACSIVACS

NA

40

ACSIVCAP

NA

10

ACSIVCNT

NA

01

ACSIVCOL

NA

02


IUB 记录格式

IUB-IUCV 请求块

IUB 描述了由于 IUCV 操作而产生的未处理的 IUCV 请求。请求和最终状态均包含在 IUB 数据结构中。IUB 是供设备管理使用的 IOBLOK 结构的 IUCV 对等结构。

下表提供了对 IUB IUCV 请求块的交叉引用:

表 9-4 IUB 请求块引用

名称
长度
偏移值

ACSIACC1

NA

02

ACSIACC2

NA

01

ACSIACS

000001

4A

ACSIACT1

000008

1A

ACSIACT2

000008

22

ACSIALC

000004

4A

ACSICAP

000004

4A

ACSICNT

000002

38

ACSICOL

000001

50

ACSIDPOL

NA

40

ACSIDRIV

000002

54

ACSIDSCR

NA

3F

ACSIDSM

NA

2A

ACSIDSN

000044

9D

ACSIEJCT

NA

2B

ACSIEXPD

000003

C9

ACSIFDSN

NA

10

ACSIFEXP

NA

08

ACSIFJOB

NA

80

ACSIFLG1

000001

0A

ACSIFLG2

000001

0B

ACSIFLG3

000001

0C

ACSIFLG4

000001

0D

ACSIFLG5

000001

0E

ACSIFLG6

000001

0F

ACSIFLG7

000001

10

ACSIFLG8

000001

84

ACSIFLG9

000001

CF

ACSIFMED

NA

40

ACSIFPGM

NA

20

ACSIFRET

NA

04

ACSIFSTP

NA

40

ACSIFVOL

NA

02

ACSIF180

NA

80

ACSIF308

NA

08

ACSIF410

NA

10

ACSIF420

NA

20

ACSIF601

NA

01

ACSIF602

NA

02

ACSIHDR

000004

00

ACSIHLN

NA

1E0

ACSIHOST

000008

42

ACSIID

NA

’CVAL’

ACSIJOBN

000008

85

ACSILABT

000001

11

ACSILAL

NA

02

ACSILCAP

NA

04

ACSILDRL

NA

02

ACSILIST

000001

1E0

ACSILLDT

NA

00

ACSILNL

NA

03

ACSILNS

NA

04

ACSILOFF

000002

3A

ACSILPOL

NA

0C

ACSILSL

NA

01

ACSILSMI

000002

4A

ACSILTOK

NA

04

ACSILVSL

NA

06

ACSIMANO

NA

20

ACSIMCAP

NA

1F4

ACSIFREC

NA

80

ACSIMED

000008

D8

ACSIMNT

NA

28

ACSIMOVE

NA

29

ACSIMPOL

NA

FA

ACSIMTOK

NA

1F4

ACSIMVSL

NA

1F4

ACSINDEL

NA

08

ACSINNDL

NA

04

ACSINOOP

NA

00

ACSIPAN

000001

4E

ACSIPGMN

000008

95

ACSIPOOL

000001

56

ACSIPROT

NA

80

ACSIQCAP

NA

1A

ACSIQCNF

NA

14

ACSIQDRL

NA

16

ACSIQDRV

NA

15

ACSIQDSN

NA

1D

ACSIQEJT

NA

19

ACSIQRQS

NA

1C

ACSIVDRV

NA

01

ACSIVER

000001

08

ACSIVHST

NA

80

ACSIVLSM

NA

20

ACSIVLST

NA

02

ACSIVN

NA

07

ACSIVOLS

000006

3C

ACSIVOLT

000001

CE

ACSIVPAN

NA

08

ACSIVROW

NA

04

ACSIVSCP

NA

20

ACSIVTKN

NA

08

ACSIVTLM

NA

80

ACSIMDRL

NA

5DC

ACSIVTPN

NA

40

ACSIVTXT

NA

04

ACSIVUSR

NA

40

ACSIVVOL

NA

04

ACSIWTOR

NA

10

ACSIROW

000001

4F

ACSIRS01

NA

01

ACSIRS02

NA

02

ACSIRS03

NA

03

ACSIRT

000001

09

ACSISCR

NA

40

ACSISCRA

NA

3D

ACSISOPR

NA

05

ACSISSCR

NA

3C

ACSISTEP

000008

8D

ACSISTOP

NA

04

ACSISUBN

NA

10

ACSISUBP

000013

77

ACSITEXT

000032

57

ACSITKNO

000004

30

ACSITLSM

000002

52

ACSITPAN

000001

51

ACSITRI

NA

85

ACSITRIL

NA

4A

ACSIUNSC

NA

3E

ACSIUSER

000008

12

ACSIVACS

NA

40

ACSIVCAP

NA

10

ACSIVCNT

NA

01

ACSIVCOL

NA

02


交叉引用

下表提供了对 IUB 的交叉引用:

表 9-5 IUB 交叉引用

名称
长度
偏移值

IUBCC

000001

31

IUBCONN

NA

10

IUBDABQ

000016

10

IUBDAVL

000001

20

IUBDCBPT

000004

44

IUBECBKY

000001

21

IUBBECBT

000004

34

IUBEXT

000040

78

IUBEXT1

000008

78

IUBEXT2

000008

80

IUBEXT3

000008

88

IUBEXT4

000008

90

IUBEXT5

000008

98

IUBEYE

000004

0C

IUBFLG1

000001

30

IUBFLG2

000001

32

IUBHCOMM

NA

20

IUBIRT

000004

2C

IUBIUBPT

NA

24

IUBLEN

NA

A0

IUBLOK

NA

08

IUBNPOST

NA

40

IUBORGID

000004

3C

IUBPARML

000040

50

IUBPARM1

000008

50

IUBPARM2

000008

58

IUBPARM3

000008

60

IUBPARM4

000008

68

IUBPARM5

000008

70

IUBQ

000016

00

IUBREAD

NA

80

IUBREJCT

NA

08

IUBREPLY

NA

20

IUBSEND

NA

40

IUBSENT

NA

80

IUBTASK

000004

28