25.09.2015 Views

Teradata Parallel Data Pump

Teradata Parallel Data Pump Reference - Teradata Developer ...

Teradata Parallel Data Pump Reference - Teradata Developer ...

SHOW MORE
SHOW LESS
  • No tags were found...

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Chapter 5: Using INMOD and Notify Exit Routines<br />

Overview<br />

Table 35: <strong>Teradata</strong> T<strong>Pump</strong>-to-INMOD Status Codes (continued)<br />

Value<br />

Description<br />

4 <strong>Teradata</strong> <strong>Data</strong>base has failed, the INMOD routine should reposition to the last<br />

checkpoint, and <strong>Teradata</strong> T<strong>Pump</strong> is not expecting the INMOD routine to return a data<br />

record.<br />

Note: If the database restarts before the first checkpoint, <strong>Teradata</strong> T<strong>Pump</strong> sends entry<br />

code 5 for cleanup, and then it sends entry code 0 to re-initialize.<br />

<strong>Teradata</strong> T<strong>Pump</strong> reads the repositioning information, provided by the INMOD after a<br />

code 3, from the restart log table and returned to the INMOD in the buffer normally used<br />

for the data record.<br />

5 The <strong>Teradata</strong> T<strong>Pump</strong> job has ended and the INMOD routine should perform any<br />

required cleanup tasks.<br />

6 The INMOD should initialize and prepare to receive records.<br />

7 The next record is available for the INMOD.<br />

Table 36 explains the two status codes used by the INMOD-to-<strong>Teradata</strong> T<strong>Pump</strong> interface.<br />

Table 36: INMOD-to-<strong>Teradata</strong> T<strong>Pump</strong> Interface Status Codes<br />

Value<br />

Description<br />

0 A record is being returned as the body value for a read call (code 1).<br />

For calls other than read, a value of 0 indicates successful completion.<br />

Any nonzero<br />

value<br />

The INMOD routine is at an end-of-file condition for a read call (code 1). For calls<br />

other than read, a nonzero value indicates a processing error that terminates<br />

<strong>Teradata</strong> T<strong>Pump</strong>.<br />

Length<br />

Length is the 32-bit binary value that the INMOD routine uses to specify the length, in bytes,<br />

of the data record. The INMOD routine can use a length value of zero to indicate an end-offile<br />

condition.<br />

Body<br />

Body is the area where the INMOD routine places the data record. Maximum record length is<br />

31K or 31,744 bytes for <strong>Teradata</strong> for Windows. Maximum record length for <strong>Teradata</strong> <strong>Data</strong>base<br />

for UNIX is 62K or 63,488 bytes.<br />

Sequence Number<br />

Sequence number is a 4-byte integer record counter portion of the source sequence number.<br />

Parameter List<br />

The parameter list in the second 32-bit address consists of the following:<br />

• VARCHAR specification<br />

<strong>Teradata</strong> <strong>Parallel</strong> <strong>Data</strong> <strong>Pump</strong> Reference 207

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!