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

The SQL Pass-Through Facility for Relational Databases 4 CONNECT Statement 429DBCONINIT=DBMS-user-commandspecifies a user-defined initialization command to be executed immediatelyafter the connection to the DBMS.You can specify any DBMS command that can be passed by theSAS/ACCESS engine to the DBMS and that does not return a result set oroutput parameters. The command executes immediately after the DBMSconnection is established successfully. If the command fails, a disconnectoccurs, and the CONNECT statement fails. You must specify the command asa single, quoted string, unless it is an environment variable.DBCONTERM=’DBMS-user-command’specifies a user-defined termination command to be executed before thedisconnect from the DBMS that occurs with the DISCONNECT statement.Default value: noneThe termination command that you select can be a script, storedprocedure, or any DBMS SQL language statement that might provideadditional control over the interaction between the SAS/ACCESS engine andthe DBMS. You can specify any valid DBMS command that can be passed bythe SAS/ACCESS engine to the DBMS and that does not return a result setor output parameters. The command executes immediately before SASterminates each connection to the DBMS. If the command fails, SAS providesa warning message but the disconnect still occurs. You must specify thecommand as a quoted string.DBGEN_NAME= DBMS | SASspecifies whether to automatically rename DBMS columns containingcharacters that SAS does not allow, such as $, to valid SAS variable names.See “DBGEN_NAME= LIBNAME Option” on page 124 for more information.DBMAX_TEXT=integerdetermines the length of any very long DBMS character data type that isread into SAS or written from SAS when using a SAS/ACCESS engine. Thisoption applies to reading, appending, and updating rows in an existing table.It does not apply when you are creating a table.Examples of a long DBMS data type are the SYBASE TEXT data type orthe Oracle LONG RAW data type.DBPROMPT=YES | NOspecifies whether SAS displays a window that prompts the user to enterDBMS connection information before connecting to the DBMS.Default value: NOInteraction: DEFER= LIBNAME optionIf you specify DBPROMPT=YES, SAS displays a window that interactivelyprompts you for the DBMS connection arguments when the CONNECTstatement is executed. Therefore, it is not necessary to provide connectionarguments with the CONNECT statement. If you do specify connectionarguments with the CONNECT statement and you specifyDBPROMPT=YES, the connection argument values are displayed in thewindow. These values can be overridden interactively.If you specify DBPROMPT=NO, SAS does not display the prompting indow.The DBPROMPT= option interacts with the DEFER= LIBNAME option todetermine when the prompt window appears. If DEFER=NO, theDBPROMPT window opens when the CONNECT statement is executed. IfDEFER=YES, the DBPROMPT window opens the first time a pass-throughstatement is executed. The DEFER= option normally defaults to NO, butdefaults to YES if DBPROMPT=YES. You can override this default byexplicitly setting DEFER=NO.