CREATE OR REPLACE PACKAGE BODY EFT_NOM.cg$CG_REF_CODES IS

PROCEDURE   validate_mandatory(cg$val_rec IN cg$row_type,
                               loc        IN VARCHAR2 DEFAULT '');
PROCEDURE   up_autogen_columns(cg$rec    IN OUT cg$row_type,
                               cg$ind    IN OUT cg$ind_type,
                               operation IN VARCHAR2 DEFAULT 'INS',
                               do_denorm IN BOOLEAN DEFAULT TRUE);
PROCEDURE   err_msg(msg  IN VARCHAR2,
                    type IN INTEGER,
                    loc  IN VARCHAR2 DEFAULT '');
PROCEDURE   uk_key_updateable(uk IN VARCHAR2);
PROCEDURE   fk_key_transferable(fk IN VARCHAR2);



--------------------------------------------------------------------------------
-- Name:        uk_key_updateable
--
-- Description: Raise appropriate error when unique key updated
--
-- Parameters:  none
--------------------------------------------------------------------------------
PROCEDURE uk_key_updateable(uk IN VARCHAR2) IS
BEGIN
    cg$errors.push(cg$errors.MsgGetText(cg$errors.API_UNIQUE_KEY_UPDATE, cg$errors.ERR_UK_UPDATE, uk),
                   'E',
                   'API',
                   cg$errors.API_UNIQUE_KEY_UPDATE,
                   'cg$err.uk_key_updateable');
                   cg$errors.raise_failure;
END uk_key_updateable;


--------------------------------------------------------------------------------
-- Name:        fk_key_transferable
--
-- Description: Raise appropriate error when foreign key updated
--
-- Parameters:  none
--------------------------------------------------------------------------------
PROCEDURE fk_key_transferable(fk IN VARCHAR2) IS
BEGIN
    cg$errors.push(cg$errors.MsgGetText(cg$errors.API_FOREIGN_KEY_TRANS, cg$errors.ERR_FK_TRANS, fk),
                   'E',
                   'API',
                   cg$errors.API_FOREIGN_KEY_TRANS,
                   'cg$err.fk_key_transferable');
    cg$errors.raise_failure;
END fk_key_transferable;


--------------------------------------------------------------------------------
-- Name:        up_autogen_columns
--
-- Description: Specific autogeneration of column values and conversion to
--              uppercase
--
-- Parameters:  cg$rec    Record of row to be manipulated
--              cg$ind    Indicators for row
--              operation Procedure where this procedure was called
--------------------------------------------------------------------------------
PROCEDURE up_autogen_columns(cg$rec IN OUT cg$row_type,
                             cg$ind IN OUT cg$ind_type,
                             operation IN VARCHAR2 DEFAULT 'INS',
                             do_denorm IN BOOLEAN DEFAULT TRUE) IS
BEGIN
    IF (operation = 'INS') THEN

        NULL;
    ELSE
NULL;
    END IF;


EXCEPTION
    WHEN no_data_found THEN
        NULL;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                      'E',
                      'ORA',
                      SQLCODE,
                      'cg$CG_REF_CODES.up_autogen_columns.denorm');
        cg$errors.raise_failure;

END up_autogen_columns;


--------------------------------------------------------------------------------
-- Name:        validate_mandatory
--
-- Description: Checks all mandatory columns are not null and raises appropriate
--              error if not satisfied
--
-- Parameters:  cg$val_rec Record of row to be checked
--              loc        Place where this procedure was called for error
--                         trapping
--------------------------------------------------------------------------------
PROCEDURE validate_mandatory(cg$val_rec IN cg$row_type,
                             loc        IN VARCHAR2 DEFAULT '') IS
