Specifications

54 MDR User Guide
GetServerStatus
Declaration:
STATUS GetServerStatus(void);
and
STATUS GetServerStatus(UINT32 * BootStatus);
and
STATUS GetServerStatus(MDR_OPERATION_STATUS * OperationStatus);
Description: Get the server status.
The first function requests the status of the MDR server. This function should be called
after a successful call to the function
ConnectToServer to check that everything is
correct on the MDR server side.
The second function requests the boot status of the MDR Server. Please refer to the
appendix G for more information on the MDR Server boot status.
The third function requests the operation status of the MDR server. Polling the operation
status of an MDR server can be used to retrieve the progress of an operation (record,
playback, copy, etc.). The
MDR_OPERATION_STATUS structure contains the following
fields:
• Operation: Current server operation (same as server state, see definitions in
MdrDefs.h file)
•
SourceId: Identifier of the source device (see definitions of source devices in
MdrDefs.h file)
•
TargetId: Identifier of the target device (see definitions of target devices in
MdrDefs.h file)
•
BlocksToTransfer: Number of blocks to be transferred during the current
running transfer operation (if the current server operation is a transfer)
• BlocksTransferred: Number of blocks transferred so far during the current
running transfer operation (if the current server operation is a transfer)
•
BlockSize: Size of each block to be transferred during the current running
transfer operation (if the current server operation is a transfer)
Returned value: status of the MDR Server. This value can be among the following
values:
Status Meaning
MDR_SERVER_OK (or OK)
Idle state
MDR_SERVER_ERROR (or ERROR)
Error has occurred
MDR_SERVER_TRANSFERRING
Transferring data (record or playback)
MDR_SERVER_INITIALIZING
Initializing a copy (using tape drive)
MDR_SERVER_COPYING
Copying data (using tape drive)
MDR_SERVER_WAITING_NEXT_TAPE
Waiting for the next tape
MDR_SERVER_WAITING_RIGHT_TAPE
Waiting for the right tape
MDR_SERVER_FORMATTING_DISK
Formatting one or several disks
MDR_SERVER_NOT_CONNECTED_TO_SD
Not connected to any disk group
The errno variable is set accordingly to the status returned. See MdrDefs.h for the
definition of the status and the MDR
errno values.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com