SaveOrGetGLCategoryInfo

Save Or Get GL Category Info

Major Business Rule

Object Name: B3001060

Parent DLL: CMFGBASE

Location: Client/Server

Language: C

1.Functional Description

1.1Purpose
This business function will save the GL category code, Company and Branch being processed, along with
the amount.  If it is called more than once for a GL code, Branch, and Company  (meaning the Key
should already exist in the linked list) then it will accumulated the amount for that category by adding
the new amount to the already existing amount in the linked list.  If called in a second mode, then it
will retrieve each node from the linked list, and destroy the node as it is retrieved.  It will
return the information from the node.  When finished (meaning no more nodes exist)
it will send a flag back to the calling application.

1.2Setup Notes and Prerequisites

1.3Special Logic

2.Technical Specifications

2.4Processing

Linked list structure:
GLPT - this is the category code.  (it is the index to the node- meaning it is unique)
KCO - this is the key company (it is the index to the node - meaning it is unique)
MCU - this is the branch plant (it is the index to the node - meaning it is unique)
SV3E1 -this is the amount that exists for the category code.

1)   If the Mode is '0'

A)  If the Pointer to the link list is NULL Create the Link list and add a node
      with the information sent in:  GL category, Key Company and Branch, and amount.

B)  Else

If the node does not already exist for the GL category, Company and Branch passed in,
add a node to the end of the link list with the information sent in.

If the node already exists for the GL category, Company and Branch passed in, then add
the amount passed in, to the  amount that already exists in the node for that GL category
code.

2)  If the Mode is '1' send back the fields saved in the last linked list node, and delete that node.
     If the linked list is empty (or this is the last node in the linked list) send back DS End = '1'
else End = '0'.

3)  If the Mode is '2' destroy the entire linked list and set the Pointer to the Link list to NULL.

Data Structure

D3001060 - SaveOrGetGLCategoryInfo

Parameter Name Data Item Data Type Req/Opt I/O/Both

cMode MODE char NONE NONE

The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.

szGlCategoryCode GLPT char NONE NONE

A user defined code (41/9) that identifies the G/L offset that system uses when it searches for the account to which it posts the transaction. If
you do not want to specify a class code, you can enter **** (four asterisks) in this field. You can use automatic accounting instructions (AAIs) to
predefine classes of automatic offset accounts for the Inventory Management, Procurement, and Sales Order Management systems. You
might assign G/L class codes as follows:    IN20   Direct Ship Orders    IN60   Transfer Orders    IN80   Stock Sales The system can generate
accounting entries based upon a single transaction. For example, a single sale of a stock item can trigger the generation of accounting entries
similar to the following:         Sales-Stock (Debit) xxxxx.xx    A/R Stock Sales (Credit) xxxxx.xx    Posting Category: IN80             Stock Inventory
(Debit) xxxxx.xx    Stock COGS (Credit) xxxxx.xx The system uses the class code and the document type to find the AAI.

mnGLAmount SV3E1 MATH_NUMERIC NONE NONE

The previous serial number of a specific computer located at an installation. If the client is swapping an AS/400, then new WorldVision
licenses need to be issued under the new CPU number and the old CPU number should be entered in this field. In addition, the contract type
should be "SWP".

cEndFlag VC01A char NONE NONE

This is a generic field used for video constants display.

idPointerToLinkedList GENLNG ID NONE NONE

General purpose ID variable.

szCompanyKey KCO char NONE NONE

A number that, with the document number, document type and G/L date, uniquely identifies an original document, such as invoice, voucher,
or journal entry. If you use the Next Numbers by Company/Fiscal Year feature, the Automatic Next Numbers program (X0010) uses the
document company to retrieve the correct next number for that company. If two or more original documents have the same document number and
document type, you can use the document company to locate the desired document.

szCostCenter MCU char NONE 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.

Related Functions

None

Related Tables

None

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
cMode	MODE	char	NONE	NONE
The processing mode used in Purchase Order Consolidator to signify when specific orders are being processed.
szGlCategoryCode	GLPT	char	NONE	NONE
A user defined code (41/9) that identifies the G/L offset that system uses when it searches for the account to which it posts the transaction. If you do not want to specify a class code, you can enter **** (four asterisks) in this field. You can use automatic accounting instructions (AAIs) to predefine classes of automatic offset accounts for the Inventory Management, Procurement, and Sales Order Management systems. You might assign G/L class codes as follows: IN20 Direct Ship Orders IN60 Transfer Orders IN80 Stock Sales The system can generate accounting entries based upon a single transaction. For example, a single sale of a stock item can trigger the generation of accounting entries similar to the following: Sales-Stock (Debit) xxxxx.xx A/R Stock Sales (Credit) xxxxx.xx Posting Category: IN80 Stock Inventory (Debit) xxxxx.xx Stock COGS (Credit) xxxxx.xx The system uses the class code and the document type to find the AAI.
mnGLAmount	SV3E1	MATH_NUMERIC	NONE	NONE
The previous serial number of a specific computer located at an installation. If the client is swapping an AS/400, then new WorldVision licenses need to be issued under the new CPU number and the old CPU number should be entered in this field. In addition, the contract type should be "SWP".
cEndFlag	VC01A	char	NONE	NONE
This is a generic field used for video constants display.
idPointerToLinkedList	GENLNG	ID	NONE	NONE
General purpose ID variable.
szCompanyKey	KCO	char	NONE	NONE
A number that, with the document number, document type and G/L date, uniquely identifies an original document, such as invoice, voucher, or journal entry. If you use the Next Numbers by Company/Fiscal Year feature, the Automatic Next Numbers program (X0010) uses the document company to retrieve the correct next number for that company. If two or more original documents have the same document number and document type, you can use the document company to locate the desired document.
szCostCenter	MCU	char	NONE	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.