Using tracing with the QMF MESSAGE command

You can use the QMF MESSAGE command to do more than display a message when an application ends. You can also use it to record messages in the QMF trace data output. To do this, run the application with the L-Option for TRACE set to L1 or L2. (For information on how to do this, refer to Using the L-option for tracing.) Every message processed through the MESSAGE command is then recorded, along with other QMF messages (and commands if L2 is used), in the QMF trace data output.

By placing MESSAGE commands in strategic places in your program, you can log useful information in the QMF trace file. After the QMF session, you can examine it, either on the terminal or in printed output. For more information about the QMF trace data output, see Allocating the QMF trace data output.

Example

An application issues the commands shown in the following example:

call dsqcix "SET PROFILE (TRACE=L2"

·
·
·
call dsqcix "MESSAGE (TEXT='QUERYA COMPLETED SUCCESSFULLY'"
·
·
·
call dsqcix "MESSAGE (TEXT='EXECB ENTERED WITH VALUE OF 7'"
·
·
·

Records containing the messages 'QUERYA COMPLETED SUCCESSFULLY' and 'EXECB ENTERED WITH VALUE OF 7' are written into the QMF trace data output.

Because QMF messages can change from one release to the next, you should not use the QMF trace data output as input to an application.

[ Previous Page | Next Page | Contents | Index ]