Attach Forms With Comm Port in Oracle Forms

Question

I am trying to make connection of Oracle forms Builder with my device using comm port but i dnt know the complete procedure to attach the comm with oracle forms also i have no idea to convert asquii data to normal form.Please any one help me to attach comm port with my oracle forms and also convert asqui code which is showing on hyper terminal into normal data.Also I am using oracle forms 6i

Answer 1

Make a java component (PJC) and use a rxtx library (http://rxtx.qbang.org/wiki/index.php/Examples) ...
I have made a PJC to use a RS232 port from oracle forms for Hypercom POS terminal..
Here is my code (in short i will post a component on PJC site (here I can't post a complete code because of 30000 char limit ;) )..
If you look in method "public void init(IHandler handler) " I make a download of rxtxSerial.dll from my forms server and then I call System.loadLibrary("rxtxSerial");"
In other way you must put the dll in windows/system32 path.. This dll is native library for rs232 communication.
If you look at the method "public void doTransaction" you can see the initialization of comm port...
With inputStream and OutputStream you read and write datas to/from your rs232 port..
p.s: the code is not complete but you can see how I made the rs232 communication (also the code is not final ;) )
====================================================
public class PosTerminalPjc extends VBean {
     private static final long serialVersionUID = -8814623494538014849L;
     Properties res = new Properties();
     SerialPort serialPort;
     OutputStream os;
     InputStream is;
     CommPortIdentifier portId;
     Enumeration portList;
     IHandler mHandler;
  Random randomGenerator = new Random();
        char STX = 2;
     char ETX = 3;
     char EOT = 4;
     char ACK = 6;
     char NAK = 15;
     char FS = 28;
     private static final ID COMPORT         = ID.registerProperty("COMPORT"); // serial port (COM1,COM2,COM3,...)
     private static final ID AMOUNT          = ID.registerProperty("AMOUNT"); // amount of the transaction (12)
     private static final ID TRANSACTIONTYPE = ID.registerProperty("TRANSACTIONTYPE"); // SALE, REFUND
  private static final ID EXECUTE         = ID.registerProperty("EXECUTE"); // invoke doTransaction();
  //Output parameters to form
  private static final ID TRANSACTIONPROCESSED  = ID.registerProperty("TRANSACTIONPROCESSED");
  private static final ID TRANSACTIONFLAG       = ID.registerProperty("TRANSACTIONFLAG");
  private static final ID TRANSACTIONNUMBER     = ID.registerProperty("TRANSACTIONNUMBER");
  private static final ID BATCHNUMBER           = ID.registerProperty("BATCHNUMBER");
  private static final ID TRANSACTIONDATE       = ID.registerProperty("TRANSACTIONDATE");
  private static final ID TRANSACTIONTIME       = ID.registerProperty("TRANSACTIONTIME");
  private static final ID TRANSACTIONAMOUNT     = ID.registerProperty("TRANSACTIONAMOUNT");
  private static final ID CARDDATASOURCE        = ID.registerProperty("CARDDATASOURCE");
  private static final ID NUMBERCUSTOMERCARD    = ID.registerProperty("NUMBERCUSTOMERCARD");
  private static final ID EXPIRATIONDATE        = ID.registerProperty("EXPIRATIONDATE");
  private static final ID TERMINALID            = ID.registerProperty("TERMINALID");
  private static final ID MERCHANTID            = ID.registerProperty("MERCHANTID");
  private static final ID COMPANYNAME           = ID.registerProperty("COMPANYNAME");
  private static final ID SEQUENTIALNUMBER      = ID.registerProperty("SEQUENTIALNUMBER");
  private static final ID ERRORDESC             = ID.registerProperty("ERRORDESC");
     //Events
  private static final ID EVT_OK  = ID.registerProperty("EVT_OK"); //custom event if all ok
  private static final ID EVT_ERR = ID.registerProperty("EVT_ERR"); //custom event if error occured
  // state machine variables
     long l_timeout;
     long l_wait_for = 5000; // pos terminal wait for command (5 seconds)
     long l_wait_for_transaction = 62000 * 2; // pos terminal timeout
     long l_second = 1000; // one second
     byte b_retry = 0;
     String dataValue = "";
  byte[] readBuffer = new byte[2000]; //2000 bytes buffer to read rs232 stream
     String comPort = ""; // local variable to store com port name
                                   // (COM1,COM2,...)
     String transactionType = "SALE"; // type of transaction to be executed (SALE
                                                  // or REFUND) default SALE
     String amount = "0"; // default amount value is set to 0
     //output paramerers
  String transactionProcessed = "";
  String transactionFlag = "";
  String transactionNumber = "";
  String batchNumber = "";
  String transactionDate = "";
  String transactionTime = "";
  String transactionAmount = "";
  String cardDataSource = "";
  String numberCustomerCard = "";
  String expirationDate = "";
  String terminalId = "";
  String merchandId = "";
  String companyName = "";
  String sequentialNumber ="";
  String errorDescription;
    public PosTerminalPjc() {
          super();
          System.out.println("============================");
          System.out.println("== State machine POS v1.0 ==");
          System.out.println("== Peter Valencic (c)     ==");
          System.out.println("== 03.04.2012             ==");
          System.out.println("============================");
    System.out.println("java.library.path: "+System.getProperty("java.library.path"));
          try {
               res.load(this.getClass().getResourceAsStream("/res/language.properties")); // load language file
          } catch (Exception ex) {
               System.err.println("Err loading language.properties file: "
                         + ex.toString());
  public void init(IHandler handler)
    super.init(handler);
    this.mHandler = handler;
    System.out.println("init handler ok");
    System.out.println("code base: "+handler.getCodeBase());
    //load dll from codeBase URL
    try
      String mylibName = "rxtxSerial.dll";
      String URLpath = "http://dekani:7777/forms/java/";
      System.out.println("URL: "+ URLpath + mylibName);
      URL libUrl = new URL(URLpath+mylibName);
      System.out.println("libUrlgetFile: " + libUrl.getFile());
      File file = new File(mylibName);
      System.out.println(file);
      if (!file.exists())
      file.createNewFile();
      URLConnection urlc = libUrl.openConnection();
      InputStream in = urlc.getInputStream();
      FileOutputStream out = new FileOutputStream(file);
      byte[] buffer = new byte[1048];
      int read;
      while ((read = in.read(buffer)) != -1){
         out.write(buffer, 0, read); // write
        out.close();
        in.close();
        System.loadLibrary("rxtxSerial");
    catch(Exception exc)
      System.err.println("Exception SystemLoadLibrary: " + exc.toString());
      this.showError(res.getProperty("s_dlg_err_title"),res.getProperty("s_lib"));
  private void doTransaction() throws Exception {
    String sequentialNumber = ""+getRandomInteger(1000,9000,randomGenerator);
          String phase = null; // initial null value for state machine phase
          long l_ack_timeout = 0; //initial value for acknowledge timeout
          // com port check
          if (getComPort().trim().equalsIgnoreCase("")) {
               this.showError(res.getProperty("s_dlg_err_title"),
                         res.getProperty("s_com_invalid"));
          if (this.mHandler != null)
                            CustomEvent ce = new CustomEvent(this.mHandler, EVT_ERR);
                            this.setErrorDescription(res.getProperty("s_com_invalid"));
                            dispatchCustomEvent(ce);
               return;
          // transaction type chek
          System.out.println(this.getTransactionType());
          if (!getTransactionType().equalsIgnoreCase("REFUND")
                    & !getTransactionType().equalsIgnoreCase("SALE")
        & !getTransactionType().equalsIgnoreCase("TICKET")
        & !getTransactionType().equalsIgnoreCase("VOID")
               this.showError(res.getProperty("s_dlg_err_title"),res.getProperty("s_tran_invalid_type"));
      if (this.mHandler != null)
                            CustomEvent ce = new CustomEvent(this.mHandler, EVT_ERR);
                            this.setErrorDescription(res.getProperty("s_tran_invalid_type"));
                            dispatchCustomEvent(ce);
               return;
          portList = portId.getPortIdentifiers();
          while (portList.hasMoreElements()) {
               portId = (CommPortIdentifier) portList.nextElement();
      System.out.println(portId.getName());
               if (portId.getName().equalsIgnoreCase(this.getComPort())) {
                    System.out.println("Port is used : "
                              + portId.isCurrentlyOwned());
                    serialPort = (SerialPort) portId.open("ComDriver", 2000);
                    serialPort.setSerialPortParams(9600, SerialPort.DATABITS_7,
                              SerialPort.STOPBITS_1, SerialPort.PARITY_EVEN);
                    serialPort.notifyOnDataAvailable(true);
                    serialPort.notifyOnOutputEmpty(true);
                    os = serialPort.getOutputStream();
                    is = serialPort.getInputStream();
                    break;
          if (portId == null) {
          this.showError(res.getProperty("s_dlg_err_title"),res.getProperty("s_com_not_found"));
      if (this.mHandler != null)
                            CustomEvent ce = new CustomEvent(this.mHandler, EVT_ERR);
                            this.setErrorDescription(res.getProperty("s_com_not_found"));
                            dispatchCustomEvent(ce);
               return;
    else if (portId.getName().equalsIgnoreCase(this.getComPort()) == false)
              this.showError(res.getProperty("s_dlg_err_title"),res.getProperty("s_com_not_found"));
      if (this.mHandler != null)
                            CustomEvent ce = new CustomEvent(this.mHandler, EVT_ERR);
                            this.setErrorDescription(res.getProperty("s_com_not_found"));
                            dispatchCustomEvent(ce);
      return;
          // state machine infinite loop
          while (true)
               // SEND DATA TO POS TERMINAL
               if (phase == null)
                    System.out.println("start phase");
                    byte[] req = null;
                    //verify transaction type to be SALE or REFUND
                    //if REFUND then transaction number must be specified
                    if (getTransactionType().equalsIgnoreCase("SALE")) {
                         System.out.println("--> SALE send message to the pos terminal");
                         System.out.println("--> amount: " + amount);
                         req = protocolStream("000000"+sequentialNumber+"01100" + FS + amount + FS
                                   + FS + "+0" + FS + "978" + FS + FS + FS + FS + FS
                                   + FS + FS + ETX);
                    else if (getTransactionType().equalsIgnoreCase("REFUND")) {
                         System.out.println("--> REFUND send message to the pos terminal");
                         System.out.println("--> amount: " + amount);
                         System.out.println("--> transaction number: " + getTransactionNumber());
                         req = protocolStream("000000123405100" + getTransactionNumber() + FS + amount
                                   + FS + FS + "+0" + FS + "978" + FS + FS + FS + FS
                                   + FS + FS + FS + ETX);
        else if (getTransactionType().equalsIgnoreCase("VOID")) {
                         System.out.println("--> VOID transaction");
                         System.out.println("--> amount: " + amount);
                         System.out.println("--> transaction number: " + getTransactionNumber());
                         req = protocolStream("000000123410100" + getTransactionNumber() + FS      + FS + FS + "+0" + FS + "978" + FS + FS + FS + FS
                                   + FS + FS + FS + ETX);
        else if (getTransactionType().equalsIgnoreCase("TICKET")) {
                         System.out.println("--> TICKET duplicate");
                           req = protocolStream("000000123413100" + getTransactionNumber() + FS      + FS + FS + "+0" + FS + "978" + FS + FS + FS + FS
                                   + FS + FS + FS + ETX);
        else {
                         //nothing ;)
                    os.write(req);
                    os.flush();
                    l_ack_timeout = System.currentTimeMillis() + 1500;
                    //wait for half second
                    Thread.sleep(500);
                    l_timeout = System.currentTimeMillis() + l_wait_for; //add some time for timeout
                    phase = "TO_POS_ACK";
                    System.out.println("phase: " + phase);
               }//phase null
               //CHECK IF THE TIMEOUT OCCURED
            if (phase.equalsIgnoreCase("TO_POS_ACK") & (l_timeout < System.currentTimeMillis()) & (b_retry < 4))
                b_retry += 1;
                System.out.println("TIMEOUT: " + b_retry);
                l_timeout = System.currentTimeMillis() + l_wait_for;
                if (b_retry >= 4) {
                    System.out.println("Timeout occured");
                    closePort();
                    this.showError(res.getProperty("s_dlg_err_title"),res.getProperty("s_timeout"));
                    break;
          //CHECK FOR THE ACKNOWLEDGE (FIRST RESPONSE FROM POS TERMINAL)
            if (phase.equalsIgnoreCase("TO_POS_ACK") &
                    (l_ack_timeout < System.currentTimeMillis())) {
                try {
                    int numBytes = 0;
                    dataValue = "";
                    while ((numBytes = is.read(readBuffer)) > 0) {
                        dataValue += new String(readBuffer, 0, numBytes, "ASCII");
                    if (dataValue.getBytes().length > 0) {
                        System.out.println("->first byte: " +
                            dataValue.getBytes()[0]);
                        System.out.println("total length: " +
                            dataValue.getBytes().length);
                        //check for ack byte
                        if (dataValue.getBytes()[0] == 6) {
                            System.out.println(
                                "<--ACKNOWLEDGE received from pos terminal");
                            phase = "WAIT_FOR_TRANSACTION";
                            l_timeout = System.currentTimeMillis() + l_wait_for_transaction;
                            System.out.println("-> wait for transaction response");
                } catch (IOException ev) {
          //WAIT FOR TIMEOUT ON MESSAGE (watch dog timer)
            if (phase.equalsIgnoreCase("WAIT_FOR_TRANSACTION") &
                    (l_timeout < System.currentTimeMillis())) {
                System.out.println(
                    "Error receiving response from pos terminal!!!");
                closePort();
                this.showError(res.getProperty("s_dlg_err_title"),
                             res.getProperty("s_response_error"));
              if (this.mHandler != null)
                CustomEvent ce = new CustomEvent(this.mHandler, EVT_ERR);
                this.setErrorDescription(res.getProperty("s_response_error"));
                dispatchCustomEvent(ce);
                break;
          //WAIT FOR SOME DATA TO COME FROM POS TERMINAL OVER RS232
            if (phase.equalsIgnoreCase("WAIT_FOR_TRANSACTION")) {
                try {
                    int numBytes = 0;
                    dataValue = "";
                    Thread.sleep(500);
                    while ((numBytes = is.read(readBuffer)) > 0) {
                        dataValue += new String(readBuffer, 0, numBytes, "ASCII");
                    if (dataValue.getBytes().length > 0) {
                        System.out.println("->first byte: " +
                            dataValue.getBytes()[0] + "|" +
                            dataValue.getBytes()[1]);
                        System.out.println("->ascii: " + dataValue);
                        System.out.println("total length: " +
                            dataValue.getBytes().length);
                        if (dataValue.indexOf("PREKINIL UPORABNIK") != -1) {
                            System.out.println(
                                "Uporabnik je prekinil povezavo!");
                              closePort();
                            //transaction cancelled by user s_user_cancel
                            this.showError(res.getProperty("s_dlg_err_title"),
                                         res.getProperty("s_user_cancel"));
                          if (this.mHandler != null)
                            CustomEvent ce = new CustomEvent(this.mHandler, EVT_ERR);
                            this.setErrorDescription(res.getProperty("s_user_cancel"));
                            dispatchCustomEvent(ce);
                            break;
                        if (dataValue.indexOf("NAPACEN VNOS") != -1) {
                            System.out.println("Napačen vnos");
                            closePort();
                            //invalid user entry
                            this.showError(res.getProperty("s_dlg_err_title"),
                                         res.getProperty("s_user_invalid_entry"));
                           if (this.mHandler != null)
                            CustomEvent ce = new CustomEvent(this.mHandler, EVT_ERR);
                            this.setErrorDescription(res.getProperty("s_user_invalid_entry"));
                            dispatchCustomEvent(ce);
                            break;
                        if (dataValue.indexOf("PROSIM POCAKAJ") != -1) {
                            System.out.println("<-- PROSIM POCAKAJ");
                            continue;
                        //preberemo podatke iz stringe terminala
                        if (dataValue.indexOf("SPREJETO") != -1) {
                            closePort();
                            System.out.println("<-- TRANSAKCIJA SPREJETA");
                            System.out.println(dataValue);
                            StringTokenizer st = new StringTokenizer(dataValue, "\034" );
                            String dv = st.nextToken();
                            sequentialNumber = dv.substring(6,10);
                            transactionProcessed = dv.substring(1, 3);
                            transactionFlag = dv.substring(13,15);
                            transactionNumber = dv.substring(15,21);
                            batchNumber = dv.substring(21,25);
                            transactionDate = dv.substring(25,31);
                            transactionTime = dv.substring(31,37);
                            transactionAmount = st.nextToken();
                            st.nextToken(); //Amount exponent
                            st.nextToken(); //Amount currency
                            cardDataSource = st.nextToken();
                            numberCustomerCard = st.nextToken();
                            expirationDate = st.nextToken();
                            st.nextToken(); // authorization code
                            terminalId = st.nextToken();
                            merchandId = st.nextToken();
                            companyName = st.nextToken();
                            System.out.println("================");
                            System.out.println(transactionProcessed);
                            System.out.println(transactionFlag);
                            System.out.println(transactionNumber);
                            System.out.println(batchNumber);
                            System.out.println(transactionDate);
                            System.out.println(transactionTime);
                            System.out.println(transactionAmount);
                            System.out.println(cardDataSource);
                            System.out.println(numberCustomerCard);
                            System.out.println(expirationDate);
                            System.out.println(terminalId);
                            System.out.println(merchandId);
                            System.out.println(companyName);
                            if (this.mHandler != null)
                              System.out.println("dispatch custom event");
                              CustomEvent ce = new CustomEvent(this.mHandler, EVT_OK);
                              dispatchCustomEvent(ce);
                            return;
                } catch (IOException ev) {
                  System.err.println("Exception sm: " + ev.toString());
            System.out.print('*');
            Thread.sleep(200);
          }//end state machine loop
      * protocolStream prepare the stream to be send over RS232 to POS terminal
      * with LRC cheksum control
      * @param data
      * @return byte[]
     private byte[] protocolStream(String data) {
          char STX = (char) 0x02;
          String tmp = "" + STX + STX + data + "" + getLRC(data);
          System.out.println("PStream: " + tmp);
          for (int i = 0; i < tmp.getBytes().length; i++) {
               System.out.print(tmp.getBytes() + ":");
          return tmp.getBytes();
* close port and stream
private void closePort()
try {
serialPort.close();
is.close();
os.close();
} catch (Exception ee) {
     * Longitudinal Redundancy Check (LRC)
     * @param packet
     * @return String
     private String getLRC(String packet) {
          char[] splitPacket = packet.toCharArray();
          char lrc = 0x00;
          for (int x = 0; x < splitPacket.length; x++) {
               lrc = (char) (lrc ^ splitPacket[x]);
          return "" + (char) lrc;
     private String paddingString(String s, int n, char c, boolean paddingLeft) {
          if (s == null) {
               return s;
          int add = n - s.length(); // may overflow int size... should not be a
          if (add <= 0) {
               return s;
          StringBuffer str = new StringBuffer(s);
          char[] ch = new char[add];
          Arrays.fill(ch, c);
          if (paddingLeft) {
               str.insert(0, ch);
          } else {
               str.append(ch);
          return str.toString();
public boolean setProperty(ID id, Object value)
if (id.toString().equalsIgnoreCase("COMPORT")) {
setComPort((String)value);
System.out.println("RS232 com port: " + getComPort());
return false;
if (id.toString().equalsIgnoreCase("AMOUNT")) {
this.setAmount((String)value);
System.out.println("Amount value: " + getAmount());
return false;
if (id.toString().equalsIgnoreCase("TRANSACTIONTYPE")) {
this.setTransactionType((String)value);
System.out.println("Transaction Type value: " + this.getTransactionType());
return false;
if (id.toString().equalsIgnoreCase("EXECUTE")) {
System.out.println("Invoke pos terminal");
try
doTransaction();
catch(Exception ex)
System.err.println("Execute Exception>> " + ex.toString());
this.showError(res.getProperty("s_dlg_err_title"),res.getProperty("s_gen_exception"));
return false;
return false;
     * Display error message inside oracle form
     * @param title
     * @param exceptionString
     private void showError(String title, String exceptionString) {
          JOptionPane.showMessageDialog(this, exceptionString, title, 0);
Edited by: peterv6i.blogspot.com on May 8, 2012 10:18 AM
Edited by: peterv6i.blogspot.com on May 8, 2012 10:20 AM
Edited by: peterv6i.blogspot.com on May 8, 2012 10:21 AM