Kernel APIs: $$CCD^XLFUTL

$$CCD^XLFUTL(): Append Check Digit

Reference Type: Supported, Category: Utility Functions, ICR#: 2622

Description

The $$CCD^XLFUTL extrinsic function returns a number appended with a computed check digit. To check if the original number corresponds with the appended check digit, use the $$VCD^XLFUTL(): Verify Integrity API.

Format

  $$CCD^XLFUTL(x)

Input Parameters

(required) Integer for which the check digit is computed.

REF: see "The Taylor Report" in Computerworld magazine, 1975, for the algorithm.

NOTE: This Check Digit algorithm is considered obsolete. Developers are advised to consider other alternatives to validate data integrity. Alternatives include using:

AES Encryption/Decryption: $$AESENCR^XUSHSH and $$AESDECR^XUSHSH.
Secure Hash Algorithm (SHA) hashing: $$SHAHASH^XUSHSH or $$SHAN^XLFSHAN for strings.
Other SHA hash APIs can be used to validate data integrity for:

Files: $$FILE^XLFSHAN or $$HOSTFILE^XLFSHAN

Routines: $$ROUTINE^XLFSHAN

Globals: $$GLOBAL^XLFSHAN

Messages: $$LSHAN^XLFSHAN.

Output

returns:

Returns the number with appended check digit.

Examples

Example 1

>S X=$$CCD^XLFUTL(99889)

>W X
998898

Example 2

>S X=$$CCD^XLFUTL(7654321)

>W X
76543214