HP-UX SNAplus2 Upgrade Guide (June 2003)

5
Contents
1. Overview of Upgrading
Enhancements in SNAplus2 R6.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Java CPI-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
OLAR (Online Addition/Replacement) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Enhancements Offered by SNAplus2 R6.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Upgrade Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Client-Server Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Preparing for Upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2. Upgrading from Earlier Versions of SNAplus2 to R6.0 and later
Summary of Changes Between Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Planning the Upgrade Process for a Client/Server System. . . . . . . . . . . . . . . . . . . . . . 24
Upgrading the Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Upgrading a Complete Client/Server System in One Pass . . . . . . . . . . . . . . . . . . . . . . 25
Phased Upgrade of a Running Client/Server System . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Restrictions in a Mixed Network of Current-Level and Back-Level Computers. . . . 27
Upgrade Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Changing the Configuration during the Upgrade Process . . . . . . . . . . . . . . . . . . . . . 30
Adding New Servers or Clients During the Upgrade Process . . . . . . . . . . . . . . . . . . 30
Upgrading a Windows Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3. Porting Application Programs
Overview of Porting Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
APPC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Recompiling Existing Appications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
CPI-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Terminate_Application Function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
CSV. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
LOG_MESSAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
TRANSFER_MS_DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
LUA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
HLLAPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
NM-API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Sending NMVTs Without Requesting Acknowledgement . . . . . . . . . . . . . . . . . . . . . 43
Sending and Receiving NMVTs, Acknowledgements, or Both. . . . . . . . . . . . . . . . . . 44