Routines for rchg_bf.kb


ExitCategoryField

File Name

rchg_bf.kb

Syntax

ExitCategoryField(REF id: STRING): INTEGER IS

Parameters

id - category ID

Returns

Integer

Side Effects

None

Description

This routine autopopulates a category field.

Dialog Forms Called

None


R_AcceptChange

File Name

rchg_bf.kb

Syntax

R_AcceptChange(VAL w: WINDOW): INTEGER IS

Parameters

w - Window handle

Returns

Integer

Side Effects

None

Description

This routine runs when a user finishes editing and is ready to accept the change request.

Dialog Forms Called

rchg.dfc[disposition]


R_AddApprovalToOldChange

File Name

rchg_bf.kb

Syntax

R_AddApprovalToOldChange(VAL this_Approval: R_APPROVAL_REC) IS

Parameters

this_Approval - Current approval record

Returns

Nothing

Side Effects

None

Description

This routine adds an approval record to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddAssocProblemToOldChange

File Name

rchg_bf.kb

Syntax

R_AddAssocProblemToOldChange(VAL this_AssocProb: R_ASSOC_PROB_REC) IS

Parameters

this_AssocProb - Current associated problem record

Returns

Nothing

Side Effects

None

Description

This routine adds an associated problem record to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddChangeAsActivity

File Name

rchg_bf.kb

Syntax

R_AddChangeAsActivity IS

Parameters

A_Index - Index to the activities for the current change

Returns

Nothing

Side Effects

None

Description

This routine adds a change as an activity.

Dialog Forms Called

None


R_AddChangeAttachmentsToOldChange

File Name

rchg_bf.kb

Syntax

R_AddChangeAttachmentsToOldChange IS

Parameters

None

Returns

None

Side Effects

None

Description

This routine adds change attachment records to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddCommandsToOldSchedule

File Name

rchg_bf.kb

Syntax

R_AddCommandsToOldSchedule IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds commands to the corresponding schedule on the AChanges stack.

Dialog Forms Called

None


R_AddDependenciesToOldSchedule

File Name

rchg_bf.kb

Syntax

R_AddDependenciesToOldSchedule IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds dependencies to the corresponding schedule on the AChanges stack.

Dialog Forms Called

None


R_AddHistoryForStatusChange

File Name

rchg_bf.kb

Syntax

R_AddHistoryForStatusChange(VAL thisStatus: R_STATUS_REC) IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds history for a status change.

Dialog Forms Called

None


R_AddImpactToOldChange

File Name

rchg_bf.kb

Syntax

R_AddImpactToOldChange(VAL this_Impact: R_IMPACT_REC) IS

Parameters

this_Impact - Current Impact record

Returns

Nothing

Side Effects

None

Description

This routine adds an impact record to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddInventoryToOldChange

File Name

rchg_bf.kb

Syntax

R_AddInventoryToOldChange IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds inv_effect records to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddInventorytoOldImpact

File Name

rchg_bf.kb

Syntax

R_AddInventorytoOldImpact IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds an inventory to the corresponding impact on the AChanges stack.

Dialog Forms Called

None


R_AddInventoryToOldSchedule

File Name

rchg_bf.kb

Syntax

R_AddInventoryToOldSchedule IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds an inventory to the corresponding schedule on the AChanges stack.

Dialog Forms Called

None


R_AddItemsToOldImpact

File Name

rchg_bf.kb

Syntax

R_AddItemsToOldImpact IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds an items to the corresponding impact on the AChanges stack.

Dialog Forms Called

None


R_AddKeywordsToOldImpact

File Name

rchg_bf.kb

Syntax

R_AddKeywordsToOldImpact IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds keywords to the corresponding impact on the AChanges stack.

Dialog Forms Called

None


R_AddResourceImpact

File Name

rchg_bf.kb

Syntax

R_AddResourceImpact(VAL w: WINDOW, REF impItemsList: LIST OF R_IMP_ITEM_REC, VAL impResource: R_ResourceOptionRec) IS

Parameters

w - Current window

impItemsList - list of impact item record

impResource - impact resource option record

Returns

Nothing

Side Effects

None

Description

This routine adds a resource, either organizations or people, to the impact analysis.

Dialog Forms Called

people.dfc[peoplesearchonly]


R_AddResourcesToOldSchedule

File Name

rchg_bf.kb

Syntax

R_AddResourcesToOldSchedule IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds resources to the corresponding schedule on the AChanges stack.

Dialog Forms Called

None


R_AddSchedulesToOldChange

File Name

rchg_bf.kb

Syntax

R_AddSchedulesToOldChange IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds schedule records to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddScheduleToOldChange

File Name

rchg_bf.kb

Syntax

R_AddScheduleToOldChange(VAL this_Task: R_TASK_REC) IS

Parameters

this_Task - Current task record

Returns

Nothing

Side Effects

None

Description

This routine adds a task record to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddTextToOldChange

File Name

rchg_bf.kb

Syntax

R_AddTextToOldChange IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds text records to the corresponding change on the AChanges stack.

Dialog Forms Called

None


R_AddTextToOldImpact

File Name

rchg_bf.kb

Syntax

R_AddTextToOldImpact IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds text record to the corresponding impact on the AChanges stack.

Dialog Forms Called

None


R_AddTextToOldSchedule

File Name

rchg_bf.kb

Syntax

R_AddTextToOldSchedule IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine adds text record to the corresponding schedule on the AChanges stack.

Dialog Forms Called

None


R_Apply__Model

File Name

rchg_bf.kb

Syntax

R_Apply_Model(VAL w: WINDOW, VAL newModel_ID: INTEGER, ): INTEGER IS

Parameters

w - Current window handle

newModel_ID - model ID to be applied

Returns

Integer

Side Effects

None

Description

This routine applies a model to a change.

Dialog Forms Called

None


R_ApproveSubordinateChangeRequests

File Name

rchg_bf.kb

Syntax

R_ApproveSubordinateChangeRequests(VAL This_Status: R_STATUS_REC ): BOOLEAN IS

Parameters

this_Status - status record

Returns

Boolean

Side Effects

None

Description

This routine approves subordinate change requests.

Dialog Forms Called

None


R_AssetDefinitionComplete

File Name

rchg_bf.kb

Syntax

R_AssetDefinitionComplete(REF this_Effect: R_INV_EFFECT_REC): BOOLEAN IS

Parameters

this_Effect - inventory effect

Returns

Boolean

Side Effects

None

Description

This routine checks for an asset definition. If no definition is present, then a value of FALSE is returned.

Dialog Forms Called

None


R_CascadeChangeApprovalMethod

File Name

rchg_bf.kb

Syntax

R_CascadeChangeApprovalMethod(VAL approvalType: INTEGER ): INTEGER IS

Parameters

approvalType - This equates to approval method ( 1 = 'A' = Accepts All Activities and 2 = 'B' = Depends On Activities)

Returns

Integer

Side Effects

None

Description

If you change the approval method, then that approval method cascades throughout the change family. At the same time, the status ID is reset to a status type of saved regardless.

Dialog Forms Called

None


R_CheckActivityStatus

File Name

rchg_bf.kb

Syntax

R_CheckActivityStatus(VAL w:Window): BOOLEAN IS

Parameters

w - Current window

Returns

Boolean

Side Effects

None

Description

This routine checks for invalid status on activities that may have come from models.

Dialog Forms Called

None


R_CheckDependencyDates

File Name

rchg_bf.kb

Syntax

R_CheckDependencyDates(VAL this_Dependency: R_DEPENDENCY_REC, VAL this_Task: R_TASK_REC, VAL dep_Type: STRING): BOOLEAN IS

Parameters

this_Dependency - Current dependency record

this_Task - Current task record

dep_Type - Dependency type

Returns

Boolean

Side Effects

None

Description

This routine determines if dependency dates conflict.

Dialog Forms Called

None


R_CheckDependencyStartEndDates

File Name

rchg_bf.kb

Syntax

R_CheckDependencyStartEndDates(VAL dependTask: R_TASK_REC, VAL independTask: R_TASK_REC, VAL dep_Type: STRING): BOOLEAN IS

Parameters

dependTask - Dependent task

independTask - Independent task

dep_Type - Dependency type

Returns

Boolean

Side Effects

None

Description

This routine verifies the start and end dates for a task, given its dependencies.

Dialog Forms Called

None


R_CheckForActivityDeletions

File Name

rchg_bf.kb

Syntax

R_CheckForActivityDeletions: BOOLEAN IS

Parameters

None

Returns

Boolean

Side Effects

None

Description

This routine checks to see if any activities have been deleted.

Dialog Forms Called

None


R_CheckForAlreadyExecutedImpact

File Name

rchg_bf.kb

Syntax

