SAS/ACCESS 9.2 for Relational Databases: Reference, Fourth Edition

Data Set Options for Relational Databases 4 TPT_APPL_PHASE= Data Set Option 375DBMS support:TeradataSyntaxTPT_APPL_PHASE=YES | NOSyntax DescriptionYESspecifies that the Fastload or MultiLoad run that is being restarted has failed in theapplication phase. This is valid only when SAS uses the TPT API.NOspecifies that the load process that is being restarted has not failed in the applicationphase.DetailsTo use this option, you must first set TPT=YES.SAS can restart from checkpoints any Fastload, MultiLoad, and Multi-Statementinsert that is run using the TPT API. The restart procedure varies: It depends onwhether checkpoints were recorded and in which phase the step failed during the loadprocess. Teradata loads data in two phases: the acquisition phase and the applicationphase. In the acquisition phase, data transfers from SAS to Teradata. After this phase,SAS has no more data to transfer to Teradata. If failure occurs after this phase, setTPT_APPL_PHASE=YES in the restart step to indicate that restart is in theapplication phase. (Multi-Statement insert does not have an application phase and soneed not be restarted if it fails after the acquisition phase.)Use OBS=1 for the source data set when restart occurs in the application phase.When SAS encounters TPT_RESTART=YES and TPT_APPL_PHASE=YES, it initiatesrestart in the application phase. No data from the source data set is actually sent. Ifyou use OBS=1 for the source data set, the SAS step completes as soon as it reads thefirst record. (It actually throws away the record because SAS already sent all data toTeradata for loading.)ExamplesHere is a sample SAS program that failed after the acquisition phase.libname x teradata user=testuser pw=testpw;data x.test(MULTILOAD=YES TPT=YES CHECKPOINT=7);do i=1 to 20;output;end;run;ERROR: Teradata connection: Failure occurred after the acquisition phase.Restart outside of SAS using checkpoint data 14.Set TPT_APPL_PHASE=YES to restart when failure occurs in the application phasebecause SAS has already sent all data to Teradata.proc append base=x.test(MULTILOAD=YES TPT_RESTART=YESTPT_CHECKPOINT_DATA=14 TPT_APPL_PHASE=YES) data=test(obs=1);