The sysevent handling facility provides extensive macro capability for constructing the command line arguments to be executed in response to an event. Macro expansion applies only to the command line args specified for an event handler, with macros expanded with data from the event itself. Pre-defined macros are provided for the event class, subclass, publisher and vendor information. Macros not matching one of the pre-defined macro names cause the attribute list attached to the event to be searched for an attribute of that name, with the value of the matching attribute substituted on the command line.

Macros are introduced by the $ character, with the macro name being the following token separated by a SPACE or TAB character. If the macro name is embedded in text, it may be delineated by ${ and }. A \ before the $ causes macro expansion not to occur.

$class

The class string defining the event

$publisher

The publisher string defining the event

$sequence

The sequence number of the event.

$subclass

The subclass string defining the event

$timestamp

The timestamp of the event.

$vendor

The vendor string defining the event

Macro names other than those pre-defined are compared against the attribute list provided with the event. An attribute with name matching the macro name causes the value of the attribute to be substituted as ASCII text on the generated command line.

Use of a macro for which no attribute with that name is defined, or for which multiple attributes with that name are provided, cause an error and the command is not invoked.

Attributes with signed data types (DATA_TYPE_INT16, DATA_TYPE_INT32 and DATA_TYPE_INT64) are expanded as decimal digits.

Attributes with unsigned data types (DATA_TYPE_BYTE, DATA_TYPE_UINT16, DATA_TYPE_UINT32, DATA_TYPE_UINT64 and DATA_TYPE_HTTIME) are expanded as hexadecimal digits with a 0x prefix.

Attributes with string data type (DATA_TYPE_STRING) are expanded with the string data. The data is not quoted. If if it desired that the quoted strings be generated on the command line, put quotes around the macro call in the arguments.

Array types are expanded with each element expanded as defined for that scalar type, with a space separating each element substitution.

The following example adds an event handler for an event defined by vendor SUNW, class EC_ENV and sub-class ESC_ENV_TEMP. The command to be run is /opt/SUNWenv/bin/ec_env_temp, with arguments being the class name, sub-class name and pathname derived from the event attributes. The $ characters are preceded by a backslash to circumvent shell interpretation. There is no need to restart the service after the change since the registry is maintained on $ALTROOT.

# syseventadm add -R \$ALTROOT -v SUNW -c EC_ENV -s ESC_ENV_TEMP
     /opt/SUNWenv/bin/ec_env_temp \$class \$subclass \$pathname

The following example removes the event handler added in Example 1.

# syseventadm remove -R \$ALTROOT -v SUNW -c EC_ENV -s ESC_ENV_TEMP
     /opt/SUNWenv/bin/ec_env_temp \${class} \${subclass} \${pathname}

The following example lists all event handlers for events of class EC_ENV, subclass ESC_ENV_TEMP, as defined by vendor SUNW:

# syseventadm list -v SUNW -c EC_ENV -s ESC_ENV_TEMP
     vendor=SUNW class=EC_ENV subclass=ESC_ENV_TEMP
     /opt/SUNWenv/bin/ec_env_temp \${class} \${subclass} \${pathname}

The following example lists all event handlers defined by vendor VRTS.

# syseventadm list -v VRTS

The following example removes all event handlers defined by vendor VRTS, and restarts service.

# syseventadm remove -v VRTS
# syseventadm restart

The following example lists all event handlers specified to run the command /opt/SUNWenv/bin/ec_env_temp:

# syseventadm list /opt/SUNWenv/bin/ec_env_temp

The following example removes all event handlers specified to run the command /opt/SUNWenv/bin/ec_env_temp, and restarts service:

# syseventadm remove /opt/SUNWenv/bin/ec_env_temp
# syseventadm restart