CREATE OR REPLACE PACKAGE BODY EFT_NOM.cg$LICENSING 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
    cg$rec.CREATED_BY := user;
    cg$rec.CREATED_ON := sysdate;
        NULL;
    ELSE
NULL;
    END IF;
    cg$rec.UPDATED_BY := user;
    cg$rec.UPDATED_ON := sysdate;
EXCEPTION
    WHEN no_data_found THEN
        NULL;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                      'E',
                      'ORA',
                      SQLCODE,
                      'cg$LICENSING.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.LICENSE_KEY IS NULL) THEN
        cg$errors.push(cg$errors.MsgGetText(cg$errors.API_MAND_COLUMN_ISNULL, cg$errors.VAL_MAND, P2LICENSE_KEY),
                       'E',
                       'API',
                       cg$errors.API_MAND_COLUMN_ISNULL,
                       loc);
    END IF;
    IF (cg$val_rec.CREATED_BY IS NULL) THEN
        cg$errors.push(cg$errors.MsgGetText(cg$errors.API_MAND_COLUMN_ISNULL, cg$errors.VAL_MAND, P3CREATED_BY),
                       'E',
                       'API',
                       cg$errors.API_MAND_COLUMN_ISNULL,
                       loc);
    END IF;
    IF (cg$val_rec.CREATED_ON IS NULL) THEN
        cg$errors.push(cg$errors.MsgGetText(cg$errors.API_MAND_COLUMN_ISNULL, cg$errors.VAL_MAND, P4CREATED_ON),
                       '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    LICENSE_KEY
       ,         CREATED_BY
       ,         CREATED_ON
       ,         UPDATED_BY
       ,         UPDATED_ON
       , rowid
       INTO      cg$sel_rec.LICENSE_KEY
       ,         cg$sel_rec.CREATED_BY
       ,         cg$sel_rec.CREATED_ON
       ,         cg$sel_rec.UPDATED_BY
       ,         cg$sel_rec.UPDATED_ON
       ,cg$sel_rec.the_rowid
       FROM   LICENSING
       WHERE        LICENSE_KEY = cg$sel_rec.LICENSE_KEY;
    ELSE
       SELECT    LICENSE_KEY
       ,         CREATED_BY
       ,         CREATED_ON
       ,         UPDATED_BY
       ,         UPDATED_ON
       , rowid
       INTO      cg$sel_rec.LICENSE_KEY
       ,         cg$sel_rec.CREATED_BY
       ,         cg$sel_rec.CREATED_ON
       ,         cg$sel_rec.UPDATED_BY
       ,         cg$sel_rec.UPDATED_ON
       ,cg$sel_rec.the_rowid
       FROM   LICENSING
       WHERE  rowid = cg$sel_rec.the_rowid;
    END IF;
EXCEPTION WHEN OTHERS THEN
    cg$errors.push(SQLERRM,
                   'E',
                   'ORA',
                   SQLCODE,
                   'cg$LICENSING.slct.others');
    cg$errors.raise_failure;
END slct;
--------------------------------------------------------------------------------
-- Name:        cascade_update
--
-- Description: Updates all child tables affected by a change to LICENSING
--
-- Parameters:  cg$rec     Record of LICENSING current values
--              cg$old_rec Record of LICENSING 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 LICENSING
--
-- Parameters:  cg$rec     Record of LICENSING 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 LICENSING
--
-- Parameters:  cg$rec     Record of LICENSING 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 LICENSING 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 LICENSING current values
--------------------------------------------------------------------------------
PROCEDURE validate_domain(cg$rec IN OUT cg$row_type,
                          cg$ind IN cg$ind_type DEFAULT cg$ind_true)
IS
  dummy NUMBER;
  found BOOLEAN;
  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','LICENSING'),
                       'E',
                       'API',
                       cg$errors.API_RV_TAB_NOT_FOUND,
                       'cg$LICENSING.v_domain.no_reftable_found');
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$LICENSING.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 = 'LNSG_PK') THEN
        cg$errors.push(nvl(LNSG_PK
                  ,cg$errors.MsgGetText(cg$errors.API_PK_CON_VIOLATED
					                 ,cg$errors.APIMSG_PK_VIOLAT
                                     ,'LNSG_PK'
                                     ,'LICENSING')),
                       '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 LICENSING
            (LICENSE_KEY
            ,CREATED_BY
            ,CREATED_ON
            ,UPDATED_BY
            ,UPDATED_ON)
        VALUES
            (cg$rec.LICENSE_KEY
            ,cg$rec.CREATED_BY
            ,cg$rec.CREATED_ON
            ,cg$rec.UPDATED_BY
            ,cg$rec.UPDATED_ON
);
        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;
--  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$LICENSING.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$LICENSING.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$LICENSING.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$LICENSING.ins.uk_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$LICENSING.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.LICENSE_KEY := cg$rec.LICENSE_KEY;
    cg$old_rec.LICENSE_KEY := cg$rec.LICENSE_KEY;
    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.LICENSE_KEY) THEN
            cg$rec.LICENSE_KEY := cg$upd_rec.LICENSE_KEY;
        END IF;
        IF NOT (cg$ind.CREATED_BY) THEN
            cg$rec.CREATED_BY := cg$upd_rec.CREATED_BY;
        END IF;
        IF NOT (cg$ind.CREATED_ON) THEN
            cg$rec.CREATED_ON := cg$upd_rec.CREATED_ON;
        END IF;
        IF NOT (cg$ind.UPDATED_BY) THEN
            cg$rec.UPDATED_BY := cg$upd_rec.UPDATED_BY;
        END IF;
        IF NOT (cg$ind.UPDATED_ON) THEN
            cg$rec.UPDATED_ON := cg$upd_rec.UPDATED_ON;
        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, cg$ind);
            slct(cg$old_rec);
            IF cg$rec.the_rowid is null THEN
            UPDATE LICENSING
            SET
              CREATED_BY = cg$rec.CREATED_BY
              ,CREATED_ON = cg$rec.CREATED_ON
              ,UPDATED_BY = cg$rec.UPDATED_BY
              ,UPDATED_ON = cg$rec.UPDATED_ON
        WHERE  LICENSE_KEY = cg$rec.LICENSE_KEY;
               null;
            ELSE
            UPDATE LICENSING
            SET
              CREATED_BY = cg$rec.CREATED_BY
              ,CREATED_ON = cg$rec.CREATED_ON
              ,UPDATED_BY = cg$rec.UPDATED_BY
              ,UPDATED_ON = cg$rec.UPDATED_ON
        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).LICENSE_KEY := cg$rec.LICENSE_KEY;
        cg$tableind(idx).LICENSE_KEY := cg$ind.LICENSE_KEY;
        cg$table(idx).CREATED_BY := cg$rec.CREATED_BY;
        cg$tableind(idx).CREATED_BY := cg$ind.CREATED_BY;
        cg$table(idx).CREATED_ON := cg$rec.CREATED_ON;
        cg$tableind(idx).CREATED_ON := cg$ind.CREATED_ON;
        cg$table(idx).UPDATED_BY := cg$rec.UPDATED_BY;
        cg$tableind(idx).UPDATED_BY := cg$ind.UPDATED_BY;
        cg$table(idx).UPDATED_ON := cg$rec.UPDATED_ON;
        cg$tableind(idx).UPDATED_ON := cg$ind.UPDATED_ON;
        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$LICENSING.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$LICENSING.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$LICENSING.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$LICENSING.upd.uk_violation');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$LICENSING.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.LICENSE_KEY := cg$pk.LICENSE_KEY;
           slct(cg$rec);
           validate_foreign_keys_del(cg$rec);
           domain_cascade_delete(cg$rec);
           IF cg$pk.the_rowid is null THEN
              DELETE LICENSING
              WHERE                    LICENSE_KEY = cg$pk.LICENSE_KEY;
           ELSE
              DELETE LICENSING
              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$LICENSING.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$LICENSING.del.no_data_found');
        called_from_package := FALSE;
        cg$errors.raise_failure;
    WHEN OTHERS THEN
        cg$errors.push(SQLERRM,
                       'E',
                       'ORA',
                       SQLCODE,
                       'cg$LICENSING.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       LICENSE_KEY
               ,            CREATED_BY
               ,            CREATED_ON
               ,            UPDATED_BY
               ,            UPDATED_ON
               INTO         cg$tmp_rec.LICENSE_KEY
               ,            cg$tmp_rec.CREATED_BY
               ,            cg$tmp_rec.CREATED_ON
               ,            cg$tmp_rec.UPDATED_BY
               ,            cg$tmp_rec.UPDATED_ON
               FROM      LICENSING
               WHERE              LICENSE_KEY = cg$old_rec.LICENSE_KEY
               FOR UPDATE NOWAIT;
            ELSE
               SELECT       LICENSE_KEY
               ,            CREATED_BY
               ,            CREATED_ON
               ,            UPDATED_BY
               ,            UPDATED_ON
               INTO         cg$tmp_rec.LICENSE_KEY
               ,            cg$tmp_rec.CREATED_BY
               ,            cg$tmp_rec.CREATED_ON
               ,            cg$tmp_rec.UPDATED_BY
               ,            cg$tmp_rec.UPDATED_ON
               FROM      LICENSING
               WHERE rowid = cg$old_rec.the_rowid
               FOR UPDATE NOWAIT;
            END IF;
        ELSE
            IF cg$old_rec.the_rowid is null THEN
               SELECT       LICENSE_KEY
               ,            CREATED_BY
               ,            CREATED_ON
               ,            UPDATED_BY
               ,            UPDATED_ON
               INTO         cg$tmp_rec.LICENSE_KEY
               ,            cg$tmp_rec.CREATED_BY
               ,            cg$tmp_rec.CREATED_ON
               ,            cg$tmp_rec.UPDATED_BY
               ,            cg$tmp_rec.UPDATED_ON
               FROM      LICENSING
               WHERE              LICENSE_KEY = cg$old_rec.LICENSE_KEY
               FOR UPDATE;
            ELSE
               SELECT       LICENSE_KEY
               ,            CREATED_BY
               ,            CREATED_ON
               ,            UPDATED_BY
               ,            UPDATED_ON
               INTO         cg$tmp_rec.LICENSE_KEY
               ,            cg$tmp_rec.CREATED_BY
               ,            cg$tmp_rec.CREATED_ON
               ,            cg$tmp_rec.UPDATED_BY
               ,            cg$tmp_rec.UPDATED_ON
               FROM      LICENSING
               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$LICENSING.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$LICENSING.lck.no_data_found');
            cg$errors.raise_failure;
        WHEN OTHERS THEN
            cg$errors.push(SQLERRM,
                           'E',
                           'ORA',
                           SQLCODE,
                           'cg$LICENSING.lck.others');
            cg$errors.raise_failure;
    END;
-- Optional Columns
    IF (cg$old_ind.UPDATED_BY) THEN
        IF (cg$tmp_rec.UPDATED_BY IS NOT NULL
        AND cg$old_rec.UPDATED_BY IS NOT NULL) THEN
            IF (cg$tmp_rec.UPDATED_BY != cg$old_rec.UPDATED_BY) THEN
                cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P5UPDATED_BY
                    ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$LICENSING.lck');
                any_modified := TRUE;
            END IF;
        ELSIF (cg$tmp_rec.UPDATED_BY IS NOT NULL
        OR cg$old_rec.UPDATED_BY IS NOT NULL) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P5UPDATED_BY
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$LICENSING.lck');
            any_modified := TRUE;
        END IF;
    END IF;
    IF (cg$old_ind.UPDATED_ON) THEN
        IF (cg$tmp_rec.UPDATED_ON IS NOT NULL
        AND cg$old_rec.UPDATED_ON IS NOT NULL) THEN
            IF (cg$tmp_rec.UPDATED_ON != cg$old_rec.UPDATED_ON) THEN
                cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P6UPDATED_ON
                    ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$LICENSING.lck');
                any_modified := TRUE;
            END IF;
        ELSIF (cg$tmp_rec.UPDATED_ON IS NOT NULL
        OR cg$old_rec.UPDATED_ON IS NOT NULL) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P6UPDATED_ON
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$LICENSING.lck');
            any_modified := TRUE;
        END IF;
    END IF;
-- Mandatory Columns
    IF (cg$old_ind.LICENSE_KEY) THEN
        IF (cg$tmp_rec.LICENSE_KEY != cg$old_rec.LICENSE_KEY) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P2LICENSE_KEY
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$LICENSING.lck');
            any_modified := TRUE;
        END IF;
    END IF;
    IF (cg$old_ind.CREATED_BY) THEN
        IF (cg$tmp_rec.CREATED_BY != cg$old_rec.CREATED_BY) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P3CREATED_BY
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$LICENSING.lck');
            any_modified := TRUE;
        END IF;
    END IF;
    IF (cg$old_ind.CREATED_ON) THEN
        IF (cg$tmp_rec.CREATED_ON != cg$old_rec.CREATED_ON) THEN
            cg$errors.push(cg$errors.MsgGetText(cg$errors.API_ROW_MOD, cg$errors.ROW_MOD, P4CREATED_ON
                ),'E', 'API', CG$ERRORS.API_MODIFIED, 'cg$LICENSING.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;
BEGIN
      cg$ind_true.LICENSE_KEY := TRUE;
      cg$ind_true.CREATED_BY := TRUE;
      cg$ind_true.CREATED_ON := TRUE;
      cg$ind_true.UPDATED_BY := TRUE;
      cg$ind_true.UPDATED_ON := TRUE;
END cg$LICENSING;
/