AutoCalcEmployeeCompetencies

Auto Calculate Employee Competencies

Minor Business Rule

Object Name: N0800212

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose
The purpose of this function is to automatically calculate employee competencies based on the Job
Competency level. Typically, the Job Competency Percent Achieved is calculated based on the Employee
Competency Levels. This function will reverse this process and back into the Employee Competency Levels
based on an entered Job Competency Percent Achieved.
Setup Notes and Prerequisites

Special Logic

Technical Specification

• Call Determine Auto Calc Ee Competencies Is Valid to perform error checking and to retrieve any
parameters that were not passed.
• Calculate the new percent achieved for the job competency code by dividing the level by the
required.
• Call Set Cache Sort Number, which will set the number to sort the cache by.
• For each option that is to be calculated, do the following:

• Call Sum Percent Achieved For Locked Employee Competencies to determine the existing percent
achieved for the locked employee competencies.  This function will also return the percent achieved
needed by the remaining employee competencies in the option to get the desired job competency level.
• If the percent achieved for the locked employee competencies is greater than the job competency
percent achieved, then no calculation can return the desired results.  Stop processing and return an
error message ID.
• Do while there are unlocked employee competencies to calculate:  call Calculate Next Unlocked
Employee Competency Level
• Determine the remaining job competency percent to achieve.

• Return the resulting cache to the calling program

Data Structure

D0800212 - Auto Calculate Employee Competencies

Cache Job Number  the unique number that identifies the Gap Analysis - B0800213 - cache that is
returned with the calculated employee competencies

Job Competency Code  this is the job competency for which the employee competencies are to be
calculated

Option Number  this is the option that the user requested to be calculated
Blank is allowed if the calculation is to be done for all options.

Performance Appraisal or Self Appraisal flag  this flag denotes to the program whether the
calculation is for the Performance Appraisal or the Employee Self appraisal levels.
1 = Performance Appraisal
2 = Self Appraisal

Type Review - The review type being calculated

Supervisor - The supervisor id that is part of the cache key

Address Number - The employee being appraised.  This is part of the cache key.

Date Effective - The effective date of the appraisal.  This is part of the cache key.

Organization Type - The organization type that was in effect when the gap for the performance
appraisal was created.

Employee Self Appraisal Level  if the program is to calculate for the employee self appraisal, this
is the level entered.
Required if the cPerfApprOrSelfApprFlag is '2'

Required Employee Self-Appraisal Level  if the program is to calculate for the employee self
appraisal, this is the required level for employee appraisals.  If this is left blank, the program will fetch
it from the appraisal header (F087711)

Performance Appraisal Level  if the program is to calculate for the performance appraisal, this is
the level entered
Required if the cPerfApprOrSelfApprFlag is '1'

Required Performance Appraisal Level  if the program is to calculate for the performance appraisal,
this is the required level.  If this is left blank, the program will fetch it from the appraisal header
(F087711)

Job Competency Percent Required  returns the new Job Competency Percent required calculated by the
program.

Suppress Error - If this is set to 1, then the errors will not be set on the fields.  If this is not
set to 1, then errors will be set on the fields in error.

Error Code Values:
0 = No Errors
1 = Job Number not passed
2 = Job Competency Code not passed
3 = Review Type not passed
4 = Supervisor not passed
5 = Address Number not passed
6 = Effective Date not passed
7 = Organization Type not passed
8 = Performance Appraisal Required level not passed
9 = Self Appraisal Required level not passed
10 = Performance Appraisal or Self Appraisal flag not valid value
11 = At least one employee competency scale is invalid

Cache Name - Convert Job Number from the B0800213 to a string and pass it in this parameter.  This is
a way to uniquely identify the cache using a string parameter.

Option Cache Name - This is the string cache name for the B0800222 - Option Cache

Overall Level - The overall level for the appraisal.  Input what the level is before the new job
competency level, the function will return the new overall level based on the calculated employee
competency levels.

Overall Level Description - Returns the associated description for the newly calculated overall
level.

Overall Percent Achieved - Returns the percent achieved for the newly calculated overall level.

Overall Required Level - The required overall level for this performance or self appraisal.  This is
necessary to calculate the overall percent achieved.

