Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Micromuse
Netcool

/OMNIbus

Supporting Products
Probe for Siemens EWSD (Server)

Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
2002 Micromuse Inc., Micromuse Ltd.
All rights reserved. No part of this work may be reproduced in any form
or by any person without prior written permission of the copyright
owner. This document is proprietary and confidential to Micromuse,
and is subject to a confidentiality agreement, as well as applicable
common and statutory law.
Micromuse Disclaimer of Warranty and Statement of Limited
Liability
Micromuse provides this document as is, without warranty of any
kind, either express or implied, including, but not limited to, the implied
warranties of merchantability, fitness for a particular purpose or non-
infringement. This document may contain technical inaccuracies or
typographical errors. Micromuse may make improvements and
changes to the programs described in this document or this document
at any time without notice. Micromuse assumes no responsibility for the
use of the programs or this document except as expressly set forth in the
applicable Micromuse agreement(s) and subject to terms and conditions
set forth therein. Micromuse does not warrant that the functions
contained in the programs will meet your requirements, or that the
operation of the programs will be uninterrupted or error-free.
Micromuse shall not be liable for any indirect, consequential or
incidental damages arising out of the use or the ability to use the
programs or this document.
Micromuse specifically disclaims any express or implied warranty of
fitness for high risk activities.
Micromuse programs and this document are not certified for fault
tolerance, and are not designed, manufactured or intended for use or
resale as on-line control equipment in hazardous environments
requiring fail-safe performance, such as in the operation of nuclear
facilities, aircraft navigation or communication systems, air traffic
control, direct life support machines, or weapons systems (High Risk
Activities) in which the failure of programs could lead directly to
death, personal injury, or severe physical or environmental damage.
Compliance with Applicable Laws; Export Control Laws
Use of Micromuse programs and documents is governed by all
applicable federal, state and local laws. All information therein is subject
to U.S. export control laws and may also be subject to the laws of the
country where you reside.
All Micromuse programs and documents are commercial in nature. Use,
duplication or disclosure by the United States Government is subject to
the restrictions set forth in DFARS 252.227-7015 and FAR 52.227-19.
Trademarks and Acknowledgements
Micromuse and Netcool are registered trademarks of Micromuse Ltd.
Other Micromuse trademarks include but are not limited to:
Netcool/OMNIbus, Netcool/OMNIbus for Voice Networks,
Netcool/Reporter, Netcool/Internet Service Monitors, Netcool/NT
Service Monitors, Netcool/WAP Service Monitors, Netcool/Fusion,
Netcool/Impact, Netcool/Visionary, Netcool/Precision,
Netcool/Firewall, Netcool/WebTop, Netcool ObjectServer,
Netcool/Software Developers Kit, Micromuse Alliance Program and
Network Slice.
Micromuse acknowledges the use of I/O Concepts Inc. X-Direct 3270
terminal emulators and hardware components and documentation in
Netcool/Fusion. X-Direct 1989-1999 I/O Concepts Inc. X-Direct and
Win-Direct are trademarks of I/O Concepts Inc.
Netcool/Fusion contains IBM Runtime Environment for AIX

