BIF DIGEST

描述

BIF DIGEST 命令是 CICS® 内置函数，用于计算数据字符串的 SHA-1 摘要。 结果可以作为二进制 (长度为 20 字节) ，十六进制 (长度为 40 字节) 或 base64-encoded (长度为 28 字节) 返回。 SHA-1 摘要是字符串的密码强校验和，因此出于实际目的，它对于每个字符串都是唯一的。

此命令使用需要带有 CP Assist for Cryptographic Functions (CPACF) 的 z Systems ® 加密硬件的 z/Architecture ® 消息安全辅助 (MSA) 功能。 有关更多信息，请参阅 z/OS Cryptographic Services ICSF 概述。

选项

记录 (data-value)

此选项指定要计算摘要的数据字符串。

RECORDLEN (data-value)

此选项指定数据字符串的长度 (作为全字二进制值)。

DIGESTTYPE (cvda)

此选项指定返回摘要的格式。

HEX

十六进制，生成长度为 40 字节的结果，编码为十六进制字符 (0-9 ， A-F)。

BINARY

二进制，生成长度为 20 字节的结果。

BASE64

Base64 编码，使用字符 A-Z ， a-z ， 0-9 ， + ，/， = 生成长度为 28 个字节的结果。

RESULT (数据区域)

此选项以 DIGESTTYPE 选项指定的格式返回数据字符串的 SHA-1 摘要。 结果的长度取决于请求的格式。

条件

16 INVREQ

RESP2 值：

1

DIGESTTYPE 具有无效的 CVDA 值。

3

z/体系结构消息安全辅助 (MSA) 不可用。

22 LENGERR

RESP2 值：

2

RECORDLEN 值小于 1。