Technical information
EVENT NOTIFY PROCEDURES
111
As you can see from the flow diagram, the receive notification mechanism is much simpler than either of the send
notification mechanisms. The receive notification mechanism features a single notification point and is not iterative.
Note
When a fax is routed to a user, any RNP specified in that user's profile will be run.
Immediately after a fax is received by the system, the system Receive Notify Procedures (RNP) is automatically run
and if the system finds site or device RNPs, it runs them in that order.
Receive notify procedures (RNPs)
Receive Notify Procedures (RNPs) are very similar to other notify procedures. The primary difference is that while the
send notification mechanism provides a user level of execution (for customizing a notification point on a user-by-user
basis), the receive notification mechanism implements a device level of execution (for customizing a notification point
on a device-by-device basis).
This is done because when a fax is received, the system does not necessarily know which VSI-FAX user the fax is
intended for. However, the system always knows which device answered the telephone call and received the fax.
Another major difference between user notify procedures and device RNPs is that while user notify procedures are
embedded in the vfx (send fax) command and must be specified for each fax request (they are not permanent),
device RNPs are assigned to each device via the vfxadmin device -P <RNP> command and this assignment is
permanent.
Start, stop, and fail notification
Two special notify procedures, sys-start and sys-stop, provide notification whenever the scheduler is started or
stopped, respectively. A third notification procedure, sys-devfail, provides notification any time a physical fax
device fails. A fourth notification procedure, sys-autofail, provides notification anytime a request in an autosend
directory fails.
These notification mechanisms are much simpler than send and receive notifications. Only the system notify
procedures, mentioned in the previous paragraph, can be run. Site, user, and device notify procedures are not
available.
The sys-start, sys-stop,and sys-devfail notify procedures are not provided with the default VSI-FAX
installation. You must create them according the guidelines described in Custom notify procedures
and place them in
the $VSIFAX/lib/enp directory.
Refer to these topics for additional information and sample scripts:
Custom notify procedures
Start and stop notify procedures (Tcl)
Fail notify procedures