OSI/MHS Configuration and Management Manual

Managing Your OSI/MHS Subsystem
OSI/MHS Configuration and Management Manual—424827-003
7-30
Using the EMS Analyzer
The following source file (mhssrc) filters event messages for all events generated by
the OSI/MHS subsystem:
[#SET ZMHS^VAL^SSID [ZSPI^VAL^TANDEM].[ZSPI^SSN^ZMHS].0]
FILTER select^only^OSI^MHS;
BEGIN
IF ZSPI^TKN^SSID = SSID (ZMHS^VAL^SSID) THEN
PASS;
END
To compile the filter source code, enter the following commands:
#PUSH myvar
#LOAD /KEEP 1, LOADED myvar / &
$system.zspidef.zspitacl
#LOAD /KEEP 1, LOADED myvar / &
$system.zspidef.zemstacl
#LOAD /KEEP 1, LOADED myvar / &
$myvol.zosimhs.zmhstacl
EMF /IN mhssrc / mhsfltr
To run an EMS distributor using the filter, enter the following commands:
EMSDIST /NAME $emsp/ COLLECTOR $0, TEXTOUT &
($s.#emslog, $term1), TYPE printing,&
FILTER mhsfltr
The mhsfltr file is an EMS filter that selects only the event messages generated by
an OSI/MHS subsystem. The mhssrc file contains the source code for the EMS filter.
For more information on printing distributors and writing filters, see the EMS Manual.
Using the EMS Analyzer
The EMS Analyzer (EMSA) offers a convenient method for viewing event messages. It
allows you to select among various types of filters, search criteria, and output options.
It can also be used as a debugging tool for developing EMS applications. Using a
command file called an EMSA custom (EMSACSTM) file, you can associate function
keys with specific options to define your own runtime interface. This subsection shows
how EMSA can be used with OSI/MHS using an example EMSACSTM file.
The description in this subsection is not very detailed. For complete information about
the EMS Analyzer, see the EMS Analyzer User’s Guide and Reference Manual.
Starting EMSA
This example assumes that you have installed EMSA from its ISV, which is called
ZEMSA. (In the example in this manual, the ZEMSA subvolume has been installed on
$SYSTEM, but you can choose a different volume.) The subvolume includes the file
INSTEMSA, a TACL macro that prompts you for various parameters that will
customize EMSA for your particular system.