AM3270 Management Programming Manual

CONTENTS
PREFACE ..................................................... vii
NOTATION CONVENTIONS ......................................... ix
SECTION 1. INTRODUCTION .................................... 1-1
Brief Overview of AM3270 .................................. 1-1
Objects Controlled by the Subsystem ....................... 1-1
Required Management Functions ............................. 1-2
Relationship With Other Subsystems ........................ 1-4
Subsystem Architecture .................................... 1-5
SECTION 2. MANAGEMENT PROGRAMMING FOR AM3270 ............... 2-1
How a Management Application Fits Into the Architecture ... 2-2
Commands .................................................. 2-4
Event Messages ........................................... 2-10
Communicating With the AM3270 Subsystem .................. 2-11
SECTION 3. ELEMENTS OF SPI MESSAGES FOR THE SUBSYSTEMS ..... 3-1
Definition Files .......................................... 3-2
Naming Rules and Guidelines for Applications .............. 3-4
Common Syntax Elements for the Subsystems ................. 3-4
Command Numbers ......................................... 3-4
Object Types ............................................ 3-5
Object Names ............................................ 3-6
Event Numbers ........................................... 3-7
Subjects of Event Messages .............................. 3-7
Tokens .................................................. 3-8
Constructs Involving Multiple Tokens ................... 3-11
Components of a Command, Response and Event ............ 3-11
SECTION 4. SPI PROGRAMMING CONSIDERATIONS FOR AM3270 ....... 4-1
Building the Command Buffer ............................... 4-1
Discontinuing a Command in Progress ....................... 4-2
Receiving and Decoding the Response Buffer ................ 4-3
Error Handling ............................................ 4-4
Security .................................................. 4-4
Command Protocol .......................................... 4-5
iii