X25ReadCallDetails(3X25) — Subroutines
Digital
NAME
X25ReadCallDetails − Obtains incoming call details
LIBRARY
X.25 Library (libx25.a)
SYNOPSIS
#include <netx25/x25.h>
int X25ReadCallDetails(
int pd ,
char ∗ epl ,
int ∗ eplLength );
PARAMETERS
pdIdentifies the port on which the incoming call was received.
eplPoints to an Encoded Parameter List in which the incoming call details are returned.
eplLengthPoints to the size of the buffer pointed to by epl. On return eplLength indicates the length of the encoded parameters.
DESCRIPTION
An application executed by the X.25 Application Daemon can obtain the call parameters requested by the calling DTE using the X25ReadCallDetails routine. Applications that are not started by the X.25 Application Daemon should obtain the call details by using the X25Listen routine.
The call parameters are returned in the Encoded Parameter List epl. The length of the data in the epl is returned in the location referenced by eplLength. The valid call parameters are network and subscription dependent, but can include the following:
| Item Code | Description |
| X25I_CALLEDDTE | Called DTE Address |
| X25I_CALLEDEXTISO | Called Address Extension |
| X25I_CALLEDEXTNONISO | Called Address Extension |
| X25I_CALLEDSUBADDR | Called DTE Subaddress |
| X25I_CALLINGDTE | Calling DTE Address |
| X25I_CALLINGEXTISO | Calling Address Extension |
| X25I_CALLINGEXTNONISO | Calling Address Extension |
| X25I_CALLINGSUBADDR | Calling DTE Subaddress |
| X25I_CUG | Closed User Group Closed User Group with Outgoing Access Bilateral Closed User Group |
| X25I_DTECLASS | DTE Class Entity Name |
| X25I_ETEDELAY | End-to-End Transit Delay Negotiation |
| X25I_EXPEDITE | Expedited Data Negotiation |
| X25I_NOEXPEDITE | Expedited Data Negotiation |
| X25I_FASTSELECT | Fast Select |
| X25I_FASTSELECTRESTR | Fast Select Restricted Response |
| X25I_LOCALDTE | Local DTE |
| X25I_MINTHRUCLSIN | Minimum Throughput Class Negotiation |
| X25I_MINTHRUCLSOUT | Minimum Throughput Class Negotiation |
| X25I_NETUSERID | Network User Identification |
| X25I_NONX25FACILITIES | Non-X.25 facilities provided by the local or remote network (only in the case of an internetwork virtual call) |
| X25I_PKTSIZEIN | Flow Control - Packet Size |
| X25I_PKTSIZEOUT | Flow Control - Packet Size |
| X25I_PRIORITY | Quality of Service - Priority |
| X25I_PROTECTION | Quality of Service - Protection |
| X25I_RECVBUFSIZE | Maximum amount of incoming data which can be stored in the port |
| X25I_REDIRECTREASON | Call Redirection or Deflection |
| X25I_RESTRICTED | Gateway Restricted |
| X25I_REVERSECHARGE | Reverse Charging |
| X25I_SENDBUFSIZE | Maximum amount of outgoing data which can be stored in the port |
| X25I_THRUCLSIN | Throughput Class Negotiation |
| X25I_THRUCLSOUT | Throughput Class Negotiation |
| X25I_TRANSITDELAY | Transit Delay Selection and Indication |
| X25I_USERDATA | User Data |
| X25I_WINSIZEIN | Flow Control - Window Size |
| X25I_WINSIZEOUT | Flow Control - Window Size |
Based on the requested facilities, the user can perform one of the following actions:
•Choose to accept responsibility for the call using the X25AcceptCall routine.
•Resubmit the call for rematching against other X.25 Filters using the X25RematchCall routine
•Clear down the virtual circuit using the X25ClearCall and X25ClosePort routines.
The encoded parameter list epl can be interpreted using the X25GetItemList and X25Decode routines. For more information on EPLs, refer to the X.25 for Digital UNIX − Programmer’s Reference Manual.
RETURN VALUES
Upon successful completion, the X25ReadCallDetails routine returns a value of 0. Otherwise, a (negative) error code is returned.
ERRORS
If the X25ReadCallDetails routine fails, one of the following error codes is returned:
[X25RC_BADPD]
Invalid port descriptor specified.
[X25RC_CALLABORT]
An X.25 call arrived at the Digital UNIX host, but was cleared by the network or the remote DTE before the call was accepted with the X25AcceptCall routine. You may need to increase the Call Timer at the remote DTE if the transit delay through the network is greater than or comparable to the current setting of the timer.
[X25RC_EPLSIZE]
The specified EPL is too small to contain the call detail items. As many of the items as will fit are returned in epl.
[X25RC_INVALSTATE]
The port is not in a valid state to perform the requested operation. There is no call waiting on the specified port.
[X25RC_NETMANCLR]
The call has been cleared by a network management command.
[X25RC_SERVICEDOWN]
The X.25 service is not available because an entity is not in the correct state. Either the X25 Access entity is disabled, or the X25 Protocol entity does not exist.
[X25RC_SYSERR]
An operating system error occurred. The external variable errno is set to indicate the error.
RELATED INFORMATION
Functions: X25ClosePort(3X25), X25Decode(3X25), X25Encode(3X25), X25GetItemList(3X25), X25Listen(3X25), X25MakeCall(3X25), X25RematchCall(3X25).
X.25 for Digital UNIX − Programmer’s Reference Manual.