The IOCC_ADAPTER_PASSTHRU CommandCode consists of all the CommandModifiers responsible for issuing SCSI-formatted requests to a unit. The following table describes the CommandModifiers:

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³CommandModifier         ³Description                         ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³IOCM_EXECUTE_SCB        ³Issues an IBM Subsystem Control     ³
³                        ³Block (SCB) request to the specified³
³                        ³unit.                               ³
³                        ³Support of this command is optional.³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³IOCM_EXECUTE_CDB        ³Issues a SCSI Command Descriptor    ³
³                        ³Block (CDB) request to the specified³
³                        ³unit.                               ³
³                        ³This command is mandatory for all   ³
³                        ³SCSI units.                         ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

Remarks

Support:

Mandatory for SCSI units
(See CommmandModifiers for exceptions.)
Called By:
OS2DASD.DMD, other device manager, or filter device driver
Context of Call:
TASK, INTERRUPT

Format of IORB

• IORB Type
  -
  IORB_ADAPTER_PASSTHRU
  
  IORBH Fields
  -
  CommandCode
  
  --
  IOCC_ADAPTER_PASSTHRU
  -
  CommandModifiers
  --
  IOCM_EXECUTE_SCB
  --
  IOCM_EXECUTE_CDB
  -
  Valid RequestControl Flags
  --
  IORB_ASYNC_POST
  --
  IORB_REQ_STATUSBLOCK
  --
  IORB_DISABLE_RETRY

  IORB_ADAPTER_PASSTHRU Description

  This section defines the IORB_ADAPTER_PASSTHRU control block. (See the following table.)

  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³Field Name       ³C-Type           ³Length   ³Description      ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³iorbh            ³IORBH            ³DB(68)   ³IORB header      ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³cSGLIST          ³USHORT           ³DW       ³Number of        ³
  ³                 ³                 ³         ³elements         ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³pSGLIST          ³PSCATGATENTRY    ³DD       ³Far pointer to   ³
  ³                 ³                 ³         ³s/g list         ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ppSGLIST         ³ULONG            ³DD       ³Physical address ³
  ³                 ³                 ³         ³of s/g list      ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ControllerCmdLen ³USHORT           ³DW       ³Length           ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³pControllerCmd   ³PBYTE            ³DD       ³Controller       ³
  ³                 ³                 ³         ³command pointer  ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ppSCB            ³ULONG            ³DD       ³Physical SCB     ³
  ³                 ³                 ³         ³pointer          ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³Flags            ³USHORT           ³DW       ³Flags            ³
  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
  

  On entry to the driver:

  iorbh
  See IORB General Format.

  cSGList
  contains the number of scatter/gather elements in the scatter/gather list (pSGLIST), for IOCM_EXECUTE_CDB requests. For all other requests this field contains a 0. pSGLIST
  contains a far pointer to the scatter/gather list, supplied by the caller, for IOCM_EXECUTE_CDB requests. For all other requests this field contains a 0. The scatter/gather list consists of an array of cSGList elements, each pointing to a physically contiguous area of real memory in a format defined by the SCATGATENTRY structure, shown in the following table.

  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  ³Field Name       ³C-Type           ³Length   ³Description      ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³ppXferBuf        ³ULONG            ³DD       ³Physical pointer ³
  ³                 ³                 ³         ³to buffer        ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³XferBufLen       ³ULONG            ³DD       ³Length of buffer ³
  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
  

  ppSGLIST
  contains a 32-bit physical address of the scatter/gather list for IOCM_EXECUTE_CDB requests. For all other requests, this field contains a 0.

  ControllerCmdLen
  contains the length, in bytes, of the command controller buffer.

  pControllerCmd
  contains a pointer to the controller command buffer in either SCB or CDB format, based on the CommandModifier field.

  ppSCB
  contains a 32-bit physical address of the Subsystem Control Block (SCB) for IOCM_EXECUTE_SCB requests. For all other requests, this field contains a 0.

  Flags
  contains flags to define the request, as shown in the following table.

  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  ³Flag                    ³Description                         ³
  ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
  ³PT_DIRECTION_IN         ³Data transfer direction.  This flag ³
  ³                        ³defines the direction of the data   ³
  ³                        ³transfer for IOCM_EXECUTE_CDB       ³
  ³                        ³requests.  If set, the data transfer³
  ³                        ³is from the target device to the    ³
  ³                        ³host adapter.  For all other        ³
  ³                        ³requests, this flag is ignored.     ³
  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
  

  On exit, the driver sets the Status and ErrorCode fields of the IORBH to reflect the results of the IOCC_ADAPTER_PASSTHRU request.

  Return Codes

  Following is a list of the IOCC_ADAPTER_PASSTHRU error codes:

  IOERR_CMD_NOT_SUPPORTED
  IOERR_CMD_SYNTAX
  IOERR_CMD_SGLIST_BAD
  IOERR_CMD_SW_RESOURCE
  IOERR_CMD_ABORTED
  IOERR_UNIT_NOT_ALLOCATED
  IOERR_UNIT_NOT_READY
  IOERR_UNIT_PWR_OFF
  IOERR_ADAPTER_HOSTBUSCHECK
  IOERR_ADAPTER_DEVICEBUSCHECK
  IOERR_ADAPTER_OVERRUN
  IOERR_ADAPTER_UNDERRUN
  IOERR_ADAPTER_DIAGFAIL
  IOERR_ADAPTER_TIMEOUT
  IOERR_ADAPTER_DEVICE_TIMEOUT
  IOERR_ADAPTER_REQ_NOT_SUPPORTED
  IOERR_ADAPTER_REFER_TO_STATUS
  IOERR_DEVICE_DEVICEBUSCHECK
  IOERR_DEVICE_REQ_NOT_SUPPORTED
  IOERR_DEVICE_DIAGFAIL
  IOERR_DEVICE_BUSY
  IOERR_DEVICE_OVERRUN
  IOERR_DEVICE_UNDERRUN

  For a detailed description of all the return codes, see Error Handling.

  ---

  [Back: IOCC_DEVICE_CONTROL]
  [Next: Device Helpers (DevHlp)]