R_CheckForAlreadyExecutedImpact(VAL check_Type: STRING): BOOLEAN IS

Parameters

check_Type - Type of impact analysis to check

Returns

Boolean

Side Effects

None

Description

This routine checks to see if impact analysis has been performed.

Dialog Forms Called

None


R_CheckForCCBApproval

File Name

rchg_bf.kb

Syntax

R_CheckForCCBApproval(VAL this_Approval: R_APPROVAL_REC, REF CCB_Status: STRING): BOOLEAN IS

Parameters

this_approval - approval record

ccb_Status - CCB status

Returns

Boolean

Side Effects

None

Description

This routine checks for CCB approval.

Dialog Forms Called

None


R_CheckForCompletedImpacts

File Name

rchg_bf.kb

Syntax

R_CheckForCompletedImpacts: BOOLEAN IS

Parameters

None

Returns

Boolean

Side Effects

None

Description

This routine checks for completed impacts. TRUE is returned if all impacts are completed.

Dialog Forms Called

None


R_CheckForDeleteableTask

File Name

rchg_bf.kb

Syntax

R_CheckForDeleteableTask: BOOLEAN IS

Parameters

None

Returns

Boolean

Side Effects

None

Description

This routine determines if a task relationship has been deleted.

Dialog Forms Called

None


R_CheckForDuplicateDependency

File Name

rchg_bf.kb

Syntax

R_CheckForDuplicateDependency(VAL name: STRING, VAL type: INTEGER): BOOLEAN IS

Parameters

name - Name of record to check

relation - Dependency relationship

type - Type of record to check

Returns

Boolean

Side Effects

None

Description

This routine determines if the dependency is a duplicate.

Dialog Forms Called

None


R_CheckForNoImpInv

File Name

rchg_bf.kb

Syntax

R_CheckForNoImpInv: BOOLEAN IS

Parameters

None

Returns

Boolean

Side Effects

None

Description

This routine checks to see if any inventory is associated with an impact.

Dialog Forms Called

None


R_CheckForNoImpKeywords

File Name

rchg_bf.kb

Syntax

R_CheckForNoImpKeywords: BOOLEAN IS

Parameters

None

Returns

Boolean

Side Effects

None

Description

This routine checks to see if any keywords are associated with an impact.

Dialog Forms Called

None


R_CheckForNoPossScheduleDependencyLoop

File Name

rchg_bf.kb

Syntax

R_CheckForNoPossScheduleDependencyLoop( VAL this_Dependency: R_DEPENDENCY_REC, VAL dependencyList: LIST OF R_DEPENDENCY_REC): BOOLEAN IS

Parameters

this_Dependency - Current dependency

dependencyList - list of dependencies

Returns

Boolean

Side Effects

None

Description

This routine checks to see if any task names are in the list of dependencies.

Dialog Forms Called

None


R_CheckForOldActivity

File Name

rchg_bf.kb

Syntax

R_CheckForOldActivity(VAL aIndex: INTEGER): BOOLEAN IS

Parameters

aIndex - index

Returns

Boolean

Side Effects

None

Description

This routine looks to see if the current activity on the CStack already exists on the AChanges stack. If found, TRUE is returned.

Dialog Forms Called

None


R_CheckForOldApproval

File Name

rchg_bf.kb

Syntax

R_CheckForOldApproval(VAL aIndex: INTEGER): BOOLEAN IS

Parameters

aIndex - index

Returns

Boolean

Side Effects

None

Description

This routine looks to see if the approver_id on the CStack already exists on the AChanges stack. If found, TRUE is returned.

Dialog Forms Called

None


R_CheckForOldImpact

File Name

rchg_bf.kb

Syntax

R_CheckForOldImpact(VAL aIndex: INTEGER): BOOLEAN IS

Parameters

aIndex - index

Returns

Boolean

Side Effects

None

Description

This routine looks to see if the impact category on the CStack already exists on the AChanges stack. If found, TRUE is returned.

Dialog Forms Called

None


R_CheckForOldSchedule

File Name

rchg_bf.kb

Syntax

R_CheckForOldSchedule(VAL aIndex: INTEGER): BOOLEAN IS

Parameters

aIndex - index

Returns

Boolean

Side Effects

None

Description

This routine looks to see if the schedule name on the CStack already exists on the AChanges stack. If found, TRUE is returned.

Dialog Forms Called

None


R_CheckForSubordinateCompletion

File Name

rchg_bf.kb

Syntax

R_CheckForSubordinateCompletion: BOOLEAN IS

Parameters

Returns

Boolean

Side Effects

None

Description

If there are activities to approve, then verify they have been approved. If no activities are left to approve, then the change can be approved.

Dialog Forms Called

None


R_CheckForTotalApproval

File Name

rchg_bf.kb

Syntax

R_CheckForTotalApproval(REF Total_Status: STRING, VAL This_Status: R_STATUS_REC): BOOLEAN IS

Parameters

Total_Status - total status of this change reqeust

This_Status - Current status

Returns

Boolean

Side Effects

None

Description

This routine checks for total approval for a change request.

Dialog Forms Called

None


R_CheckForTotalResourceandDuration

File Name

rchg_bf.kb

Syntax

R_CheckForTotalResourceandDuration: BOOLEAN IS

Parameters

None

Returns

Boolean

Side Effects

None

Description

This routine confirms that task start and end dates are greater than or equal to the duration. Also, it confirms that total labor_hours is greater than or equal to the task labor hours.

Dialog Forms Called

None


R_CheckForUnDefinedInvEffects

File Name

rchg_bf.kb

Syntax

R_CheckForUnDefinedInvEffects: INTEGER IS

Parameters

None

Returns

Integer

Side Effects

None

Description

This routine checks to see if any inventory effects are incomplete. An incomplete inventory effect may result from creating a new change from a problem, which creates a default effect with no definition.

Dialog Forms Called

None


R_CheckForValidCompletion

File Name

rchg_bf.kb

Syntax

R_CheckForValidCompletion: BOOLEAN IS

Parameters

None

Returns

Boolean

Side Effects

None

Description

This routine prevents the removal of tasks which are 100 percent complete. A value of FALSE is returned if attempting to delete a task which has a percentage complete of 100.

Dialog Forms Called

None


R_CheckForValidStatusAfterApproval

File Name

rchg_bf.kb

Syntax

R_CheckForValidStatusAfterApproval( VAL thisStatus: R_STATUS_REC): BOOLEAN IS

Parameters

thisStatus - status record

Returns

Boolean

Side Effects

None

Description

This routine checks to confirm that a valid Event_ID of APPROVED has been successfully added to the Cstack.History list.

Dialog Forms Called

None


R_CheckStartEndDates

File Name

rchg_bf.kb

Syntax

R_CheckStartEndDates(VAL Start_Date: DATE, VAL Start_Time: TIME, VAL End_Date: DATE, VAL End_Time: TIME ): BOOLEAN IS

Parameters

Start_Date - Start Date

Start_Time - Start Time

End_Date - End Date

End_Time - End Time

Returns

Boolean

Side Effects

None

Description

This routine determines if specified dates and times are valid.

Dialog Forms Called

None


R_CheckTimeConstraintsForExecution

File Name

rchg_bf.kb

Syntax

R_CheckTimeConstraintsForExecution: STRING IS

Parameters

None

Returns

String

Side Effects

None

Description

This routine checks to see if command can be executed.

Dialog Forms Called

None


R_ChooseInvEffectTypeMask

File Name

rchg_bf.kb

Syntax

R_ChooseInvEffectTypeMask(VAL w: WINDOW): INTEGER IS

Parameters

w - Current window

Returns

Integer

Side Effects

None

Description

This routine chooses and inventory effect type mask (add/update/delete).

Dialog Forms Called

rchg.dfc[selectinveffect]


R_CleanUpOldModelInfo

File Name

rchg_bf.kb

Syntax

R_CleanUpOldModelInfo IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine removes model information from the change.

Dialog Forms Called

None


R_ClearAlterFlags

File Name

rchg_bf.kb

Syntax

R_ClearAlterFlags IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine clears alter flags for CStack[1] instance data.

Dialog Forms Called

None


R_ClearImpactAlterFlags

File Name

rchg_bf.kb

Syntax

R_ClearImpactAlterFlags(REF this_Impact: R_IMPACT_REC) IS

Parameters

this_Impact - impact record

Returns

Nothing

Side Effects

None

Description

This routine clears impact alter flags.

Dialog Forms Called

None


R_ClearInvEffectAlterFlags

File Name

rchg_bf.kb

Syntax

R_ClearInvEffectAlterFlags(REF this_InvEffect: R_INV_EFFECT_REC)

Parameters

this_InvEffect - Inventory Effect record

Returns

Nothing

Side Effects

None

Description

This routine clears inventory effect alter flags.

Dialog Forms Called

None


R_ClearScheduleAlterFlags

