Kernel APIs: $$GLOBAL^XLFSHAN

$$GLOBAL^XLFSHAN(): Returns SHA Hash for a Global

Reference Type: Supported, Category: Data Security, ICR#: 6157

Description

The $$GLOBAL^XLFSHAN extrinsic function returns the SHA hash of a specified global, in contrast with the $$FILE^XLFSHAN API, which returns the hash for a particular entry in a global.

NOTE: This API was released with Kernel Patch XU*8.0*657.

Format

  $$GLOBAL^XLFSHAN(hashlen,filenum,dataonly)

Input Parameters

hashlen:

(required) The hash length in bits:

160 (SHA-1)
224 (SHA-224)
256 (SHA-256)
384 (SHA-384)
512 (SHA-512)

filenum:

(required) VA FileMan file number.

dataonly:

(required) Scope of the hash:

0—Global location of the data is to be included in the hash computation.
1—Hash is computed only for the data.

Output

returns:

Returns:

SHA hash—If successful.
Zero (0)—If there is an error.

Example

>W $$GLOBAL^XLFSHAN(256,200,0)
714CE00DE20E30700229F95F69DBAE34262CF30576EA03852CFBE0D0DC2BE611