BEGIN
    IF (cg$val_rec.RV_DOMAIN IS NULL) THEN
        cg$errors.push(cg$errors.MsgGetText(cg$errors.API_MAND_COLUMN_ISNULL, cg$errors.VAL_MAND, P10RV_DOMAIN),
                       'E',
                       'API',
                       cg$errors.API_MAND_COLUMN_ISNULL,
                       loc);
    END IF;
    IF (cg$val_rec.RV_LOW_VALUE IS NULL) THEN
        cg$errors.push(cg$errors.MsgGetText(cg$errors.API_MAND_COLUMN_ISNULL, cg$errors.VAL_MAND, P20RV_LOW_VALUE),
                       'E',
                       'API',
                       cg$errors.API_MAND_COLUMN_ISNULL,
                       loc);
    END IF;
    NULL;
END validate_mandatory;


--------------------------------------------------------------------------------
-- Name:        validate_foreign_keys
--
-- Description: Checks all mandatory columns are not null and raises appropriate
--              error if not satisfied
--
-- Parameters:  cg$rec Record of row to be checked
--------------------------------------------------------------------------------
PROCEDURE validate_foreign_keys_ins(cg$rec IN cg$row_type) IS
    fk_check INTEGER;
BEGIN
NULL;
END;

PROCEDURE validate_foreign_keys_upd( cg$rec IN cg$row_type,
                                     cg$old_rec IN cg$row_type,
                                     cg$ind IN cg$ind_type) IS
    fk_check INTEGER;
BEGIN
NULL;
END;

PROCEDURE validate_foreign_keys_del(cg$rec IN cg$row_type) IS
    fk_check INTEGER;
BEGIN
NULL;
END;


--------------------------------------------------------------------------------
-- Name:        slct
--
-- Description: Selects into the given parameter all the attributes for the row
--              given by the primary key
--
-- Parameters:  cg$sel_rec  Record of row to be selected into using its PK
--------------------------------------------------------------------------------
PROCEDURE slct(cg$sel_rec IN OUT cg$row_type) IS

BEGIN

    IF cg$sel_rec.the_rowid is null THEN
       SELECT    RV_DOMAIN
       ,         RV_LOW_VALUE
       ,         RV_HIGH_VALUE
       ,         RV_ABBREVIATION
       ,         RV_MEANING
       , rowid
       INTO      cg$sel_rec.RV_DOMAIN
       ,         cg$sel_rec.RV_LOW_VALUE
       ,         cg$sel_rec.RV_HIGH_VALUE
       ,         cg$sel_rec.RV_ABBREVIATION
       ,         cg$sel_rec.RV_MEANING
       ,cg$sel_rec.the_rowid
       FROM   CG_REF_CODES
       WHERE        RV_DOMAIN = cg$sel_rec.RV_DOMAIN;
    ELSE
       SELECT    RV_DOMAIN
       ,         RV_LOW_VALUE
       ,         RV_HIGH_VALUE
       ,         RV_ABBREVIATION
       ,         RV_MEANING
       , rowid
       INTO      cg$sel_rec.RV_DOMAIN
       ,         cg$sel_rec.RV_LOW_VALUE
       ,         cg$sel_rec.RV_HIGH_VALUE
       ,         cg$sel_rec.RV_ABBREVIATION
       ,         cg$sel_rec.RV_MEANING
       ,cg$sel_rec.the_rowid
       FROM   CG_REF_CODES
       WHERE  rowid = cg$sel_rec.the_rowid;
    END IF;

EXCEPTION WHEN OTHERS THEN
    cg$errors.push(SQLERRM,
                   'E',
                   'ORA',
                   SQLCODE,
                   'cg$CG_REF_CODES.slct.others');
    cg$errors.raise_failure;

END slct;


--------------------------------------------------------------------------------
-- Name:        cascade_update
--
-- Description: Updates all child tables affected by a change to CG_REF_CODES
--
-- Parameters:  cg$rec     Record of CG_REF_CODES current values
--              cg$old_rec Record of CG_REF_CODES previous values
--------------------------------------------------------------------------------
PROCEDURE cascade_update(cg$new_rec IN OUT cg$row_type,
                         cg$old_rec IN     cg$row_type) IS
BEGIN
    NULL;
END cascade_update;



