HP-UX SNAplus2 R7 LUA Programmer's Guide

Before You Begin
About This Book
• Chapter 1, Concepts, introduces the fundamental concepts of LUA. It is intended for programmers who are not
familiar with LUA.
• Chapter 2, Designing and Writing LUA Applications, contains general information a programmer needs when
writing LUA applications. This chapter also includes information about SNA concepts relevant to the design of
LUA applications, and on compiling and linking an LUA application.
• Chapter 3, LUA VCB Structure, describes the structure of the Verb Control Block (VCB) used for all LUA verbs.
• Chapter 4, RUI Verbs, describes each RUI verb in detail. Each description includes the following: purpose, verb
record format, supplied parameters and returned values, and details on how the verb interacts with other RUI
verbs.
• Chapter 5, SLI Verbs, describes each SLI verb in detail. Each description includes the following: purpose, verb
record format, supplied parameters and returned values, and details on how the verb interacts with other SLI
verbs.
• Chapter 6, Sample LUA Application, describes the SNAplus2 sample LUA application that illustrates the use
of LUA RUI verbs. This chapter also includes instructions for compiling, linking, and running the sample
application (including the SNAplus2 configuration steps necessary).
• Appendix A, Return Code Values, lists all the possible return codes in the LUA interface in numerical order and
gives their meanings.
Typographic Conventions
Table 1, Typographic Conventions shows the typographic styles used in this document.
Table 1 Typographic Conventions
Special Element Sample of Typography
Emphasized words back up files before deleting
Document title HP-UX SNAplus2 Administration Guide
File or path name
/usr/spool/uucp/myfile.bkp
Program or application
snaadmin
Command or HP-UX utility
define_node; cd
General reference to all commands of a particular type
query_* (indicates all of the administration com-
mands that query details of a resource)
Option or flag
-i
Parameter or Motif field
opcode; LU name
Literal value or selection that the user can enter (in-
cluding default values)
255; On node startup
Constant or signal
AP_GET_LU_STATUS
Return value
AP_INVALID_FORMAT; 0;
−1
Variable representing a supplied value
filename; LU_name; user_ID
Environment variable
PATH
Programming verb GET_LU_STATUS
User input
0p1
Computer output
CLOSE
10