SIGNON

登录到终端。

语法

SIGNON

条件: INVREQ ， LENGERR ， NOTAUTH 和 USERIDERR

此命令是线程安全的。

NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.

描述

SIGNON 命令使应用程序能够将新的用户标识与当前终端相关联。使用 SIGNON 命令时，以下规则适用:

登录操作仅与终端相关。如果事务没有终端作为其主要设施，那么注册没有意义。
发出 EXEC CICS SIGNON 命令时， CICS® 会修改作为发出该命令的事务的主要设施的终端的状态。
注册不会影响当前对发出该命令的事务生效的用户标识和安全功能。这是因为:
- 事务的用户标识和安全功能是在事务连接时建立的。在事务的生命周期内，无法后续修改这些项。
- 事务执行的所有操作 (无论是对本地或远程资源，还是对已连接的系统) 都在连接事务时建立的安全上下文中执行。
如果需要授权，您可以使用有效密码或有效密码短语进行登录。但是，您无法使用用于认证的密码来设置新密码短语，也无法使用用于认证的密码短语来设置新密码。

如果在 SIGNON 请求上提供了不正确的密码，那么将增大用户标识的无效尝试计数。如果在连续的 SIGNON 请求中提供了多个不正确的密码，那么外部安全管理器 (ESM)可能会撤销用户标识。当您在 SIGNON 请求中提供不正确的密码时， CICS 会发出消息 DFHXS1201 。当您在一次或多次无效尝试之后提供正确的密码时， CICS 会发出消息 DFHXS1206，其中包含无效尝试的计数。

不存在使用 SIGNON 命令的隐式签核。如果应用程序尝试将新用户与已具有注册用户标识的终端相关联，那么 CICS 会返回 INVREQ (Resp2=9) 错误响应。请注意， USERID 选项没有缺省值。

注： 6.2 及更高版本在 CHANGETIME、 LASTUSETIME 和 EXPIRYTIME 选项中，返回的时间值格式与 ASKTIME 命令相同，即以 ABSTIME 为单位。有关 ABSTIME 格式的更多信息，请参阅 ASKTIME。使用 FORMATTIME 命令可将数据重新格式化为指定的日期和时间格式。

注意: 要确保不会在系统或事务转储中显示密码，请在使用后尽快清除 EXEC CICS 命令上具有密码或密码短语选项的密码或密码短语字段。

当此命令由在 CEDF下运行的事务发出时，密码或密码短语 (以及新密码或密码短语 (如果适用)) 将被清空。

有关 CICS 如何使用 USERID 和 GROUPID的更多信息，请参阅工作方式: CICS中的标识。

选项

如果可选输入字段包含所有空格，那么将忽略该字段。

6.2 后来 CHANGETIME(数据区域)

返回上次更改密码或密码短语的日期和时间 (以 ABSTIME 为单位)。

当外部安全管理器为 RACF®时，时间显示为午夜。

6.2 后来 DAYSLEFT(数据区域)

在半字二进制字段中返回从现在到密码或密码短语到期的天数。

如果用户的密码或密码短语未过期，-1被返回。

ESMREASON (data-area)

返回 CICS 从 ESM 接收的全字二进制字段中的原因码。

如果 ESM 是 RACF，那么此字段是 RACF 原因码。

ESMRESP (数据区)

在全字二进制字段中返回 CICS 从 ESM 接收的响应代码。

如果 ESM 是 RACF，那么此字段是 RACF 返回码。

6.2 后来 EXPIRYTIME(数据区域)

返回密码将到期的日期和时间 (以 ABSTIME 为单位)。

当外部安全性管理器为 RACF时，时间显示为午夜。

如果用户的密码或密码短语未过期，-1被返回。

GROUPID (data-value)

将正在注册的用户分配给 RACF 用户组。这将仅针对此会话覆盖在 RACF 数据库中为用户指定的缺省组名。

6.2 后来 invalidcount(数据区域)

返回在半字二进制字段中为此用户输入无效密码或密码短语的次数。

创建后，首次使用 RACF USERID 登录时，将返回 x'00FF' 值。

LANGUAGECODE (data-value)

指定要注册的用户希望 CICS 使用的本地语言。将语言指定为标准 3-character IBM® 代码。这是您在 NATLANG 选项上指定的 1 字符代码的替代方法。

请参阅本地语言代码以获取代码的可能值。

注: CICS 消息仅支持美式英语，简体中文和日语。如果指定了任何其他语言，那么缺省情况下将使用英语。

LANGINUSE (数据区)

允许应用程序接收由注册过程选择的本地语言。该语言标识为标准的三字符 IBM 代码，而不是 NATLANGINUSE使用的单字符代码。它是现有 NATLANGINUSE 选项的替代方法。

