|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.dse.base.DSENotifier | +--com.ibm.dse.base.Service | +--com.ibm.dse.services.landp.MsreService
Magnetic Stripe Reader and Encoder service. It extends MsreLandp, which interacts with the MSRE hardware through a LANDP server.
Field Summary | |
java.lang.String |
COMPID
|
static int |
RC_ALREADY_OPENED
|
static int |
RC_IN_PROCESS
|
static int |
RC_INVALID_DATA
|
static int |
RC_NOT_OPENED
|
static int |
RC_OK
|
static int |
TIMEOUT_FOREVER
|
Fields inherited from class com.ibm.dse.base.Service |
externalizer |
Fields inherited from class com.ibm.dse.base.DSENotifier |
handlersList,
name |
Constructor Summary | |
MsreService()
MsreService constructor. |
Method Summary | |
void |
addReadListener(ReadListener newListener)
|
void |
addTimeoutListener(TimeoutListener newListener)
|
void |
addWriteListener(WriteListener newListener)
|
int |
cancel()
Cancels a previous read or write operation. |
int |
close()
Closes the device. |
int |
getAllTrackParams(MsreTrackParams[] tp)
Gets the track parameters for all three tracks. |
int |
getCapabilities(MsreCapabilities cap)
Gets the device capabilities. |
int |
getCounters(MsreErrorCounters ec)
Gets the error counters. |
java.lang.String |
getLandpServerName()
Getter for the externalizable parameter landpServerName. |
DeviceStatus |
getStatus()
Gets the device status: OPEN,CLOSED,READING or WRITING. |
boolean |
getTraceFlag()
Returns the trace flag. |
int |
getTrackParams(int trackNum,
MsreTrackParams tp)
Gets track parameters. |
int |
getTrackSelFlags(MsreTrackSelFlags tf)
Gets the track selection flags. |
java.lang.Object |
initializeFrom(Tag aTag)
Initializes the service. |
int |
open()
Opens the device with its default server name. |
int |
open(java.lang.String name)
Opens the device. |
int |
read()
Prepares (arms) the device for reading. |
int |
read(int timeout)
Prepares (arms) the device for reading. |
void |
readCompleted(ReadEvent ev)
Event handler for the ReadEvent event. |
void |
removeReadListener(ReadListener newListener)
|
void |
removeTimeoutListener(TimeoutListener newListener)
|
void |
removeWriteListener(WriteListener newListener)
|
int |
setAllTrackParams(MsreTrackParams[] tps)
Sets the track parameters for all three tracks. |
void |
setLandpServerName(java.lang.String sname)
Setter for the externalizable parameter landpServerName. |
void |
setTraceFlag(boolean tf)
Enables or disables tracing |
int |
setTrackParams(int trackNum,
MsreTrackParams tp)
Sets track parameters. |
int |
setTrackSelFlags(MsreTrackSelFlags tf)
Sets the track selection flags. |
void |
timedOut(TimeoutEvent ev)
Event handler for the TimeoutEvent event. |
java.lang.String |
toString()
Gives an SGML representation of the service and its parameters. |
protected void |
trace(java.lang.String s)
Traces a line to the trace facility. |
int |
write(java.lang.String data)
Prepares the device for writing. |
int |
write(java.lang.String data,
int timeout)
Prepares the device for writing. |
void |
writeCompleted(WriteEvent ev)
Event handler for the WriteEvent event. |
Methods inherited from class com.ibm.dse.base.Service |
externalizer,
getExternalizer,
getTagName,
readExternal,
readExternal,
readObject,
removeExternal,
setExternalizer,
terminate,
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,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Field Detail |
public static final int TIMEOUT_FOREVER
public static final int RC_OK
public static final int RC_ALREADY_OPENED
public static final int RC_NOT_OPENED
public static final int RC_IN_PROCESS
public static final int RC_INVALID_DATA
public java.lang.String COMPID
Constructor Detail |
public MsreService() throws LandpException
Method Detail |
public void addReadListener(ReadListener newListener)
newListener
- ReadListenerpublic void addTimeoutListener(TimeoutListener newListener)
newListener
- TimeoutListenerpublic void addWriteListener(WriteListener newListener)
newListener
- WriteListenerpublic int cancel() throws LandpException
public int close() throws LandpException
public int getAllTrackParams(MsreTrackParams[] tp) throws LandpException
tp
- array of track parameterspublic int getCapabilities(MsreCapabilities cap) throws LandpException
cap
- destination capabilities objectpublic int getCounters(MsreErrorCounters ec) throws LandpException
ec
- destination error counter objectpublic java.lang.String getLandpServerName()
public DeviceStatus getStatus()
public boolean getTraceFlag()
public int getTrackParams(int trackNum, MsreTrackParams tp) throws LandpException
trackNum
- number of track, 1 to 3.tp
- destination track parameterspublic int getTrackSelFlags(MsreTrackSelFlags tf) throws LandpException
tf
- destination flagspublic java.lang.Object initializeFrom(Tag aTag) throws java.io.IOException
aTag
- com.ibm.dse.base.Tagpublic int open() throws LandpException
public int open(java.lang.String name) throws LandpException
name
- the LANDP MSRE server name.public int read() throws LandpException
public int read(int timeout) throws LandpException
timeout
- Time out in seconds.public void readCompleted(ReadEvent ev)
ev
- ReadEvent the read event objectpublic void removeReadListener(ReadListener newListener)
newListener
- ReadListenerpublic void removeTimeoutListener(TimeoutListener newListener)
newListener
- TimeoutListenerpublic void removeWriteListener(WriteListener newListener)
newListener
- WriteListenerpublic int setAllTrackParams(MsreTrackParams[] tps) throws LandpException
tp
- array of track parameterspublic void setLandpServerName(java.lang.String sname)
public void setTraceFlag(boolean tf) throws java.lang.NumberFormatException
tf
- boolean true if trace active, false otherwisepublic int setTrackParams(int trackNum, MsreTrackParams tp) throws LandpException
trackNum
- number of track, 1 to 3.tp
- track parameterspublic int setTrackSelFlags(MsreTrackSelFlags tf) throws LandpException
th
- MsreTrackSelFlags the track selection flags to setpublic void timedOut(TimeoutEvent ev)
ev
- TimeoutEvent the timeout event objectpublic java.lang.String toString()
protected void trace(java.lang.String s)
s
- String the text to tracepublic int write(java.lang.String data) throws LandpException
data
- String the data to write to the magnetic stripe.public int write(java.lang.String data, int timeout) throws LandpException
timeout
- Time out in seconds.data
- String the data to write to the stripe.public void writeCompleted(WriteEvent ev)
ev
- WriteEvent the write event object
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |