Record management

This topic explains how instances can be part of a record and how to manage instances in a record.

Settings that have instances can be part of a record. A record is a group of settings that have dependencies on each other. For example, a user ID and a password are dependent on each other. A user ID must have a password, and a password must have a user ID. Therefore, they are grouped in the same record.

Each record has a setting that is defined as the "record key." It represents the primary setting for the record.

Determining if a setting is part of a record

To determine if a setting is part of a record, use the showvalues command with the --instances parameter. Settings that are part of a record are marked with the text "recordKey" (if the setting is the record key) or "recordKey=key_name" (if the setting is part of a record but is not the key), where key_name is the name of the setting that is the record key. See the showvalues command section for examples of the showvalues output for settings that are part of a record.

Creating an instance of a record

All settings in a record are created or deleted as a group. To create an instance of a record, you must first perform a "set" on the key setting of the record. This automatically causes an instance to be created and set to its default value for all other settings in the record. To see examples of how to create an instance of a setting, see the set command section.

Deleting an instance of a record

To delete an instance of a record, the delete command is performed on the "record key" setting. This automatically deletes all other instances for the settings in the record. For examples of deleting an instance of a setting, see the delete command section.