LOAD: functionality corresponds to the KcsLoadProfile() call. When this command is interpreted, the KcsLoadProfile() function is executed and the status is reported back from the kcmstest command display to the test log.
LOAD:Reference=scanner; Profile=clc500fs.inp; Handling=File; LoadHint=AllNow;
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 |