User Manual

Interfacing With the Open SCSI I/O Process (IOP)
Open SCSI for Fibre Channel Controller Integrator’s Manual for HP Integrity NonStop NS-Series Servers—
3-4
Using the WRITEREAD[X] Procedures
buffer
This parameter specifies the buffer that contains control information as well as any
data the application or driver sends to or receives from the device.
On return, the buffer contains updated control information and sense information
that was requested and needed and any data that was read from the device
because of the request.
The buffer consists of these basic components:
•
A header block.
•
A control field whose structure corresponds to that of the CAM control block
(CCB).
•
A sense-buffer field. This field is optional. Sense information is normally
returned when a check condition occurs on the device.
•
A data-buffer field. This field is optional. It must appear when the specified
operation sends data to or receives data from the device.
For a detailed description of the buffer, see Structure of the WRITEREAD Buffer on
page 4-5.
write-count
This parameter specifies the number of bytes that are to be transferred from the
buffer to the IOP. WRITEREAD allows a value in the range 0 through 57344. In
reality, the lower limit is at least the size of the control information.
read-count
This parameter specifies the maximum number of bytes that the application or
driver wants to read back from the IOP. WRITEREAD allows a value in the range 0
through 57344. In reality, the lower limit is at least the size of the control
information.
count-read
This optional parameter is used for waited I/O. It returns the number of bytes
actually read.
tag
The value of this optional parameter uniquely identifies a request when you use
nowait I/O. The system stores the tag value until the I/O operation finishes. At that
time, the system returns the tag value to the program in the tag parameter of the
AWAITIO[X] procedure call.