Purpose
Enables a TDP internal diagnostic trap. The trap causes the TDP to perform a specified action if the trap conditions occur.
Syntax
where:
- PERmio
- Trap a CP permanent I/O error.
- CHECKSUM
- Trap a checksum validation failure for an NP or CCU-type CP.
- BADcp
- Trap an invalid CP device.
- BADNptu
- Trap an NP transmission unit that contains an invalid encapsulation header.
- SERverpv
- Trap a Teradata Database protocol violation.
- SERVEREv
- Trap a Teradata Database encapsulation violation.
- CLIentvp
- Trap a client protocol violation.
- CLIENTEv
- Trap a client encapsulation violation.
- NORead
- Trap detection of the unexpected lack of a read when CP is recovering from a loss of communication with the Database.Lower case letters represent optional characters.
- FAUltrsp
- Trap a faulty response. A faulty response is one whose parcels do not exactly fill the response.
- IMPrstrt
- Trap detection of an implicit CP restart. An implicit CP restart occurs when TDP was not informed of the restart of a CP directly by the CP, but rather detects the restart by subsequent errors returned by the Teradata Database.Lower case letters represent optional characters.
- UNSolrsp
- Trap detection of an unsolicited response. An unsolicited response occurs when TDP receives a response from the Teradata Database that is not associated with a request that had been sent by TDPLower case letters represent optional characters.
- ABEnd
- Terminate TDP if the trap condition occurs. This is the default.
- SNAp
- Record the event to TDPSNAP if the trap condition occurs.
- name
- Trap name; length is 1 to 8 characters.
- MATchrsp
- Trap a response from the Teradata Database containing a specified warning, error, or failure code
- codevalue
- Numeric value of the Teradata Database warning, error, or failure code, between zero and 65535. While zero is not a valid Database code, it is permitted to allow trapping an erroneous error or failure code of zero. For the Success and OK parcels, a warning code of zero indicates there is no warning code so specifying a value of zero will never trap a warning; trapping a warning code of zero will work for the StatementStatus parcel.
- CODe
- For a MATCHRSP trap, provides the Teradata Database warning, error, or failure code.
- NAMe
- Provides a name to be associated with the trap. If omitted, TDP will supply a default name.
Usage Notes
The trap can be removed by using the DISABLE TRAP command.
For event types that do not support the ACTION operand, or when the ACTION operand is not specified, ABEND is the implied action.
This command is intended for use in consultation with Teradata Customer Support personnel.
Example: ENABLE TRAP
ENABLE TRAP PERMIO
Completion Message
TDP0401 TRAP TRAP0001 HAS BEEN ENABLED