15.10 - With Client Load and Unload Utilities - Access Module

Teradata Tools and Utilities Access Module Reference

prodname
Access Module
vrm_release
15.10
category
Programming Reference
featnum
B035-2425-035K

With Client Load and Unload Utilities

The Named Pipes Access Module supports normal checkpoint and restart/recovery operations on the reader process system, but has no such interaction with the writer process.

Routine recovery operations on the reader process system are handled automatically by the Named Pipes Access Module. They require no manual intervention:

  • If the reader process terminates unexpectedly, restart the job, which causes the Named Pipes Access Module to use the fallback data file to relocate to the last checkpoint in the data stream.
  • If the writer process terminates unexpectedly, manually abort the reader process and resynchronize the job.
  • The writer process generally restarts from its beginning, while the reader process falls back to the last checkpoint, allowing the Named Pipes Access Module to synchronize the two. You might need to take the following additional steps to complete the restart operation, depending on which client load and unload utilities are used:

    1 Prepare the writer process source for a clean start.

    The FastExport utility, for example, uses a log table to determine that a task was interrupted. To start an interrupted FastExport job from its beginning, you must first drop the FastExport log table.

    Note: The log table is specified by the LOGTABLE command in the FastExport job script.

    2 Modify the reader process job script. For example, in the FastLoad utility, do the following:

    a Remove any statement that drops the table being loaded.

    b Remove any statement that creates the table being loaded.

    3 Launch both the writer and the reader processes as described in “Using The Teradata Named Pipes Access Module” on page 74. The Named Pipes Access Module uses the fallback data file from the interrupted job to locate the restart position in the data stream from the writer process.

    Note: Named Pipes Access Module does not support the restart of a Named Pipe after a Teradata Database restart.