Exchange identification with peer. Application dependent identification
is passed in Buffer. Peer identification is returned in a DLCONFIRM_XID when the peer responds to
the XID command.
If a response is not received within the response timeout period, the
command is resent. If the frame is resent the number of times specified by
the retry limit without receiving a response, the request completes with
DLFLAG_ERROR set in the DLCONFIRM_XID
primitive.
Flags can be 0 or a combination of the following flags:
DLFLAG_POLL |
Send command with Poll bit set and require response to have Final bit set. This option is usually set to help match the response to the command. |
DLFLAG_BROADCAST |
Send command using broadcast address. |
DLFLAG_INLINE_ADDRESS |
An HDLC address must be prepended to the data in Buffer and Size set to the number of bytes in the address and information field. This address overrides the addresses specified in the MGSL_DLPARAMS structure. |
MgslDlCall returns ERROR_INVALID_REQUEST if the specified
link is a normal response mode secondary station. Secondary stations are
not permitted to send commands.
| Type | DLREQUEST_XID |
| Flags | As described above |
| Size | Size in bytes of information field |
| Buffer | Contains information field (local identification) |
Only one XID, TEST, or CFGR request may be active. Issuing another such
request before the original completes results in a return code of
ERROR_BUSY. Cancel an active request by issuing another
request of the same kind with DLFLAG_CANCEL set in Flags,
Size set to 0, and Buffer unused. A canceled request will not generate an
accompanying confirmation primitive.
| Previous | Contents | Next |