ACC X.25 Protocol User's Guide

84 Chapter4
X.25 Application Programming
X25STAT (3X)
PARAMETERS: req The request code associated with the terminal
operation. This will be returned either with a zread ca ll
for a type 6 (ZCOM_MSTYPE_RSLT) or 14
(ZCOM_MSTYPE_RSRT) m essage
(zmhd.mrq.mrqcode), or will be known from the call
context for a mode 8 zsend, zcntl,orzport call.
stat Status code (ZCOM error code if < 0).
NOTES This routine reads a message file for the status message text. It uses the
file zstatmsg.msg in /opt/acc/msg (ZCOM_MESSAGE_PATH). If not
found, it uses the default message file default.msg.
RETURN VALUE Routine x25stat returns a null-terminated character string, which
consists of either a Z COM error or X.25 status message.
EXAMPLE
#include <zcom/zcomsys.h>
#include <zcom/zcomcall.h>
char *message; /* Returned message string */
int32 req;
int32 stat;
message = x25stat (req, stat);
FILES /opt/acc/include/zcom/zcomsys.h ZCOM subs ystem g eneral include
file, containing data types, data
structures, constants, error codes,
masks, etc. Note that this must be the
first include file before any other
ZCOM i nclude files.
/opt/acc/include/zcom/zcomcall.h ZCOM routine function prototypes
(requires ANSI C com pilation).