Digital

NAME

X29GetParameters − Reads PAD parameters from the remote PAD

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

#include <netx25/x29.h>
int X29GetParameters(

int td ,
X29parameter parameterList[] ,
int parameterCount );

PARAMETERS

tdIdentifies the X.29 terminal for which the PAD parameters are to be read. 
 

parameterList
Specifies the array of X.29 parameters to be read when the routine is called, or the parameters returned from the remote PAD by the routine.
 

parameterCount
Specifies the number of parameters to read from the remote PAD.  To read all the remote PAD parameters, set this parameter to a negative number the absolute value of which indicates the size of the parameterList array provided.  If the value of this parameter is zero, no PAD parameters are returned in parameterList and the return value of the routine indicates the number of PAD parameters available on the remote PAD. 
 

DESCRIPTION

The X29GetParameters routine reads parameters from the remote PAD.  This routine is applicable only to incoming X.29 calls. 
 

RETURN VALUES

Upon successful completion, the X29GetParameters routine returns the number of PAD parameters read from the remote PAD.  If the parameterCount parameter supplied was zero, the return value of the function indicates the number of PAD parameters available on the remote PAD.  If the routine did not complete successfully, a (negative) error code is returned. 
 

ERRORS

 
If the X29GetParameters routine fails, one of the following error codes is returned:

[X25RC_SYSERR]
An operating system error occurred.  The external variable errno is set to indicate the error. 

[X29RC_INVALMSG]
Message not understood by remote PAD.

[X29RC_INVALSEP]
Remote PAD found an invalid parameter separator.

[X29RC_NOPARREF]
No such PAD parameter.  The parameter in error is specified in parameterList[0].reference. 

[X29RC_NOTTY]
The terminal specified is not an X.29 terminal.

[X29RC_PARAMERR]
Unspecified PAD parameter error.  The parameter in error is specified in parameterList[0].reference. 

[X29RC_TIMEDOUT]
The remote PAD did not respond to the request.
 

RELATED INFORMATION

Functions: X29SetParameters(3X25). 

X.25 for Digital UNIX − Programmer’s Reference Manual.