OSI/TS Configuration and Management Manual

NonStop Kernel File-System Interface
OSI/TS Configuration and Management Manual—424831-001
7-23
CONTROL 17 Procedure
If you expect the remote peer to send data with the CC-TPDU, be sure to
provide enough space for the read buffer by specifying a large enough value in
read-count. If the read buffer is not large enough to contain incoming data,
OSI/TS discards the data and completes your request with file-system error 22.
The maximum amount of user data that can be included in a CC-TPDU is 32
octets. The MCW in the read buffer is the same as it was in the write buffer.
Successful completion of the procedure indicates that OSI/TS received a valid
CC-TPDU from the remote peer. When OSI/TS receives a CC-TPDU, it
performs the following checks:
•
If the CC-TPDU includes addresses, the addresses must match the local and
remote TSEL fields sent in the CR-TPDU.
•
Negotiated parameters must be acceptable with respect to the connection-
negotiation procedure.
The application can retrieve the final parameters agreed on by the transport
entities using SETPARAM 10. If the CC-TPDU is invalid or contains invalid
connection-establishment parameters, OSI/TS completes your request by issuing
file-system error 140.
CONTROL 17 Procedure
To request a transport connection using CONTROL 17, your application issues a
call with the following syntax:
OSI/TS responds to this request by preparing and sending a CR-TPDU. OSI/TS
chooses connection-establishment parameters for the CR-TPDU according to the
attributes of the subdevice named in filenum.
AWAITIO procedure call
If the subdevice was opened in the nowait mode, your application must complete
the procedure with a call to the AWAITIO procedure. Successful completion
indicates that OSI/TS received a valid CC-TPDU from the remote peer. When
OSI/TS receives a CC-TPDU, it performs the following checks:
•
If the TPDU includes addresses, the addresses must match the local and
remote TSEL fields sent in the CR-TPDU.
•
Negotiated parameters must be acceptable with respect to the connection-
negotiation procedure.
If the CC-TPDU is invalid or contains invalid connection-establishment
parameters, OSI/TS completes your request by issuing file-system error 140.
CALL CONTROL ( filenum, 17, 0 [, tag ] )
Note. The CONTROL 17 procedure does not permit data to be transferred, either by
your application or by the corresponding peer entity, during the connection-
establishment phase.