Overall Scale - The scale used to determine valid values for this overall performance or self
appraisal.

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnJobnumberA	JOBS	MATH_NUMERIC	REQ	INPUT
Cache Job Number the unique number that identifies the Gap Analysis - B0800213 - cache that is returned with the calculated employee competencies
szJobCompetencyCode	JCC	char	REQ	INPUT
Job Competency Code this is the job competency for which the employee competencies are to be calculated
szOptionNumber	COPTN	char	REQ	INPUT
Option Number this is the option that the user requested to be calculated Blank is allowed if the calculation is to be done for all options.
cPerfApprOrSelfApprFlag	EV01	char	REQ	INPUT
Performance Appraisal or Self Appraisal flag this flag denotes to the program whether the calculation is for the Performance Appraisal or the Employee Self appraisal levels. 1 = Performance Appraisal 2 = Self Appraisal
cTypeIncreaseNextRevw	TINC	char	REQ	INPUT
Type Review - The review type being calculated.
mnSupervisor	ANPA	MATH_NUMERIC	REQ	INPUT
Supervisor - The supervisor id that is part of the cache key
mnAddressNumber	AN8	MATH_NUMERIC	REQ	INPUT
Address Number - The employee being appraised. This is part of the cache key.
jdDateEffective	DEF	JDEDATE	REQ	INPUT
Date Effective - The effective date of the appraisal. This is part of the cache key.
szOrganizationType	OTPS	char	REQ	INPUT
Organization Type - The organization type that was in effect when the gap for the performance appraisal was created.
mnEmployeeSelfAppraisalLev	SAPL	MATH_NUMERIC	OPT	BOTH
Employee Self Appraisal Level if the program is to calculate for the employee self appraisal, this is the level entered. Required if the cPerfApprOrSelfApprFlag is '2'
mnRequiredSelfAppraisalLev	REQLE	MATH_NUMERIC	OPT	BOTH
Required Employee Self-Appraisal Level if the program is to calculate for the employee self appraisal, this is the required level for employee appraisals. If this is left blank, the program will fetch it from the appraisal header (F087711)
mnPerformanceAppraisalLevel	PAPL	MATH_NUMERIC	OPT	BOTH
Performance Appraisal Level if the program is to calculate for the performance appraisal, this is the level entered Required if the cPerfApprOrSelfApprFlag is '1'
mnRequiredPerformanceLevel	REQLS	MATH_NUMERIC	OPT	BOTH
Required Performance Appraisal Level if the program is to calculate for the performance appraisal, this is the required level. If this is left blank, the program will fetch it from the appraisal header (F087711)
mnJobCompetencyPercentAchi	JCPCTRQD	MATH_NUMERIC	OPT	BOTH
Job Competency Percent Required returns the new Job Competency Percent required calculated by the program.
cSuppressErrorMessage	SUPPS	char	OPT	INPUT
Suppress Error - If this is set to 1, then the errors will not be set on the fields. If this is not set to 1, then errors will be set on the fields in error.
cErrorCode	ERRC	char	OPT	OUTPUT
Error Code Values: 0 = No Errors 1 = Job Number not passed 2 = Job Competency Code not passed 3 = Review Type not passed 4 = Supervisor not passed 5 = Address Number not passed 6 = Effective Date not passed 7 = Organization Type not passed 8 = Performance Appraisal Required level not passed 9 = Self Appraisal Required level not passed 10 = Performance Appraisal or Self Appraisal flag not valid value 11 = At least one employee competency scale is invalid
szCacheName	PID	char	REQ	INPUT
Convert Job Number from the B0800213 to a string and pass it in this parameter. This is a way to uniquely identify the cache using a string parameter.
szOptionCacheName	PID	char	REQ	INPUT
Option Cache Name - This is the string cache name for the B0800222 - Option Cache
mnOverallLevel	CMPV	MATH_NUMERIC	REQ	BOTH
Overall Level - The overall level for the appraisal. Input what the level is before the new job competency level, the function will return the new overall level based on the calculated employee competency levels.
szOverallLevelDescription	CCMPDS	char	OPT	BOTH
Overall Level Description - Returns the associated description for the newly calculated overall level.
mnOverallPercentAchieved	JCPCTRQD	MATH_NUMERIC	REQ	BOTH
Overall Percent Achieved - Returns the percent achieved for the newly calculated overall level.
mnOverallRequiredLevel	REQL	MATH_NUMERIC	REQ	INPUT
Overall Required Level - The required overall level for this performance or self appraisal. This is necessary to calculate the overall percent achieved.
szOverallScale	SCLE	char	REQ	INPUT
Overall Scale - The scale used to determine valid values for this overall performance or self appraisal.

