Youcan use the open or the openx subroutine call to open the SSA adapter device
driver.If you use the openx subroutine call, set the ext parameter to 0, because the call
does not use it.
Summary of SSA Error Conditions
If an open or ioctl subroutine that has been issued to an SSAadapter fails, the
subroutine returns -1, and the global variable errno is set to a value from the file
/usr/include/sys/errno.h.
Possible errno values for the SSAadapter device driver are:
EINVAL Anunknown ioctl was attempted or the parameters supplied were not valid.
EIO An I/O error occurred.
ENOMEM
The command could not be completed because not enough real memory or
paging space was available.
ENXIO The requested device does not exist.
Managing Dumps
The SSAadapter device driver is a target for the system dump facility.
The DUMPQUERY option returns a minimum transfer size of 0 bytes and a maximum
transfer size that is appropriate for the SSAadapter.
Tobe processed, calls to the SSA adapter device driver DUMPWRITE option should
use the arg parameter as a pointer to the SSA_Ioreq_t structure, which is defined in
/usr/include/sys/ssa.h. Using this interface, commands for which the adapter provides
support can be run on a previously started (opened) target device. The SSAadapter
device driver ignores the uiop parameter.
Note: Only the SsaMCB.MCB_Result field of the SSA_Ioreq_t structure is set at
completion of the DUMPWRITE. During the dump, no support is provided for
error logging.
If the dddump entry point completes successfully,it returns a 0. If the entry point does
not complete successfully,it returns one of the following:
EINVAL Arequest that is not valid was sent to the adapter device driver; for example, a
request for the DUMPSTARToption was sent before a DUMPINIT option had
been run successfully.
EIO The adapter device driver was unable to complete the command because the
required resources were not available, or because an I/O error had occurred.
ETIMEDOUT
The adapter did not respond with status before the passed command time-out
value expired.
Chapter13. Using the Programming Interface 259