DLREQUEST_CONFIGURE

Send a configure (CFGR) command to a loop mode secondary station. This is used only by a loop controller. The secondary station should respond with a configure response. When the request completes, the API generates a DLCONFIRM_CONFIGURE primitive.

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_CONFIGURE primitive.

Flags can be set to 0 or any 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.

Type	`DLREQUEST_CONFIGURE`
Flags	As described above
Size	1
Buffer	Configure parameter (1 byte)

MgslDlCall will return ERROR_INVALID_REQUEST if the specified link is a normal response mode secondary station. Secondary stations are not permitted to send commands.

The buffer contains a single byte that sets or clears a specific condition on the secondary station. The byte should be one of the constants in the table below. For all constants except CFGR_CLEAR, the constant CFGR_ON or CFGR_OFF should be logically combined to set or clear the condition.

CFGR (Configure) Parameters
`CFGR_CLEAR`	Clear all conditions.
`CFGR_BEACON_TEST`	Set or clear the beacon test condition. The beacon test suppresses the carrier transmission to the next down loop neighbor, causing it to send BCN (beacon) frames.
`CFG_MONITOR_MODE`	Set or clear the monitor mode condition. This configures the secondary to receiver but not transmit frames.
`CFGR_WRAP`	Set or clear the wrap condition. This causes the secondary to wrap the transmit to the receive.
`CFGR_SELF_TEST`	Initiate a self test on the secondary station. The response contains the results of the test.
`CFGR_LINK_TEST`	Set a modified link test condition on the secondary station. This condition controls the format of TEST responses generated by the secondary. The format is application specific.

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.

Contents