[ Previous |
Next |
Contents |
Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference
N_DISCON_REQ Primitive
Purpose
Requests that an existing connection be disconnected.
Structure
This primitive consists of one M_PROTO message block with the following structure:
typedef struct {
ulong PRIM_type;
ulong DISCON_reason;
ulong RES_length;
ulong RES_offset;
ulong SEQ_number;
} N_discon_req_t;
(Optionally followed by clear user data.)
Description
The N_DISCON_REQ primitive requests that the network service (NS) provider either disconnect an existing connection or deny a request for a network connection. This primitive is user-originated.
The format of the message is one M_PROTO message block, followed by one or more M_DATA message blocks that indicate user data. Any integral number of octets of data, up to the network's clear user data limit, can be sent provided the length is even.
Parameters
PRIM_type |
Specifies the N_DISCON_REQ primitive. |
DlSCON_reason |
Not used since all calls are cleared with a diagnostic of 0 (zero). |
RES_length |
Indicates the length of the responding address parameter. The responding address parameter is optional and is present if the primitive indicates rejection of an attempt by an NS user to establish a network connection. The responding address parameter conveys the network address of the NS user entity from which the N_DISCON_REQ primitive was issued. Under certain circumstances, such as call redirection and generic addressing, the value of the responding address parameter may be different from the destination address in the corresponding N_CONN_REQ primitive. |
RES_offset |
Specifies where the responding address begins. The value of this parameter is the offset from the beginning of the M_PROTO message block. |
SEQ_number |
Identifies the sequence number of an N_CONN_IND primitive. This parameter can have two types of values:
>0 |
Identifies the sequence number of the rejected N_CONN_IND message. NPI uses this number to associate the N_DISCON_REQ primitive with an unacknowledged N_CONN_IND primitive that is to be rejected. |
0 |
Indicates the N_DISCON_REQ primitive is rejecting an established network connection (NC). |
|
Acknowledgments
The NS provider should generate one of the following acknowledgments upon receipt of this primitive:
Successful |
Indicated by the N_OK_ACK primitive. |
Unsuccessful |
Non-fatal errors are indicated by the N_ERROR_ACK primitive. |
Error Codes
The applicable non-fatal errors are as follows:
NOUTSTATE |
Indicates the primitive was issued from an invalid state. |
NBADDATA |
Indicates the amount of user data specified was outside the range supported by the NS provider. |
NSYSERR |
Indicates a system error. The error is indicated in the primitive. |
NBADSEQ |
Indicates one of the following conditions:
- The specified sequence number referred to an invalid N_CONN_IND primitive.
- The primitive attempted to reject an established NC, but the value of the sequence number was not 0.
- The primitive attempted to reject an unconfirmed N_CONN_REQ primitive, but the value of the sequence number was not 0.
|
Implementation Specifics
The N_DISCON_REQ primitive is part of X.25 Licensed Program.
[ Previous |
Next |
Contents |
Search ]