HP-UX SNAplus2 R7 APPC Programmer's Guide

Before You Begin
About This Book
Organization of This Book
This book is organized as follows:
• Chapter 1, Concepts, introduces the fundamental concepts of APPC. It is intended for programmers who are not
familiar with APPC.
• Chapter 2, Writing Transaction Programs, contains general information an APPC programmer needs when
writing transaction programs (TPs).
• Chapter 3, APPC Control Verbs, describes each APPC control verb in detail. Each description includes the
following: purpose, verb control block (VCB), supplied and returned parameters, conversation states in which
the verb can be issued, conversation state changes after the verb has executed. Differences between the
implementations of APPC for different operating systems are indicated where they occur; these are generally
minor variations due to operating system differences.
• Chapter 4, APPC Conversation Verbs, describes each APPC conversation verb in detail. Each description
includes the following: purpose, verb control block (VCB), supplied and returned parameters, conversation
states in which the verb can be issued, conversation state changes after the verb has executed. Differences
between the implementations of APPC for different operating systems are indicated where they occur; these are
generally minor variations due to operating system differences.
• Chapter 5, TP Server Verbs, describes each APPC TP server verb in detail. Each description includes the
following: purpose, verb control block (VCB), supplied and returned parameters, conversation states in which
the verb can be issued, conversation state changes after the verb has executed. Differences between the
implementations of APPC for different operating systems are indicated where they occur; these are generally
minor variations due to operating system differences.
• Chapter 6, Sample Transaction Programs, describes the SNAplus2 sample APPC transaction programs, which
illustrate the use of APPC verbs. This chapter also includes instructions for compiling, linking, and running the
TPs on each of the supported operating systems.
• Appendix A, Return Code Values, lists all the possible return codes in the APPC interface in numerical order
and gives their meanings.
• Appendix B, Common Return Codes, documents certain primary and secondary return codes that are common
to several verbs.
• Appendix C, APPC State Changes, provides information about APPC conversation states: which verbs are
permitted in each state, and the state to which the conversation changes on return from each verb.
• Appendix D, SNA LU 6.2 Support, provides reference information about how the SNAplus2 implementation of
APPC relates to the SNA LU 6.2 architecture, and about the LU 6.2 control operator verbs whose function
is provided in SNAplus2 by the command-line administration program
snapadmin
and by NOF (node operator
facility) verbs.
Typographic Conventions
Table 1, Typographic Conventions shows the typographic styles used in this document.
Table 1 Typographic Conventions
Special Element Sample of Typography
Document title
HP-UX SNAplus2 Administration Guide
File or path name
sna_tps
Program or application
snaadmin
Command or HP-UX utility
vi; define_mode
General reference to all values of a particular type
AP_SEC_BAD_* (indicates all of the return values that
begin with
AP_SEC_BAD)
16