SPOOLOPEN INPUT

描述

SPOOLOPEN INPUT 命令打开从系统假脱机程序到 CICS®的输入的假脱机报告。

它准备直接使用外部写程序名称 (USERID) 和指定的类来获取 (读取) 现有假脱机数据集。

另一个任务可能已为输入分配假脱机文件。 在这种情况下，您应该在适当的时间间隔之后重试。

成功执行此命令后，您应尽快读取报告并继续执行 CLOSE ，以便允许其他用户使用 JES 单线程。 如果在事务结束或同步点之前未发出 SPOOLCLOSE ，那么 $TAG1 CICS $TAG2 将执行隐式 SPOOLCLOSE KEEP ，并将消息写入 CSMT 以提醒系统程序员可能不需要保留资源。 在准备好完全处理数据集之前，不应使用此命令来 SPOOLOPEN 数据集。

此命令如果成功，将返回一个令牌，稍后将使用该令牌在 SPOOLREAD 和 SPOOLCLOSE 命令中标识报告。

选项

CLASS (data-value)

指定 1 字符类指定。 CLASS 操作数可用作输入报告的选择参数。 如果将其省略，那么将获取指定 USERID 的第一个报告，而不考虑其类。

TOKEN (数据区)

指定用于标识报告的 8 字符 CICS分配的令牌。

USERID (data-value)

指定 8 字符的用户标识。 它必须以与 CICS 通用 applid 相同的 4 字符开头，以便 CICS 可以检查用户是否尝试访问并非用于其 CICS 系统的数据集。

条件

85 ALLOCERR

在下列任何情况下发生:

• 动态分配已拒绝用于分配输入数据集的请求。

  RESP2 给出了表示此错误的动态分配响应代码。 前两个字符是信息原因码 (S99INFO) ，后两个字符是错误原因码 (S99ERROR) ，如 z/OS MVS Programming: authorized Assembler Services Guide中所定义。

21 ILLOGIC

RESP2 值：

3

指定的 CLASS 值无效。

16 INVREQ

RESP2 值：

4

不受支持的语言。

8

不受支持的功能。

16

缺少 USERID。

36

缺少输入 | 输出。

40

已启用子系统接口。

注: 错误 1024 及以上是内部错误，不应该发生。 如果返回了其中一个错误代码，请与 IBM® 支持中心联系。

80 个假脱机

RESP2 值：

4

不存在子系统。

8

正在禁用接口; CICS 正在停顿。

12

接口已停止。

42 个 NOSTG

在下列任何情况下发生:

• 在 JES 接口子任务 (DFHPSPSS) 中 GETMAIN 失败。

  RESP2 给出 GETMAIN 寄存器 15 返回码。

70 NOTAUTH

在下列任何情况下发生:

• 应用程序发出了带有未经授权的 USERID 的 SPOOLOPEN INPUT 命令。 对于要授权的 USERID ，其前四个字符必须与当前 CICS applid 的前四个字符匹配。

13 NOTFND

RESP2 值：

4

找不到用于检索指定外部写程序名称的数据集; 或者该数据集存在，但处于 HELD 状态。

如果 CICS 区域 USERID 对 JESSPOOL 类中的相应 PROFILE 没有 ALTER 访问权，那么也可以返回此属性。

1024

输入或输出功能已损坏， SPOOLCLOSE 无法完成。

19 NOTOPEN

RESP2 值：

8

尚未打开数据集，或者未对假脱机数据集发出 SPOOLOPEN 的任务尝试访问该数据集。

1024

子任务 OPEN 宏失败。

87 OPENERR

RESP2 值：

4

VSAM SHOWCB 宏未能返回用于访问 JES 假脱机文件的 VSAM 控制块的长度。

在下列任何情况下也会发生 (未设置RESP2 ):

• 在 SPOOLOPEN 处理期间发生内部错误，已强制请求失败。

88 SPOLBUSY

RESP2 值：

4

接口已由另一个任务使用。

8

接口已由当前任务使用。

在下列任何情况下也会发生 (未设置RESP2 ):

• JES 接口中的 JES/input 单线程不可用。

89 容错器

在下列任何情况下发生:

• 子系统接口宏 (IEFSSREQ) 已失败。 未选择输入数据集名称。

  RESP2 提供了 "IEFSSREQ" 响应代码。

86 STRELERR

在下列任何情况下发生:

• 在 JES 接口子任务 (DFHPSPSS) 中 FREEMAIN 失败。

  RESP2 给出 FREEMAIN 寄存器 15 返回码。