Purpose
Writes a hexadecimal representation of
x with a length of
y to the CTF trace file.
Syntax
CALL PLICTFHX(999, 1, -1, x, [ y]);
Parameters
x is any variable of any data type.
y is the length to be written to the CTF trace file.
If the
y parameter is missing,
y equals size (x).
y is the length of data that is output in twice the number of hex characters, i.e. the number of characters output is y*2.
Examples
DCL STGPTR POINTER;
DCL 1 STG BASED(STGPTR),
3 HEAD,
5 (NEXT, PREV) PTR,
3 DATA,
5 FB FIXED BIN(31),
5 FC CHAR(200);
CALL PLICTFHX(999, 1, -1, STGPTR);
CALL PLICTFHX(999, 1, -1, STG);
CALL PLICTFHX(999, 1, -1, STG, SIZE(HEAD));
CALL PLICTFHX(999, 1, -1, DATA);
Description
CTF is a diagnostic tool that traces running applications and creates trace files in one of two formats: text (the default) or binary. Use this subroutine to write hexadecimal characters to the trace file.