|
|
|
|
This section explains how information is organized and presented in this book.
This book is organized as follows:
Concepts, introduces the fundamental concepts of APPC. It is intended for programmers who are not familiar with APPC.
Writing Transaction Programs, contains general information an APPC programmer needs when writing transaction programs (TPs).
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.
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.
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.
Sample Transaction Programs, describes the SNAP-IX sample APPC transaction programs, which illustrate the use of APPC verbs. This chapter also includes instructions for compiling, linking, and running the TPson each of the supported operating systems.
Common Return Codes, documents certain primary and secondary return codes that are common to several verbs.
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.
SNA LU 6.2 Support, provides reference information about how the SNAP-IX 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 SNAP-IX by the command-line administration program snaadmin and by NOF (node operator facility) verbs.
Typographic Conventions shows the typographic styles used in this document.
| Special Element | Sample of Typography |
| Document title | SNAP-IX Administration Guide |
| File or path name | sna_tps |
| Program or application | snaadmin |
| Command or Solaris 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) |
| Option or flag | |
| Parameter or Motif field | primary_rc; what_rcvd |
| Literal value or selection that the user can enter (including default values) | 0; 32,767 |
| Constant or signal | |
| Return value | AP_OK; AP_SYNC_LEVEL_NOT_SUPPORTED; TRUE |
| Variable representing a supplied value | lParam; ReturnedHandle |
| Environment variable | |
| Programming verb | RECEIVE_ALLOCATE |
| User input | cc -I |
| Function, call, or entry point | APPC_Async; WinAsyncAPPC |
| Data structure | |
| Hexadecimal value | 0x20 |
This symbol is used to indicate the start of a section of text that applies only to the Solaris operating system.
This symbol is used to indicate the start of a section of text that applies to the Win32 client(Windows client), which runs on the Microsoft NT (Version 3.51 or later) and Windows 95 operating systems.
The Windows client APIs are fully compatible with Microsoft SNA Server and Windows Open System Architecture (WOSA), enabling applications written for SNA Server to run unchanged on Windows clients.
This symbol indicates the end of a section of Solaris-specific or Windows-specific text. The information following this symbol applies regardless of the operating system.
|
|
|
 |
|
