Creating a Member of a Variable Group (CREATE Command)

Use this command to create a member of a variable group.

Format

CREATE variable-group-name:member-name

where:

variable-group-name

is the name of a variable group previously defined using a DEFINE VARIABLE command. See Section 3.

member-name

is the unique name of the member. You can specify the member name using a variable reference or as a fixed string constant, but you cannot refer to another variable group member. A fixed string constant is a set of characters enclosed in quotation marks (for example, “ABC”) and cannot include variable substitution (for example, “FROM \_HOSTID\”).

If the member-name already exists, the CREATE action does not affect the previously created member. A warning message is produced.

Examples

The following example adds the member HOST1, specified as a fixed string constant, to the variable group HostidList:

CREATE HostidList:”HOST1”

The following example creates the member PRD01C in the previously defined variable group DiskErrors, where PRD01C is the value of the variable disk. The value (PRD01C) of the variable (disk) names the member.

CREATE DiskErrors:disk

The following example applies to SP-AMS only. It uses the value of a predefined variable to name a member of a user-defined variable group. The value of the predefined variable _HOSTID names a member of the user-defined variable group HostidList.

CREATE HostidList:_HOSTID

The following example creates a member in the user-defined variable group Status. The name of the member is the value of the fifth token of the matched message. If the fifth message token is RESERVED, this command creates the member RESERVED in the variable group Status.

CREATE Status:_TOKEN5

An alternative way to reference _TOKEN5 is to specify only the number of the token, as shown in this example:

CREATE Status:5