File Name

rchg_bf.kb

Syntax

R_ClearScheduleAlterFlags(REF this_Task: R_TASK_REC) IS

Parameters

this_task - Current task

Returns

Nothing

Side Effects

None

Description

This routine clears task alter flags.

Dialog Forms Called

None


R_CompleteSubordinateChangeRequests

File Name

rchg_bf.kb

Syntax

R_CompleteSubordinateChangeRequests: INTEGER IS

Parameters

None

Returns

Integer

Side Effects

None

Description

This routine completes subordinate change requests.

Dialog Forms Called

None


R_ConvertInvEffectToChangeStyle

File Name

rchg_bf.kb

Syntax

R_ConvertInvEffectToChangeStyle(VAL massDefList: LIST OF R_MassDefRec, VAL invList: LIST OF IS_InventoryRec): INTEGER IS

Parameters

massDef - Current group maintenance record

invList - List of associated inventory

Returns

Integer

Side Effects

None

Description

This routine converts a group maintenance record into an inventory effect.

Dialog Forms Called

None


R_ConvertInvEffectToInvStyle

File Name

rchg_bf.kb

Syntax

R_ConvertInvEffectToInvStyle(REF massDefList: LIST OF R_MassDefRec, REF invList: LIST OF IS_InventoryRec, VAL description: STRING): INTEGER IS

Parameters

massDefList - Current group maintenance record

invList - List of associated inventory

description - description

Returns

Integer

Side Effects

None

Description

This routine converts an inventory effect to a group maintenance record.

Dialog Forms Called

None


R_CreateExcludeCompletedSQLString

File Name

rchg_bf.kb

Syntax

R_CreateExcludeCompletedSQLString(REF Status_SQL_String: STRING, VAL Restricted_To_Problem: BOOLEAN, VAL Problem_ID: STRING) IS

Parameters

Status_SQL_String - Selection criteria

Restricted_To_Problem - Determines whether to restrict the displayed changes to those associated with a given problem ID

Problem_ID - The problem ID to which the query will be restricted

Returns

Nothing

Side Effects

None

Description

This routine creates the selection criteria for excluding the completed type.

Dialog Forms Called

None


R_DetermineapprovalEligibility

File Name

rchg_bf.kb

Syntax

R_DetermineapprovalEligibility IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine manages the list of approvals for a given change request, determining which of those approvers are eligible for approval. For those approvers that qualify as eligible, their approval dispositions will be set to 'Eligible.' This value is then used to determine which change requests get displayed in an Approval dialog box MCLB. This routine is called for approvals at the end of all change request modifications.

Dialog Forms Called

None


R_DisplayEntireChangeTree

File Name

rchg_bf.kb

Syntax

R_DisplayEntireChangeTree(VAL w:WINDOW, VAL Change_ID: INTEGER, REF DDViews: R_DataViewerRec VAL field_Name: STRING) :LIST OF R_DISPLAY_CTREE_REC IS

Parameters

w - Window handler

Change_ID - Change ID

DDViews - R_DataViewerRec

Field_Name - MCLB control field name

Returns

R_G_Entire_CTree - The entire change tree

Side Effects

None

Description

This function displays the entire change tree in an MCLB control.

Dialog Forms Called

None


R_DuplicateInvEffectAssetTag

File Name

rchg_bf.kb

Syntax

R_DuplicateInvEffectAssetTag(VAL newTag: STRING, VAL oldID: INTEGER): BOOLEAN IS

Parameters

newTag - Asset tag

oldID - Inventory effect ID

Returns

Boolean

Side Effects

None

Description

This routine searches for a duplicate asset tag for the current change request. If found, TRUE is returned.

Dialog Forms Called

None


R_DuplicateInvEffectAssetTagFromDB

File Name

rchg_bf.kb

Syntax

R_DuplicateInvEffectAssetTagFromDB(VAL newTag: STRING): BOOLEAN IS

Parameters

newTag - Asset tag

Returns

Boolean

Side Effects

None

Description

This routine selects inventory effect IDs from table INV_EFFECT.

Dialog Forms Called

None


R_Enable_DisableControls

File Name

rchg_bf.kb

Syntax

R_Enable_DisableControls(VAL w: WINDOW, VAL mode: INTEGER, VAL status_id: STRING): INTEGER IS

Parameters

w - Current window

mode - Integer

status_id - String

Returns

Integer

Side Effects

None

Description

This function sets dialog box controls to their appropriate enabled or disabled state based upon mode or status type in the case of 'Freeze.'

Dialog Forms Called

None


R_Enable_ViewControls

File Name

rchg_bf.kb

Syntax

R_Enable_ViewControls(VAL w: WINDOW, VAL mode: INTEGER, VAL status_id: STRING): INTEGER

Parameters

w - Current window

mode - Will equal edit or view mode

status_id - Current status ID

Returns

Integer

Side Effects

None

Description

This function sets dialog controls to their appropriate enabled or disabled state based upon mode or status type in the case of 'Freeze.'

Dialog Forms Called

None


R_ExecuteCallActionFromScheduleTask

File Name

rchg_bf.kb

Syntax

R_ExecuteCallActionFromScheduleTask(VAL Type:STRING, REF Error_List: LIST OF STRING): INTEGER IS

Parameters

Type - When the task should be executed

Error_List - List of error which occurred during execution

Returns

Integer

Side Effects

None

Description

This routine calls a system command from a scheduled task.

Dialog Forms Called

None


R_ExecuteConnectionImpact

File Name

rchg_bf.kb

Syntax

R_ExecuteConnectionImpact(REF impItemsList: LIST OF R_IMP_ITEM_REC)

Parameters

impItemsList - list of impact items

Returns

Nothing

Side Effects

None

Description

This routine performs connection impact analysis.

Dialog Forms Called

None


R_ExportChangeToProjectScheduler

File Name

rchg_bf.kb

Syntax

R_ExportChangeToProjectScheduler IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This is an empty routine.

Dialog Forms Called

None


R_ExtractInvEffectAtrFromList

File Name

rchg_bf.kb

Syntax

R_ExtractInvEffectAtrFromList(REF lst: LIST OF R_INV_EFFECT_ATR_REC, VAL ID: INTEGER): R_INV_EFFECT_ATR_REC IS

Parameters

lst - List of attributes found

ID - ID of inventory effect

Returns

R_INV_EFFECT_ATR_REC

Side Effects

None

Description

This routine extracts inventory effect attributes from a list.

Dialog Forms Called

None


R_ExtractInvEffectConFromList

File Name

rchg_bf.kb

Syntax

R_ExtractInvEffectConFromList(REF lst: LIST OF R_INV_EFFECT_CON_REC, VAL ID: INTEGER): R_INV_EFFECT_CON_REC IS

Parameters

lst - List of contracts found

ID - ID of inventory effect to search

Returns

R_INV_EFFECT_CON_REC

Side Effects

None

Description

This routine extracts an inventory effect contract from the list.

Dialog Forms Called

None


R_ExtractInvEffectFromList

File Name

rchg_bf.kb

Syntax

R_ExtractInvEffectFromList(REF lst: LIST OF R_INV_EFFECT_REC, VAL ID: INTEGER): R_INV_EFFECT_REC IS

Parameters

lst - List of inventory effect "connections"

ID - ID of inventory effect

Returns

R_INV_EFFECT_REC

Side Effects

None

Description

This routine extracts a list for the given ID.

Dialog Forms Called

None


R_ExtractInvEffectHstFromList

File Name

rchg_bf.kb

Syntax

R_ExtractInvEffectHstFromList(REF lst: LIST OF R_INV_EFFECT_HST_REC, VAL el: R_INV_EFFECT_HST_REC): R_INV_EFFECT_HST_REC IS

Parameters

lst - List of history records

el - Current inventory effects history record

Returns

R_INV_EFFECT_HST_REC

Side Effects

None

Description

This routine gets a history list from the given inventory effect.

Dialog Forms Called

None


R_ExtractInvEffectOnFromList

File Name

rchg_bf.kb

Syntax

R_ExtractInvEffectOnFromList(REF lst: LIST OF R_INV_EFFECT_ON_REC, VAL ID: INTEGER): R_INV_EFFECT_ON_REC IS

Parameters

lst - List of inventory effect "connections"

ID - ID of inventory effect

Returns

R_INV_EFFECT_ON_REC

Side Effects

None

Description

This routine extracts a list of inventory effect contracts for the given ID.

Dialog Forms Called

None


R_FindInvEffectInList

File Name

rchg_bf.kb

Syntax

R_FindInvEffectInList(VAL lst: LIST OF R_INV_EFFECT_REC, VAL ID: INTEGER): INTEGER IS

Parameters

lst - list of inventory effect records

ID - inventory effect ID

Returns

Integer

Side Effects

None

Description