Related Functions

None

Related Tables

None

CalculateNextUnlockedEmployeeCom

Auto Calculate Employee Competencies

Minor Business Rule

Object Name: N0800212

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose

This function calculates a single employee competency level based on a job competency percent
achieved.  In order to do this, the typical calculation to get a job competency percent achieved must be
reversed.  That calculation is (if the Required is not 0):  divide the level by the required and then
multiply that result by the weight.  If the required is 0, then the job competency percent achieved is
calculated by multiplying the level by the weight and adding 100%

Setup Notes and Prerequisites

This is an internal subfunction of Auto Calculate Employee Competencies.  It is not intended to be
called directly.

Special Logic

Technical Specification

• First an inflation multiplier has to be calculated by dividing the total level weight by the level
weight remaining.
• Then calculate the competency level.  If the required is not 0, then the level is the remaining
percent to achieve multiplied by the required competency level multiplied by the inflation multiplier.  If
the required is 0, then the level is the remaining percent to achieve multiplied by the inflation
multiplier minus 1.
• Call Check Scale for Valid Value to determine if the calculated level is valid in the scale.  If it
is not, it will return the closest valid value.

Data Structure

D0800212C - Calculate Next Unlocked Employee Competency Level

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnJobCompetencyPercentAchieved	JCPCTRQD	MATH_NUMERIC	REQ	INPUT
Job Competency Percent Achieved - The percent achieved for the job competency. This is calculated by dividing the Job Competency Level by the Performance Appraisal Required Level.
mnTotalLevelWeightForEEComps	LVWT	MATH_NUMERIC	REQ	INPUT
Total Level Weight - Returns the total level weight for all the employee competencies in the selected option.
mnLevelWeightRemainingEEComps	LVWT	MATH_NUMERIC	REQ	INPUT
Level Weight Remaining - The total level weight minus the level weights of each locked employee competency.
mnRequiredCompetencyLevel	REQL	MATH_NUMERIC	REQ	INPUT
Required Level - This is the level required for the employee competency in order for the employee to be considered proficient in his or her current job.
szScale	SCLE	char	REQ	INPUT
Scale - The scale that this competency is rated on. Scales must be valid in the F05103 and have levels defined in the F05119.
mnCompetencyLevel	CMPV	MATH_NUMERIC	OPT	OUTPUT
Competency Level Output the calculated level that is valid for the scale.
cErrorCode	ERRC	char	OPT	OUTPUT
Error Code Values: 0 = No Errors 1 = Scale not found in scale master 2 = No levels found for this scale 3 = Level Weight Remaining equals 0
szCompetencyLevelDescription	CCMPDS	char	OPT	OUTPUT
Competency Level Description - Describes the competency level returned as it is defined in the F05119.
mnRemainingPercentToAchieve	JCPCTRQD	MATH_NUMERIC	REQ	INPUT
Remaining Percent To Achieve - the Job Competency Percent Achieved minus the percent achieved for all the locked and already calculated employee competencies.

Related Functions

None

Related Tables

None

CheckScaleForValidValue

Auto Calculate Employee Competencies

Minor Business Rule

Object Name: N0800212

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose
This function checks the scale to edit if the level entered is valid in that scale.  If it is valid,
the function will return the associated description.  If it is not valid, the function will determine
the closest valid level for the scale and return that level, the associated description, and a flag
which notifies the calling program which direction the function had to round to achieve that level Up
(U) or Down (D).

Setup Notes and Prerequisites

Special Logic

Technical Specification

Error Code Values:
0 = No Errors
1 = Scale not found in scale master
2 = No levels found for this scale
Get the high/low for the entire scale

Determine if the level passed in is a valid level for the scale.

If the level is valid, return the description and an N in the rounding flag.

This is not a valid level.  Get the records just above and below.  Determine which way to round that
is the closest value to the passed in value.  Return a U or D depending on the direction the function
had to round.

Data Structure

D0800212B - Check Scale For Valid Value

Scale - The scale that this competency is rated on.  Scales must be valid in the F05103 and have
levels defined in the F05119.

Competency Level  Input the calculated level.  Output the closest level that is valid in the scale.

Competency Level Description - Describes the competency level returned as it is defined in the
F05119.

Rounding Flag - This parameter recommends to the function whether it should round up (U) or down (D)
when looking for a level that is valid in the scale.  As an output parameter, this returns to the
calling program whether rounding was up (U), down (D), or not necessary (N).
U = Round Up
D = Round Down
N = Not Necessary

