HEXIMAGE returns a character string that is the hexadecimal representation of the storage at a specified location.
HEXIMAGE(p,n) returns a character string that is the hexadecimal representation of n bytes of storage at location p. Its length is 2 * n.
HEXIMAGE(p,n,z) returns a character string that is the hexadecimal representation of n bytes of storage at location p with character z inserted between every set of eight characters in the output string. Its length is (2 * n) + ((n - 1)/4).
- p
- Restricted expression that must have a locator type (POINTER or OFFSET). If p is OFFSET, it must have the AREA attribute.
- n
- Expression. n must have a computational type and is converted to FIXED BINARY(31,0).
- z
- If specified, z must have the type CHARACTER(1) NONVARYING.
If the number of bytes to be converted to hex is not known at compile time, then no more than 32767 bytes will be converted.
For examples of the HEXIMAGE built-in function, see HEX.