This routine extracts a list for the given ID.

Dialog Forms Called

None


R_FindOldCommand

File Name

rchg_bf.kb

Syntax

R_FindOldCommand(VAL this_SchedCommand: R_SCHED_COMMANDS_REC): BOOLEAN IS

Parameters

this_SchedCommand - A command for a task

Returns

Boolean

Side Effects

None

Description

This routine finds old commands.

Dialog Forms Called

None


R_FindScheduleInList

File Name

rchg_bf.kb

Syntax

R_FindScheduleInList(VAL Sched_Name: STRING, VAL Schedules: LIST OF R_TASK_REC): R_TASK_REC IS

Parameters

Sched_Name - ID of specified schedule (Schedule Name is the primary key)

Schedules - List of schedules to search

Returns

Integer

Side Effects

None

Description

This routine retrieves the schedule for the specified 'Sched_Name.'

Dialog Forms Called

None


R_FindScheduleMatchingDependency

File Name

rchg_bf.kb

Syntax

R_FindScheduleMatchingDependency(VAL this_Task: STRING, VAL TaskList: LIST OF R_TASK_REC): INTEGER IS

Parameters

this_Task - Current scheduled task record

TaskList - List of scheduled tasks

Returns

Integer

Side Effects

None

Description

This routine locates the task record matching the dependency.

Dialog Forms Called

None


R_FreezeControls

File Name

rchg_bf.kb

Syntax

R_FreezeControls(VAL w: WINDOW, VAL statusType: STRING, VAL mode: INTEGER): BOOLEAN IS

Parameters

w - Current window

statusType - String

mode - Integer

Returns

Boolean

Side Effects

None

Description

This routine disables change notebook controls when opening a change request that has a status type of 'Freeze.'

Dialog Forms Called

None


R_FreezeSubordinateRequests

File Name

rchg_bf.kb

Syntax

R_FreezeSubordinateRequests(VAL This_Status: R_STATUS_REC): INTEGER IS

Parameters

This_Status - status record

Returns

Integer

Side Effects

None

Description

This routine takes a subordinate request (an activity) and changes the current status_id (should be of status type other than "Frozen") and sets it to the passed-in status ID (This_Status). This_Status.Type should be equal to "Frozen".

Dialog Forms Called

None


R_GetActivityDates

File Name

rchg_bf.kb

Syntax

R_GetActivityDates(REF activityDateTime: R_SCHEDULE_DT_REC, VAL Type: INTEGER) IS

Parameters

activityDateTime - Record structure that contains dates and times

Type - Differentiates between planned and actual dates/times

Returns

Nothing

Side Effects

None

Description

This routine gets activity dates.

Dialog Forms Called

None


R_GetApprovalMatchingMCLB

File Name

rchg_bf.kb

Syntax

R_GetApprovalMatchingMCLB(VAL w: WINDOW, VAL field_Name: STRING, REF this_Approval: R_APPROVAL_REC): INTEGER IS

Parameters

w - Current window

field_Name - Name of approval MCLB

this_Approval - Current approval record

Returns

Integer

Side Effects

None

Description

This routine finds the index for the approval record matching the MCLB.

Dialog Forms Called

None


R_GetAssocProblemMatchingMCLB

File Name

rchg_bf.kb

Syntax

R_GetAssocProblemMatchingMCLB(VAL w: WINDOW, VAL field_Name: STRING, REF this_AssocProb: R_ASSOC_PROB_REC): INTEGER IS

Parameters

w - Current window

field_Name - Name of associated problem MCLB

this_AssocProb - associated problem record

Returns

Integer

Side Effects

None

Description

This routine finds the index for the associated problem record matching the MCLB.

Dialog Forms Called

None


R_GetCCBNamesForMember

File Name

rchg_bf.kb

Syntax

R_GetCCBNamesForMember(VAL user_id: STRING): INTEGER IS

Parameters

user_id - group member user ID

Returns

Integer

Side Effects

None

Description

This routine retrieves a list of group IDs for which a given user_id is a member.

Dialog Forms Called

None


R_GetChangeListIndex

File Name

rchg_bf.kb

Syntax

R_GetChangeListIndex(VAL Changes: LIST OF R_CHANGE_REC, VAL ID: INTEGER): INTEGER IS

Parameters

Changes - List of changes

ID - ID of change to be found

Returns

Integer

Side Effects

None

Description

This routine gets the index for the change record specified by ID.

Dialog Forms Called

None


R_GetCurrIndex

File Name

rchg_bf.kb

Syntax

R_GetCurrIndex(VAL w: WINDOW,VAL field_Name: STRING, VAL type: INTEGER): INTEGER IS

Parameters

w - Current window

field_Name - Name of MCLB

type - Type of component

Returns

Integer

Side Effects

None

Description

This routine gets the current index for as change component.

Dialog Forms Called

None


R_GetDateTimesForTask

File Name

rchg_bf.kb

Syntax

R_GetDateTimesForTask(VAL Curr_Index: INTEGER, REF TaskList: LIST OF R_TASK_REC) IS

Parameters

Curr_Index - Index of scheduled tasks

TaskList - List of scheduled tasks

Returns

Nothing

Side Effects

None

Description

This routine calculates dates for scheduled tasks.

Dialog Forms Called

None


R_GetImpactItemMatchingMCLB

File Name

rchg_bf.kb

Syntax

R_GetImpactItemMatchingMCLB(VAL w: WINDOW, VAL field_Name: STRING, REF this_ImpactItem: R_IMP_ITEM_REC): INTEGER IS

Parameters

w - Current window

field_Name - Name of impact MCLB

this_impactItem - impact item record

Returns

Integer

Side Effects

None

Description

This routine finds the index for the impact record matching the MCLB.

Dialog Forms Called

None


R_GetImpactMatchingMCLB

File Name

rchg_bf.kb

Syntax

R_GetImpactMatchingMCLB(VAL w: WINDOW, VAL field_Name: STRING, REF this_Impact: R_IMPACT_REC): INTEGER IS

Parameters

w - Current window

field_Name - Name of impact MCLB

Returns

Integer

Side Effects

None

Description

This routine finds the index for the impact record matching the MCLB.

Dialog Forms Called

None


R_GetInventory

File Name

rchg_bf.kb

Syntax

R_GetInventory(VAL inventory_id: STRING, REF problem_id: STRING) IS

Parameters

inventory_id - inventory id

problem_id - problem id

Returns

Nothing

Side Effects

None

Description

This routine retrieves inventory IDs based on a given problem ID.

Dialog Forms Called

None


R_GetLocationForPerson

File Name

rchg_bf.kb

Syntax

R_GetLocationForPerson(VAL people_ID: INTEGER): STRING IS

Parameters

people_ID - The ID of the person to search for

Returns

String

Side Effects

None

Description

This routine checks for a contact relationship and then returns the location ID for that contact.

Dialog Forms Called

None


R_GetOrganizationForPerson

File Name

rchg_bf.kb

Syntax

R_GetOrganizationForPerson(VAL people_ID: INTEGER): STRING IS

Parameters

people_ID - The ID of the person for which to search

Returns

String

Side Effects

None

Description

This routine fetches the first organization that a person belongs to and returns the organization ID.

Dialog Forms Called

None


R_GetOrganizationNameList

File Name

rchg_bf.kb

Syntax

R_GetOrganizationNameList(VAL people_id: INTEGER, REF lst: LIST OF STRING): INTEGER IS

Parameters

people_id - people ID

lst - list of organization names

Returns

Integer

Side Effects

None

Description

This routine retrieves a list of organization names to which this person belongs.

Dialog Forms Called

None


R_GetScheduleMatchingMCLB

File Name

rchg_bf.kb

Syntax

R_GetScheduleMatchingMCLB(VAL w: WINDOW, VAL field_Name: STRING, REF this_Task: R_TASK_REC): INTEGER IS

Parameters

w - Current window

field_Name - Name of the task MCLB

this_Task - Current task

Returns

Integer

Side Effects

None

Description

This routine finds the index for the task record matching the MCLB.

Dialog Forms Called

None


R_GetSomeHistList

File Name

rchg_bf.kb

Syntax

R_GetSomeHistList(VAL where: STRING, REF lst: LIST OF HistRec): INTEGER IS

Parameters

where - SQL WHERE clause

lst - list of history records

Returns

Integer

Side Effects

None

Description

This routine retrieves a list of inventory history.

Dialog Forms Called

None


R_HistoryEventHasOccurred

File Name

rchg_bf.kb

Syntax

R_HistoryEventHasOccurred(VAL change_id: INTEGER, VAL event_id: STRING): BOOLEAN IS

Parameters

change_id - ID of change

event_id - ID of history event

Returns

Boolean

Side Effects

None

Description

This routine verifies if a selected history event has occured.

Dialog Forms Called

None


R_InitChangeFromProblem

