test

KCMS Test Suite User's Guide

MODIFYLH:

MODIFYLH: Command Description

MODIFYLH: functionality corresponds to the KcsModifyLoadHints()() call. When this command is interpreted, the KcsModifyLoadHints()() function is executed and the status is reported back from the kcmstest command display to the test log. This command is commonly used when a profile has previously been loaded for attributes only. It allows the rest of the profile to be loaded.

MODIFYLH: Command Syntax Example

MODIFYLH:Reference=connected; LoadHint=LoadAllNow;

MODIFYLH: Keywords and Values

Table 3-13 presents the MODIFYLH: command keywords and their descriptions.

Table 3-13 MODIFYLH: Command Keywords

Keyword 

Description 

Reference=

Is the name that was assigned when the profiles were loaded, created, or connected.  

LoadHint=

Defines the load hint that will be used to load the profile. This keyword has the values shown in Table 3-14 . In the table, the keyword value is followed by the corresponding value set in the loadHints parameter passed to the KcsLoadProfile()() function. A LoadHint= keyword can appear more than once in a single script file. Multiple load hints are logically OR'd together.

Operation=

Defines the operation load hint that will be used to connect the new profile. This keyword has the operation and content hint values shown in Table 3-15 . In the table, the keyword value is followed by the corresponding value set in the loadHints parameter passed to the KcsLoadProfile()() function. An Operation= keyword can appear more than once in a single script command. Multiple load hints are logically OR'd together.

XStatus=

The default expected status is KcsSuccess. If the script command is expected to complete successfully, the XStatus= keyword is not required. In cases where a script command is expected to return a non-success status, the keyword is followed by the corresponding expected, non-success status in hexadecimal format.

Table 3-14 presents the MODIFYLH: command LoadHint= keyword values.

Table 3-14 MODIFYLH: Command LoadHint= Keyword Values

Value 

Load Hint Set 

AllNow

KcsLoadAllNow

AllWhen

KcsLoadAllWhenNeeded

LoadAttr

KcsLoadAttributeNow

MinMem

KcsLoadMinimalMemory

PurgeMem

KcsPurgeMemoryNow

LoadWhenNever

KcsLoadNever

LoadWhenNow

KcsLoadNow

LoadWhenNeeded

KcsLoadWhenNeeded

LoadWhenIdle

KcsLoadWhenIdle

UnloadWhenNow

KcsUnloadNow

UnloadWhenFree

KcsUnloadWhenFreed

UnloadWhenNeeded

KcsUnloadWhenNeeded

UnloadAfter

KcsUnloadAfterUse

WhatAttr

KcsAttributes

WhatAll

KcsAll

WhatEffects

KcsEffect

Table 3-15 presents the MODIFYLH: command Operation= keyword values.

Table 3-15 MODIFYLH: Command Operation=Keyword Values

Value 

Load Hint Set 

OpsAll

KcsOpAll

ContUnkn

KcsContUnknown

Graphics

KcsContGraphics

Image

KcsContImage

ColorMtrc

KcsContColorimetric

ContAll

KcsContAll