BSP Developer's Guide

6
Components
The _CHILDREN property declares that INCLUDE_FOO is a child component of
folder FOLDER_ROOT. The prepended underscore (“_”) serves to reverse the
relationship declared by the property CHILDREN. You can also use _DEFAULTS in
conjunction with _CHILDREN to specify a component as a default component of a
folder. For more information about this CDL convention, see 6.4 Releasing
Components, p.135.
If you think a component is becoming too complex, you can divide it into a set of
components assigned to a folder or selection object. In the following example,
INCLUDE_FOO has been specified as part of a selection. You can add or remove the
group from your configuration as a unit rather than by its individual components.
For folders, the DEFAULTS property specifies the base set of components that are
included if the group is configured without any overrides.
For selections, the DEFAULTS property specifies the components that are included
to satisfy the count (declared by the COUNT property), if you provide no
alternative values.
In a selection group, the COUNT property specifies the minimum and maximum
number of included components. If the user exceeds these limits the system flags
the selection as misconfigured.
6
Selection SELECT_FOO {
NAME
Foo type
SYNOPSIS Select the type of desired FOO support
COUNT 0-1
CHILDREN INCLUDE_FOO_TYPE1 \
INCLUDE_FOO_TYPE2 \
INCLUDE_FOO_TYPE3
DEFAULTS INCLUDE_FOO_TYPE1
}
Step 10:
Create a Dummy Component
The project facility analyzes archives only when they are associated with included
components. This creates a chicken and egg problem: in order to know about a
particular archive, the project facility would need to analyze components before
they are actually added. In other words, if you add a component declared with an
ARCHIVE property, the configuration analysis is done without knowing what the
value of ARCHIVE is. So, if your component includes an archive with several object
modules, you should create a dummy component that is always included, making
it possible for the project facility to know that a new archive should be read. Call
such a component INSTALL_FOO. It should contain only NAME, SYNOPSIS, and
ARCHIVE properties. The user cannot add other components from the same
archive until INSTALL_FOO is added.
133