KnowledgeBase 00075: Hold File Logging

Introduction

QM applications can set a print unit into mode 3 to direct the output to the
$HOLD file or to another specific destination file. Sometimes it is useful for
other components of the application to be alerted to creation of a print file.

The HOLD.FILE.LOGGER Subroutine

When using a mode 3 print unit, QM will check for the existance of a catalogued
subroutine named HOLD.FILE.LOGGER and, if found, will call this when the print
unit is opened and again when it is closed.

The subroutine takes three arguments:

The print unit number.

A mode flag set to 1 when opening the file, 0 when closing it.

The pathname of the data file.

Typically, the subroutine might trigger some other action such as forwarding
the print file to some other software such as an email system.