Error Code Values:
0 = No Errors
1 = Scale not found in scale master
2 = No levels found for this scale

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szScale	SCLE	char	REQ	INPUT
Scale - The scale that this competency is rated on. Scales must be valid in the F05103 and have levels defined in the F05119.
mnCompetencyLevel	CMPV	MATH_NUMERIC	REQ	BOTH
Competency Level Input the calculated level. Output the closest level that is valid in the scale.
szCompetencyLevelDescription	DL01	char	OPT	OUTPUT
Competency Level Description - Describes the competency level returned as it is defined in the F05119.
cRoundingFlag	EV01	char	OPT	BOTH
Rounding Flag. This parameter recommends to the function whether it should round up (U) or down (D) when looking for a level that is valid in the scale. As an output parameter, this returns to the calling program whether rounding was up (U), down (D), or not necessary (N). U = Round Up D = Round Down N = Not Necessary
cErrorCode	ERRC	char	OPT	OUTPUT
Error Code Values: 0 = No Errors 1 = Scale not found in scale master 2 = No levels found for this scale

Related Functions

None

Related Tables

None

DetermineAutoCalcEeCompetenciesI

Auto Calculate Employee Competencies

Minor Business Rule

Object Name: N0800212

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose
This function tests that the appropriate parameters are passed before auto calculating the employee
competencies.

Setup Notes and Prerequisites
This is an internal subfunction of Auto Calculate Employee Competencies. It is not intended to be
called directly.

Special Logic

Technical Specification

Error Code Values:
0 = No Errors
1 = Job Number not passed
2 = Job Competency Code not passed
3 = Review Type not passed
4 = Supervisor not passed
5 = Address Number not passed
6 = Effective Date not passed
7 = Organization Type not passed
8 = Performance Appraisal Required level not passed
9 = Self Appraisal Required level not passed
A = Performance Appraisal or Self Appraisal flag not valid value.

'b7If the Job Number, Job Competency Code, Review Type, Supervisor number, Employee
number, Effective Date, or Organizational Type is not passed in, return an error.
'b7If the Performance Appraisal or Self Appraisal flag is not 1 or 2, then set an error.
'b7If the Performance Appraisal or Self Appraisal flag is 1 and the Required Performance
Appraisal Level is not passed in, return an error.
'b7If the Performance Appraisal or Self Appraisal flag is 2 and the Required Self
Appraisal Level is not passed in, return an error.

Data Structure

D0800212D - Determine Auto Calc Ee Competencies Is Valid

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnJobnumberA	JOBS	MATH_NUMERIC	OPT	INPUT
Cache Job Number the unique number that identifies the B0800213 cache that is returned with the calculated employee competencies
szJobCompetencyCode	JCC	char	OPT	INPUT
Job Competency Code this is the job competency for which the employee competencies are to be calculated.
cPerfApprOrSelfApprFlag	EV01	char	OPT	INPUT
Performance Appraisal or Self Appraisal flag this flag denotes to the program whether the calculation is for the Performance Appraisal or the Employee Self appraisal levels. 1 = Performance Appraisal 2 = Self Appraisal
cTypeIncreaseNextRevw	TINC	char	OPT	INPUT
Type Review - The review type being calculated.
mnSupervisor	ANPA	MATH_NUMERIC	OPT	INPUT
Supervisor - The supervisor id, which is part of the cache key
mnAddressNumber	AN8	MATH_NUMERIC	OPT	INPUT
Address Number - The employee being appraised. This is part of the cache key.
jdDateEffective	DEF	JDEDATE	OPT	INPUT
Date Effective - The effective date of the appraisal. This is part of the cache key.
szOrganizationType	OTPS	char	OPT	INPUT
Organization Type - The organization type that was in effect when the gap for the performance appraisal was created.
mnRequiredSelfAppraisalLev	REQLE	MATH_NUMERIC	OPT	INPUT
Required Employee Self-Appraisal Level if the program is to calculate for the employee self appraisal, this is the required level for employee appraisals. If this is left blank, the program will fetch it from the appraisal header (F087711)
mnRequiredPerformanceLevel	REQLS	MATH_NUMERIC	OPT	INPUT
Required Performance Appraisal Level if the program is to calculate for the performance appraisal, this is the required level. If this is left blank, the program will fetch it from the appraisal header (F087711)
cSuppressErrorMessage	SUPPS	char	OPT	INPUT
Suppress Error - If this is set to 1, then the errors will not be set on the fields. If this is not set to 1, then errors will be set on the fields in error.
cErrorCode	ERRC	char	OPT	OUTPUT
Error Code Values: 0 = No Errors 1 = Job Number not passed 2 = Job Competency Code not passed 3 = Review Type not passed 4 = Supervisor not passed 5 = Address Number not passed 6 = Effective Date not passed 7 = Organization Type not passed 8 = Performance Appraisal Required level not passed 9 = Self Appraisal Required level not passed 10 = Performance Appraisal or Self Appraisal flag not valid value.
szCacheName	PID	char	OPT	INPUT
Cache Name - Convert the Job Number into a string and pass it in this parameter.

