KCMS Test Suite User's Guide

In This Chapter

This chapter describes each test script in the KCMS test suite. The chapter groups the test scripts into the categories listed in Table 4-1 and presents them in the order shown (that is, loading profiles is presented first, connecting profiles second, and so forth).

Test Script Categories

Table 4-1 shows the KCMS API function name and the corresponding script command name that is used by the kcmstest utility. When describing a function being performed, this chapter uses the test script command name.

Table 4-1 Test Script Categories


Category	KCMS "C" API Function	Script Command
Loading profiles	`KcsLoadProfile()()`	`LOAD:`
Connecting profiles	`KcsConnectProfile()()`	`CONNECT:`
Evaluating profiles	`KcsEvaluateProfile()()`	EVAL:
Optimizing profiles	`KcsOptimizeProfile()()`	`OPTIMIZE:`
Modifying load hints	`KcsModifyLoadHints()()`	See "Cross-Category API Functions And Script Commands" .
Saving profiles	`KcsSaveProfile()()`	See "Cross-Category API Functions And Script Commands" .
Getting attributes Setting attributes	`KcsGetAttribute()()` `KcsSetAttribute()()`	`GETATTR:` `SETATTR:`
Updating profiles	`KcsUpdateProfile()()`	`UPDATE:`
Freeing profiles	`KcsFreeProfile()()`	See "Cross-Category API Functions And Script Commands" .
Enhancements	No particular function; tests new features and bug fixes

Cross-Category API Functions And Script Commands

The KcsAvailable()(), KcsCreateProfile()(), KcsFreeProfile()(), KcsModifyLoadHints()(), KcsSaveProfile()(), and KcsSetCallback()() functions in the KCMS framework API are not addressed directly as a testing category in a single script. Each of these functions is exercised in the course of performing normal testing.

KcsCreateProfile() (CREATE: command) is called to generate an empty profile that can be used by subsequent script commands such as GETATTR:, SETATTR:, and UPDATE:.
KcsFreeProfile()() (FREE: command) is called in each test script where a profile is loaded, connected, or created. This is the expectation of the KCMS framework.
KcsModifyLoadHints()()(MODIFYLH: command) typically is called to load the rest of a profile previously loaded for attributes only. It is called in the IC_lhints.scr script.
KcsSaveProfile()() (SAVE: command) is performed and tested in several of the script categories listed in Table 4-2 .
KcsSetCallback()() is called in the EVAL:, UPDATE:, and OPTIMIZE: script commands whose operation is expected to take an extended period of time.

In addition, the LOG: command is not associated with a particular KCMS API function. Instead it serves to show comment data in the test scripts.

Table 4-2 Testing the SAVE: Command


Category	Script Name
Connecting Profiles	`IC_conerr.scr`
Getting and Setting Attributes	`IC_attr1.scr`
Updating Profiles	`IC_update1.scr`, `IC_update2.scr`
Enhancements	`IC_gray.scr`, `IC_pacbug.scr`, `IC_sun_update.scr`, `IC_updatewin.scr`, `IC_xprofilesav.scr`, `IC_xprofilesavremote.scr`, `IC_xprofilesavroot.scr`

For More Information on API Functions

This chapter summarizes the testing of the KCMS API functions. Operation of a function is described only where it is necessary to describe the associated testing. For a detailed function descriptions, see the KCMS SDK manual KCMS Application Developer's Guide.

Note -

Many of the images resulting from EVAL: calls are not saved. This is only to limit the amount of disk space used by the test suite. See "EVAL: Keywords and Values" (ImageOut= keyword) for details on how to save the resulting image.