TS/MP 2.5 Management Programming Manual

Contents
About This Manual........................................................................................9
Product Version........................................................................................................................9
Supported Release Version Updates (RVUs)..................................................................................9
Intended Audience....................................................................................................................9
Related Manuals......................................................................................................................9
New and Changed Information................................................................................................11
Documentation Organization...................................................................................................12
Notation Conventions..............................................................................................................13
Publishing History...................................................................................................................15
HP Encourages Your Comments................................................................................................15
1 Introduction.............................................................................................17
Which Sections Do You Need?................................................................................................17
Architecture and Components...................................................................................................18
Distributed Systems Management..............................................................................................19
Management Interfaces...........................................................................................................20
PATHCOM Interface...........................................................................................................21
System Programming Interface (SPI) Interface.........................................................................21
2 TS/MP Management Programming.............................................................23
Comparison of PATHCOM and SPI Commands...........................................................................23
Pathway Management Programming Interface............................................................................25
Control and Inquiry............................................................................................................25
Starting and Opening PATHMON........................................................................................25
Sending Commands and Receiving Replies...........................................................................26
Design Considerations............................................................................................................27
3 SPI Programming Considerations................................................................29
Definition Files........................................................................................................................29
Naming Conventions..........................................................................................................29
Contents...........................................................................................................................30
Location............................................................................................................................30
Which Files Do You Need?.................................................................................................30
Message Elements for the Pathway Subsystem.............................................................................31
Commands.......................................................................................................................31
Object Types................................................................................................................32
Object Names..............................................................................................................34
Object-Selector Tokens...................................................................................................34
Event Numbers.............................................................................................................34
Other Tokens................................................................................................................35
Extensible Structured Tokens...........................................................................................35
Types for Fields in Structured Tokens.................................................................................37
Data Lists and Error Lists.................................................................................................38
Building and Sending a Command Message.............................................................................38
Summary of Steps..............................................................................................................38
Considerations for SSINIT...................................................................................................38
Considerations for SSPUT....................................................................................................39
Considerations for SSNULL and Extensible Structured Tokens...................................................39
Specifying Continuation......................................................................................................40
Required Object States for Continuation................................................................................41
Continuation Example........................................................................................................42
32-Byte File Names............................................................................................................42
Resetting Values in Fields....................................................................................................43
Contents 3