CREATE OR REPLACE PACKAGE efno_nominations IS
  --
  -- Author  :
  -- Created :
  -- Purpose :
  --
  g_package_name CONSTANT VARCHAR2(30) := 'efno_confirmations';
  g_header       CONSTANT VARCHAR2(160) := '$Header:   $';
  g_revision     CONSTANT VARCHAR2(160) := '$Revision: $';
  --
  /**
  -- PROCEDURE upd_nom_timestamp
  -- Autonomous Transaction
  -- Updates the nomination timestamp with the given date
  -- Used by the timestamping functions when a RETRY has been required
  --
  -- %param p_nomi_id Unique Identifier of the confirmation to be updated
  -- %param p_timestamp Successful timestamp information
  --
  */
  PROCEDURE upd_nomi_timestamp(p_nomi_id   IN nominations.nomi_id%TYPE,
                              p_timestamp IN DATE);
  --
  FUNCTION get_coca ( p_coca_id IN contract_categories.coca_id%TYPE
                    , p_column  IN VARCHAR2
                    ) RETURN VARCHAR;
  --
  FUNCTION get_conp ( p_conp_id cont_network_points.conp_id%TYPE
                    , p_column  IN VARCHAR2
                    ) RETURN VARCHAR;
  --
  nnpcv_tab efno_confirmations.nnpcv_tab;
  --
  /**
  -- FUNCTION evaluate_rule
  -- Validates a single EXISTING rule previously defined through the EFT Nominations Web interface
  -- and validates the data stored returning the coca and conp ids of the items checked in the rule
  -- (also works out if any conp/coca combinations are missing but shouldnt be a problem here...)
  --
  -- %param p_rule_id The Unique identifier of the ROW (rule_id) or SHEET (coru_id) rule
  -- %param p_rule_type ROW or SHEET
  -- %param p_nnpcv_tab OUT Table of conp and coca id's that this rule checks
  -- %param p_contract_id Unique identifier of a contract
  -- %param p_nomination_id Unique identifier of a Nomination
  --
  -- %return BOOLEAN TRUE indicating that the rule is valid syntactically and the data passed the test
  --                 FALSE indicates that processing is required to show those elements in error
  */
  FUNCTION evaluate_rule ( p_rule_id        IN     rules.rule_id%TYPE
                         , p_rule_type      IN     VARCHAR2
                         , p_nnpcv_tab         OUT efno_confirmations.nnpcv_tab
                         , p_contract_id    IN     contracts.cont_id%TYPE   DEFAULT 0
                         , p_nomination_id  IN     nominations.nomi_id%TYPE DEFAULT 0
                         , p_return_error      OUT VARCHAR2
                         ) RETURN BOOLEAN;
  --
  -- Rule Loops
  --
  FUNCTION rule_loops( p_nomi_id         IN     nominations.nomi_id%TYPE
                     , p_contract_id     IN     contracts.cont_id%TYPE
                     , p_return_error       OUT VARCHAR2
                     , p_nnpcv_tab          OUT efno_confirmations.nnpcv_tab
                     ) RETURN BOOLEAN;
  --
  /**
  -- FUNCTION about
  --
  -- %return A textual description of the version number and VSS header for this package
  */
  FUNCTION about RETURN VARCHAR2;
  --
END efno_nominations;
/