Routines for tiv_mig.kb


AddMigrationScheduleEntry

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


AddRollback

File Name

tiv_mig.kb

Syntax

None

Parameters

trans: The transaction totals.

grand: The grand totals.

Returns

The updated rand record structure.

Side Effects

None

Description

Adds the roolback transactions for each type of table.

Dialog Forms Called

None


AddTransactionTotals

File Name

tiv_mig.kb

Syntax

None

Parameters

trans: The transaction totals.

grand: The grand totals.

Returns

The updated rand record structure.

Side Effects

None

Description

Adds the transaction totals from a Tivoli Inventory Migration transaction to the grand totals.

Dialog Forms Called

None


CheckToEnableButtons

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

Determines of the MigrationButton and FindButton should be enabled. This is called when any of the Entities to Migrate or Processing Option checkboxes is exited. If at least one Entity, one Processing Option is checked and there is at least one record in the MCLB, the MigrateButton is enabled. It is also called when the DataSource and Tivoli Release fields are exited.

Dialog Forms Called

None


FillTivoliLists

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

Populates lists required for Tivoli Migration.

Dialog Forms Called

None


FillWindowDataFromSettingsFile

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


FindListIndex

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


GetWindowData

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


InitializeVariables

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


IterateThruMigrationList

File Name

tiv_mig.kb

Syntax

None

Parameters

ErrorInMigration

migrationList

Returns

None

Side Effects

None

Description

Migrates the records in the migration list from Tivoli's Inventory System to Tivoli Asset Management. Also Migrates People and Locations if those options are enabled on the migration definition dialog.

Dialog Forms Called

None


OfferToScheduleSMS

File Name

tiv_mig.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


PopulateExternalMapControlValues

File Name

tiv_mig.kb

Syntax

None

Parameters

The EXTERNAL_MAP table.

Returns

The updated EXTERNAL_MAP record.

Side Effects

None

Description

Populates the contral columns of the EXTERNAL_MAP record. these are the values that are always populated regardless of the type of EXTERNAL_MAP record being created. The values specific to each type of map record should be mapped in the calling function.

Dialog Forms Called

None


PopulateInvRec

File Name

tiv_mig.kb

Syntax

None

Parameters

The is_inventory record. The current MigrationList Record.

The mapping options for Asset Tag and Alternate Tag.

Returns

The updated EXTERNAL_MAP record.

Side Effects

None

Description

Populates the Inventory Record according to the mapping options defined in the Migration definition dialog. The values are obtained from the current migration list record

Dialog Forms Called

None


RequestTivoliMigration

File Name

tiv_mig.kb

Syntax

RequestTivoliMigration

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure is initialized the environment variables and calls the event handler for the Tivoli Migration dialog. Used as a system action from the toolbar.

Dialog Forms Called

tiv_mig.dfc[migration]


SetEntryFields

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


SortSettingsFileList

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


StartStopRangeOK

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

True is values are valid, false if they are not.

Side Effects

None

Description

Ensures that the StartMachine # is less then the StopMachine #.

Dialog Forms Called

None


TIV_Initialize

File Name

tiv_mig.kb

Syntax

None

Parameters

w - Current window handle.

Returns

None

Side Effects

None

Description

Initialize all fields in the dialog to their default value.

Dialog Forms Called

None


TIV_Initialize_From_Datasource

File Name

tiv_mig.kb

Syntax

None

Parameters

w - Current window handle.

Returns

None

Side Effects

None

Description

Initialize all fields in the dialog to reflect data from the selected datasource.

Dialog Forms Called

None


TIV_MigrationSetupEvent

File Name

tiv_mig.kb

Syntax

TIV_MigrationSetupEvent

Parameters

None

Returns

Nothing

Side Effects

None

Description

Event handler for defining the Tivoli migration options and for invoking the migration process itself. This provides a way to schedule a migration, save and open a migration setting, print migration options and interactively run a migration using a GUI interface.

Dialog Forms Called

None


TIV_SettingsEvent

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


TIV_Update

File Name

tiv_mig.kb

Syntax

TIV_Update

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure is called from the scheduler. It is used as a system action but will not bring up any gui related to the migration process. This procedure bypasses any gui related functionality but provides and call the same functionality that is seen in the GUI version of the Tivoli Inventory migration.

Dialog Forms Called

None


TIVRecordTransaction

File Name

tiv_mig.kb

Syntax

None

Parameters

msglist: The list of messages.

return_code: The return code of the last transaction.

action: A string indicating the attempted action. The standard

is for the calling routine to use the format

<action attempted>: <identifiers>

Returns

The updated msglist

Side Effects

None

Description

Formats input parameters into standard message line and adds it to the passed in message list.

Dialog Forms Called

None


TIVResetTotals

File Name

tiv_mig.kb

Syntax

None

Parameters

total_rec: The TivoliTotals record.

Returns

The updated TivoliTotals record.

Side Effects

None

Description

Accepts the TivoliTotals record as input and resets all columns to zero.

Dialog Forms Called

None


TIVWriteMessagesToLog

File Name

tiv_mig.kb

Syntax

None

Parameters

msglist: The list of messages.

Returns

None

Side Effects

None

Description

Accepts a list of messages that were built during the migration of one Tivoli asset, and its related People and Locations, and records them in the message log. columns to zero.

Dialog Forms Called

None


TIVWriteMigHeader

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

Writes a record to the log file indicating the date and time the Tivoli migration started and the selected migration options.

Dialog Forms Called

None


TIVWriteMigSummary

File Name

tiv_mig.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

Writes a record to the log file indicating the date and time the Tivoli migration completed and the summary totals for the different transaction types.

Dialog Forms Called

None