User guide

9: Client Applications — Commands and Responses
DC 900-1338I 169
9.2.5 Activating an ICP Link (Bind)
After dlOpen has been called and an attach message written to the ICP, the link can be
configured (Section 9.2.7.1 on page 175). After the link is configured, it is necessary to
request the ICP to start the link’s receiver and transmitter. Starting (enabling) the link
is accomplished by sending a bind message to the ICP. The
bind command activates one
of the ICP’s links by initializing flags and turning on that link’s receiver. This is accom-
plished by issuing a call to
dlWrite with the optional argument structure set as shown in
Figure 9–8.
From the ICP’s perspective, when the application sends a
bind command to the ICP, the
ICP completes all preparations to receive and transmit on the specified link. For the
bind command, the fields of the ICP and protocol headers that the ICP receives contain
the following values:
DLI_OPT_ARGS.usFWPacketType FW_DATA
DLI_OPT_ARGS.usFWCommand FW_ICP_WRITE
DLI_OPT_ARGS.usFWStatus n/a
DLI_OPT_ARGS.usICPClientID n/a
DLI_OPT_ARGS.usICPServerID n/a
DLI_OPT_ARGS.usICPCommand DLI_ICP_CMD_BIND
DLI_OPT_ARGS.iICPStatus n/a
DLI_OPT_ARGS.usICPParms [0] n/a
DLI_OPT_ARGS.usICPParms [1] n/a
DLI_OPT_ARGS.usICPParms [2] n/a
DLI_OPT_ARGS.usProtCommand DLI_ICP_CMD_BIND
DLI_OPT_ARGS.iProtModifier n/a
DLI_OPT_ARGS.usProtLinkID Link to start
DLI_OPT_ARGS.usProtCircuitID n/a
DLI_OPT_ARGS.usProtSessionID Protocol Session ID
DLI_OPT_ARGS.usProtSequence n/a
DLI_OPT_ARGS.usProtXParms [0] 0 or DLI_PROT_SEND_BIND (See
Section 9.2.5.1)
DLI_OPT_ARGS.usProtXParms [1] n/a
Figure 9–8: Bind Command Format