WAIT JOURNALNAME

描述

WAIT JOURNALNAME 将该任务与已创建但其输出已延迟的一个或多个日志记录的输出同步; 即，与异步日志输出请求同步。

日志记录可能已从日志缓冲区写出到相应的系统记录器日志流，或者系统记录器输出操作可能正在进行中。 如果已完成日志流输出操作，那么控制权将立即返回给请求任务; 如果未完成，那么请求任务将等待操作完成。

如果请求程序已连续向同一日志发出成功的异步输出请求，那么必须仅在这些请求中的最后一个请求上进行同步，以确保所有日志记录都已输出到系统记录器日志流。 这可以通过发出独立 WAIT JOURNALNAME 命令或通过使最后一个输出命令本身同步 (通过在 WRITE JOURNALNAME 命令中指定 WAIT 选项) 来完成。

WAIT JOURNALNUM

与日志输出同步。 支持该命令是为了与 CICS® 早期版本兼容。该命令已被 WAIT JOURNALNAME 命令取代，建议使用该命令。

语法与 WAIT JOURNALNAME 相同，只是 JOURNALNUM 指定的是数值而不是字符值。 数值 nn 的范围为 01-99，对应日记账名称 DFHJnn。 此命令是线程安全的。

选项

JOURNALNAME (数据值)

指定一个 1-to 8 字符的日志名，用于标识任务要在其上等待同步的日志。 该名称必须是CICS已知的日记账名称。

要针对 CICS 系统日志发出等待，请指定 DFHLOG 作为日志名称。

要像在文件资源定义中一样针对使用日志编号约定定义的日志发出等待，请将名称指定为 DFHJnn，其中 nn 是范围在 1 到 99 之间的日志编号。

注: 在此命令上指定 DFHJ01 是指用户日志， 不是 系统日志。

REQID (数据值)

在全字二进制变量中指定引用已创建但可能尚未写出的日志记录的标记。 该令牌由 CICS 从此任务发出的先前 WRITE JOURNALNAME 命令返回。

如果未指定 REQID ，那么该任务将与 JOURNALNAME 指定的日志的当前缓冲区输出同步。

条件

17 IOERR

由于系统记录器或 SMF 返回了不可恢复的错误情况，因此未输出日志记录。

缺省操作: 如果日志是系统日志，那么 CICS 会停顿或异常终止。 如果是常规日志，那么任务将异常终止。

43 JIDERR

在以下任一情况下发生:

• 指定的日志名称在 CICS 区域中未知。
• 指定的日志名称指的是当前连接到另一个 MVS 映像中的CICS区域的仅 DASD 日志流。

缺省操作: 异常终止任务。

19 NOTOPEN

在下列任何情况下发生:

• 无法满足此命令，因为用户显式禁用了指定的日志。
• 将针对先前未写入的日志发出等待请求。
• 此日志是使用将其映射到此系统的系统日志所使用的日志流的模型定义的。 尝试连接到日志流时未检测到此错误。 将安装日志的定义并将其设置为失败。

缺省操作: 异常终止任务。

70 NOTAUTH

JOURNALNAME (数据值) 上的资源安全性检查失败。

缺省操作: 异常终止任务。