Routines for d_svcs.kb


AddTSD390WrkHist

File Name

d_svcs.kb

Syntax

AddTSD390WrkHist ( VAL CustomData: VRType, VAL descriptionText: STRING ): INTEGER

Parameters

CustomData - problem data for work history

descriptionText - STRING TSD390 freeform text field

Returns

return code

Side Effects

None

Description

This procedure creates work history records based on TSD390 transfer.

Dialog Forms Called

None


FindDataview

File Name

d_svcs.kb

Syntax

FindDataview ( VAL transactionType: INTEGER, VAL site_id: STRING ): STRING

Parameters

transactionType - ransaction being performed

site_id - source site_id

Returns

dataview name

Side Effects

None

Description

This function returns the dataview name based on the transaction type and site ID.

Dialog Forms Called

None


LoadFieldNames

File Name

d_svcs.kb

Syntax

LoadFieldNames ( REF CustomData: VRType, REF strList: List of STRING)

Parameters

CustomData - extended Data that contains the names of the fields in the dataview

strList - list of strings in which to load the field names

Returns

None

Side Effects

This procedure is dependent on the format of data from the host computer containing a field description flag in the 33 position, and the distributed data being in .ini file format.

Description

This procedure loads the field names into a list of string. It searches the data value to determine if the value is a valid field type.

Dialog Forms Called

None


PerformAPICall

File Name

d_svcs.kb

Syntax

PerformAPICall ( VAL transType: INTEGER, VAL site_id: INTEGER, REF CustomData: VRType ): INTEGER

Parameters

transType -integer that contains the transaction

site_id - Site_id to identify the source to use

CustomData - VRType record containing data to be passed through the API call

Returns

RetCode from the API being called

Side Effects

None

Description

This function performs the appropriate API call given the transaction type, site ID and data to be passed.

Dialog Forms Called

None


ProcessMappedAPIRequest

File Name

d_svcs.kb

Syntax

ProcessMappedAPIRequest ( VAL Transaction: INTEGER, REF SendListInfo: LIST OF ExtendedData ): INTEGER

Parameters

Transaction - type of transaction as defined in d_gconst

SendListInfo - list of Extended Data records containing body of the API request

Returns

An integer Success/Failure return code

Side Effects

This function requires that the trmap100.dll is located in the ASE_PATH.

Description

This function passes the request to the Tivoli Script do_ function defined in trmap100.dll, which evaluates the transaction type and passes the request on to the host API or the distributed C API.

Dialog Forms Called

None


ReadHostIniInfo

File Name

d_svcs.kb

Syntax

ReadHostIniInfo: INTEGER

Parameters

None

Returns

ret: INTEGER Success or Fail of IniRead

Side Effects

This function fills the global host control data list.

Description

This function initializes the global host control data list, then performs reads on the .ini file to assign a value for the specific control data.

Dialog Forms Called

None


SendDataToHost

File Name

d_svcs.kb

Syntax

SendDataToHost ( REF CustomData:VRType , VAL condition: STRING, transactionType: INTEGER, site_id: STRING ): INTEGER

Parameters

CustomData - VRType record containing data to be passed through the API call

condition - string with the condition used to retrieve the data

Returns

RetCode indicating the success of the query

Side Effects

This routine can only be used to return a single row of data

Description

This function creates and loads a VRType record with the data from the custom table and calls the appropriate API to send the data to the host.

Dialog Forms Called

None


SendWrkHistToHost

File Name

d_svcs.kb

Syntax

SendWrkHistToHost ( REF CustomData:VRType , VAL condition: STRING, VAL transactionType: INTEGER, VAL site_id: STRING ): INTEGER IS

Parameters

CustomData - VRType record containing data to be passed through the API call

condition - string with the condition used to retrieve the data

Returns

RetCode indicating the success of the query

Side Effects

This routine loads all work history into one string and passes that string through the desc_ovrflw field.

Description

This function creates and loads a VRType record with the data from the work history table and sends it to the host using the appropriate API call.

Dialog Forms Called

None


UnlockRecord

File Name

d_svcs.kb

Syntax

UnlockRecord ( VAL TransType: INTEGER, VAL User: UsersRecord, VAL Problem: ProblemRecord, VAL site_id: STRING )

Parameters

TransType - the net connection to the client

Returns

None

Side Effects

None

Description

Unlocks a host user record after server recieves data.

Dialog Forms Called

None