LOAD: Keywords and Values (KCMS Test Suite User's Guide)

KCMS Test Suite User's Guide

`LOAD:` Keywords and Values

Table 3-9 presents the LOAD: command keywords and their descriptions.

Table 3-9 LOAD: Command Keywords


Keyword	Description
`Reference=`	Is the name that this profile will be referred to in subsequent script commands. In the context of the test script, it is the profile name.
`Profile=`	Is the file name of the profile. All profiles must be located in the `kcmstest/profiles` directory. This keyword may name a pre-made profile or a profile that is created as part of the test script.
`Handling=`	Describes how the profile will be handled. This keyword has the values listed in Table 3-10.
`LoadHint=`	Defines the load hint that will be used to load the profile. This keyword has the values listed in Table 3-11. 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 command. Multiple load hints are logically OR'd together.
`Operation=`	Defines the operation load hint that will be used to load the profile. This keyword has the operation and content hint values listed in Table 3-12. In the table, the keyword 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 operations are logically OR'd together.
`KcsDisplay=`	Is the X Window System display (display:screen) number in the form of 0.0, 0.1, and so forth. Use this keyword for multiheaded systems.
`KcsHost=`	Is the host name of the workstation from which a profile is to be read. You must have the `kcms_server`(1) daemon running to access another host through the network.
`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-10 presents the LOAD: command Handling= keyword values.

Table 3-10 LOAD: Command Handling= Keyword Values


Value	Description
`File`	Sets `Desc.type = KcsFileProfile`
`KcsSolarisFile`	Sets `Desc.type = KcsSolarisProfile`
`KcsWindow`	Sets `Desc.type = KcsWindowProfile`
`Memory`	Sets `Desc.type = KcsMemoryProfile`

Table 3-11 presents the LOAD: command LoadHint= keyword values.

Table 3-11 LOAD: 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-12 presents the LOAD: command Operation= keyword values.

Table 3-12 LOAD: Command Operation= Keyword Values


Value	Load Hint Set
`OpsAll`	`KcsOpAll`
`ContUnkn`	`KcsContUnknown`
`Graphics`	`KcsContGraphics`
`Image`	`KcsContImage`
`ColorMtrc`	`KcsContColorimetric`
`ContAll`	`KcsContAll`