File Name

rchg_bf.kb

Syntax

R_InitChangeFromProblem(REF thisChange: R_CHANGE_REC, VAL problem: ProblemRecord) IS

Parameters

this_Request - current change record

problem - problem record from which to initialize the change record

Returns

Nothing

Side Effects

None

Description

This routine initializes a change from a problem record.

Dialog Forms Called

None


R_InitializeChangeData

File Name

rchg_bf.kb

Syntax

R_InitializeChangeData(VAL w: WINDOW) IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine initializes change data.

Dialog Forms Called

None


R_InitializeChangeMCLBs

File Name

rchg_bf.kb

Syntax

R_InitializeChangeMCLBs(VAL w: WINDOW) IS

Parameters

Changes - List of changes

w - Window Handler

Returns

Nothing

Side Effects

None

Description

This routine initializes the change MCLBs.

Dialog Forms Called

None


R_InitializeOldStatusField

File Name

rchg_bf.kb

Syntax

R_InitializeOldStatusField(REF thisRequest: R_CHANGE_REC): INTEGER IS

Parameters

thisRequest - change request

Returns

Integer

Side Effects

None

Description

This routine initializes the old_status field.

Dialog Forms Called

None


R_InsertHistoryForInvEffects

File Name

rchg_bf.kb

Syntax

R_InsertHistoryForInvEffects IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine inserts history for inventory effects.

Dialog Forms Called

None


R_InsertIntoInvEffectListBox

File Name

rchg_bf.kb

Syntax

R_InsertIntoInvEffectListBox(VAL w: WINDOW) IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine inserts inventory effect descriptions into inventory effect list boxes.

Dialog Forms Called

None


R_InvContractToInvEffectCon

File Name

rchg_bf.kb

Syntax

R_InvContractToInvEffectCon(VAL invK: InvContractRec ): R_INV_EFFECT_CON_REC IS

Parameters

invK - Current inventory contract record

Returns

R_INV_EFFECT_CON_REC

Side Effects

None

Description

This routine copies the inventory contract information to inventory effects.

Dialog Forms Called

None


R_InvEffectAtrToPhysAttrib

File Name

rchg_bf.kb

Syntax

R_InvEffectAtrToPhysAttrib(VAL effectAtr: R_INV_EFFECT_ATR_REC ): R_PhysAttribRec IS

Parameters

effectAtr - Current inventory affect attribute record

Returns

R_PhysAttribRec

Side Effects

None

Description

This routine copies the inventory effect attribute information to inventory.

Dialog Forms Called

None


R_InvEffectConToInvContract

File Name

rchg_bf.kb

Syntax

R_InvEffectConToInvContract(VAL effectCon: R_INV_EFFECT_CON_REC ): InvContractRec IS

Parameters

effectCon - Current inventory effect contract record

Returns

InvContractRec

Side Effects

None

Description

This routine copies the Inventory Effect contract information to inventory.

Dialog Forms Called

None


R_InvEffectHstToInvHist

File Name

rchg_bf.kb

Syntax

R_InvEffectHstToInvHist(VAL effectHst: R_INV_EFFECT_HST_REC): R_HistViewRec

Parameters

effectHst - Current inventory effects history record

Returns

R_HistViewRec

Side Effects

None

Description

This routine copies the inventory effect history to inventory.

Dialog Forms Called

None


R_InvEffectOnToIsInv

File Name

rchg_bf.kb

Syntax

R_InvEffectOnToIsInv(VAL effectOn: R_INV_EFFECT_ON_REC): IS_InventoryRec IS

Parameters

effectOn - Current inventory effect on record

Returns

IS_InventoryRec

Side Effects

None

Description

This routine copies the inventory effects information to inventory.

Dialog Forms Called

None


R_InvEffectToMassDef

File Name

rchg_bf.kb

Syntax

R_InvEffectToMassDef(VAL invEffect: R_INV_EFFECT_REC): R_MassDefRec IS

Parameters

invEffect - Current inventory effects record

Returns

R_MassDefRec

Side Effects

None

Description

This routine copies the inventory effect information to the inventory.

Dialog Forms Called

None


R_InvHistToInvEffectHst

File Name

rchg_bf.kb

Syntax

R_InvHistToInvEffectHst(VAL hist: R_HistViewRec): R_INV_EFFECT_HST_REC IS

Parameters

hist - Current inventory history record

Returns

R_INV_EFFECT_HST_REC

Side Effects

None

Description

This routine copies the inventory history to the inventory effect.

Dialog Forms Called

None


R_InvokeInvEffectsForChange

File Name

rchg_bf.kb

Syntax

R_InvokeInvEffectsForChange: INTEGER IS

Parameters

None

Returns

Integer

Side Effects

None

Description

This routine starts group maintenance for TCM.

Dialog Forms Called

None


R_IsInvToInvEffectOn

File Name

rchg_bf.kb

Syntax

R_IsInvToInvEffectOn(VAL inv: IS_InventoryRec): R_INV_EFFECT_ON_REC IS

Parameters

inv - Current inventory record

Returns

R_INV_EFFECT_ON_REC

Side Effects

None

Description

This routine copies the inventory information to an inventory effect.

Dialog Forms Called

None


R_ListInit

File Name

rchg_bf.kb

Syntax

R_ListInit: INTEGER IS

Parameters

None

Returns

Integer

Side Effects

None

Description

This routine initializes TAM preference settings.

Dialog Forms Called

None


R_LoadActivityStructureForChange

File Name

rchg_bf.kb

Syntax

R_LoadActivityStructureForChange: INTEGER IS

Parameters

None

Returns

Integer

Side Effects

None

Description

This routine retrieves model activities from the database.

Dialog Forms Called

None


R_LoadAfterStatusCodesIntoComboBox

File Name

rchg_bf.kb

Syntax

R_LoadAfterStatusCodesIntoComboBox(VAL w: WINDOW, VAL field_Name: STRING):INTEGER IS

Parameters

w - Current window

field_Name - Name of the combo box

Returns

Integer

Side Effects

None

Description

This routine loads the specified statuses into a specified combo box.

Dialog Forms Called

None


R_LoadChangeApprovalFromModel

File Name

rchg_bf.kb

Syntax

R_LoadChangeApprovalFromModel( VAL ApprovalList: LIST OF R_MO_APPROVAL_REC) IS

Parameters

ApprovalList - List of approvals to create

Returns

Nothing

Side Effects

None

Description

This routine creates approvals from a model.

Dialog Forms Called

None


R_LoadChangeAttachmentsFromModel

File Name

rchg_bf.kb

Syntax

R_LoadChangeAttachmentsFromModel(VAL w: WINDOW, VAL AttachmentList: LIST OF R_MO_ATTACHMENT_REC ) IS

Parameters

w - Window handle of change notebook

AttachmentList - List of file attachments to create

Returns

Nothing

Side Effects

None

Description

This routine creates file attachments from a model.

Dialog Forms Called

None


R_LoadChangeImpactFromModel

File Name

rchg_bf.kb

Syntax

R_LoadChangeImpactFromModel(VAL ImpactList: LIST OF R_MO_IMPACT_REC)

Parameters

ImpactList - List of impacts to create

Returns

Nothing

Side Effects

None

Description

This routine creates impacts from the given model.

Dialog Forms Called

None


R_LoadChangeRecordFromModel

File Name

rchg_bf.kb

Syntax

R_LoadChangeRecordFromModel (VAL w: WINDOW) IS

Parameters

w - Window handle of the change notebook

Returns

Nothing

Side Effects

None

Description

This routine intializes the change request databased upon the model data retrieved by the category.

Dialog Forms Called

None


R_LoadChangeScheduleFromModel

File Name

rchg_bf.kb

Syntax

R_LoadChangeScheduleFromModel( VAL TaskList: LIST OF R_MODEL_TASK_REC) IS

Parameters

Schedule_List - List of scheduled tasks

Returns

Nothing

Side Effects

None

Description

This routine creates scheduled tasks from a model.

Dialog Forms Called

None


R_LoadScheduleCommandsFromModel

File Name

rchg_bf.kb

Syntax

R_LoadScheduleCommandsFromModel(REF this_Task: R_TASK_REC, VAL CommandList: LIST OF R_MO_SCHED_COMMANDS_REC) IS

Parameters

this_Task - Current task record

CommandList - List of commands

Returns

Nothing

Side Effects

None

Description

This routine creates schedule commands from a model.

Dialog Forms Called

None


R_LoadScheduleDependenciesFromModel

File Name

rchg_bf.kb

Syntax

R_LoadScheduleDependenciesFromModel( REF this_Task: R_TASK_REC, VAL DependencyList: LIST OF R_MO_DEPENDENCY_REC) IS

Parameters

this_Task - Current task record

DependencyList - List of dependencies

Returns

Nothing

