ACC X.25 Protocol User's Guide

X.25 Application Programming
ZX25INFO (3X) — ACC X.25
Chapter 4 109
PAR A ME TER S : zxip (Return Param) Address of the user supplied ZCOM
X.25 access data structure. On
successful return, access information
will be setup in this buffer. This data
structure is then used in subsequent
zx25...(3X) calls.
auxname User supplied name to use for
opening the response ZLU. The name
must be unique within the local node.
It may be a maximum of 7 characters
long, plus a terminating NULL.
RETURN VALUE Routine zx25info returns a 0 when successful. If there was a ZCOM error,
it returns a negative value. See /opt/acc/include/zcom/zcomsys.h for
the list of ZCOM error codes and their meanings.
NOTES 1. The auxname parameter is the ZLU name used to open the response
ZLU. If multiple copies of a program will be run, this name should be
made unique for each copy (for example, using the process ID to
generate this name, or using the makezluname routine).
2. In a multi-threaded application, the threads cannot share a global
ZCOM X.25 access data buffer zxip. To call zx25info, each thread
must use a separate buffer and a different ZLU name. Normally,
zx25info should be called AFTER a thread is generated, using a
per-thread buffer.