--------------------------------------------------------------------------------
-- Name:        cascade_delete
--
-- Description: Delete all child tables affected by a delete to CG_REF_CODES
--
-- Parameters:  cg$rec     Record of CG_REF_CODES current values
--------------------------------------------------------------------------------
PROCEDURE cascade_delete(cg$old_rec IN OUT cg$row_type)
IS
BEGIN
    NULL;
END cascade_delete;

--------------------------------------------------------------------------------
-- Name:        domain_cascade_delete
--
-- Description: Delete all child tables affected by a delete to CG_REF_CODES
--
-- Parameters:  cg$rec     Record of CG_REF_CODES current values
--------------------------------------------------------------------------------
PROCEDURE domain_cascade_delete(cg$old_rec IN OUT cg$row_type)
IS
BEGIN
    NULL;
END domain_cascade_delete;


--------------------------------------------------------------------------------
-- Name:        validate_arc
--
-- Description: Checks for adherence to arc relationship
--
-- Parameters:  cg$rec     Record of CG_REF_CODES current values
--------------------------------------------------------------------------------
PROCEDURE validate_arc(cg$rec IN OUT cg$row_type) IS
i NUMBER;
BEGIN
    NULL;
END validate_arc;


--------------------------------------------------------------------------------
-- Name:        validate_domain
--
-- Description: Checks against reference table for values lying in a domain
--
-- Parameters:  cg$rec     Record of CG_REF_CODES current values
--------------------------------------------------------------------------------
PROCEDURE validate_domain(cg$rec IN OUT cg$row_type) IS
dummy NUMBER;
no_tabview EXCEPTION;
PRAGMA EXCEPTION_INIT(no_tabview, -942);
BEGIN

    NULL;

EXCEPTION
    WHEN cg$errors.cg$error THEN
        cg$errors.raise_failure;
    WHEN no_tabview THEN
        cg$errors.push(cg$errors.MsgGetText(cg$errors.API_RV_TAB_NOT_FOUND, cg$errors.APIMSG_RV_TAB_NOT_FOUND, 'CG_REF_CODES','CG_REF_CODES'),
                       'E',
                       'API',
                       cg$errors.API_RV_TAB_NOT_FOUND,
                       'cg$CG_REF_CODES.v_domain.no_reftable_found');
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$CG_REF_CODES.v_domain.others');
        cg$errors.raise_failure;
END validate_domain;


--------------------------------------------------------------------------------
-- Name:        err_msg
--
-- Description: Pushes onto stack appropriate user defined error message
--              depending on the rule violated
--
-- Parameters:  msg     Oracle error message
--              type    Type of violation e.g. check_constraint: ERR_CHECK_CON
--              loc     Place where this procedure was called for error
--                      trapping
--------------------------------------------------------------------------------
PROCEDURE err_msg(msg   IN VARCHAR2,
                  type  IN INTEGER,
                  loc   IN VARCHAR2 DEFAULT '') IS
con_name VARCHAR2(240);
BEGIN
    con_name := cg$errors.parse_constraint(msg, type);
    IF (con_name = 'CRE_PK') THEN
        cg$errors.push(nvl(CRE_PK
                  ,cg$errors.MsgGetText(cg$errors.API_PK_CON_VIOLATED
					                 ,cg$errors.APIMSG_PK_VIOLAT
                                     ,'CRE_PK'
                                     ,'CG_REF_CODES')),
                       'E',
                       'API',
                       cg$errors.API_PK_CON_VIOLATED,
                       loc);

    ELSE
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       loc);
    END IF;
END err_msg;




--------------------------------------------------------------------------------
-- Name:        doLobs
--
-- Description: This function is updating lob columns
--
-- Parameters:  cg$rec  Record of row to be inserted
--              cg$ind  Record of columns specifically set
--------------------------------------------------------------------------------
PROCEDURE doLobs(cg$rec IN OUT cg$row_type,
                 cg$ind IN OUT cg$ind_type) IS
BEGIN
   NULL;
END doLobs;


