com.ibm.dse.services.jxfs.msd
Class JXFSMsd

java.lang.Object
  |
  +--com.ibm.dse.base.DSENotifier
        |
        +--com.ibm.dse.base.Service
              |
              +--com.ibm.dse.services.jxfs.JXFSService
                    |
                    +--com.ibm.dse.services.jxfs.msd.JXFSMsd

public class JXFSMsd
extends JXFSService
implements com.jxfs.general.JxfsConst, com.jxfs.control.msd.JxfsMSDConst

This class implements a Service that manages a JXFS MSD Device Control.

See Also:
Serialized Form

Fields inherited from class com.ibm.dse.services.jxfs.JXFSService
AUTOOPEN_NO, AUTOOPEN_YES, ids, idSyncs, preOpenTimeout, syncTimeout, trace, waitMsgTime
 
Fields inherited from class com.ibm.dse.base.Service
externalizer
 
Fields inherited from class com.ibm.dse.base.DSENotifier
handlersList, name
 
Fields inherited from interface com.jxfs.general.JxfsConst
JXFS_ALL, JXFS_ALM_OFFSET, JXFS_CDR_OFFSET, JXFS_CHK_OFFSET, JXFS_COPYRIGHT, JXFS_DEP_OFFSET, JXFS_E_BUSY, JXFS_E_CANCELLED, JXFS_E_CLAIMED, JXFS_E_CLOSED, JXFS_E_DISABLED, JXFS_E_EXISTS, JXFS_E_FAILURE, JXFS_E_FIRMWARE, JXFS_E_ILLEGAL, JXFS_E_IO, JXFS_E_NOCONTROL, JXFS_E_NOEXIST, JXFS_E_NOHARDWARE, JXFS_E_NOSERVICE, JXFS_E_NOT_SUPPORTED, JXFS_E_NOTCLAIMED, JXFS_E_NOTREMOTE, JXFS_E_OFFLINE, JXFS_E_OPEN, JXFS_E_PARAMETER_INVALID, JXFS_E_REMOTE, JXFS_E_SYSTEM, JXFS_E_TIMEOUT, JXFS_E_UNREGISTERED, JXFS_FOREVER, JXFS_LEVEL_ACTIVE, JXFS_LEVEL_ALL, JXFS_LEVEL_CONFIGURED, JXFS_LEVEL_WORKSTATION, JXFS_MSD_OFFSET, JXFS_O_CLOSE, JXFS_O_OPEN, JXFS_O_UPDATEFIRMWARE, JXFS_PIN_OFFSET, JXFS_PTR_OFFSET, JXFS_RC_SUCCESSFUL, JXFS_RC_UNSUCCESSFUL, JXFS_S_BIN_STATUS, JXFS_S_CLAIMED, JXFS_S_HARDWAREERROR, JXFS_S_MEDIA_STATUS, JXFS_S_POWERSAVEOFF, JXFS_S_POWERSAVEON, JXFS_S_RELEASED, JXFS_S_REMOTEFAILURE, JXFS_S_SERVICE_STARTED, JXFS_S_SERVICE_STOPPED, JXFS_S_SHUTDOWN, JXFS_S_USERACTIONERROR, JXFS_S_WORKING, JXFS_SIU_OFFSET, JXFS_TIO_OFFSET, JXFS_VALID_CONTROLID, JXFS_VERSION_CONTROL, JXFSDEVICE_OFFSET, JXFSDIRECTIO_OFFSET, JXFSERR, JXFSERREXT, NO_MATCH, NO_SOURCE, NO_SUPPORT, OK_NEWER, OK_OLDER, OK_OTHER
 
