技術情報：ミドルウェア

弊社のPOSデバイスは、下記のインターフェースに接続されます。

1. SIO(RS485)
2. USB
3. RS232c

1.及び2.のPOSデバイスをお使いになる場合、POSS(IBM Point of Sale Subsystem)を ご使用いただけます。 POSS(IBM Point of Sale Subsystem) ドライバは主に IBM POS ターミナルのSIO(RS485) インターフェース及びUSBインターフェースに接続される POSデバイスをサポートするためのドライバです。

3.のPOSデバイスをご使用になる際は、アプリケーションからRS232c直接制御する方法も、OPOS/JavaPOS ドライバ経由で制御する方法も可能です。POSS ドライバのインストールは不要です。
4614はSIOインターフェースを持たないためPOSS(IBM Point of Sale Subsystem) ドライバのインストールは不要です。

POSS(IBM Point of Sale Subsystem) ドライバのAPIを使用してアプリケーションを作成することも可能ですが、煩雑となる可能性もあり、併せてOPOS/JavaPOSのドライバのご使用を推奨します。
具体的なモデル名や POS 機器などの詳細は各 POS ターミナルのサポート情報をご参照ください。
尚、POSS for OS/2及びWindows95のサポートは2000年をもって終了いたしました。

上に戻る

POSS/OPOS/JPOS モジュールの明らかな障害に関しては、今後も担当者までご連絡いただければ対応いたします。 こちらをご覧下さい。 なお、問題の切り分けが不十分な場合は差し戻しさせていただく場合があります。予めご了承ください。

POSS、OPOS、JavaPOSは、問題判別のためにトレースを取ることができます。

UPOS1.9.0以降のバージョンのトレース取得方法

トレースを取る場合は、若干のオーバーヘッドがかかります。例えば、ラインディスプレイの表示が緩慢になるなどの状況も見られます。実環境でお使いいただく場合は、必要な時のみにトレースの設定を行うようにしてください。

• c:\pos\bin\aiptraced.exe を起動してください。
• メニューバーから Setup->Tracing を　クリックしてトレースを取得するデバイスの設定を行ってください。
  実サイズを表示
• Options で　必要であれば最大ファイルサイズを定義してください。
• システム起動時からトレースを取る場合は、OptionsのStatup Mode を　Enabledに設定してください。
• メニューバーから Tracing->Enable をクリックしてトレース取得を開始してください。

UPOS1.9.0以前のバージョンのトレース取得方法

トレースファイルは、際限無く追加されていきます。また、若干のオーバーヘッドがかかります。例えば、ラインディスプレイの表示が緩慢になるなどの状況も見られます。実環境でお使いいただく場合は、必要な時のみにトレースの設定を行うようにしてください。

POSSのトレース取得

• トレース ON にするには C:\POS に TRACE.ON というファイルを作成して，リブートしてください。
• トレースが有効になると，C:\POS\LOG に AIPTRACE.LOG というファイルが作られてログが記録されます。
• トレースを OFF にするには，C:\POS の TRACE.ON を消すかリネームしてください。

OPOSのトレース取得

環境変数 AIP_OPOS_LOG_FILE にトレースを取る為のファイル名を指定します。この指定が無いと、C:\AIPOPOS.LOG にとられます。 環境変数AIP_OPOS_TRACEに on を設定する事により、全てのトレースを取る事が出来ます。
加えて、AIP_OPOS_TRACE_ALLにonを設定する事で、詳細なトレースを取ることができます。
環境変数AIP_OPOS_TRACEに取りたいコンポーネントのキーワードを指定する事で、指定されたコンポーネントのみのトレースを取る事が出来ます。以下にキーワードの一覧を示します。なお、複数のキーワードを指定する場合は、セミコロン";"で区切ってください。
トレースファイルは、際限無く追加されていきます。また、若干のオーバーヘッドがかかります。実環境でお使いいただく場合は、必要な時のみにトレースの設定を行うように気を付けてください。

JavaPOSのトレース取得

RS-485 および USB(Windows)

以下の手順でトレースを作成します。

1. jpos.xmlファイルを編集します。
2. その使用しているデバイスのJposEntryの場所をさがします。
3. JposEntryに次の行を追加します。
   <Property name="TraceLevel" type="String" value="4">
   <Property name="TraceFilename" type="String" value="trace.out"/>
   ファイル名 trace.out はどのような名称でもかまいません。トレース出力するファイルとなります。
   このファイルはアプリケーションを起動する度に、appendされるので、トレースファイルを分割したい場合は、 取り除くかリネームする必要があります。
