AC Event Reports Syntax

Format

TYPE=AC  | CLASS=[owner-class-name . ] ... object-class
						| INSTANCE=[owner-class-name . ] ... object-name
					[ | HOST=system-name ]
					[ | APPL=application-name ]
					[ | APPLQUAL=application-qualifier ]
					[ | attribute-name=attribute-value ] . . .

Note: Operations Sentinel provides a default image for each class. To change this default Topology icon to a new image that has been saved with Operations Sentinel, you need to change the image attribute using the AC event report.In the following example, the Topology icon or image for the class UNIX or Linux System changes from the default image “Component” to the new custom image “server.” Here, the instance of the object to be modified is identified by the instance value \_HOSTID\. TYPE=AC | CLASS=UNIX/Linux System | INSTANCE= \_HOSTID\ | TOPOLOGYIMAGE=Linux

owner-class-name

owner-class-name is a qualifier for any object that is not a system or server. Multiple iterations of owner-object-name are required for an object that is not a system or a server, and is not contained directly in a system. For example, If UNIX system A contains tape subsystem B, which contains tape drive C, the owner-class-name and object-class would be “A . B . C”. When an object-class or object-name contains qualification, the first segment of the qualifier must always refer to a system (or server).

object-class

object-class is the class to which the object belongs. The class determines the attributes (properties) of the object. The class can be any of the base classes, or any class derived directly or indirectly from one of the base classes.

object-name

object-name is the name of the object within the specified class and system.

SP-AMS Consideration [MCP, UNIX]

You can use the variable \_HOSTID\ to substitute the name of the systemthat sent the message.

CP-AMS Consideration [OS 2200]

The character strings $HOST$ and $CONSOLE$ have a special meaning when used as values of an instance name. Operations Sentinel Console replaces these strings with the name of the system($HOST$) or console ($CONSOLE$) where the matched message originated.

system-name

system-name specifies the systemto which the object belongs. The systemname must match the name that you specified for the system when defining it with Operations Sentinel.

Note: If you use the new syntax for the CLASS and INSTANCE attributes, do not use the HOST attribute. The HOST attribute is included only for compatibility.

application-name

application-name is the name of the application program that sent the attribute change request. This attribute is optional.

Reserved Names

See the table in “AL Event Reports Syntax” for the names of processes internal to Operations Sentinel. Do not use them as the application name in event reports. These names are case sensitive, as all are application-name attribute values.

application-qualifier

application-qualifier further identifies the program that sent the request. It is used to distinguish between one instance of the application and another. This attribute is optional.

attribute-name=attribute-value

These refer to attributes (properties) defined for the specified class.

attribute-name is not case sensitive but attribute-value is case sensitive. The attribute value is free-format, but do not include the attribute-value pair separator ( | ) in an attribute value.

Multiple Attributes

If you want to change the values of more than one attribute for a single object, it is more efficient to include all of the attribute changes in one event report.

Examples

The following example changes the values of the total blocks and percent of file system space used for the file system identified by the second token of the message that was matched. Variables are used to substitute information from the matched message.

TYPE=AC  | CLASS=UNIX/Linux System . UNIX/Linux File System
						| INSTANCE=\_HOSTID\ . \_TOKEN2\
						| Total_Blocks=\_TOKEN3\
						| Percent_Used=\_TOKEN6 "%" 1\

The following example shows an event report sent to Operations Sentinel Console to change the values of the status and equipment mnemonic for the tape drive identified by the third token of the message that was matched and owned by the host identified by "$HOST$".

TYPE=AC  | CLASS=OS 2200 System . OS 2200 Tape
						| INSTANCE=$HOST$ . \_TOKEN3\
						| STATUS=\_TOKEN5\
						| EQUIPMENT MNEMONIC=\_TOKEN7\"