Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

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

Reference Type: Supported, Category: Data Security, Integration Agreement:6157

Description

This 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

Output
  • SHA hash if successful.
  • Zero (0) - If there is an error.

 

Example

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