PLICTFHX Subroutine

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.

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.

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);

Restrictions

None.