EMS Filters

You can write EMS filters to select messages based on the values of the fields, or tokens, in the messages. For example, you can use the provided sample filter file XCM1EMFS with EMSDIST or VIEWPOINT to display all CA XCOM Data Transport EMS messages.

You can also write filters that access only selected CA XCOM Data Transport EMS messages such as:

All completed transfers
All aborted transfers
All started transfers

EMS filters are very useful for application programmers. For example, a filter can be used for an application program that is waiting to receive a certain file. When the file is received, the program receives the EMS message from CA XCOM Data Transport and can then process the file.

To allow CA XCOM Data Transport to write messages to EMS, you need to add the following DEFINEs:

ADD DEFINE =_EMS_COLLECTOR, class map, file $0

This line defines the EMS collector for CA XCOM Data Transport as $0, which is the default collector. If needed, you can set this value to another collector:

ADD DEFINE =_EGEN_ADD_EVENT_TEXT, class map, file $YES

This define adds a text token to CA XCOM Data Transport EMS messages. If you are printing messages, EMSTEXT generates displayable message text from this token.

Note: The CA XCOM Data Transport EMS messages do not include a format template.

For more information about writing your own filters and programs that communicate with EMS, see the HP NonStop Event Management System (EMS) Guide.