, Java
Technology Edition Runtime Modules Copyright IBM Corporation
1999. All rights reserved.
Micromuse acknowledges the use of MySQL in Netcool/Precision.
Copyright 1995, 1996 TcX AB & Monty Program KB & Detron HB
Stockholm SWEDEN, Helsingfors FINLAND and Uppsala SWEDEN.
All rights reserved.
Micromuse acknowledges the use of the UCD SNMP Library in
Netcool/Precision and Netcool/ISM. Copyright 1989, 1991, 1992 by
Carnegie Mellon University. Derivative Work - Copyright 1996, 1998,
1999, 2000 The Regents of the University of California. All rights
reserved.
Portions of the Netcool/ISM code are copyright (c) 2001, Cambridge
Broadband Ltd. All rights reserved.
Portions of the Netcool/ISM code are copyright (c) 2001, Networks
Associates Technology, Inc. All rights reserved.
Micromuse acknowledges the use of Viador Inc. software and
documentation for Netcool/Reporter. Viador 1997-1999 is a
trademark of Viador Inc.
Netcool Visionary, Netcool/Precision and Netcool/Reporter include
software developed by the Apache Group for use in the Apache HTTP
server project (http://www.apache.org). Copyright 1995-1999 The
Apache Group. All rights reserved.
Micromuse acknowledges the use of Merant drivers. Copyright
MERANT Solutions Inc., 1991-1998.
The following product names are trademarks of Tivoli Systems or IBM
Corporation: AIX, IBM, OS/2, RISC System/6000, Tivoli Management
Environment, and TME10.
IBM and NetView/6000 are either trademarks or registered trademarks
of IBM Corporation. VTAM is a trademark of IBM Corporation.
Omegamon is a trademark of Candle Corporation.
Netspy is a trademark of Computer Associates International Inc.
The Sun logo, Sun Microsystems, SunOS, Solaris, SunNet Manager, Java
are trademarks of Sun Microsystems Inc.
SPARC is a registered trademark of SPARC International Inc. Programs
bearing the SPARC trademark are based on an architecture developed
by Sun Microsystems Inc. SPARCstation is a trademark of SPARC
International Inc., licensed exclusively to Sun Microsystems Inc.
UNIX is a registered trademark of the X/Open Company Ltd. Sybase is
a registered trademark of Sybase Inc.
Action Request System and Remedy are registered trademarks of
Remedy Corporation.
Peregrine System and ServiceCenter are registered trademarks of
Peregrine Systems Inc.
HP and OpenView are trademarks of Hewlett-Packard Company.
Microsoft, Windows, Windows NT are either registered trademarks or
trademarks of Microsoft Corporation.
FireWall-1 is a registered trademark of Check Point Software
Technologies Ltd.
Netscape and Netscape Navigator are registered trademarks of
Netscape Communications Corporation in the United States and other
countries. Netscape's logos and Netscape product and service names are
also trademarks of Netscape Communications Corporation, which may
be registered in other countries.
Micromuse acknowledges the use of Xpm tool kit components.
SentinelLM is a trademark of Rainbow Technologies Inc.
GLOBEtrotter and FLEXlm are registered trademarks of Globetrotter
Software Inc.
Red Hat, the Red Hat Shadow Man logo, RPM, Maximum RPM, the
RPM logo, Linux Library, PowerTools, Linux Undercover, RHmember,
RHmember More, Rough Cuts, Rawhide and all Red Hat-based
trademarks and logos are trademarks or registered trademarks of Red
Hat Inc. in the United States and other countries.

Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Linux is a registered trademark of Linus Torvalds.
Nokia is a registered trademark of Nokia Corporation.
WAP Forum and all trademarks, service marks and logos based on
these designations (Trademarks) are marks of Wireless Application
Protocol Forum Ltd.
Micromuse acknowledges the use of InstallAnywhere software in
Netcool/WAP Service Monitors. Copyright Zero G Software Inc.
Orbix is a registered trademark of IONA Technologies PLC. Orbix 2000
is a trademark of IONA Technologies PLC.
All other trademarks, registered trademarks and logos are the property
of their respective owners.
Micromuse Inc., 139 Townsend Street, San Francisco, USA CA 94107
www.ibm.com

Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Document Control Page
This document is supplied solely as an electronic copy. To obtain the most recent version, see the
IBM Tivoli Netcool Information Center:
http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp
Before you read this document you should be familiar with the Netcool/OMNIbus product
documentation.
Document Details
Modification History
Document Name Probe for Siemens EWSD (Server)
Print Date 24 October 2002
Current Status Approved
Document Version No. Comments Print Date
1.0 First Draft 24 October 2002
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Probe for Siemens EWSD (Server) Page i
Table of Contents
Probe for Siemens EWSD (Server) .......................................................................................................... 1
Summary ............................................................................................................................................. 1
Data Acquisition................................................................................................................................. 2
Interpreting Data.................................................................................................................. 2
Data Stream Capture ........................................................................................................... 2
Timeout.................................................................................................................................. 2
Properties and Command Line Options......................................................................................... 3
Elements............................................................................................................................................... 6
Error Messages.................................................................................................................................... 7
Contact Information.................................................................................................................................. 9
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved

Page ii Probe for Siemens EWSD (Server)
Probe for Siemens EWSD (Server) Page 1
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Probe for Siemens EWSD (Server)
The Siemens EWSD system supports both switched telephony and data applications. Siemens
EWSD switches provide a wide variety of business and residential services encompassing
ISDN, CLASS, SS7, Centrex, and Advanced Intelligent Network capabilities. They can be
managed through various systems.
Note: For information about the UNIX client version of this probe, see the Probe for Siemens
EWSD (UNIX) guide. For information about the Windows client version of this
probe, see the Probe for Siemens EWSD (Windows) guide.
Summary
Table 1: Probe for Siemens EWSD (Server) Summary
Probe Target Siemens EWSD
Probe Executable Name nco_p_siemens_ewsd_server
Probe Supported on AIX 4, Solaris 2, Solaris 7, HP-UX 10, HP-UX 11, Linux 2x86
Properties file $OMNIHOME/probes/arch/siemens_ewsd_server.props
Rules file $OMNIHOME/probes/arch/siemens_ewsd_server.rules
Requirements Netcool/OMNIbus 3.4 and above
Connection Method TPC/IP Socket
License Band C
Page 2 Probe for Siemens EWSD (Server)
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Data Acquisition
The Probe for Siemens EWSD (Server) generates Netcool events by acting as a multi-headed
TCP/IP socket server. When it starts, it listens for a connection from the Siemens EWSD
system on the specified port. There is no set limit to the number of clients that can connect to
the probe.
Interpreting Data
Data received from the Siemens EWSD system can include arrays and tables. The start of an
array is indicated by the characters <<<. The start of a table is indicated by a line containing
the characters -+- . You can specify how the probe interprets data using the DecodeArrays,
DecodeTables, and DecodeSecondTables properties as follows:
To instruct the probe to interpret arrays, set the DecodeArrays property to 1.
To instruct the probe to interpret the first table that appears in an event, set the
DecodeTables property to 1.
To instruct the probe to interpret the second table that appears in an event, set the
DecodeSecondTables property to 1.
Data Stream Capture
The Probe for Siemens EWSD (Server) can capture all raw data sent from a device. This raw
data is stored in a log file and can be used for debugging purposes, to develop new features
for the probe, or to pass to other management systems that require the same data. To enable
stream capture, set the StreamCapture property to 1 and specify a log file to store the data
using the StreamCaptureFilename property.
Timeout
The Probe for Siemens EWSD (Server) has a timeout facility that allows it to disconnect from
the socket if it fails to receive an alarm within a predefined amount of time. You can specify
how long the probe waits before disconnecting using the ReadTimeout property.
Probe for Siemens EWSD (Server) Page 3
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Properties and Command Line Options
This section describes the properties and command line options specific to this probe. For
information about default properties and command line options, see Appendix D of the
Netcool/OMNIbus Administration Guide:
Table 2: Probe for Siemens EWSD (Server) Properties and Command Line Options
Property Name Command Line Option Description
DecodeArrays integer -decodearrays integer Specifies whether the probe interprets arrays:
0 - the probe does not interpret arrays
1 - the probe interprets arrays
The default is 0.
DecodeSecondTables
integer
-decodesecondtables integer Specifies whether the probe interprets the second
table that appears in the event:
0 - the probe does not interpret the first table
1 - the probe interprets the first table
The default is 0.
DecodeTables integer -decodetables integer Specifies whether the probe interprets the first table
that appear in the event:
0 - the probe does not interpret the second table
1 - the probe interprets the second table
The default is 0.
EventReadString string -eventreadstring string String the probe sends to the Siemens EWSD
system to indicate that it has received an event. This
string can act as an acknowledgment that prompts
the system to send the next alarm.
The default is "".
MaxEvents integer -maxevents integer Maximum number of events the probe attempts to
read simultaneously from a given source.
The default is 10.
Note: You can increase this number to increase the
event throughput when a large number of events are
generated.
Page 4 Probe for Siemens EWSD (Server)
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
NoNameResolution
integer
-nonameresolution integer Specifies whether the probe performs name
resolution on IP addresses:
0 - probe performs name resolution
1 - probe does not perform name resolution
The default is 0.
PortNumber integer -portnumber integer Active port to which the probe listens for
connections from the Siemens EWSD system.
The default is 4567.
ReadTimeout integer -readtimeout integer Time (in seconds) that the probe allows the socket
to be silent. If this time is exceeded, it assumes that
the connection is dead and disconnects.
The default is 1.
ReportStatus integer -reportstatus integer Specifies whether the probe sends a ProbeWatch
message to the ObjectServer when clients connect
to or disconnect from the socket:
0 - the probe does not send ProbeWatch messages
1 - the probe sends ProbeWatch messages
The default is 1.
SocketBuffer integer -socketbuffer integer Maximum buffer size for each socket.
The default is 1024.
Note: You can increase this number if the probe
needs to read a large number of events quickly.
Table 2: Probe for Siemens EWSD (Server) Properties and Command Line Options (Continued)
Property Name Command Line Option Description
Probe for Siemens EWSD (Server) Page 5
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
SplitPairs integer -splitpairs integer Specifies whether the probe splits name-value pairs
that are separated by an equals (=) sign:
0 - the probe does not split name-value pairs
1 - the probe splits name-value pairs
The default is 0.
StreamCapture integer -streamcapture integer Specifies whether the probe captures all raw data
sent from the device:
0 - stream capture disabled
1 - stream capture enabled
The default is 0.
Note: If you set this property to 1, you must specify
the file to store the data using the
StreamCaptureFilename property.
StreamCaptureFilename
string
-streamcapturefilename
string
File the probe uses to store the input stream log.
The default is $OMNIHOME/var/
siemens_ewsd_server.stream.
Note: This property is required if you set the
StreamCapture property to 1.
Table 2: Probe for Siemens EWSD (Server) Properties and Command Line Options (Continued)
Property Name Command Line Option Description
Page 6 Probe for Siemens EWSD (Server)
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Elements
Table 3 describes the elements that the Probe for Siemens EWSD (Server) generates:
Table 3: Probe for Siemens EWSD (Server) Elements
Element Name Element Description
$EventTime Time at which the event occurred.
$Mask Mask number for the event. This defines the contents and
format of the event. For descriptions of all event formats, see
the Siemens EWSD Output Manual.
$Linen Each line of the event is passed to the rules file as a single
token, where n represents a line number. This element
indicates the line number of the event.
$NEName The network element name.
Probe for Siemens EWSD (Server) Page 7
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Error Messages
This section describes the error messages specific to this probe. For information about generic
error messages, see Appendix D of the Netcool/OMNIbus Administration Guide:
Table 4: Probe for Siemens EWSD (Server) Error Messages
Error Description Action
Error adding list element to node
Error adding socket node to List
Error allocating memory for
ProbeWatchString
Error allocating memory for
sockDataList
Expect: Error allocating memory for
buffer
Failed to build intial poll list
Failed to build Poll List
Failed to create NSProbe Event:
<event>
Failed to create the server socket
The probe failed to allocate internal
storage.
Make more memory available.
Expect timed out after<number>
seconds
When the Siemens EWSD system tried
to log in to or log out of the probe, the
expect part of the chat timed out.
Check that the Siemens EWSD system
is running correctly.
Failed to connect to Object Server -
<reason>
The probe failed to connect to the
ObjectServer.
Check that the ObjectServer is available.
Footer defined, but no header. Please
define or undefine both.
Header defined, but no footer. Please
define or undefine both.
Received HEADER when expecting
FOOTER, sending incomplete event!
RegComp Failed for FOOTER:
<reason>
RegComp Failed for HEADER:
<reason>
The incoming data stream may be
corrupt.
Check that the Siemens EWSD system
is running correctly.
Illegal port :<port number> The port number specified is not valid. Check the PortNumber property in the
properties file.
Page 8 Probe for Siemens EWSD (Server)
Netcool

/OMNIbus

Version 1.0
Supporting Products
Probe for Siemens EWSD (Server)
24 October 2002
Status: Approved
Only managed to write <percentage>
out of <total> characters
The probe cannot write out data
because the disk is full.
Make more disk space available.
REGEXP: sub <number> does not
exist
A regular expression is incorrectly
formed in the rules file.
Check the rules file for the regular
expression and correct the entry.
The probe has received <number>
bytes of data without an event
terminator! Sending incomplete
event!
The probe failed to receive the
character indicating the end of an event.
The event stream may have become
corrupted.
Check the connection to the switch and
that it is running correctly.
Unable to open file : <path> -
<filename>
The specified file could not be opened. Check that the permissions of the file are
set correctly.
Unable to write to file : <path> -
<filename>
The probe was unable to write to the
recovery file.
Check that there is enough disk space to
save the recovery file.
Table 4: Probe for Siemens EWSD (Server) Error Messages (Continued)
Error Description Action
Contact Information
Technical Support Contact Details
USA
Telephone Number:
Fax Number:
E-Mail:
World Wide Web:
Address:
1-800 Netcool (800 638 2665)
001 415 538 9090
415 538 9091
support@micromuse.com
http://support.micromuse.com
Customer Support Services, 139 Townsend Street, San
Francisco, California 94107
Europe
Telephone Number:
Fax Number:
E-Mail:
World Wide Web:
Address:
+44 (0)20 8877 0073
+44 (0)20 8875 0991
support@micromuse.com
http://support.micromuse.com
Customer Support Services, Disraeli House, 90 Putney
Bridge Road, London, SW18 1DA
Company Contact Details
http://www.micromuse.com
USA
Micromuse Inc (HQ),
139 Townsend Street,
San Francisco,
CA 94107,
USA
Phone: ++1 415 538 9090
Fax: ++1 415 538 9091
EUROPE
Micromuse Ltd.,
Disraeli House,
90 Putney Bridge Road,
London SW18 1DA,
United Kingdom
Phone: +44 020 8875 9500
Fax: +44 020 8875 9995