--------------------------------------------------------------------------------
-- Name:        ins
--
-- Description: API insert procedure
--
-- Parameters:  cg$rec  Record of row to be inserted
--              cg$ind  Record of columns specifically set
--              do_ins  Whether we want the actual INSERT to occur
--------------------------------------------------------------------------------
PROCEDURE ins(cg$rec IN OUT cg$row_type,
              cg$ind IN OUT cg$ind_type,
              do_ins IN BOOLEAN DEFAULT TRUE) IS
cg$tmp_rec cg$row_type;

--  Constant default values


BEGIN
--  Application_logic Pre-Insert <<Start>>
--  Application_logic Pre-Insert << End >>

--  Defaulted

--  Auto-generated and uppercased columns

    up_autogen_columns(cg$rec, cg$ind, 'INS', do_ins);

    called_from_package := TRUE;

    IF (do_ins) THEN
        validate_foreign_keys_ins(cg$rec);
        validate_arc(cg$rec);
        validate_domain(cg$rec);

        INSERT INTO CG_REF_CODES
            (RV_DOMAIN
            ,RV_LOW_VALUE
            ,RV_HIGH_VALUE
            ,RV_ABBREVIATION
            ,RV_MEANING)
        VALUES
            (cg$rec.RV_DOMAIN
            ,cg$rec.RV_LOW_VALUE
            ,cg$rec.RV_HIGH_VALUE
            ,cg$rec.RV_ABBREVIATION
            ,cg$rec.RV_MEANING
);
        doLobs(cg$rec, cg$ind);
        slct(cg$rec);

        upd_oper_denorm2(cg$rec, cg$tmp_rec, cg$ind, 'INS');
    END IF;

    called_from_package := FALSE;


    IF NOT (do_ins) THEN
        cg$table(idx).RV_DOMAIN := cg$rec.RV_DOMAIN;
        cg$tableind(idx).RV_DOMAIN := cg$ind.RV_DOMAIN;

        cg$table(idx).RV_LOW_VALUE := cg$rec.RV_LOW_VALUE;
        cg$tableind(idx).RV_LOW_VALUE := cg$ind.RV_LOW_VALUE;

        cg$table(idx).RV_HIGH_VALUE := cg$rec.RV_HIGH_VALUE;
        cg$tableind(idx).RV_HIGH_VALUE := cg$ind.RV_HIGH_VALUE;

        cg$table(idx).RV_ABBREVIATION := cg$rec.RV_ABBREVIATION;
        cg$tableind(idx).RV_ABBREVIATION := cg$ind.RV_ABBREVIATION;

        cg$table(idx).RV_MEANING := cg$rec.RV_MEANING;
        cg$tableind(idx).RV_MEANING := cg$ind.RV_MEANING;

        idx := idx + 1;
    END IF;

--  Application logic Post-Insert <<Start>>
--  Application logic Post-Insert << End >>