Related Functions

None

Related Tables

None

SetCacheSortNumber

Auto Calculate Employee Competencies

Minor Business Rule

Object Name: N0800212

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose
This function will set a number in the cache so that it can be sorted on that number.

The purpose of the sort number is to sort the cache in such a way as to allow the easiest
calculation.  If the Job Competency Percent Achieved is greater than 100% then the levels will mostly need to be
above the required.  To make the calculation easier, sort the cache so that the competencies with the
Required closest to the Max are calculated first, and the ones with the Required farthest from the Max
are calculated last.  This is because the competencies with a required close to the max are more
likely to need to be rounded down to fit into the scale.  If the competencies with more room are
calculated last, then they can make up for the rounding.
Do the opposite if the Job Competency % achieved is less than 100%.

Sorting the records in this way also eliminates the need to go through the cache more than once if
the first set of calculation were not close.

Setup Notes and Prerequisites
This is an internal subfunction of Auto Calculate Employee Competencies.  It is not intended to be
called directly.

Special Logic

Technical Specification

'b7For each employee competency for this option, calculate the sort number and update the
cache with that value.
'b7If the Job Competency Percent Achieved is greater than 100%, then the sort number is
calculated by subtracting the Required from the Scale High, and dividing that result by the Scale High
minus the Scale Low.
'b7If the Job Competency Percent Achieved is less than or equal to 100%, then the sort
number is calculated by subtracting the Scale Low from the Required, and dividing that result by the
Scale High minus the Scale Low.

Data Structure

D0800212E - Set Cache Sort Number

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnJobnumberA	JOBS	MATH_NUMERIC	REQ	INPUT
Cache Job Number the unique number that identifies the B0800213 cache that is returned with the calculated employee competencies.
mnAddressNumber	AN8	MATH_NUMERIC	REQ	INPUT
Address Number - The employee being appraised. This is part of the cache key.
szJobCompetencyCode	JCC	char	REQ	INPUT
Job Competency Code this is the job competency for which the employee competencies are to be calculated
szOptionNumber	COPTN	char	OPT	INPUT
Option Number - The option that needs its sort numbers populated.
mnJobCompetencyPercentAchi	JCPCTRQD	MATH_NUMERIC	REQ	INPUT
Job Competency Percent Achieved - The percent achieved for the job competency. This is calculated by dividing the Job Competency Level by the Performance Appraisal Required Level.
cErrorCode	ERRC	char	OPT	OUTPUT
Error Code Values 0 = No errors
szCacheName	PID	char	REQ	INPUT
Cache Name - Convert Job Number to a string and pass it in this parameter. This is a way to uniquely identify the cache using a string parameter.

Related Functions

None

Related Tables

None

SumPercentAcheivedForLockedEmplo

Auto Calculate Employee Competencies

Minor Business Rule

Object Name: N0800212

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose
This function will determine the job competency percent achieved for the already locked employee
competencies.
Setup Notes and Prerequisites
This is an internal subfunction of Auto Calculate Employee Competencies. It is not intended to be
called directly.

Special Logic

Technical Specification

• Go through the cache, fetching the locked employee competencies for the selected option.  For each
locked competency with the required not equal to 0, divide the level by the required and multiply by
the weight.  For a competency with the required equal to 0, then add 1 to the level and multiply by the
weight.  Add up all these values.
• For each unlocked competency, increment the Unlocked Competency counter.
• Subtract the resulting employee competency percent achieved from the job competency percent
achieved.
• Subtract the level weight of the locked records from the total weight of all the employee
competencies that make up the option.

Data Structure

D0800212A - Sum Percent Achieved For Locked Employee Competencies

