Routines for pd_svcs.kb


AID_TextCreateSearchString

File Name

pd_svcs.kb

Syntax

PROCEDURE AID_TextCreateSearchString(REF WhereStr: STRING, VAL Aid: AidRecord, VAL TextCols: LIST OF STRING);

Parameters

WhereStr - SQL + Fulcrum Where clause returned by

the function.

SolutionRecord - A AID Record that contains the

criteria to use in building the where clause.

TextCols - A list of AID column names that should

be used for text retieval.

Returns

Nothing

Side Effects

None

Description

This function builds a SQL where clause from a given AID record. It performs FULCRUM Text syntax substitution for the columns specified in the TextCols list.

Dialog Forms Called

None


AidtoSolution

File Name

pd_svcs.kb

Syntax

AidtoSolution ( AidRecord, SolutionsRecord);

Parameters

AidRecord - Record holding information relating to a

Diagnostic Aid

SolutionsRecord - Record holding information relating to

a solution.

Returns

Nothing

Side Effects

None

Description

This function converts information in a AidRecord to solution information.

Dialog Forms Called

None


DeleteDiagnosticAid

File Name

pd_svcs.kb

Syntax

FUNCTION DeleteDiagnosticAid ( VAL aid: AidRecord ): INTEGER;

Parameters

AidRecord - The record holding the Diagnostic Aid info

to delete.

Returns

INTEGER - Return values for the SQLDelete / SQLUpdate

Side Effects

None

Description

This function will delete a Diagnostic Aid record from the database. It will not delete the solution, but will set it to inactive if there are no other Diagnostic Aids or Hypernodes referencing it.

Dialog Forms Called

None


DoCommonProblemInquiry

File Name

pd_svcs.kb

Syntax

FUNCTION DoCommonProblemInquiry: BOOLEAN;

Parameters

None

Returns

BOOLEAN - TRUE = Display Inquiry screen automatically.

Side Effects

None

Description

This function returns TRUE if the Common Problem Inquiry screen is to be displayed automatically.

Dialog Forms Called

None


DoErrorMessageInquiry

File Name

pd_svcs.kb

Syntax

FUNCTION DoErrorMessageInquiry: BOOLEAN;

Parameters

None

Returns

BOOLEAN - TRUE = Display Inquiry screen automatically.

Side Effects

None

Description

This function returns TRUE if the Error Message Inquiry screen is to be displayed automatically.

Dialog Forms Called

None


DoHotNewsInquiry

File Name

pd_svcs.kb

Syntax

FUNCTION DoHotNewsInquiry: BOOLEAN;

Parameters

None

Returns

BOOLEAN - TRUE = Display Inquiry screen automatically.

Side Effects

None

Description

This function returns TRUE if the Hot News Inquiry screen is to be displayed automatically.

Dialog Forms Called

None


DoSolutionsInquiry

File Name

pd_svcs.kb

Syntax

FUNCTION DoSolutionsInquiry: BOOLEAN;

Parameters

None

Returns

BOOLEAN - TRUE = Display Inquiry screen automatically.

Side Effects

None

Description

This function returns TRUE if the Solutions Inquiry screen is to be displayed automatically.

Dialog Forms Called

None


InquireDictionary

File Name

pd_svcs.kb

Syntax

FUNCTION InquireDictionary ( VAL mainWindow: WINDOW, VAL messageWindow: WINDOW, REF word: DictionaryViewRecord, VAL doInquiry: BOOLEAN, VAL doSelect: BOOLEAN, VAL doWorkWith: BOOLEAN, REF dlgHdl: WINDOW): INTEGER;

Parameters

mainWindow - The main window to receive system-wide messages

messageWindow - Message Window or the direct parent to this

window.

word - The reference parameter that will

accept the dictionary info if one is

selected

doInquiry - Display and process the Vendor Inquiry screen

doSelect - Allow a record to be selected from the Work

with process

doWorkWith - Display and process the Vendor Work with

Screen

dlgHdl - This is teh handle of the created window.

Returns

INTEGER - Last return value from the dialog creation

process. It the Work with screen is displayed

will return the value from the DlgCreate() else

will return the value from the Inquiry

DlgBox().

Side Effects

None

Description

This function is used to display and process the Dictionary Inquiry and Dictionary Work with screens. If the Inquiry flag is TRUE will process the Inquiry and create a SQL search string based on the values entered. If the Work with flag is TRUE will display the Work with screen with either all the words ( Inquiry flag = FALSE ) or a list of words matching the search criteria entered in the Inquiry screen ( Inquiry flag = TRUE ).

Dialog Forms Called

dctnry.dfc[dictionary_inquiry]

dctnry.dfc[workwithdictionary]


InquireSolutions

File Name

pd_svcs.kb

Syntax

FUNCTION InquireSolutions ( VAL mainWin: WINDOW, VAL msgWin: WINDOW, REF sol: SolutionsRecord, VAL doInquiry: BOOLEAN, VAL doSelect: BOOLEAN, VAL doWorkWith: BOOLEAN, REF solWin: WINDOW): INTEGER;

Parameters

mainWin - The main window to receive system-wide messages

msgWin - Message Window or the direct parent to this

window.

sol - The reference parameter that will accept

the Solution information if one is selected.

doInquiry - Display and process the Solution Inquiry screen

doSelect - Allow a record to be selected from the Work

with process

doWorkWith - Display and process the Solutions Work with

Screen

solWin - The handle of the solution window.

Returns

INTEGER - Last return value from the dialog creation

process. If the Work with screen is displayed

it will return the value from the DlgCreate() else

it will return the value from the Inquiry

DlgBox().

Side Effects

None

Description

This function is used to display and process the Solution Inquiry and Solution Work with screens. If the Inquiry flag is TRUE it will process the Inquiry and create a SQL search string based on the values entered. If the Work with flag is TRUE will display the Work with screen with either all the Solutions ( Inquiry flag = FALSE ) or a list of Solutions matching the search criteria entered in the Inquiry screen ( Inquiry flag = TRUE ). If the user is allowed to select values then the SolutionRecord will be populated with the Solution information selected by the user.

Dialog Forms Called

solution.dfc[solutions_inquiry]

solution.dfc[workwithsolutions]


InvalidateKeyWordList

File Name

pd_svcs.kb

Syntax

PROCEDURE InvalidateKeyWordList;

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure invalidates the KeyWord list so it will be refreshed from the DB the next time GetKeyWordList is called.

Dialog Forms Called

None


SOL_TextCreateSearchString

File Name

pd_svcs.kb

Syntax

PROCEDURE SOL_TextCreateSearchString(REF WhereStr: STRING, VAL Sol: SolutionsRecord, VAL TextCols: LIST OF STRING);

Parameters

WhereStr - SQl + Fulcrum Where clause returned by

the function.

SolutionRecord - A Solution Record that contains the

criteria to use in building the where clause.

TextCols - A list of SOLUTION column names that should

be used for text retieval.

Returns

Nothing

Side Effects

None

Description

This function builds a SQL where clause from a given SOLUTION record. It performs FULCRUM Text syntax substitution for the columns specified in the TextCols list.

Dialog Forms Called

diagwin.dfc[picknode]

solution.dfc[chooseaid]

common.dfc[aidnotebook]

hotnews.dfc[aidnotebook]

error.dfc[aidnotebook]