EMS Manual

Distributor Event Messages
EMS Manual—426909-005
18-18
1002: ZEMS-EVT-DEST-ACCESS
ZEMS-TKN-SUBJECT-MARK (shared)
is the standard EMS token that immediately precedes each subject token. This
event message has one subject token:
ZEMS-TKN-FAILFILENAME (nonshared)
is the file name of a bad file. Here it is the name of a destination device or
process that the distributor could not access.
ZSPI-TKN-PROC-ERR (nonshared)
specifies a procedure associated with the event. Here EMS assigns one of these
values:
ZEMS-VAL-ZFILOPEN 22
ZEMS-VAL-ZFILWRITE 25
The extensible structured token ZEMS-MAP-STATUS-DIST and tokens ZEMS-TKN-
FAILFILENAME and -ZFILERR are described in Token and Data Type Definitions on
page 18-3.
Cause. There are two possible causes: (1) a printing distributor cannot access a text
destination, or (2) a forwarding distributor cannot access the collector to which event
messages are forwarded.
Effect. The distributor performs, depending on its type:

A forwarding distributor that tried unsuccessfully to open a target collector tries
again periodically. The distributor resumes forwarding messages if a later attempt
succeeds.

A printing distributor that tried to communicate with a TEXTOUT destination and
timed-out does one of:

If another TEXTOUT destination is operating, the distributor disconnects the
current TEXTOUT destination.

If no other TEXTOUT destination is operating, the distributor tries periodically
to communicate with the current one.
A printing distributor that has had communications problems other than time-out
problems with a TEXTOUT destination tries again periodically.
An application can connect a disconnected TEXTOUT destination when the problem is
corrected.
Recovery. If the distributor cannot access a collector or a destination, check for a
security violation. If the distributor cannot access a printer, check the printer.
If another destination is available, disconnect the problem destination. After you fix the
problem destination, reconnect it to the system.
If you cannot correct the problem, contact your service provider.