Restriction:
These options apply only when the Enterprise Server feature is enabled.
If the trace on error option is specified, this option can be used to control which error conditions cause MFCS to write the
trace output. If it is not specified, trace output is written on every error condition, as described in the topic trace on
error.
Syntax:
trace error filter=token-list
Parameters:
- token-list
- A list of one or more tokens, separated by spaces and/or commas. Tokens can be any of:
- FAIL
- This special token will cause errors to be reported if MFCS returns a non-zero value to CAS. This typically indicates a severe
processing failure, such as, an invalid request from CAS or the failure to allocate storage.
- RETCODE
- This special token will cause errors to be reported if the EZ Sockets API parameter RETCODE is -1 on returning from an EZ
Sockets function. Many EZ Sockets APIs (though not all) use -1 to indicate that some error occurred.
- ERRNO
- Any valid numeric value, per the IBM EZ Sockets documentation. Currently these include the values 4-121, 1002-1036, 10101-10999,
and 20000-20002. See IBM documentation for the meanings of these values.
- mnemonic name
- The mnemonic name for any ERRNO value, such as EBADF, EIBMSOCKOUTOFRANGE, or EBADRDLEN. See IBM documentation for the names
and their meanings.
The default is to trace on all errors.