4. 更新を保管し、エディタを終了します。

RS-232 および USB

POS Control Centerにより、以下の手順でデバイスのトレースを取るようにします。

1. POS Control Centerを起動します。
   
   1. Programs -> IBM JavaPOS -> POS Control Center または、
   2. コマンドプロンプトより、java.com.ibm.jpos.tools.sdicc.ControlCenterApp と入力する。
2. ファイル -> プロパティ　を選択する。
3. jutilタブを選択します。
4. 該当するプロパティを変更します。変更項目毎にEnterキーを押します。 TracerOutputTo=Console (default), ファイルにデータが入るようFileをセットします。
   

実サイズを表示

上に戻る

IBM POS Printerのインストール

POS Printerをご使用の場合、以下の設定が必要になる場合があります。

• 4610Printerをご使用の場合
  1. 最新Firmwareの適用
     出荷時には、最新のFirmwareが適用されています。VersionUpする場合には、 製品ダウンロード情報 のユーティリティをご使用ください。
  2. FontのLoad
     出荷時には、DBCSフォントは設定されておりません。Loadするには、 製品ダウンロード情報 のユーティリティとFontをご使用ください。
  3. お客様ロゴの印字設定
     OPOS、JavaPOSのsetBitmap、シーケンスをご使用になり、印字してください。
     
• 4689Printerをご使用の場合
  1. 最新Firmwareの適用
     出荷時には、最新のFirmwareが適用されています。VersionUpする場合には、 製品ダウンロード情報 のユーティリティをご使用ください。
  2. FontのLoad
     出荷時には、フィーチャーコードの指定で初期フォントを選択することができますが、Loadするには、 製品ダウンロード情報 のユーティリティとFontをご使用ください。
  3. お客様ロゴの印字設定
     レシートカットされた際に、印字されます。HWのROMに登録する必要があります。 プリンターロゴ設定プログラム をご使用ください。

IBM System attached POS DBCS Keyboardのインストール

• DBCSDriverへ変更するには、以下の手順でインストールしてください。
  1. コントロールパネルのキーボードを選択する。
  2. ハードウェアのプロパティからドライバの更新を選択する。
  3. デバイスの既知のドライバを表示する。
  4. IBM System attached Point of Sale DBCS Keyboardsを選択し、インストールする。

上に戻る

デバイス初期化例

スタートフォルダなどにアプリケーションを入れた場合、POSSにて接続デバイスを認識する前に、アプリケーションからデバイスの初期化が行われると、107（NOHARDWARE）のリターンコードを返すことがあります。
これを避ける為、下記のようなリトライを推奨しています。
詳細は、POSS Programming Guide（18-10）を参照ください。
Onlineになるまでの調整として、30秒程のSleepとOpenのリトライを推奨いたします。

• [例]
    dim rc as long
    dim NoHardware as boolean
    dim counter as integer
    NoHardware = true
    counter = 0   
    Do while NoHardware and counter <  10
      counter = counter + 1
      rc = keyboard1.open("kbd1")
      if rc  < > 107 then
        NoHardware = False
        if rc < > 0 then
          MsgBox(" Open device problem " & rc)
          return
        end if
      end if
      Sleep(3000)
    Loop
    if rc == 107 then
      MsgBox("No Hardware detected!")
      return
    end if
  

OPOS/JavaPOS1.4以前からのバージョンアップに必要なアプリケーション側の変更

OPOSの仕様変更に伴い、IBM OPOSドライバーでも変更されたメソッドがあります。
下記に示した事項以外の仕様の追加・変更、また詳細な情報については、OPOS技術 協議会の情報を参照してください。

1. コントロール名が変わる為、コントロールを貼り変えてオブジェクト名を変更する。
   全デバイス:OPOS

   例：MSR -> OPOSMSR
       Printer -> OPOSPOSPrinter

2. Claimメソッド名をClaimDeviceに、Releaseメソッド名をReleaseDeviceに変更する。
   全デバイス:OPOS
   
3. MSRの場合、JIS2データは、Track4に入ります。MSR:OPOS,JavaPOS 初期化後のデフォルトは、"MSR_TR_1_2_3"ですので、"MSR_TR_1_2_3_4"を指定してください。
   本件のみ、JavaPOS 1.5も該当します。

• データ取得例：  　 
               msr.TracksToRead = 15 'MSR_TR_1_2_3_4　　　  
               trackData = msr.Track4Data
  

上に戻る