<Catalog> element

The <Catalog> element indicates the name of the catalog file that contains the definitions for the child <Parameter> elements.


Parent element: <Profile>

The following attributes are supported:

Table 1. Attributes
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:

Table 2. Child elements
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.


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'


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.


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 id="privdevParam" version="2.0">
    <Parameter name="privatedevices"/> 
  <Catalog id="privfileParam" version="2.0">
    <Parameter name="privatefiles" />

Related information

The <Catalog> element (in catalog files).