User guide

164 DC 900-1338I
Protocol Software Toolkit Programmer Guide
9.2.3 Initiating a Session with an ICP Link (Attach)
When the DLI configuration file parameter protocol is set to raw (protocol="raw"), a call
to the
dlOpen function establishes a data path to the ICP for a given link. This path is ref-
erenced by the return value of
dlOpen and is called the session identifier. A call to dlPoll
can be used to verify the success of the dlOpen function. If the status of the new session
is
DLI_STATUS_READY, the open was successful. Next, the data path must be extended
to the ICP with an attach. This is accomplished by issuing a call to
dlWrite with the
optional argument structure set as shown in Figure 9–4.
Note
The ICP returns a protocol session identifier in the usProtSessionID
field. This value must be used in the usProtSessionID field of the
optional arguments structure in all future calls to
dlWrite for this
link.
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_ATTACH
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_ATTACH
DLI_OPT_ARGS.iProtModifier n/a
DLI_OPT_ARGS.usProtLinkID Link the session relates to
DLI_OPT_ARGS.usProtCircuitID n/a
DLI_OPT_ARGS.usProtSessionID n/a
DLI_OPT_ARGS.usProtSequence n/a
DLI_OPT_ARGS.usProtXParms [0] n/a
DLI_OPT_ARGS.usProtXParms [1] n/a
Figure 9–4: Attach Command Format