RetrieveCorrectCentury

Retrieve Correct Century

Minor Business Rule

Object Name: B0000154

Parent DLL: CALLBSFN

Location: Client/Server

Language: C

Functional Description

Purpose
This business function takes as input a fiscal year and returns the correct century for that year.
Also, it returns the century concatenated with the input year.

Setup Notes and Prerequisites
The business function determines the correct century to return by comparing the input year to the
CENTCHG data item default value. If the input year is greater than the CENTCHG value then the current
default century will be returned.  Otherwise, the current default century incremented by one will be
returned.

    PARAMETER        INPUT/OUTPUT   REQUIRED
1.  mnFiscalYear        Input         No
2.  mnCentury           Output        No
3.  mnCenturyYear       Output        No

(Note: If mnFiscalYear is left blank fiscal               year 00 will be used)

Examples:

1. CENTCHG      = 10  2. CENTCHG      = 10
   Default CTRY = 19     Default CTRY = 19
   mnFiscalYear = 97     mnFiscalYear = 07
   mnCentury    = 19     mnCentury    = 20
   mnCenturyYear= 1997   mnCenturyYear= 2007

3. CENTCHG      = 00  4. CENTCHG      = 00
   Default CTRY = 19     Default CTRY = 19
   mnFiscalYear = 03     mnFiscalYear = 00
   mnCentury    = 19     mnCentury    = 20
   mnCenturyYear= 1903   mnCenturyYear= 2000

Technical Specification
• Get the default value for the century (CTRY) data dictionary item.
• Get the default value for the century change (CENTCHG) data dictionary item (this is a fiscal year
value).
• If input fiscal year is greater than century change fiscal year
•

Century to return is the default value for the century data dictionary item.

• Else
•
Century to return is the default value for the century data dictionary item plus one.

• Concatenate the century to return and the fiscal year passed in as a parameter.
• Return century and century/fiscal year.

Data Structure

D0000154 - Retrieve Correct Century

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

mnFiscalYear FY MATH_NUMERIC NONE NONE

Special Input Expected
This input parameter receives the fiscal year for which the century is to be calculated.

Significant Data Values
If this parameter is left blank, the business function will calculate the century based on fiscal
year 00.
^

mnCentury CTRY MATH_NUMERIC NONE NONE

Special Output Returned
This output parameter returns the century that was calculated based on the fiscal year input.
^

mnCenturyYear CENTYR MATH_NUMERIC NONE NONE

Special Output Returned
This output parameter returns the calculated century concatenated with the specified fiscal year.

^

Related Functions

None

Related Tables

None

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnFiscalYear	FY	MATH_NUMERIC	NONE	NONE
Special Input Expected This input parameter receives the fiscal year for which the century is to be calculated. Significant Data Values If this parameter is left blank, the business function will calculate the century based on fiscal year 00. ^
mnCentury	CTRY	MATH_NUMERIC	NONE	NONE
Special Output Returned This output parameter returns the century that was calculated based on the fiscal year input. ^
mnCenturyYear	CENTYR	MATH_NUMERIC	NONE	NONE
Special Output Returned This output parameter returns the calculated century concatenated with the specified fiscal year. ^