The component query script (cqs),
located in SSOroot/cntl/cqs,
is responsible for prompting the user for information
and then passing that input to the ccs.
utility calls the cqs
during installations and upgrades, but not during removals.
The cqs takes two arguments:
The keyword_list is a space-separated list of one or more
keywords that apply to the current query being performed
by the cqs:
Upgrades an older version of an SSO-based component to
the new version of an SSO-based component (installation only).
Upgrades an old-custom component to an SSO component.
The cqs is running on the CPU of the target system
and can query the kernel or take other actions to provide the user
with intelligent defaults.
The cqs is running with a root directory
equal to the root directory of the target system.
TRUE_CLIENT_ROOT is always specified when FOR_LOCAL_CLIENT
this keyword might be specified alone if the cqs is running
on the server system of a diskless client,
but with a
area specified that is equal to the real root of the client.
The package_list is a space-separated list of the
fully-qualified package names in the component.
Package names are in the form:
To use the simpler package instead,
use the getPackageCode function in the
Note that packages are listed if any of its subpackages are selected,
but this does not mean that a package is fully selected.
Component query scripts should exit with one of the following values:
script executed successfully.
script execution was unsuccessful and the installation or removal is aborted;
the user can choose to STOP the component.
script execution logged warnings, but the installation or removal proceeded;
the user can choose to STOP or continue the component.
script stopped processing on this component
(the component is left in the state it was in when the cqs
but continued other component installation without user intervention.
The following limitations apply to cqs operation:
Do not use the cqs to perform configuration;
use ccs instead.
The cqs cannot alter any files except those in the
Make sure that the cqs can take its own output as input,
to allow users to install multiple targets with the same input values.
Make sure that the cqs can run in different modes
at different times during the installation.
The cqs always runs prior to the PRE_ATTACH step of
The cqs can only reference files in the component's
The cqs can only reference utilities that are
either part of the component itself or are located in
the /ibin directory.
The cqs only allows character-based tty I/O.
Use the FOR_LOCAL_CLIENT and TRUE_CLIENT_ROOT to tell
the cqs whether it is running on the target CPU
and has access to the target root filesystem
so that it can query the system hardware for default settings.
However, if neither keyword is specified,
the cqs must be able to run on another system,
without accessing the target root filesystem.
During an upgrade,
when the cqs receives either the UPGRADE or
the ccs should run non-interactively and save any old
configuration information in the directory specified by the
``Component script environment variables'' in Developer's Topics
for more information on CCS_PERSISTENT_STORAGE.