ENABLE TRAP - Teradata Director Program

Teradata® Director Program Reference

Product
Teradata Director Program
Release Number
17.00
Published
June 2020
Language
English (United States)
Last Update
2020-06-18
dita:mapPath
pxm1544831938750.ditamap
dita:ditavalPath
obe1474387269547.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:

In the following attribute descriptions, lowercase letters represent optional characters.
BADcp
Trap an invalid CP device.
BADNptu
Trap an NP transmission unit that contains an invalid encapsulation header.
CHECKSUM
Trap a checksum validation failure for an NP or CCU-type CP.
CLIENTEv
Trap a client encapsulation violation.
CLIentvp
Trap a client protocol violation.
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 database.
MATchrsp
Trap a response from the database containing a specified warning, error, or failure code
MISrtrsp
Trap a misrouted response. A misrouted response is a response from the database that was received on a CP or NP other than the one that sent the request.
NORead
Trap detection of the unexpected lack of a read when CP is recovering from a loss of communication with the database.
PERmio
Trap a CP permanent I/O error.
SERVEREv
Trap a database encapsulation violation.
SERverpv
Trap a database protocol violation.
UNSolrsp
Trap detection of an unsolicited response. An unsolicited response occurs when TDP receives a response from the database that is not associated with a request that had been sent by TDP

Optional parameters:

NAMe
Provides a name to be associated with the trap. If omitted, TDP supplies a default name.
name
Trap name; length is 1 to 8 characters.
ABEnd
Terminate TDP if the trap condition occurs. This is the default.
SNAp
Record the event to TDPSNAP if the trap condition occurs.
CODe
For a MATCHRSP trap, provides the database warning, error, or failure code.
codevalue
Numeric value of the database warning, error, or failure code, between zero and 65535. While zero is not a valid 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 works for the StatementStatus parcel.

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 PERMIO

ENABLE TRAP PERMIO

Completion Message

TDP0401 TRAP TRAP0001 HAS BEEN ENABLED