Side Effects

None

Description

This routine creates schedule dependencies from a model.

Dialog Forms Called

None


R_LoadScheduleResourcesFromModel

File Name

rchg_bf.kb

Syntax

R_LoadScheduleResourcesFromModel(REF this_Task: R_TASK_REC, VAL ResourceList: LIST OF R_MO_RESOURCE_REC) IS

Parameters

this_Task - Current task record

ResourceList - List of Resources

Returns

Nothing

Side Effects

None

Description

This routine creates schedule resources from a model.

Dialog Forms Called

None


R_LoadTextForChange

File Name

rchg_bf.kb

Syntax

R_LoadTextForChange: INTEGER IS

Parameters

None

Returns

Integer

Side Effects

None

Description

This routine retrieves extended text from the database for a change.

Dialog Forms Called

None


R_MakeRelationFromActivity

File Name

rchg_bf.kb

Syntax

R_MakeRelationFromActivity(REF this_Task: R_TASK_REC) IS

Parameters

this_Task - Created scheduled task

Returns

Nothing

Side Effects

None

Description

This routine creates a scheduled task for an activity.

Dialog Forms Called

None


R_MarkDoneHistoryForInvEffects

File Name

rchg_bf.kb

Syntax

R_MarkDoneHistoryForInvEffects IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine marks history for inventory effects as complete.

Dialog Forms Called

None


R_MassDefToInvEffect

File Name

rchg_bf.kb

Syntax

R_MassDefToInvEffect(VAL massDef: MassDefRec): R_INV_EFFECT_REC IS

Parameters

massDef - Current mass definition record

Returns

R_INV_EFFECT_REC

Side Effects

None

Description

This routine copies the inventory information to the inventory effect.

Dialog Forms Called

None


R_MergeInvEffect

File Name

rchg_bf.kb

Syntax

R_MergeInvEffect(VAL old: R_INV_EFFECT_REC, VAL new: R_INV_EFFECT_REC): R_INV_EFFECT_REC IS

Parameters

old - Old inventory effect record

new - New inventory effect record

Returns

R_INV_EFFECT_REC

Side Effects

None

Description

This routine merges old and new versions of an inventory effect.

Dialog Forms Called

None


R_MergeInvEffectAtrLists

File Name

rchg_bf.kb

Syntax

R_MergeInvEffectAtrLists(VAL oldList: LIST OF R_INV_EFFECT_ATR_REC, VAL newList: LIST OF R_INV_EFFECT_ATR_REC ): LIST OF R_INV_EFFECT_ATR_REC IS

Parameters

oldList - Old list of inventory effect attributes

newList - New list of inventory effect attributes

Returns

LIST OF R_INV_EFFECT_ATR_REC

Side Effects

None

Description

This routine merges lists of inventory effect attributes.

Dialog Forms Called

None


R_MergeInvEffectConLists

File Name

rchg_bf.kb

Syntax

R_MergeInvEffectConLists(VAL oldList: LIST OF R_INV_EFFECT_CON_REC, VAL newList: LIST OF R_INV_EFFECT_CON_REC ): LIST OF R_INV_EFFECT_CON_REC IS

Parameters

oldList - Old list of inventory effect contracts

newList - New list of inventory effect contracts

Returns

LIST OF R_INV_EFFECT_CON_REC

Side Effects

None

Description

This routine merges lists of contracts together.

Dialog Forms Called

None


R_MergeInvEffectHstLists

File Name

rchg_bf.kb

Syntax

R_MergeInvEffectHstLists(VAL oldList: LIST OF R_INV_EFFECT_HST_REC, VAL newList: LIST OF R_INV_EFFECT_HST_REC ): LIST OF R_INV_EFFECT_HST_REC IS

Parameters

oldList - List of planned events

newList - List of completed events

Returns

R_INV_EFFECT_HST_REC

Side Effects

None

Description

This routine merges history records (planned and completed).

Dialog Forms Called

None


R_MergeInvEffectLists

File Name

rchg_bf.kb

Syntax

R_MergeInvEffectLists(VAL oldList: LIST OF R_INV_EFFECT_REC, VAL newList: LIST OF R_INV_EFFECT_REC, VAL origDescription: STRING ): LIST OF R_INV_EFFECT_REC IS

Parameters

oldList - Old list of inventory effect "connections"

newList - New list of inventory effect "connections"

origDescription - original description

Returns

LIST OF R_INV_EFFECT_REC

Side Effects

None

Description

This routine merges lists of inventory effect "connections".

Dialog Forms Called

None


R_MergeInvEffectOnLists

File Name

rchg_bf.kb

Syntax

R_MergeInvEffectOnLists(VAL oldList: LIST OF R_INV_EFFECT_ON_REC, VAL newList: LIST OF R_INV_EFFECT_ON_REC ): LIST OF R_INV_EFFECT_ON_REC IS

Parameters

oldList - Old list of inventory effect "connections"

newList - New list of inventory effect "connections"

Returns

List of R_INV_EFFECT_ON_REC

Side Effects

None

Description

This routine merges lists of inventory effect contracts.

Dialog Forms Called

None


R_ModifyAllChangeIds

File Name

rchg_bf.kb

Syntax

R_ModifyAllChangeIds IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine modifies change IDs when copying.

Dialog Forms Called

None


R_NotifyFrozenApprovers

File Name

rchg_bf.kb

Syntax

R_NotifyFrozenApprovers( VAL status_type: STRING) IS

Parameters

status_type - status type

Returns

Nothing

Side Effects

None

Description

This routine sends a notification to all approvers for this change request who are currently eligible to approve. When a change request is set to a frozen or non-frozen status type, the user will understand that their approval either is or is not needed at this time.

Dialog Forms Called

None


R_NotifyFrozenTaskResources

File Name

rchg_bf.kb

Syntax

R_NotifyFrozenTaskResources( VAL status_type: STRING) IS

Parameters

status_type - status type

Returns

Nothing

Side Effects

None

Description

This routine notifies the task resources for a given change request that is has been altered to a status type of 'Frozen.'

Dialog Forms Called

None


R_ParseChangeText

File Name

rchg_bf.kb

Syntax

R_ParseChangeText IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This is an empty routine.

Dialog Forms Called

None


R_PerformActivityEditView

File Name

rchg_bf.kb

Syntax

R_PerformActivityEditView(VAL w: WINDOW, VAL field_Name: STRING) IS

Parameters

w - Current window

field_Name - Field name

Returns

Nothing

Side Effects

None

Description

This routine performs the editing and viewing of an activity.

Dialog Forms Called

rchg.dfc[change_notebook]


R_PerformChangeEditViewCopy

File Name

rchg_bf.kb

Syntax

R_PerformChangeEditViewCopy(VAL w: WINDOW, VAL field_Name: STRING, REF this_Request: R_CHANGE_REC) IS

Parameters

w - Current window

field_Name - Current field name

this_Request - Current change request

Returns

Nothing

Side Effects

None

Description

This routine is for managing the editing, viewing, and copying of changes.

Dialog Forms Called

rchg.dfc[qbe_copy]

rchg.dfc[change_notebook]


R_PerformImpactEditView

File Name

rchg_bf.kb

Syntax

R_PerformImpactEditView(VAL w: WINDOW, VAL field_Name: STRING) IS

Parameters

w - Current window

field_Name - Field name

Returns

Nothing

Side Effects

None

Description

This routine performs editing and viewing of an impact.

Dialog Forms Called

rchg.dfc[impact_notebook]


R_PerformInventoryEdit

File Name

rchg_bf.kb

Syntax

R_PerformInventoryEdit(VAL w: WINDOW) IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine performs Inventory editing.

Dialog Forms Called

None


R_PerformProblemAdd

File Name

rchg_bf.kb

Syntax

R_PerformProblemAdd(VAL w: WINDOW) IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine associates a problem to the change request.

Dialog Forms Called

None


R_PerformScheduleEditView

File Name

rchg_bf.kb

Syntax

R_PerformScheduleEditView(VAL w: WINDOW, VAL field_Name: STRING, VAL MCLB_Name: STRING, REF this_Request: R_CHANGE_REC) IS

Parameters

w - Current window

field_Name - Current field name

MCLB_Name - MCLB name

this_Request - Current change request

Returns

Nothing

Side Effects

None

Description

This routine is for managing the editing, viewing, and copying of tasks.

Dialog Forms Called

rchg.dfc[task_notebook]


R_PhysAttribToInvEffectAtr

File Name

rchg_bf.kb

Syntax

R_PhysAttribToInvEffectAtr(VAL pVal: R_PhysAttribRec ): R_INV_EFFECT_ATR_REC IS

Parameters

pVal - Current inventory attribute record

Returns

R_INV_EFFECT_ATR_REC

Side Effects

None

Description

This routine copies the physical attributes to an inventory effect.