Cache Job Number  the unique number that identifies the B0800213 cache that is returned with the
calculated employee competencies.

Job Competency Percent Achieved - The percent achieved for the job competency.  This is calculated by
dividing the Job Competency Level by the Performance Appraisal Required Level.

Number Unlocked Employee Competencies - This is the number of employee competencies in this option
that are not locked.

Option Number - the current option that needs the locked employee competencies calculated.

Address Number - the employee who is being appraised

Total Level Weight - Returns the total level weight for all the employee competencies in the selected
option.

Level Weight Remaining - The total level weight minus the level weights of each locked employee
competency.

Remaining Percent To Achieve - the Job Competency Percent Achieved minus the percent achieved for all
the locked employee competencies.

Cache Name - Convert Job Number to a string and pass it in this parameter.  This is a way to uniquely
identify the cache using a string parameter.

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnJobnumberA	JOBS	MATH_NUMERIC	REQ	INPUT
Cache Job Number the unique number that identifies the B0800213 cache that is returned with the calculated employee competencies.
mnJobCompetencyPercentAchi	JCPCTRQD	MATH_NUMERIC	REQ	INPUT
Job Competency Percent Achieved - The percent achieved for the job competency. This is calculated by dividing the Job Competency Level by the Performance Appraisal Required Level.
mnNumberUnlockedEmpComp	MATH01	MATH_NUMERIC	OPT	BOTH
Number Unlocked Employee Competencies - This is the number of employee competencies in this option that are not locked.
szJobCompetencyCode	JCC	char	REQ	INPUT
Job Competency Code - the JCC being automatically calculated.
szOptionNumber999	COPTN	char	REQ	INPUT
Option Number - the current option that needs the locked employee competencies calculated.
mnAddressNumber	AN8	MATH_NUMERIC	REQ	INPUT
Address Number - the employee who is being appraised
mnTotalLevelWeight	LVWT	MATH_NUMERIC	OPT	OUTPUT
Total Level Weight - Returns the total level weight for all the employee competencies in the selected option.
mnLevelWeightRemaining	LVWT	MATH_NUMERIC	OPT	BOTH
Level Weight Remaining - The total level weight minus the level weights of each locked employee competency.
mnRemainingPercentToAcheive	JCPCTRQD	MATH_NUMERIC	OPT	OUTPUT
Remaining Percent To Achieve - the Job Competency Percent Achieved minus the percent achieved for all the locked employee competencies.
szCacheName	PID	char	REQ	INPUT
Cache Name - Convert Job Number to a string and pass it in this parameter. This is a way to uniquely identify the cache using a string parameter.

Related Functions

None

Related Tables

None

rror - If this is set to 1, then the errors will not be set on the fields. If this is not
set to 1, then errors will be set on the fields in error.

cErrorCodeERRCcharOPTOUTPUT

Error Code Values:
0 = No Errors
1 = Job Number not passed
2 = Job Competency Code not passed
3 = Review Type not passed
4 = Supervisor not passed
5 = Address Number not passed
6 = Effective Date not passed
7 = Organization Type not passed
8 = Performance Appraisal Required level not passed
9 = Self Appraisal Required level not passed
10 = Performance Appraisal or Self Appraisal flag not valid value

11 = At least one employee competency scale is invalid

szCacheNamePIDcharREQINPUT

Convert Job Number from the B0800213 to a string and pass it in this parameter. This is a way to
uniquely identify the cache using a string parameter.

szOptionCacheNamePIDcharREQINPUT

Option Cache Name - This is the string cache name for the B0800222 - Option Cache

mnOverallLevelCMPVMATH_NUMERICREQBOTH

Overall Level - The overall level for the appraisal. Input what the level is before the new job
competency level, the function will return the new overall level based on the calculated employee
competency levels.

szOverallLevelDescriptionCCMPDScharOPTBOTH

Overall Level Description - Returns the associated description for the newly calculated overall
level.

mnOverallPercentAchievedJCPCTRQDMATH_NUMERICREQBOTH

Overall Percent Achieved - Returns the percent achieved for the newly calculated overall level.

mnOverallRequiredLevelREQLMATH_NUMERICREQINPUT

Overall Required Level - The required overall level for this performance or self appraisal. This is
necessary to calculate the overall percent achieved.

szOverallScaleSCLEcharREQINPUT

Overall Scale - The scale used to determine valid values for this overall performance or self
appraisal.