ENABLE TRAP - Teradata Director Program

Teradata Director Program Reference

Product
Teradata Director Program
Release Number
16.10
Published
May 2017
Language
English (United States)
Last Update
2018-05-09
dita:mapPath
hwt1488824663348.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2416
lifecycle
previous
Product Category
Teradata Tools and Utilities

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 TDP
Lower 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