Dialog Forms Called

None


R_ProcessChangeEntryFields

File Name

rchg_bf.kb

Syntax

R_ProcessChangeEntryFields(VAL w: WINDOW, VAL type: INTEGER) IS

Parameters

w - Current window

type - Type of interaction to R_Perform

Returns

Nothing

Side Effects

None

Description

This routine handles screen interactions with changes.

Dialog Forms Called

None


R_ProcessCopyEntryFields

File Name

rchg_bf.kb

Syntax

R_ProcessCopyEntryFields(VAL w: WINDOW, REF this_CopyChange: R_CHANGE_REC, VAL type: INTEGER) IS

Parameters

w - Current window

this_CopyChange - Current copy change record

type - Type of interaction to R_Perform

Returns

Nothing

Side Effects

None

Description

This routine handles the screen interactions with copying changes.

Dialog Forms Called

None


R_ProcessImpactEntryFields

File Name

rchg_bf.kb

Syntax

R_ProcessImpactEntryFields(VAL w: WINDOW, REF this_Impact: R_IMPACT_REC, VAL type: INTEGER) IS

Parameters

w - Current window

this_Impact - Current impact record

type - Type of interaction to R_Perform

Returns

Nothing

Side Effects

None

Description

This routine handles the screen interactions with impacts.

Dialog Forms Called

None


R_ProcessKeywordsEntryFields

File Name

rchg_bf.kb

Syntax

R_ProcessKeywordsEntryFields(VAL w: WINDOW, REF this_ImpKeyword: R_IMP_KEYWORD_REC, VAL type: INTEGER) IS

Parameters

w - Current window

this_ImpKeyword - Current impact keyword record

type - Type of interaction to R_Perform

Returns

Nothing

Side Effects

None

Description

This routine handles the screen interactions with impact keywords.

Dialog Forms Called

None


R_ProcessResourceEntryFields

File Name

rchg_bf.kb

Syntax

R_ProcessResourceEntryFields(VAL w: WINDOW, REF this_Resource: R_RESOURCE_REC, VAL type: INTEGER) IS

Parameters

w - Current window

this_Resource - Current resource record

type - Type of interaction to R_Perform

Returns

Nothing

Side Effects

None

Description

This routine handles the screen interactions with resources.

Dialog Forms Called

None


R_ProcessSchedCommandEntryFields

File Name

rchg_bf.kb

Syntax

R_ProcessSchedCommandEntryFields(VAL w: WINDOW, REF this_SchedCommand: R_SCHED_COMMANDS_REC, VAL type: INTEGER) IS

Parameters

w - Current window

this_SchedCommand - Current schedule command record

type - Type of interaction to R_Perform

Returns

Nothing

Side Effects

None

Description

This routine handles the screen interactions with schedule commands.

Dialog Forms Called

None


R_ProcessScheduleEntryFields

File Name

rchg_bf.kb

Syntax

R_ProcessScheduleEntryFields(VAL w: WINDOW, REF this_Task: R_TASK_REC, VAL type: INTEGER) IS

Parameters

w - Current window

this_Task - Current task record

type - Type of interaction to R_Perform

Returns

Nothing

Side Effects

None

Description

This routine handles the screen interactions with schedules.

Dialog Forms Called

None


R_ProcessStatusChangeAtEvents

File Name

rchg_bf.kb

Syntax

R_ProcessStatusChangeAtEvents(VAL w: WINDOW, VAL New_Status: STRING, VAL Old_Status: STRING, VAL Disposition: STRING): INTEGER IS

Parameters

w - Current window

New_Status - New status of the change

Old_Status - Previous status of the change

Disposition - Reason for the status change

Returns

Integer

Side Effects

None

Description

This routine executes the status change.

Dialog Forms Called

None


R_RemoveOldApproverInfo

File Name

rchg_bf.kb

Syntax

R_RemoveOldApproverInfo(VAL C_Index: INTEGER) IS

Parameters

C_Index - index

Returns

Nothing

Side Effects

None

Description

This routine removes old approver information.

Dialog Forms Called

None


R_RemoveOldModelInfo

File Name

rchg_bf.kb

Syntax

R_RemoveOldModelInfo IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine removes model information from the change.

Dialog Forms Called

None


R_ResolveassociatedProblems

File Name

rchg_bf.kb

Syntax

R_ResolveassociatedProblems(VAL w: WINDOW): INTEGER IS

Parameters

w - Current window

Returns

Integer

Side Effects

None

Description

This routine updates the problem status codes for all associated problems upon completion of a change request.

Dialog Forms Called

None


R_SaveSubordinateChangeRequests

File Name

rchg_bf.kb

Syntax

R_SaveSubordinateChangeRequests(REF activity_Status_Altered: BOOLEAN): INTEGER IS

Parameters

activity_Status_Altered - Captures whether the user chose to perform a cascade save

Returns

Integer

Side Effects

None

Description

This routine saves subordinate change requests.

Dialog Forms Called

None


R_ScheduleInList

File Name

rchg_bf.kb

Syntax

R_ScheduleInList(VAL schedules: LIST OF R_TASK_REC, VAL Sched_Name: STRING): BOOLEAN IS

Parameters

schedules - list of tasks

Sched_Name - Schedule name

Returns

Boolean

Side Effects

None

Description

This routine checks to see if the schedule has already been added to the list of Schedules in the change.

Dialog Forms Called

None


R_ScheduleLoopExists

File Name

rchg_bf.kb

Syntax

R_ScheduleLoopExists(VAL this_Dependency: R_DEPENDENCY_REC, VAL dependencyList: LIST OF R_DEPENDENCY_REC): BOOLEAN IS

Parameters

this_Dependency - Current dependency record

dependencyList - List of dependencies to check

Returns

Boolean

Side Effects

None

Description

This routine determines if task relationships would cause a scheduling loop.

Dialog Forms Called

None


R_SearchForKeywordsInChanges

File Name

rchg_bf.kb

Syntax

R_SearchForKeywordsInChanges( REF impItemsList: LIST OF R_IMP_ITEM_REC, REF chg_ia_description: STRING) IS

Parameters

impItemsList - List of changes found

Returns

Nothing

Side Effects

None

Description

This routine does impact analysis on changes.

Dialog Forms Called

None


R_SearchForKeywordsInProblems

File Name

rchg_bf.kb

Syntax

R_SearchForKeywordsInProblems( REF impItemsList: LIST OF R_IMP_ITEM_REC, REF chg_ia_description: STRING) IS

Parameters

impItemsList - List of problems found

chg_ia_description - description

Returns

Nothing

Side Effects

None

Description

This routine does impact analysis on problems.

Dialog Forms Called

None


R_SendHotNews

File Name

rchg_bf.kb

Syntax

R_SendHotNews(VAL w: WINDOW): INTEGER IS

Parameters

w - Current window

Returns

Integer

Side Effects

None

Description

This routine sends Hot News to the help desk.

Dialog Forms Called

None


R_SetControlsToViewMode

File Name

rchg_bf.kb

Syntax

R_SetControlsToViewMode(VAL w: WINDOW, VAL mode: INTEGER): BOOLEAN

Parameters

w - Current window handler

mode - View mode

Returns

Boolean

Side Effects

None

Description

Disables Change notebook controls when opening a change request in view mode.

Dialog Forms Called

None


R_SetImpactFieldsForModification

File Name

rchg_bf.kb

Syntax

R_SetImpactFieldsForModification(VAL w: WINDOW) IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine disables fields for the modification of impacts.

Dialog Forms Called

None


R_SetInvEffectTypeMask

File Name

rchg_bf.kb

Syntax

R_SetInvEffectTypeMask(VAL effect_type: INTEGER,VAL viewMode: BOOLEAN): INTEGER IS

Parameters

effect_type - Add|Update|Delete

viewmode - View mode

Returns

Integer

Side Effects

None

Description

This routine sets the inventory effect type mask.

Dialog Forms Called

None


R_SetScheduleFieldsForModification

File Name

rchg_bf.kb

Syntax

R_SetScheduleFieldsForModification(VAL w: WINDOW) IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine disables fields for modification in scheduled tasks.

Dialog Forms Called

None


R_SetViewModeForControls

File Name

rchg_bf.kb

Syntax

R_SetViewModeForControls(VAL w: WINDOW)

Parameters

w - Current window

Returns

None

Side Effects

None

Description

Sets change controls for view mode.

Dialog Forms Called

None


R_SubmitSubordinateChangeRequests

File Name

rchg_bf.kb

Syntax

R_SubmitSubordinateChangeRequests(REF activity_Status_Altered: BOOLEAN): INTEGER IS

Parameters

activity_Status_Altered - captures whether the user chose to perform a cascade save

Returns

Integer

Side Effects

None

Description

This routine submits subordinate change requests.

Dialog Forms Called

