SET JOURNALNAME

启用或禁用 CICS® 用户日志。

语法

警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。

SET JOURNALNAME

条件: INVREQ ， IOERR ， JIDERR 和 NOTAUTH

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。

此命令是线程安全的。

描述

SET JOURNALNAME 命令允许您启用或禁用 CICS 用户日志。

SET JOURNALNAME 对用作 VSAM 文件的正向恢复日志或自动日志的日志没有影响，直到下次打开该文件为止。它对系统日志没有影响。

您可以将 SET JOURNALNAME 用于 CICS当前未知的日志名称。 CICS 会动态地为指定的日志创建一个条目，并在必要时使用匹配的 JOURNALMODEL 定义将其定义到 z/OS® 系统记录器。

针对 CICS 未知的日志名称发出 SET JOURNALNAME 命令的能力使您能够在首次引用相应日志之前执行日志流连接处理。例如，您可以在初始化时的 PLT 程序期间执行此操作，以避免通常在第一次引用时发生的延迟。

SET JOURNALNUM 已经过时，由 SET JOURNALNAME 代替。

选项

ACTION (cvda)

指定您希望 CICS 对指定的日志名称执行的操作。 CVDA 值包括：

清空

日志缓冲区将写出到日志流中，但日志未关闭。

您可以使用此选项来确保在使用批处理实用程序处理流之前将所有当前记录写出到日志流中。

对于自动日志和正向恢复日志，如果文件处于打开状态，那么将强制 FLUSH (FLUSH 不会等到下次文件处于打开状态)。

RESET

日志与其日志流断开连接，但可以通过日志写入重新打开。

注: ACTION 和 STATUS 是互斥选项。如果指定 ACTION ，那么也不能指定 STATUS。

JOURNALNAME (data-value)

指定日志的名称。

要修改使用 1-99 范围内的数字标识定义的日志，请指定日志名称 DFHJnn，其中 nn 是日志编号。

不能指定 DFHLOG 或 DFHSHUNT ，因为不允许您修改系统日志的状态。

状态 (cvda)

指定日志的新状态。 CVDA 值如下所示：

DISABLED: 然后将清除日志，并将其禁用。在 SET JOURNALNAME 命令上的 STATUS (ENABLED) 或 ACTION (RESET) 选项重新启用之前，不能再次使用此参数。
ENABLED: 该日志已打开，可供使用。

注: STATUS 和 ACTION 是互斥选项。如果指定 STATUS ，那么不能同时指定 ACTION。

条件

INVREQ

RESP2 值：

2: 请求无效。
3: 无法更改系统日志。
4: ATION 选项具有无效的 CVDA 值。
5: STATUS 选项具有无效的 CVDA 值。
7: ATION 选项为当前未连接到日志流的日志指定 FLUSH 或 RESET。

IOERR

RESP2 值：

6: 无法连接与日志名称关联的日志流，或者无法打开日志，或者在将日志缓冲区清空到日志流期间发生了不可恢复的错误。

JIDERR

RESP2 值：

1: 找不到指定的日志名称。
2: 尝试定义与日志名关联的日志流期间发生错误，或者未正确指定日志名。
3: 指定的日志名称是指另一个 z/OS 映像中的 CICS 区域当前连接到的仅 DASD 日志流。

NOTAUTH

RESP2 值：

100: 未授权与发出任务关联的用户使用此命令。
101: 未授权与发出任务关联的用户以此命令所需的方式访问此特定资源。