EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-20
CONTROL Command (ZEMS-CMD-CONTROL)
Error-Handling Notes
Table 17-10 lists the name, number, and description of each ZEMS-CMD-CONTROL
error message (or warning). The messages are grouped by the command features to
which they are each related.
Each name marked with an asterisk (*) is a warning—the value of the ZSPI-TKN-
RETCODE token is set to zero. The error list contains the ZSPI-TKN-ERROR token,
which contains the number of the warning.
For a more complete description of each error and for a description of the error-list
tokens associated with each error, see Section 21, Distributor Errors.
Installing Filters
All types of distributors (consumer, forwarding, and printing) use EMS filters. These
include compiled filters, filter tables, and burst filters. If you start a consumer or printing
distributor without a filter, the system provides a default filter that passes all event
Table 17-10. CONTROL Command Errors
Name
(ZEMS-ERR-) Number Description
Filter Load and Related Options
FLT-FORM
FLT-LOAD
REQ-PARM
1019
1020
1022
Bad filter format
Failed to load filter
Required parameter missing
Collector Connect/Disconnect
HIST-MODE
MAX-COLLECTOR
COLLECTOR-EXISTS
COLL-NOT-FOUND
NO-POOL
1024
1025
1026
1027
1043
Bad operation on log-file source
Ten collectors already
Already connected
Not connected; cannot disconnect
No space for another collector
Positioning
TOO-EARLY*
TOO-LATE*
EOF
FORWARD-SEARCH
NO-EVENT SOURCE
502
503
1032
1033
1044
Position too far in the past
Position too far in the future
Last record read from log file
Missing next file to search
Specify source collector
Add/Delete TEXTOUT
MAX-DEST
DEST-EXISTS
DEST-NOT-FOUND
1035
1037
1038
Exceeds 10 TEXTOUT destinations
Destination already added
Destination not found
Distributor Access
STAT-ONLY 1052 Access to the specified distributor is not permitted
Entries marked with an asterisk (*) are warnings (use the prefix ZEMS-WRN-) rather than errors (use the prefix
ZEMS-ERR-).