dbo uspLogError (procedure)

Modified on 2011/08/27 11:17 by wikibot Categorized as Uncategorized
== wikibot ==

{| border="1" cellpadding="5" cellspacing="0" style="border-collapse:collapse"
|- valign="top"
| '''Procedure'''
| dbo.uspLogError
|- valign="top"
| '''Description'''
| Logs error information in the ErrorLog table about the error that caused execution to jump to the CATCH block of a TRY...CATCH construct. Should be executed from within the scope of a CATCH block otherwise it will return without inserting error information.
|}

=== Source ===
{{{{<nowiki>
-- uspLogError logs error information in the ErrorLog table about the 
-- error that caused execution to jump to the CATCH block of a 
-- TRY...CATCH construct. This should be executed from within the scope 
-- of a CATCH block otherwise it will return without inserting error 
-- information. 
CREATE PROCEDURE [dbo].[uspLogError] 
    @ErrorLogID [int] = 0 OUTPUT -- contains the ErrorLogID of the row inserted
AS                               -- by uspLogError in the ErrorLog table
BEGIN
    SET NOCOUNT ON;

    -- Output parameter value of 0 indicates that error 
    -- information was not logged
    SET @ErrorLogID = 0;

    BEGIN TRY
        -- Return if there is no error information to log
        IF ERROR_NUMBER() IS NULL
            RETURN;

        -- Return if inside an uncommittable transaction.
        -- Data insertion/modification is not allowed when 
        -- a transaction is in an uncommittable state.
        IF XACT_STATE() = -1
        BEGIN
            PRINT 'Cannot log error since the current transaction is in an uncommittable state. ' 
                + 'Rollback the transaction before executing uspLogError in order to successfully log error information.';
            RETURN;
        END

        INSERT [dbo].[ErrorLog] 
            (
            [UserName], 
            [ErrorNumber], 
            [ErrorSeverity], 
            [ErrorState], 
            [ErrorProcedure], 
            [ErrorLine], 
            [ErrorMessage]
            ) 
        VALUES 
            (
            CONVERT(sysname, CURRENT_USER), 
            ERROR_NUMBER(),
            ERROR_SEVERITY(),
            ERROR_STATE(),
            ERROR_PROCEDURE(),
            ERROR_LINE(),
            ERROR_MESSAGE()
            );

        -- Pass back the ErrorLogID of the row inserted
        SET @ErrorLogID = @@IDENTITY;
    END TRY
    BEGIN CATCH
        PRINT 'An error occurred in stored procedure uspLogError: ';
        EXECUTE [dbo].[uspPrintError];
        RETURN -1;
    END CATCH
END;
</nowiki>}}}}

=== References ===
{| border="1" cellpadding="5" cellspacing="0" style="border-collapse:collapse"
|- style="background:silver"
| '''Dependency Type'''
| '''Object Type'''
| '''Referenced Object'''

|- valign="top"
| Insert
| Table
| [[dbo ErrorLog (table)|dbo.ErrorLog]]

|- valign="top"
| Execute
| Procedure
| [[dbo uspPrintError (procedure)|dbo.uspPrintError]]

|}

=== Dependencies ===
{| border="1" cellpadding="5" cellspacing="0" style="border-collapse:collapse"
|- style="background:silver"
| '''Reference Type'''
| '''Object Type'''
| '''Referencing Object'''

| '''Child Type'''
| '''Child Object'''

|- valign="top"
| Execute
| Procedure
| [[HumanResources uspUpdateEmployeeHireInfo (procedure)|HumanResources.uspUpdateEmployeeHireInfo]]

| &nbsp;
| &nbsp;
|- valign="top"
| Execute
| Procedure
| [[HumanResources uspUpdateEmployeeLogin (procedure)|HumanResources.uspUpdateEmployeeLogin]]

| &nbsp;
| &nbsp;
|- valign="top"
| Execute
| Procedure
| [[HumanResources uspUpdateEmployeePersonalInfo (procedure)|HumanResources.uspUpdateEmployeePersonalInfo]]

| &nbsp;
| &nbsp;
|- valign="top"
| Execute
| Table
| [[Production WorkOrder (table)|Production.WorkOrder]]

| Trigger
| iWorkOrder
|- valign="top"
| Execute
| Table
| [[Production WorkOrder (table)|Production.WorkOrder]]

| Trigger
| uWorkOrder
|- valign="top"
| Execute
| Table
| [[Purchasing PurchaseOrderDetail (table)|Purchasing.PurchaseOrderDetail]]

| Trigger
| iPurchaseOrderDetail
|- valign="top"
| Execute
| Table
| [[Purchasing PurchaseOrderDetail (table)|Purchasing.PurchaseOrderDetail]]

| Trigger
| uPurchaseOrderDetail
|- valign="top"
| Execute
| Table
| [[Purchasing PurchaseOrderHeader (table)|Purchasing.PurchaseOrderHeader]]

| Trigger
| uPurchaseOrderHeader
|- valign="top"
| Execute
| Table
| [[Purchasing Vendor (table)|Purchasing.Vendor]]

| Trigger
| dVendor
|- valign="top"
| Execute
| Table
| [[Sales SalesOrderDetail (table)|Sales.SalesOrderDetail]]

| Trigger
| iduSalesOrderDetail
|- valign="top"
| Execute
| Table
| [[Sales SalesOrderHeader (table)|Sales.SalesOrderHeader]]

| Trigger
| uSalesOrderHeader
|- valign="top"
| Execute
| Table
| [[Sales Store (table)|Sales.Store]]

| Trigger
| iStore
|}
devio dbscript ScrewTurn Wiki

Navigation¶

dbo uspLogError (procedure)