Fields inherited from interface com.jxfs.control.msd.JxfsMSDConst
JXFS_COPYRIGHT, JXFS_E_CHK_NOTSUPPORTEDCAP, JXFS_E_MSD_BADDATA, JXFS_E_MSD_INVALIDMEDIA, JXFS_E_MSD_MEDIAJAMMED, JXFS_E_MSD_NO_STRIPE, JXFS_E_MSD_NOMEDIA, JXFS_E_MSD_NOTRACKS, JXFS_E_MSD_NOTSUPPORTEDTRACK, JXFS_E_MSD_PARITY, JXFS_E_MSD_READ_EOF, JXFS_E_MSD_READ_OTHER, JXFS_E_MSD_READFAILURE, JXFS_E_MSD_SHUTTERFAIL, JXFS_E_MSD_WRITEFAILURE, JXFS_I_MSD_MEDIA_INSERTED, JXFS_I_MSD_NO_MEDIA_PRESENT, JXFS_MSD_SEC_NOCHECK, JXFS_MSD_SEC_NOTREADY, JXFS_MSD_SEC_SECFAIL, JXFS_MSD_SEC_SECOK, JXFS_MSD_SECTYPE_CIM86, JXFS_MSD_SECTYPE_MMBOX, JXFS_MSD_SECTYPE_NOTSUPPORTED, JXFS_MSD_TYPE_DIP, JXFS_MSD_TYPE_MOTOR, JXFS_MSD_TYPE_SWIPE, JXFS_O_MSD_READDATA, JXFS_O_MSD_WRITEDATA, JXFS_S_MSD_BIN_STATUS, JXFS_S_MSD_MEDIA_STATUS, JXFS_S_MSD_SEC_NOTREADY, JXFS_S_MSD_SEC_READY, JXFS_S_MSD_SEC_STATUS, JXFS_S_MSD_SEC_UNKNOWN, JXFS_VERSION_CONTROL
 
Fields inherited from interface com.jxfs.general.JxfsConst
JXFS_ALL, JXFS_ALM_OFFSET, JXFS_CDR_OFFSET, JXFS_CHK_OFFSET, JXFS_COPYRIGHT, JXFS_DEP_OFFSET, JXFS_E_BUSY, JXFS_E_CANCELLED, JXFS_E_CLAIMED, JXFS_E_CLOSED, JXFS_E_DISABLED, JXFS_E_EXISTS, JXFS_E_FAILURE, JXFS_E_FIRMWARE, JXFS_E_ILLEGAL, JXFS_E_IO, JXFS_E_NOCONTROL, JXFS_E_NOEXIST, JXFS_E_NOHARDWARE, JXFS_E_NOSERVICE, JXFS_E_NOT_SUPPORTED, JXFS_E_NOTCLAIMED, JXFS_E_NOTREMOTE, JXFS_E_OFFLINE, JXFS_E_OPEN, JXFS_E_PARAMETER_INVALID, JXFS_E_REMOTE, JXFS_E_SYSTEM, JXFS_E_TIMEOUT, JXFS_E_UNREGISTERED, JXFS_FOREVER, JXFS_LEVEL_ACTIVE, JXFS_LEVEL_ALL, JXFS_LEVEL_CONFIGURED, JXFS_LEVEL_WORKSTATION, JXFS_MSD_OFFSET, JXFS_O_CLOSE, JXFS_O_OPEN, JXFS_O_UPDATEFIRMWARE, JXFS_PIN_OFFSET, JXFS_PTR_OFFSET, JXFS_RC_SUCCESSFUL, JXFS_RC_UNSUCCESSFUL, JXFS_S_BIN_STATUS, JXFS_S_CLAIMED, JXFS_S_HARDWAREERROR, JXFS_S_MEDIA_STATUS, JXFS_S_POWERSAVEOFF, JXFS_S_POWERSAVEON, JXFS_S_RELEASED, JXFS_S_REMOTEFAILURE, JXFS_S_SERVICE_STARTED, JXFS_S_SERVICE_STOPPED, JXFS_S_SHUTDOWN, JXFS_S_USERACTIONERROR, JXFS_S_WORKING, JXFS_SIU_OFFSET, JXFS_TIO_OFFSET, JXFS_VALID_CONTROLID, JXFS_VERSION_CONTROL, JXFSDEVICE_OFFSET, JXFSDIRECTIO_OFFSET, JXFSERR, JXFSERREXT, NO_MATCH, NO_SOURCE, NO_SUPPORT, OK_NEWER, OK_OLDER, OK_OTHER
 
Constructor Summary
JXFSMsd()
          This constructor creates a JXFSMsd object.
JXFSMsd(java.lang.String aName)
          This constructor creates a JXFSMsd object.
 
Method Summary
 int ejectCardSync()
          Makes an ejectCard call to the jxfs device control and waits for the operation complete event
 int formatAndWriteDataSync(Context aContext, RecordFormat ftrack1, RecordFormat ftrack2, RecordFormat ftrack3, boolean newCard, MSDTracks mwt)
          Makes a writeData call to the jxfs device control and waits for the operation complete event
 void operationCompleteOccurred(com.jxfs.events.OperationCompleteEvent anEvent)
          Receives the operation complete events Manages the particular situation of automatic open
 int readDataAndUnformatSync(com.jxfs.control.msd.JxfsMSDTrackSelection tracksToRead, Context aContext, RecordFormat ftrack1, RecordFormat ftrack2, RecordFormat ftrack3, MSDReadData mrd)
          Makes a readData call to the jxfs device control and waits for the operation complete event
 int retainCardSync()
          Makes an retainCard call to the jxfs device control and waits for the operation complete event
 