请参阅本地语言代码以获取代码的可能值。

6.2 后来 lastusetime(数据区域)

返回上次访问此用户标识的数据和时间 (以 ABSTIME 为单位)。

NATLANG (data-value)

指定 1 字符代码，用于标识用户在注册会话期间要使用的本地语言。

请参阅本地语言代码以获取代码的可能值。

注: CICS 消息仅支持美式英语，简体中文和日语。如果指定了任何其他语言，那么缺省情况下将使用英语。

NATLANGINUSE (数据区)

指定表示注册会话期间使用的本地语言的 1 字符代码。当前实现始终返回字符 E (U.S)。英语) ，对应于 NATLANG 选项中提供的语言。 NATLANGINUSE 对应于以下 (按优先级递减顺序):

SIGNON 命令的 NATLANG 选项中提供的语言。
与用户关联的语言。这在 ESM 语言段中指定。
与终端定义关联的语言。
与 CICS 区域的缺省 USERID 关联的语言。
系统初始化参数中指定的缺省语言。

请参阅本地语言代码以获取代码的可能值。

NEWPASSWORD (data-value)

指定定义新密码的可选 8 字节字段。仅当同时指定了 PASSWORD 时，此选项才有效。不能在此字段中输入密码短语。

如果此字段为空，那么将忽略此字段。

如果 ESM 不允许混合大小写密码，那么密码将转换为大写。

NEWPHRASE (data-area)

指定可选的 1 到 8 字符的新密码或 ESM 所需的 9 到 100 字符的新密码短语。仅当同时指定了 PHRASE 时，此选项才有效。

如果此字段为空，那么将忽略此字段。

如果 ESM 不允许混合大小写密码，那么会将 1-to 8 字符密码转换为大写。

NEWPHRASELEN (data-value)

将新密码短语的长度指定为全字二进制值。仅当同时指定了 NEWPHRASE 时，此选项才有效。

如果 NEWPHRASELEN 为 0 ，那么将忽略 NEWPHRASE 。

OIDCARD (data-value)

指定可选的 65 字节字段，其中包含来自 32xx 设备上的磁条阅读器 (MSR) 的进一步安全数据。

PASSWORD (data-value)

指定 ESM 所需的 8 字节密码。

如果 ESM 不允许混合大小写密码，那么密码将转换为大写。

PHRASE (数据区)

指定可选的 1-to 8 字符密码或 ESM 所需的 9-to 100 字符密码短语。

如果 ESM 不允许混合大小写密码，那么会将 1-to 8 字符密码转换为大写。

PHRASELEN (data-value)

将密码短语的长度指定为全字二进制值。仅当同时指定了 PHRASE 时，此选项才有效。

USERID (data-value)

指定 8 字节的登录用户标识。

提供的用户标识将转换为大写。

条件

16 INVREQ

RESP2 值：

2: 密码不能用于更改密码短语或密码短语不能用于更改密码。
9: 终端已登录。
10: 没有终端与此任务相关联。
11: 此任务的终端具有预设安全性。
12: 无法识别来自 CICS 安全模块的响应。
13: RACF 在 ESMRESP 中返回的值未由 CICS进行分类。请参阅 ESM 文档以获取 ESMRESP 和 ESMREASON 值的说明。
14: 必需的本地语言不可用。
15: 尝试在不使用 CRTE 事务的情况下使用事务路由进行登录。
18: 未初始化 CICS ESM 接口 (SEC=NO 指定为系统初始化参数)。
25: 终端的类型无效。
26 日: SNSCOPE 检查期间发生错误。 MVS ENQ 请求已达上限。
27: ESM 未处于活动状态。
28 日: 必需的本地语言无效。
29 日: 用户已登录。这与注册作用域检查相关。
200: 不允许对分布式程序链接服务器程序使用命令。

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

22 LENGERR

RESP2 值：

1: PHRASELEN 超出范围。
2: NEWPHRASELEN 超出范围。

70 NOTAUTH

RESP2 值：

1: 密码或密码短语是必需的。
2: 提供的密码或密码短语错误。
3: 需要新的密码或密码短语。
4: 新密码或密码短语不可接受。
5: 需要 OIDCARD。
6: 提供的 OIDCARD 错误。
16: USERID 无权使用此终端。
17 日: 未授权 USERID 使用应用程序。
19: 已撤销 USERID。
20: 已撤销 USERID 对指定组的访问权。
21: SECLABEL 检查期间登录失败。
22: 由于 ESM 当前未接受注册，因此登录失败。
23: GROUPID 对于 ESM 未知。
24: USERID 未包含在 GROUPID 中。

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

69 个用户标识

RESP2 值：

8: ESM 不知道 USERID。
30: USERID 全部为空白或空。

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