<Catalog> element
The <Catalog> element indicates the name of the catalog file that contains the definitions for the child <Parameter> elements.
Syntax
Parent element: <Profile>The following attributes are supported:
| Attribute | Required | Type | Description |
|---|---|---|---|
| id | yes | string | Specifies the catalog id. This name should be unique on the system. |
| version | no | string | Specifies the version of the catalog used to build this profile. |
The following child elements are supported:
| Child element | Required | Number | Description |
|---|---|---|---|
| <Parameter> | no | 0 – any | Parameter included in the catalog. |
| <SubCat> | no | 0 – any | Subcategory included in the catalog. |
| <Seed> | no | 0 – any | Seed included in the catalog. |
Attributes
- id attribute
The id attribute must be set to the name of the catalog that defines the parameters listed under the <Catalog> element. The id attribute is the base name of the catalog file on the disk, with the .xml extension removed. For example, a profile will use the <Catalog id=“commandParam”> element to reference the commandParam.xml catalog file.
By default, the catalog files are searched under the/etc/security/artex/catalogs directory. However it is possible, for the root user only, to search other directories by setting the ARTEX_CATALOG_PATH environment variable. Multiple directories can be specified in this environment variable using the : separator.
- version attribute
The version attribute is written as MM.mm where MM is the major number and mm is the minor number.
The version attribute must match the version of the referenced catalog file (see The <Catalog> element in the section Writing AIX® Runtime Expert catalogs). If an AIX Runtime Expert command is run on a profile that references a catalog with the incorrect version, the following warning message is displayed:
0590-218 Catalog version differs from the one referenced in profile Local catalog version is '2.1'. Version used to build profile was '2.0'
Usage
The <Catalog> element identifies the catalog file that contains the definition of the listed seeds and parameters. All seeds and parameter elements in a profile must be located in the appropriate <Catalog> element.
A profile may reference several catalogs. For example, the default.xml profile is built during the installation of the artex.base.sample fileset by merging a select set of other sample profiles.
Examples
The security attributes profile secattrProfile.xml uses three catalogs, each catalog handling, one of the security tables:
<Profile origin="reference" readOnly="true" version="2.0.0">
<Catalog id="privcmdParam" version="2.0"
<Parameter name="privatecommands" />
</Catalog>
<Catalog id="privdevParam" version="2.0">
<Parameter name="privatedevices"/>
</Catalog>
<Catalog id="privfileParam" version="2.0">
<Parameter name="privatefiles" />
</Catalog>
</Profile>