GLFG - NEWKEY
Define Seed for new Org Keys created with GLUTSUCC
The GL Copy Org. Keys (GLUTSUCC) utility is the preferred method to copy an Org Key, whether GL or JL Key. The utility looks for the GLFG/NEWKEY common code. If "SEED" is in the short description of this common code, then it uses the NU Subsystem Information (NUUPAUSS) page to create a seed for the new key; uses the GL subsystem with a KY prefix.
If the short description of the GLFG/NEWKEY common code is not "SEED," then GLUTSUCC looks through the Associated Numeric Values defined on GLFG/NEWKEY. Whenever the system finds an Associated Numeric Value that is not zero or blank, the system looks at the Associated Code of that level (for example, if Numeric Value 1 is non-zero, it looks at Associated Code 1). The system then takes the value in this Associated Code and finds out which key part it is (system looks in the GL General Information (GLUPGN) page at the key part description).
If it finds a key part by that name, it looks at the Associated Description at the same level.
If the first 4 characters of the upshifted Associated Description are "DESC," then it tries to look up the key part (using same ledger as the key and the key part it found in GLUPGN, and then the key's key part value), and if it finds it, it uses that key part's long description as part of the new key description.
If the first four characters of the upshifted Association Description are not "DESC," then it uses part of the key part as part of the key.
It uses the Associated Numeric Value to determine how much of the value to use as the new key value.
Code Category: GLFG
Code Value: NEWKEY
Short Description: SEED
Medium Description: Not required.
Long Description: Not required.
Associated Numeric Values
1: 2
2: 3
3: 2
4-5: Reserved for future use.
Associated Codes
1: FUND
2: LOC
3: DEPT
4-5: Reserved for future use.
Associated Descriptions
1-3: DESC
4-5: Reserved for future use.
Example:
For example, if the first associated numeric value is 2, the first associated code is FUND, and the first Associated Description is DESC, it would find out which key part is called FUND (if none of them are, it will give an error). Since the first Associated Description is DESC, it will look up the Fund code for the org. key (it will look up the glk_grp_mstr record for the Fund value this key has) and use the first 2 characters of that Fund's long description (it uses 2 because the first associated numeric value is 2) as part of the new key.
If the first Associated Description was not DESC, it would have taken the first 2 characters of the key's Fund code as part of the new key.
Detailed Example:
In this example, the original key is 123456, it has a FUND of 01 "General Fund" and a FUNC of 789 "Public Safety."
If the common code GLFG/NEWKEY has:
1st Assoc Numeric Value = 3, Code = FUND, Desc = "DESC"
2nd Assoc Numeric Value = 2, Code = FUNC, Desc = ""
Then the resulting key will look like GEN78.
If the common code GLFG/NEWKEY has:
1st Assoc Numeric Value = 2, Code = FUND, Desc = "none"
2nd Assoc Numeric Value = 6, Code = FUNC, Desc = "desc"
Then the resulting key will look like 01PUBLIC.