None


R_UnApply_Prev_Model

File Name

rchg_bf.kb

Syntax

R_UnApply_Prev_Model(VAL w: WINDOW, VAL newCategory: STRING, VAL oldModel_ID: INTEGER, VAL promptUser: BOOLEAN, VAL modelExists: BOOLEAN ): INTEGER IS

Parameters

w - Current window handle

newCategory - new category name

model_ID - model ID previously applied

promptUser - Indicates if the user should be prompted

modelExists - Boolean answering whether a previous model exists

Returns

Integer

Side Effects

None

Description

This routine removes the previous applied model from this change.

Dialog Forms Called

None


R_UnFreezeSubordinateRequests

File Name

rchg_bf.kb

Syntax

R_UnFreezeSubordinateRequests(VAL This_Status: R_STATUS_REC ): INTEGER IS

Parameters

This_Status - status record

Returns

Integer

Side Effects

None

Description

This routine takes a subordinate request (an activity) and changes the current status_id (should be of status type "Frozen") and sets it to the status ID passed-in (This_Status).

Dialog Forms Called

None


R_UpdateActivityToScheduleTasks

File Name

rchg_bf.kb

Syntax

R_UpdateActivityToScheduleTasks(VAL w: WINDOW, VAL field_Name: STRING, VAL type: INTEGER) IS

Parameters

w - Current window

field_Name - Name of the task MCLB

type - Type of scheduled task

Returns

Nothing

Side Effects

None

Description

This routine updates the scheduled task MCLB with an activity.

Dialog Forms Called

None


R_UpdateApprovalsList

File Name

rchg_bf.kb

Syntax

R_UpdateApprovalsList(VAL this_Approval: R_APPROVAL_REC) IS

Parameters

this_Approval - Current approval record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of approvals.

Dialog Forms Called

None


R_UpdateApproverInformation

File Name

rchg_bf.kb

Syntax

R_UpdateApproverInformation(VAL this_Disposition: STRING, VAL approver_ID: LIST OF STRING, VAL this_Status: R_STATUS_REC) IS

Parameters

this_Disposition - approver disposition

approver_ID - approver ID

this_Status - status record

Returns

Nothing

Side Effects

None

Description

This routine updates approver information.

Dialog Forms Called

None


R_UpdateAssocProblemList

File Name

rchg_bf.kb

Syntax

R_UpdateAssocProblemList(VAL this_AssocProblem: R_ASSOC_PROB_REC) IS

Parameters

this_AssocProblem - Current associated problem record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of associated problems.

Dialog Forms Called

None


R_UpdateChangeDisplay

File Name

rchg_bf.kb

Syntax

R_UpdateChangeDisplay(VAL w: Window) IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine updates the change display.

Dialog Forms Called

None


R_UpdateChangeList

File Name

rchg_bf.kb

Syntax

R_UpdateChangeList IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of changes.

Dialog Forms Called

None


R_UpdateDependencyList

File Name

rchg_bf.kb

Syntax

R_UpdateDependencyList(VAL this_Dependency: R_DEPENDENCY_REC) IS

Parameters

this_Dependency - Current dependency record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of dependencies.

Dialog Forms Called

None


R_UpdateImpactsList

File Name

rchg_bf.kb

Syntax

R_UpdateImpactsList(VAL this_Impact: R_IMPACT_REC) IS

Parameters

this_Impact - Current impact record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of impacts.

Dialog Forms Called

None


R_UpdateImpCategoryForAttached

File Name

rchg_bf.kb

Syntax

R_UpdateImpCategoryForAttached(REF this_Impact: R_IMPACT_REC, VAL old_Category: STRING) IS

Parameters

this_Impact - Current impact record

old_Category - Previous impact code

Returns

Nothing

Side Effects

None

Description

This routine updates the impact code for the impact component.

Dialog Forms Called

None


R_UpdateImpInvList

File Name

rchg_bf.kb

Syntax

R_UpdateImpInvList(VAL this_AffInv: R_IMP_INV_REC) IS

Parameters

this_AffInv - Current impact inventory record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of impact inventory.

Dialog Forms Called

None


R_UpdateImpItemsList

File Name

rchg_bf.kb

Syntax

R_UpdateImpItemsList(REF this_ImpItem: R_IMP_ITEM_REC) IS

Parameters

this_ImpItem - Current impact item record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of impact items.

Dialog Forms Called

None


R_UpdateImpKeywordsList

File Name

rchg_bf.kb

Syntax

R_UpdateImpKeywordsList(VAL this_ImpKeyword: R_IMP_KEYWORD_REC) IS

Parameters

this_ImpKeyword - Current impact keyword record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of impact keywords.

Dialog Forms Called

None


R_UpdateMCLBFromModel

File Name

rchg_bf.kb

Syntax

R_UpdateMCLBFromModel(VAL w: WINDOW, VAL fieldName: STRING, VAL type: INTEGER) IS

Parameters

w - Window handle of MCLB

fieldName - MCLB control name

type - Approvals, Schedules, Impacts or Activities

Returns

Nothing

Side Effects

None

Description

This routine updates an MCLB from a model.

Dialog Forms Called

None


R_UpdateMCLBWithStatus

File Name

rchg_bf.kb

Syntax

R_UpdateMCLBWithStatus(VAL w: WINDOW, VAL controlName: STRING) IS

Parameters

w - Handle of the window

controlName - Name of the MCLB

Returns

Nothing

Side Effects

None

Description

This routine updates the rows in an MCLB for a status change.

Dialog Forms Called

None


R_UpdateResourceList

File Name

rchg_bf.kb

Syntax

R_UpdateResourceList(VAL this_Resource: R_RESOURCE_REC) IS

Parameters

this_Resource - Current resource record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of resources.

Dialog Forms Called

None


R_UpdateSchedCommandList

File Name

rchg_bf.kb

Syntax

R_UpdateSchedCommandList(VAL this_SchedCommand: R_SCHED_COMMANDS_REC) IS

Parameters

this_SchedCommand - Current schedule command record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of schedule commands.

Dialog Forms Called

None


R_UpdateSchedInvList

File Name

rchg_bf.kb

Syntax

R_UpdateSchedInvList(VAL this_SchedInv: R_TASK_INV_REC) IS

Parameters

this_SchedInv - Current schedule inventory record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of schedule inventory.

Dialog Forms Called

None


R_UpdateSchedNameForAttached

File Name

rchg_bf.kb

Syntax

R_UpdateSchedNameForAttached(REF this_Task: R_TASK_REC, VAL old_Sched_Name: STRING) IS

Parameters

this_Task - Current task record

old_Sched_Name - Previous task name

Returns

Nothing

Side Effects

None

Description

This routine updates the scheduled task name for the scheduled task component.

Dialog Forms Called

None


R_UpdateScheduleList

File Name

rchg_bf.kb

Syntax

R_UpdateScheduleList(VAL this_Task: R_TASK_REC) IS

Parameters

this_Task - Current task record

Returns

Nothing

Side Effects

None

Description

This routine handles the addition, modification and deletion of scheduled tasks.

Dialog Forms Called

None


R_UpdateTimeEntryValue

File Name

rchg_bf.kb

Syntax

R_UpdateTimeEntryValue(VAL w: WINDOW,VAL field_Name: STRING, REF field_Value: TIME, REF Alter_Flag: INTEGER) IS

Parameters

w - Current window

field_Name - Name of field to extract

field_Value - Value of field

Alter_Flag - What state the new field has

Returns

Nothing

Side Effects

None

Description

This routine updates the value for a time entry field.

Dialog Forms Called

None


R_VerifyApprover

File Name

rchg_bf.kb

Syntax

R_VerifyApprover(REF approverID: LIST OF STRING): BOOLEAN IS

Parameters

approverID - List of approvals for which the current user is responsible

Returns

Boolean

Side Effects

None

Description

This routine verifies that the current user is an approver for this change.

Dialog Forms Called

None


R_VerifyStatusChangeAtEvents

File Name

rchg_bf.kb

Syntax

R_VerifyStatusChangeAtEvents(VAL w: WINDOW, VAL New_Status: STRING, VAL Old_Status: STRING): INTEGER IS

Parameters

w - Window handle of the current window

New_Status - New status to check

Old_Status - Previous status of the change

Returns

Integer

Side Effects

None

Description

This routine verifies that a proper status change took place.

Dialog Forms Called

None


R_ViewChange

File Name

rchg_bf.kb

Syntax

R_ViewChange(Val ChangeID: INTEGER, REF Result: INTEGER ) IS

Parameters

ChangeID - Change ID

Result - 0 = Fails, 1= Succeeds

Returns

Nothing

Side Effects

The ChangeID must be a valid change ID.

Description

This routine opens the Change notebook in view mode.

Dialog Forms Called

rchg.dfc[change_notebook]