Methods inherited from class com.ibm.dse.services.jxfs.JXFSService
cancel, claim, closeSync, finalize, getDeviceControl, getDeviceName, getIniConfigFile, getStatus, initializeFrom, intermediateOccurred, isAutoOpen, isOpened, openSync, registerListener, release, setAutoOpen, setDeviceName, setIniConfigFile, statusOccurred, terminate, toString, waitForID, waitOpen
 
Methods inherited from class com.ibm.dse.base.Service
externalizer, getExternalizer, getTagName, readExternal, readExternal, readObject, removeExternal, setExternalizer, toStrings, toTags, writeExternal, writeExternal
 
Methods inherited from class com.ibm.dse.base.DSENotifier
addHandler, getHandlersList, getName, removeHandler, setName, signalEvent, signalEvent, signalEvent
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

JXFSMsd

public JXFSMsd()
This constructor creates a JXFSMsd object.

JXFSMsd

public JXFSMsd(java.lang.String aName)
        throws java.io.IOException
This constructor creates a JXFSMsd object.
Parameters:
aName - java.lang.String The object name
Throws:
java.io.IOException - The object cannot be created
Method Detail

ejectCardSync

public int ejectCardSync()
                  throws com.jxfs.events.JxfsException
Makes an ejectCard call to the jxfs device control and waits for the operation complete event
Returns:
int - the jxfs result of the operation

formatAndWriteDataSync

public int formatAndWriteDataSync(Context aContext,
                                  RecordFormat ftrack1,
                                  RecordFormat ftrack2,
                                  RecordFormat ftrack3,
                                  boolean newCard,
                                  MSDTracks mwt)
                           throws com.jxfs.events.JxfsException,
                                  DSEException
Makes a writeData call to the jxfs device control and waits for the operation complete event
Parameters:
aContext - com.ibm.dse.base.Context The Context to format the data to write
ftrack1 - com.ibm.dse.base.RecordFormat The RecordFormat to format the data to write track 1
ftrack2 - com.ibm.dse.base.RecordFormat The RecordFormat to format the data to write track 2
ftrack3 - com.ibm.dse.base.RecordFormat The RecordFormat to format the data to write track 3
newCard - boolean The indicator of proceeding with a card already present
mwt - MSDTracks The object returned with info of tracks written
Returns:
int - the jxfs result of the operation

operationCompleteOccurred

public void operationCompleteOccurred(com.jxfs.events.OperationCompleteEvent anEvent)
Receives the operation complete events Manages the particular situation of automatic open
Overrides:
operationCompleteOccurred in class JXFSService
Parameters:
anEvent - com.jxfs.events.OperationCompleteEvent The OperationCompleteEvent event received

readDataAndUnformatSync

public int readDataAndUnformatSync(com.jxfs.control.msd.JxfsMSDTrackSelection tracksToRead,
                                   Context aContext,
                                   RecordFormat ftrack1,
                                   RecordFormat ftrack2,
                                   RecordFormat ftrack3,
                                   MSDReadData mrd)
                            throws com.jxfs.events.JxfsException,
                                   DSEException
Makes a readData call to the jxfs device control and waits for the operation complete event
Parameters:
tracksToRead - JxfsMSDTrackSelection The indicatior of which tracks to read
aContext - com.ibm.dse.base.Context The Context to unformat the data read
ftrack1 - com.ibm.dse.base.RecordFormat The RecordFormat to unformat the data read from track 1
ftrack2 - com.ibm.dse.base.RecordFormat The RecordFormat to unformat the data read from track 2
ftrack3 - com.ibm.dse.base.RecordFormat The RecordFormat to unformat the data read from track 3
jrd - MSDReadData The object returned with data read from every track
Returns:
int - the jxfs result of the operation

retainCardSync

public int retainCardSync()
                   throws com.jxfs.events.JxfsException
Makes an retainCard call to the jxfs device control and waits for the operation complete event
Returns:
int - the jxfs result of the operation