CalcContractCommitDateTime

Calculate Contract Commitment Date and Time

Minor Business Rule

Object Name: N1700800

Parent DLL: CCRIN

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose

This business function will take in the start date, start time, coverage type, response time, and 

coverage times for the coverage type and will return a commitment date and time.


1.2Setup Notes and Prerequisites

Coverage type, and service package must be set up for the contract.  The CSMS constants must also 

have a holiday day type code entered.


1.3Special Logic


Call ConvertTimeHHMMSSToDecimal for every starting and ending time received from the calling program. 

Sub-function ConvertTimeHHMMSSToDecimal is specific to CSMS and calculating the contractual response 

time.  Also sub-function SetContractCommitTime is specific to CSMS and calculating the contractual 

response time.  Neither of these sub-functions needs to be called outside of this Named E/R.  


The ConvertTimeMMHHSSToDecimal sub-function will take the time passed in HHMMSS and will convert it 

to the quarter hour just passed.  For example, if the time passed in is 12:38:45, this function will 

return 12.5000 as the decimal time.



Data Structure

D1700800 - Calculate Contract Commitment Date and Time

Parameter NameData ItemData TypeReq/OptI/O/Both
jdStartDateUPMJJDEDATEREQINPUT

The date that specifies the last update to the file record.

mnStartTimeUPMTMATH_NUMERICREQINPUT

The time that specifies when the program executed the last update to this record.

mnResponseTimeRSTMMATH_NUMERICREQINPUT

The guaranteed time during which service will be completed, as provided by a service contract, from the time that a provider logs a 
maintenance request or work order. This unit of time relates to the service type in the Service Contract Services table (F1725). Enter the response 
time in hours.

cDayTypeTD01charREQINPUT

A code to indicate the type of day. Valid values are:    W Work Day    E Weekend    H Holiday 

cHolidayDayTypeTD01charREQINPUT

A code to indicate the type of day. Valid values are:    W Work Day    E Weekend    H Holiday 

mnBeginningCoverageTime1BEG1MATH_NUMERICREQINPUT

The time of day that service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnBeginningCoverageTime2BEG2MATH_NUMERICREQINPUT

The time of day that service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnBeginningCoverageTime3BEG3MATH_NUMERICREQINPUT

The time of day that service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnBeginningCoverageTime4BEG4MATH_NUMERICREQINPUT

The time of day that service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnBeginningCoverageTime5BEG5MATH_NUMERICREQINPUT

The time of day service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Specify this value 
in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnBeginningCoverageTime6BEG6MATH_NUMERICREQINPUT

The time of day service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Enter this value in 
24 hour units. For example, enter 2:00:00 P.M. as14:00:00. Valid Times are 00:00:00 through 23:59:59.

mnBeginningCoverageTime7BEG7MATH_NUMERICREQINPUT

The time of day service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Enter the value in 
24 hour units. For example, enter 2:00:00 P.M. as 14:00:00. Valid Times are 00:00:00 through 23:59:59.

mnBeginningCoverageTime8BEG8MATH_NUMERICREQINPUT

The time of day service contract coverage begins for each day of the week, Sunday through Saturday, and for holidays. Enter the value in 
24 hour units. For example, enter 2:00:00 P.M. as 14:00:00. Valid Times are 00:00:00 through 23:59:59.

mnEndingCoverageTime1ECV1MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 p.m. as 14:00:00.

mnEndingCoverageTime2ECV2MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnEndingCoverageTime3ECV3MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnEndingCoverageTime4ECV4MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnEndingCoverageTime5ECV5MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00.

mnEndingCoverageTime6ECV6MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Specify this 
value in 24 hour units. For example, enter 2:00:00 P.M. as 14:00:00. Valid times are 00:00:00 through 23:59:59.

mnEndingCoverageTime7ECV7MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Enter the value in 
24 hour units. For example, enter 2:00:00 P.M. as 14:00:00. Valid times are 00:00:00 through 23:59:59.

mnEndingCoverageTime8ECV8MATH_NUMERICREQINPUT

The time of day that service contract coverage ends for each day of the week, Sunday through Saturday, and for holidays. Enter the value in 
24 hour units. For example, enter 2:00:00P.M. as 14:00:00. Valid times are 00:00:00 through 23:59:59.

nDayOfWeekINT01integerREQINPUT

Number of Days in Future to Query for Responses Due. 

jdCommitmentDateUPMJJDEDATEREQOUTPUT