EXCEPTION
    WHEN cg$errors.cg$error THEN
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.mandatory_missing THEN
        validate_mandatory(cg$rec, 'cg$CG_REF_CODES.ins.mandatory_missing');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.check_violation THEN
        err_msg(SQLERRM, cg$errors.ERR_CHECK_CON, 'cg$CG_REF_CODES.ins.check_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.fk_violation THEN
        err_msg(SQLERRM, cg$errors.ERR_FOREIGN_KEY, 'cg$CG_REF_CODES.ins.fk_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.uk_violation THEN
        err_msg(SQLERRM, cg$errors.ERR_UNIQUE_KEY, 'cg$CG_REF_CODES.ins.uk_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$CG_REF_CODES.ins.others');
        called_from_package := FALSE;
        cg$errors.raise_failure;
END ins;


--------------------------------------------------------------------------------
-- Name:        upd
--
-- Description: API update procedure
--
-- Parameters:  cg$rec  Record of row to be updated
--              cg$ind  Record of columns specifically set
--              do_upd  Whether we want the actual UPDATE to occur
--------------------------------------------------------------------------------
PROCEDURE upd(cg$rec IN OUT cg$row_type,
              cg$ind IN OUT cg$ind_type,
              do_upd IN BOOLEAN DEFAULT TRUE) IS
cg$upd_rec cg$row_type;
cg$old_rec cg$row_type;
RECORD_LOGGED BOOLEAN := FALSE;

BEGIN
--  Application_logic Pre-Update <<Start>>
--  Application_logic Pre-Update << End >>

    cg$upd_rec.RV_DOMAIN := cg$rec.RV_DOMAIN;
    cg$old_rec.RV_DOMAIN := cg$rec.RV_DOMAIN;

    cg$upd_rec.the_rowid := cg$rec.the_rowid;
    cg$old_rec.the_rowid := cg$rec.the_rowid;

    IF (do_upd) THEN
        slct(cg$upd_rec);

        IF NOT (cg$ind.RV_DOMAIN) THEN
            cg$rec.RV_DOMAIN := cg$upd_rec.RV_DOMAIN;
        END IF;
        IF NOT (cg$ind.RV_LOW_VALUE) THEN
            cg$rec.RV_LOW_VALUE := cg$upd_rec.RV_LOW_VALUE;
        END IF;
        IF NOT (cg$ind.RV_HIGH_VALUE) THEN
            cg$rec.RV_HIGH_VALUE := cg$upd_rec.RV_HIGH_VALUE;
        END IF;
        IF NOT (cg$ind.RV_ABBREVIATION) THEN
            cg$rec.RV_ABBREVIATION := cg$upd_rec.RV_ABBREVIATION;
        END IF;
        IF NOT (cg$ind.RV_MEANING) THEN
            cg$rec.RV_MEANING := cg$upd_rec.RV_MEANING;
        END IF;
    ELSE
	   -- Perform checks if called from a trigger
	   -- Indicators are only set on changed values
	   null;


    END IF;

--  Auto-generated and uppercased columns

    up_autogen_columns(cg$rec, cg$ind, 'UPD', do_upd);

--  Now do update if updateable columns exist
    IF (do_upd) THEN
        DECLARE
            old_called BOOLEAN;
        BEGIN
            old_called := called_from_package;
            called_from_package := TRUE;

            validate_foreign_keys_upd(cg$rec, cg$old_rec, cg$ind);
            validate_arc(cg$rec);
            validate_domain(cg$rec);

            slct(cg$old_rec);

            IF cg$rec.the_rowid is null THEN
            UPDATE CG_REF_CODES
            SET
              RV_LOW_VALUE = cg$rec.RV_LOW_VALUE
              ,RV_HIGH_VALUE = cg$rec.RV_HIGH_VALUE
              ,RV_ABBREVIATION = cg$rec.RV_ABBREVIATION
              ,RV_MEANING = cg$rec.RV_MEANING
        WHERE  RV_DOMAIN = cg$rec.RV_DOMAIN;
               null;
            ELSE
            UPDATE CG_REF_CODES
            SET
              RV_LOW_VALUE = cg$rec.RV_LOW_VALUE
              ,RV_HIGH_VALUE = cg$rec.RV_HIGH_VALUE
              ,RV_ABBREVIATION = cg$rec.RV_ABBREVIATION
              ,RV_MEANING = cg$rec.RV_MEANING
        WHERE rowid = cg$rec.the_rowid;

               null;
            END IF;

            slct(cg$rec);

            upd_denorm2(cg$rec, cg$ind);
            upd_oper_denorm2(cg$rec, cg$old_rec, cg$ind, 'UPD');
            cascade_update(cg$rec, cg$old_rec);
            called_from_package := old_called;
        END;
    END IF;



    IF NOT (do_upd) THEN
        cg$table(idx).RV_DOMAIN := cg$rec.RV_DOMAIN;
        cg$tableind(idx).RV_DOMAIN := cg$ind.RV_DOMAIN;
        cg$table(idx).RV_LOW_VALUE := cg$rec.RV_LOW_VALUE;
        cg$tableind(idx).RV_LOW_VALUE := cg$ind.RV_LOW_VALUE;
        cg$table(idx).RV_HIGH_VALUE := cg$rec.RV_HIGH_VALUE;
        cg$tableind(idx).RV_HIGH_VALUE := cg$ind.RV_HIGH_VALUE;
        cg$table(idx).RV_ABBREVIATION := cg$rec.RV_ABBREVIATION;
        cg$tableind(idx).RV_ABBREVIATION := cg$ind.RV_ABBREVIATION;
        cg$table(idx).RV_MEANING := cg$rec.RV_MEANING;
        cg$tableind(idx).RV_MEANING := cg$ind.RV_MEANING;
        idx := idx + 1;
    END IF;

--  Application_logic Post-Update <<Start>>
--  Application_logic Post-Update << End >>

EXCEPTION
    WHEN cg$errors.cg$error THEN
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.upd_mandatory_null THEN
        validate_mandatory(cg$rec, 'cg$CG_REF_CODES.upd.upd_mandatory_null');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.check_violation THEN
        err_msg(SQLERRM, cg$errors.ERR_CHECK_CON, 'cg$CG_REF_CODES.upd.check_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.fk_violation THEN
        err_msg(SQLERRM, cg$errors.ERR_FOREIGN_KEY, 'cg$CG_REF_CODES.upd.fk_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.uk_violation THEN
        err_msg(SQLERRM, cg$errors.ERR_UNIQUE_KEY, 'cg$CG_REF_CODES.upd.uk_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$CG_REF_CODES.upd.others');
        called_from_package := FALSE;
        cg$errors.raise_failure;
END upd;


--------------------------------------------------------------------------------
-- Name:        upd_denorm
--
-- Description: API procedure for simple denormalization
--
-- Parameters:  cg$rec  Record of row to be updated
--              cg$ind  Record of columns specifically set
--              do_upd  Whether we want the actual UPDATE to occur
--------------------------------------------------------------------------------
PROCEDURE upd_denorm2( cg$rec IN cg$row_type,
                       cg$ind IN cg$ind_type
					      )
IS
BEGIN

NULL;
END upd_denorm2;


--------------------------------------------------------------------------------
-- Name:        upd_oper_denorm
--
-- Description: API procedure for operation denormalization
--
-- Parameters:  cg$rec  Record of row to be updated
--              cg$ind  Record of columns specifically set
--              do_upd  Whether we want the actual UPDATE to occur
--------------------------------------------------------------------------------
PROCEDURE upd_oper_denorm2( cg$rec IN cg$row_type,
                            cg$old_rec IN cg$row_type,
                            cg$ind IN cg$ind_type,
                            operation IN VARCHAR2 DEFAULT 'UPD'
					           )
IS
BEGIN





NULL;
END upd_oper_denorm2;

--------------------------------------------------------------------------------
-- Name:        del
--
-- Description: API delete procedure
--
-- Parameters:  cg$pk  Primary key record of row to be deleted
--------------------------------------------------------------------------------
PROCEDURE del(cg$pk IN cg$pk_type,
              do_del IN BOOLEAN DEFAULT TRUE) IS
BEGIN
--  Application_logic Pre-Delete <<Start>>
--  Application_logic Pre-Delete << End >>

--  Delete the record

    called_from_package := TRUE;

    IF (do_del) THEN
        DECLARE
           cg$rec cg$row_type;
           cg$old_rec cg$row_type;
           cg$ind cg$ind_type;
        BEGIN
           cg$rec.RV_DOMAIN := cg$pk.RV_DOMAIN;
           slct(cg$rec);

           validate_foreign_keys_del(cg$rec);
           domain_cascade_delete(cg$rec);

           IF cg$pk.the_rowid is null THEN
              DELETE CG_REF_CODES
              WHERE                    RV_DOMAIN = cg$pk.RV_DOMAIN;
           ELSE
              DELETE CG_REF_CODES
              WHERE  rowid = cg$pk.the_rowid;
           END IF;

           upd_oper_denorm2(cg$rec, cg$old_rec, cg$ind, 'DEL');
           cascade_delete(cg$rec);
        END;
    END IF;

    called_from_package := FALSE;


--  Application_logic Post-Delete <<Start>>
--  Application_logic Post-Delete << End >>

EXCEPTION
    WHEN cg$errors.cg$error THEN
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN cg$errors.delete_restrict THEN
        err_msg(SQLERRM, cg$errors.ERR_DELETE_RESTRICT, 'cg$CG_REF_CODES.del.delete_restrict');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN no_data_found THEN
        cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_DEL, cg$errors.ROW_DEL),
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$CG_REF_CODES.del.no_data_found');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$CG_REF_CODES.del.others');
        called_from_package := FALSE;
        cg$errors.raise_failure;
END del;


--------------------------------------------------------------------------------
-- Name:        lck
--
-- Description: API lock procedure
--
-- Parameters:  cg$old_rec  Calling apps view of record of row to be locked
--              cg$old_ind  Record of columns to raise error if modified
--              nowait_flag TRUE lock with NOWAIT, FALSE don't fail if busy
--------------------------------------------------------------------------------
PROCEDURE lck(cg$old_rec IN cg$row_type,
              cg$old_ind IN cg$ind_type,
              nowait_flag IN BOOLEAN DEFAULT TRUE) IS
cg$tmp_rec cg$row_type;
any_modified BOOLEAN := FALSE;

BEGIN
--  Application_logic Pre-Lock <<Start>>
--  Application_logic Pre-Lock << End >>

--  Do the row lock

    BEGIN
        IF (nowait_flag) THEN
            IF cg$old_rec.the_rowid is null THEN
               SELECT       RV_DOMAIN
               ,            RV_LOW_VALUE
               ,            RV_HIGH_VALUE
               ,            RV_ABBREVIATION
               ,            RV_MEANING
               INTO         cg$tmp_rec.RV_DOMAIN
               ,            cg$tmp_rec.RV_LOW_VALUE
               ,            cg$tmp_rec.RV_HIGH_VALUE
               ,            cg$tmp_rec.RV_ABBREVIATION
               ,            cg$tmp_rec.RV_MEANING
               FROM      CG_REF_CODES
               WHERE              RV_DOMAIN = cg$old_rec.RV_DOMAIN
               FOR UPDATE NOWAIT;
            ELSE
               SELECT       RV_DOMAIN
               ,            RV_LOW_VALUE
               ,            RV_HIGH_VALUE
               ,            RV_ABBREVIATION
               ,            RV_MEANING
               INTO         cg$tmp_rec.RV_DOMAIN
               ,            cg$tmp_rec.RV_LOW_VALUE
               ,            cg$tmp_rec.RV_HIGH_VALUE
               ,            cg$tmp_rec.RV_ABBREVIATION
               ,            cg$tmp_rec.RV_MEANING
               FROM      CG_REF_CODES
               WHERE rowid = cg$old_rec.the_rowid
               FOR UPDATE NOWAIT;
            END IF;
        ELSE
            IF cg$old_rec.the_rowid is null THEN
               SELECT       RV_DOMAIN
               ,            RV_LOW_VALUE
               ,            RV_HIGH_VALUE
               ,            RV_ABBREVIATION
               ,            RV_MEANING
               INTO         cg$tmp_rec.RV_DOMAIN
               ,            cg$tmp_rec.RV_LOW_VALUE
               ,            cg$tmp_rec.RV_HIGH_VALUE
               ,            cg$tmp_rec.RV_ABBREVIATION
               ,            cg$tmp_rec.RV_MEANING
               FROM      CG_REF_CODES
               WHERE              RV_DOMAIN = cg$old_rec.RV_DOMAIN
               FOR UPDATE;
            ELSE
               SELECT       RV_DOMAIN
               ,            RV_LOW_VALUE
               ,            RV_HIGH_VALUE
               ,            RV_ABBREVIATION
               ,            RV_MEANING
               INTO         cg$tmp_rec.RV_DOMAIN
               ,            cg$tmp_rec.RV_LOW_VALUE
               ,            cg$tmp_rec.RV_HIGH_VALUE
               ,            cg$tmp_rec.RV_ABBREVIATION
               ,            cg$tmp_rec.RV_MEANING
               FROM      CG_REF_CODES
               WHERE rowid = cg$old_rec.the_rowid
               FOR UPDATE;
            END IF;
        END IF;

    EXCEPTION
        WHEN cg$errors.cg$error THEN
            cg$errors.raise_failure;
        WHEN cg$errors.resource_busy THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_LCK, cg$errors.ROW_LCK),
                           'E',
                           'ORA',
                           SQLCODE,
                           'cg$CG_REF_CODES.lck.resource_busy');
            cg$errors.raise_failure;
        WHEN no_data_found THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_DEL, cg$errors.ROW_DEL),
                           'E',
                           'ORA',
                           SQLCODE,
                           'cg$CG_REF_CODES.lck.no_data_found');
            cg$errors.raise_failure;
        WHEN OTHERS THEN
            cg$errors.push(SQLERRM,
                           'E',
                           'ORA',
                           SQLCODE,
                           'cg$CG_REF_CODES.lck.others');
            cg$errors.raise_failure;
    END;

