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

128 DBLIBTERM= LIBNAME Option 4 Chapter 10DBLIBTERM= LIBNAME OptionSpecifies a user-defined termination command to execute once, before the DBMS that isassociated with the first connection made by the LIBNAME statement or libref disconnects.Default value: noneValid in: SAS/ACCESS LIBNAME statementDBMS support: Aster nCluster, DB2 under UNIX and PC Hosts, DB2 under z/OS,Greenplum, HP Neoview, Informix, Microsoft SQL Server, MySQL, Netezza, ODBC,OLE DB, Oracle, Sybase, Sybase IQ, TeradataSyntaxDBLIBTERM=DBMS-user-commandSyntax DescriptionDBMS-user-commandis any DBMS command that can be executed by the SAS/ACCESS engine and thatdoes not return a result set or output parameters.DetailsThe termination command that you select can be a script, stored procedure, or anyDBMS SQL statement that might provide additional control over the interactionbetween the SAS/ACCESS engine and the DBMS. The command executes immediatelybefore SAS terminates the last connection to the DBMS. If the command fails, thenSAS provides a warning message but the library deassignment and disconnect stilloccurs. You must specify the command as a single, quoted string.DBLIBTERM= fails if either CONNECTION=UNIQUE or DEFER=YES or both ofthese LIBNAME options are specified.When two LIBNAME statements share the same physical connection, thetermination command is executed only once. (Multiple LIBNAME statements that useCONNECTION=GLOBALREAD and identical values for CONNECTION_GROUP=,DBCONINIT=, DBCONTERM=, DBLIBINIT=, and DBLIBTERM= options and anyDBMS connection options can share the same connection to the DBMS.)ExampleIn the following example, CONNECTION=GLOBALREAD is specified on bothLIBNAME statements, but the DBLIBTERM commands are different. Therefore, thesecond LIBNAME statement fails to share the same physical connection.libname mydblib oracle user=testuser pass=testpassconnection=globalread dblibterm=’Test’;libname mydblib2 oracle user=testuser pass=testpassconnection=globalread dblibterm=’NoTest’;