The date that specifies the last update to the file record.

mnCommitmentTimeUPMTMATH_NUMERICREQOUTPUT

The time that specifies when the program executed the last update to this record.

szBranchPlantMMCUcharREQINPUT

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

mnThresholdTHRESVALMATH_NUMERICOPTNONE

A value that is assigned to individuals within a distribution list to determine if the individuals will be included in the approval of a workflow 
task. This value can be any numeric value, such as an amount, quality, or percentage. 

cApplyThresholdEV01charOPTNONE

An option that specifies the type of processing for an event.

cSuppressErrorMessages_EV01EV01charOPTNONE

An option that specifies the type of processing for an event.

cErrorCode_ERRCERRCcharOPTNONE

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

szErrorMessageID_DTAIDTAIcharOPTNONE

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.

Related Functions

None

Related Tables

None
ConvertTimeHHMMSSToDecimal

ConvertTimeHHMMSSToDecimal

Calculate Contract Commitment Date and Time

Minor Business Rule

Object Name: N1700800

Parent DLL: CCRIN

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose

This business function will convert the time from HHMMSS to decimal format: HH.mm where mm = 1/60 

hour.  Seconds are omitted from the time conversion.  For example, if the time passed in is 12:30:45, 

this function will return 12.5000 as the decimal time.  


1.2Setup Notes and Prerequisites



1.3Special Logic


This function is specific to CSMS.




Data Structure

D1700800B - Convert time from HHMMSS to decimal

Parameter NameData ItemData TypeReq/OptI/O/Both
mnTimeHHMMSSUPMTMATH_NUMERICOPTINPUT

The time that specifies when the program executed the last update to this record.

mnTimeDecimalCLATMATH_NUMERICOPTOUTPUT

The actual amount to produce a given amount of product.

Related Functions

None

Related Tables

None
SetContractCommitStartTime

SetContractCommitStartTime

Calculate Contract Commitment Date and Time

Minor Business Rule

Object Name: N1700800

Parent DLL: CCRIN

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose

This sub-function will determine the starting point of the next business day and will return the 

commitment date and time to the calling function.


1.2Setup Notes and Prerequisites


1.3Special Logic


This function is used specifically for CSMS and calculating the contractual commitment date and time.



Data Structure

D1700800A - Set Contract Commit Start Time

Parameter NameData ItemData TypeReq/OptI/O/Both
nWeekDayINT01integerOPTBOTH

Number of Days in Future to Query for Responses Due. 

cDayTypeTD01charOPTBOTH

A code to indicate the type of day. Valid values are:    W Work Day    E Weekend    H Holiday 

cHolidayDayTypeTD01charOPTINPUT

A code to indicate the type of day. Valid values are:    W Work Day    E Weekend    H Holiday 

mnBegTimeSunCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnBegTimeMonCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnBegTimeTueCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnBegTimeWedCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnBegTimeThuCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnBegTimeFriCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnBegTimeSatCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnBegTimeHolCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnStartTimeCLATMATH_NUMERICOPTBOTH

The actual amount to produce a given amount of product.

jdCommitDateUPMJJDEDATEOPTBOTH

The date that specifies the last update to the file record.

mnCommitTimeCLATMATH_NUMERICOPTBOTH

The actual amount to produce a given amount of product.

mnEndingTimeCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnResponseTimeCLATMATH_NUMERICOPTBOTH

The actual amount to produce a given amount of product.

mnTimeRemainingCLATMATH_NUMERICOPTBOTH

The actual amount to produce a given amount of product.

szCostCenterAltMMCUcharOPTINPUT

A code that represents a high-level business unit. Use this code to refer to a branch or plant that might have departments or jobs, which 
represent lower-level business units, subordinate to it. For example:     o Branch/Plant (MMCU)     o Dept A (MCU)     o Dept B (MCU)     o Job 123 
(MCU) Business unit security is based on the higher-level business unit.

mnBeginningTimeCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeSunCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeMonCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeTueCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeWedCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeThuCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeFriCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeSatCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

mnEndTimeHolCLATMATH_NUMERICOPTINPUT

The actual amount to produce a given amount of product.

cSuppressErrors_EV01EV01charOPTNONE

An option that specifies the type of processing for an event.

cErrorCode_ERRCERRCcharOPTNONE

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

szErrorMessageID_DTAIDTAIcharOPTNONE

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.

Related Functions

None

Related Tables

None