Only application programs created for reception can receive a message log report. The UAPs (SUP, SPP, or MHP) of OpenTP1 cannot receive this report.

Set the environment variable DCDIR that indicates the OpenTP1 home directory for the application programs that receive a report. This value must be the same as for the OpenTP1 that reports a message log.

If the online jobs of OpenTP1 obtain all the message logs at start or later, the application programs that receive a report must be started before OpenTP1.

The application programs that receive a message log report contend for the start of reception using the dc_log_notify_open() function. Then, they receive a message log with the dc_log_notify_receive() function. Only one message log can be received by the dc_log_notify_receive() function. To receive multiple message logs, call the dc_log_notify_receive() function repeatedly.

To terminate message log report reception, call the dc_log_notify_close() function. When calling the dc_log_notify_open() function after calling the dc_log_notify_close() function, the message log report can be re-received.

The application programs that receive a report continue to wait until the dc_log_notify_close() function is called after OpenTP1 has terminated. If the termination of reception is reported to the application programs, send data using the dc_log_notify_send() function from other application programs. In the application programs that report a reception termination, the dc_log_notify_open() function cannot be called before calling the dc_log_notify_send() function.

Figure 3-72 shows reception of a message log report.

Figure 3-72 Reception of a message log report