INQUIRE JOURNALNAME

检索有关系统日志和常规日志的状态的信息。

语法

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

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

INQUIRE JOURNALNAME

条件: END ， ILLOGIC ， JIDERR 和 NOTAUTH

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

此命令是线程安全的。

描述

INQUIRE JOURNALNAME 命令返回有关系统上的日志 (包括系统日志和常规日志) 的信息。

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

浏览

您还可以使用浏览选项（START、NEXT 和 END）浏览系统中日记帐名称表中的所有日记帐条目INQUIRE JOURNALNAME命令。看浏览资源定义有关浏览的一般信息，包括语法、异常条件和示例。

选项

JOURNALNAME (data-value)

指定 1 到 8 个字符的日记帐名称。

要查询使用 1 – 99 范围内的数字标识符定义的期刊，请指定期刊名称 DFHJ韓，在哪里韓是期刊编号。

要查询系统日志，请指定 DFHLOG。

状态 (cvda)

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

DISABLED: CEMT 或 EXEC CICS， SET JOURNALNAME(...) 已禁用日志命令。直到通过 STATUS(ENABLED) 或 ACTION(RESET) 选项重新启用它，它才能被使用SET JOURNALNAME命令。
ENABLED: 该日志已安装并可供使用。
FAILED: 日志迂到日志流故障。直到通过 STATUS(ENABLED) 或 ACTION(RESET) 选项重新启用它，它才能被使用SET JOURNALNAME命令，或直到下一个CICS重新开始。应从z/OS®系统记录器再次使用之前请进行清点。

STREAMNAME (数据区)

返回与日志名称关联的日志流名称 (LSN)。

该名称的长度最多可以为 26 个字符。使用尾部空格 (X'40 ') 填充小于 26 个字符的名称。如果日志由指定 DUMMY 或 SMF 类型的日志模型定义，那么 CICS 将返回 26 个空白。

类型 (cvda)

指示日志流格式的类型。 CVDA 值包括：

DUMMY: 记录不会写入任何日志流。
MVS: 记录被写入z/OS系统记录器日志流。
SMF: 记录被写入z/OSSMF 日志流。

条件

END

RESP2 值：

2: 已检索所有授权资源定义。此命令上指定的所有数据区保持不变。

ILLOGIC

RESP2 值：

1: 当浏览已在进行时，或者在没有前面的 START 的情况下，提供了 NEXT 或 END 时，给出了 START。

JIDERR

RESP2 值：

1: 找不到指定的日志名称。

NOTAUTH

RESP2 值：

100: 用户无权执行此命令。
101: 用户对指定的日志没有必需的访问权。 (不适用于 INQUIRE JOURNALNAME START ， INQUIRE JOURNALNAME NEXT 或 INQUIRE JOURNALNAME END 命令。)