CHANGE PHRASE

更改 RACF® 为指定用户 ID 记录的密码或密码短语。

语法

CHANGE PHRASE

条件: INVREQ ， LENGERR ， NOTAUTH 和 USERIDERR

此命令是线程安全的。

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

描述

用户标识可以同时具有密码和密码短语。如果 PHRASELEN 介于 1 到 8 个字符之间，那么会将该短语视为密码。如果长度介于 9 到 100 个字符之间，那么会将其视为密码短语。不能使用 1-to 8 字符密码来更改密码短语。同样，不能使用 9 到 100 个字符的密码短语来更改 1 到 8 个字符的密码。

与 SIGNON 命令不同， CHANGE PHRASE 不依赖于主体设施; 因此，可以在非终端环境 (例如， Web 应用程序和 APPC 会话) 中发出此命令。

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

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

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

选项

选项 ESMRESP 和 ESMREASON 从 ESM 返回响应和原因码 (如果有)。

CHANGETIME (数据区)

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

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

DAYSLEFT (data-area)

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

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

ESMREASON (data-area)

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

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

ESMRESP (数据区)

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

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

EXPIRYTIME (数据区)

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

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

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

INVALIDCOUNT (data-area)

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

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

LASTUSETIME (数据区)

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

NEWPHRASE (data-area)

指定可选的 1 到 8 字符的新密码或 ESM 所需的 9 到 100 字符的新密码短语。仅当正确指定了当前密码时，才会更改密码。仅当正确指定了当前密码短语时，才会更改密码短语。

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

NEWPHRASELEN (数据区)

指定新密码或密码短语的长度 (作为全字二进制值)。

PHRASE (数据区)

指定指定用户标识的当前密码或密码短语。

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

PHRASELEN (数据区)

指定当前密码或密码短语的长度 (作为全字二进制值)。

USERID (data-value)

指定要更改其密码或密码短语的用户的用户标识。

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

条件

16 INVREQ

RESP2 值：

2: 不能使用密码来更改密码短语或密码短语来更改密码。
13: RACF 在 ESMRESP 中返回的值未由 CICS进行分类。请参阅 ESM 文档以获取 ESMRESP 和 ESMREASON 值的说明。
18: 未初始化 CICS ESM 接口。
29 日: ESM 未响应。
32: 用户标识字段在无效位置中包含空白字符。

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

22 LENGERR

RESP2 值：

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

70 NOTAUTH

RESP2 值：

1: PHRASE 字段和/或 NEWPHRASE 字段为空白。
2: 提供的密码或密码短语错误。如果 ESM 是 RACF，那么 RACF 维护的撤销计数将递增。
4: 新密码或密码短语不可接受。
17 日: 未授权 USERID 使用应用程序。
19: 已撤销用户标识。
20: 已撤销与用户的缺省组的连接。
22: 在 SECLABEL 处理期间，更改密码请求失败。
31 日: 将在与缺省组的连接中撤销用户。

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

69 个用户标识

RESP2 值：

8: ESM 不知道 USERID。

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