-- Optional Columns

    IF (cg$old_ind.RV_HIGH_VALUE) THEN
        IF (cg$tmp_rec.RV_HIGH_VALUE IS NOT NULL
        AND cg$old_rec.RV_HIGH_VALUE IS NOT NULL) THEN
            IF (cg$tmp_rec.RV_HIGH_VALUE != cg$old_rec.RV_HIGH_VALUE) THEN
                cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P30RV_HIGH_VALUE
                    ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
                any_modified := TRUE;
            END IF;
        ELSIF (cg$tmp_rec.RV_HIGH_VALUE IS NOT NULL
        OR cg$old_rec.RV_HIGH_VALUE IS NOT NULL) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P30RV_HIGH_VALUE
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
            any_modified := TRUE;
        END IF;
    END IF;
    IF (cg$old_ind.RV_ABBREVIATION) THEN
        IF (cg$tmp_rec.RV_ABBREVIATION IS NOT NULL
        AND cg$old_rec.RV_ABBREVIATION IS NOT NULL) THEN
            IF (cg$tmp_rec.RV_ABBREVIATION != cg$old_rec.RV_ABBREVIATION) THEN
                cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P40RV_ABBREVIATION
                    ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
                any_modified := TRUE;
            END IF;
        ELSIF (cg$tmp_rec.RV_ABBREVIATION IS NOT NULL
        OR cg$old_rec.RV_ABBREVIATION IS NOT NULL) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P40RV_ABBREVIATION
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
            any_modified := TRUE;
        END IF;
    END IF;
    IF (cg$old_ind.RV_MEANING) THEN
        IF (cg$tmp_rec.RV_MEANING IS NOT NULL
        AND cg$old_rec.RV_MEANING IS NOT NULL) THEN
            IF (cg$tmp_rec.RV_MEANING != cg$old_rec.RV_MEANING) THEN
                cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P50RV_MEANING
                    ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
                any_modified := TRUE;
            END IF;
        ELSIF (cg$tmp_rec.RV_MEANING IS NOT NULL
        OR cg$old_rec.RV_MEANING IS NOT NULL) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P50RV_MEANING
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
            any_modified := TRUE;
        END IF;
    END IF;

-- Mandatory Columns

    IF (cg$old_ind.RV_DOMAIN) THEN
        IF (cg$tmp_rec.RV_DOMAIN != cg$old_rec.RV_DOMAIN) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P10RV_DOMAIN
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
            any_modified := TRUE;
        END IF;
    END IF;
    IF (cg$old_ind.RV_LOW_VALUE) THEN
        IF (cg$tmp_rec.RV_LOW_VALUE != cg$old_rec.RV_LOW_VALUE) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P20RV_LOW_VALUE
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$CG_REF_CODES.lck');
            any_modified := TRUE;
        END IF;
    END IF;

    IF (any_modified) THEN
        cg$errors.raise_failure;
    END IF;

--  Application_logic Post-Lock <<Start>>
--  Application_logic Post-Lock << End >>

END lck;


END cg$CG_REF_CODES;
/