CacheWorkCenterCosts

Cache Work Center Costs

Minor Business Rule

Object Name: B3104320

Parent DLL: CMFGBASE

Location: Client/Server

Language: C

Functional Description

Purpose
The purpose of this function is to perform all caching functionality for the Work Center Costs Cache.  The Work Center Costs Cache is used by the
Manufacturing Journal Entries UBE (R31802A) to cache costs associated with a work center.

Setup Notes and Prerequisites
The CacheWorkCenterCosts function must be called with cMode = 0 in order to create an instance of the cache before any other caching functionality
can be performed.  In addition, the cache must be called with cMode = 4 after all desired caching functionality has been performed in order to terminate
the cache.

Business Function Paramenters:
1.  szCacheJobNumber - A unique job number that can be combined with business function object name to create a unique cache name.
2.  cMode - Indicates the desired processing.
     Valid modes include:
0 = Create an instance of the cache
1 = Add a record to cache
2 = Read a record from cache
4 = Terminate the cache
3.  szCacheJobNumber - A unique job number that can be combined with business function object name to create a unique cache name.
4.  cSuppressErrorMessage - A value of '1' indicates that errors encountered during processing should not be set in the message center.
5.   idhCursor - A cursor pointing to a particular record in the cache.  The cursor is passed back from the function when the cReturnPointer
parameter is set to '1' and should be passed into the function for a sequential read of the cache.
6.   szParentCostType - A member of the cache and part of the cache key.
7.   szWorkCenter - A member of the cache and part of the cache key.
8.   szSubAssemblyCostType Date - A member of the cache.
9.  szErrorMessageID - The error message ID returned from the business function when an error occurs during processing.  This ID is
    returned regardless of the value in the cSuppressErrorMessage parameter.
10.   mnPlannedAmt - A member of the cache.
11.   mnActualAmt - A member of the cache.
12.   mnUnaccCompAmt- A member of the cache.
13.   mnUnaccCompUnits - A member of the cache.
14.   mnUnaccScrapAmt - A member of the cache.
15.   mnUnaccScrapUnits - A member of the cache.
16.   mnCompletedAmt - A member of the cache.
17.   mnCompletedUnits - A member of the cache.
18.   mnScrappedAmt - A member of the cache.
19.   mnScrappedUnits - A member of the cache.

Technical Specifications
Cache Structure:
szParentCostType
  szWorkCenter
  szCacheJobNumber
  szSubAssemblyCostType
  szErrorMessage
  mnPlannedAmt
  mnActualAmt
  mnUnaccCompAmt
  mnUnaccCompUnits
  mnUnaccScrapAmt
mnUnaccScrapUnits
  mnCompletedAmt
  mnCompletedUnits
mnScrappedAmt
  mnScrappedUnits
Cache Key:
                szParentCostType
szWorkCenter

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szCacheJobNumber	JOBN	char	OPT	NONE
The code that identifies the work station ID that executed a particular job.
cMode	EV01	char	OPT	NONE
An option that specifies the type of processing for an event.
cSuppressErrorMessage	EV01	char	OPT	NONE
An option that specifies the type of processing for an event.
idhCursor	GENLNG	ID	OPT	NONE
General purpose ID variable.
szParentCostType	COST	char	OPT	NONE
A code that designates each element of cost for an item. Examples of the cost object types are: o A1 Purchased raw material o B1 Direct labor routing rollup o B2 Setup labor routing rollup o C1 Variable burden routing rollup o C2 Fixed burden routing rollup o Dx Outside operation routing rollup o Xx Extra add-ons, such as electricity and water The optional add-on computations usually operate with the type Xx extra add-ons. This cost structure allows you to use an unlimited number of cost components to calculate alternative cost rollups. The system then associates these cost components with one of six user defined summary cost buckets.
szWorkCenter	MCU	char	OPT	NONE
An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units for which you have no authority.
szSubAssemblyCostType	COST	char	OPT	NONE
A code that designates each element of cost for an item. Examples of the cost object types are: o A1 Purchased raw material o B1 Direct labor routing rollup o B2 Setup labor routing rollup o C1 Variable burden routing rollup o C2 Fixed burden routing rollup o Dx Outside operation routing rollup o Xx Extra add-ons, such as electricity and water The optional add-on computations usually operate with the type Xx extra add-ons. This cost structure allows you to use an unlimited number of cost components to calculate alternative cost rollups. The system then associates these cost components with one of six user defined summary cost buckets.
szErrorMessage	DTAI	char	OPT	NONE
A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.
mnPlannedAmt	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnActualAmt	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnUnaccCompAmt	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnUnaccCompUnits	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnUnaccScrapAmt	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnUnaccScrapUnits	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnCompletedAmt	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnCompletedUnits	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnScrappedAmt	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.
mnScrappedUnits	MN29D9	MATH_NUMERIC	OPT	NONE
This is a generic field used as a work field in Everest.

CacheWorkCenterCosts