CHANGE PASSWORD
更改 RACF® 针对指定用户标识记录的密码。
语法
条件: INVREQ , NOTAUTH 和 USERIDERR
此命令是线程安全的。
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
描述
与 SIGNON 命令不同, CHANGE PASSWORD 不依赖于主体设施; 因此,可以在非终端环境 (例如, Web 应用程序和 APPC 会话) 中发出此命令。
当此命令由在 CEDF下运行的事务发出时,密码或密码短语 (以及新密码或密码短语 (如果适用)) 将被清空。
选项
选项 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 为单位)。
- NEWPASSWORD (data-value)
- 为指定的用户标识指定新的 8 字符密码。 仅当正确指定了当前密码时,才会更改密码。
如果 ESM 不允许混合大小写密码,那么密码将转换为大写。
- PASSWORD (data-value)
- 指定指定用户标识的当前 8 字符密码。
如果 ESM 不允许混合大小写密码,那么密码将转换为大写。
- USERID (data-value)
- 指定要更改其密码的用户的 8 字符用户标识。
提供的用户标识将转换为大写。
条件
- 16 INVREQ
- RESP2 值:
- 13
- RACF 在 ESMRESP 中返回的值未由 CICS进行分类。 请参阅 ESM 文档以获取 ESMRESP 和 ESMREASON 值的说明。
- 18
- 未初始化 CICS ESM 接口。
- 29 日
- ESM 未响应。
- 32
- 用户标识字段在无效位置中包含空白字符。
缺省操作: 异常终止任务。
- 70 NOTAUTH
- RESP2 值:
- 1
- PASSWORD 字段和/或 NEWPASSWORD 字段为空白。
- 2
- 提供的密码错误。 如果 ESM 为 RACF,那么 RACF 维护的撤销计数将递增。
- 4
- 新密码不可接受。
- 17 日
- 未授权 USERID 使用应用程序。
- 19
- 已撤销 USERID。
- 22
- 在 SECLABEL 处理期间,更改密码请求失败。
- 31 日
- 将在与缺省组的连接中撤销用户。
缺省操作: 异常终止任务。
- 69 个用户标识
- RESP2 值:
- 8
- ESM 不知道 USERID。
缺省操作: 异常终止任务。
