CPI-C for Java

Java 是最近相當受矚目的 Internet 技術； 它是由 Sun Microsystems 所開發的網路計算環境。 Java 之所以好用，有下面兩個原因：

1. 它與平台無關，因此應用程式只要寫一次，即可在各種電腦上執行。
2. 它可以用動態方式下載 ; 也就是說， 程式碼可以常駐於伺服器，再根據需要流到用戶端， 而減少用戶端的安裝成本。

IBM 建立了一個 Java 連結， 連結到通訊共用程式設計介面（CPI-C，為 SNA LU 6.2 的開放式 API）。 此舉可以讓 Java 更適合用在 Java 高度錯誤控制的企業網路上。

Java 工具箱所用的 CPI-C 提供下列各項功能：

• Java 應用程式的 CPI-C 只要寫一次， 即可在任何支援 Java 用 CPI-C 的平台上執行。
• 可將用戶端應用程式移轉到 Java 用 CPI-C， 然後與現有的 APPC 和 CPI-C 伺服器應用程式一起執行， 而不需要變更這些伺服器應用程式。
• 將現有的 CPI-C 程式設計技術運用在現今的 Java 世界

JPing 範例程式

JPing 是一個 CPI-C Java 應用程式範例， 其行為與 ASUITE "APING" 用戶端應用程式類似。 JPing 會與在閘道或工作站上執行的 APING 伺服器處理 (APINGD) 交換資料。 JPing 是從指令行執行，其作業是由在啟動時所給定的指令行引數所控制。

類別檔 JPing.class 包含在 Java Archive (JAR) 檔 CPICJAVA.JAR 當中。 在執行這個範例時，必須告訴 Java 執行環境 (JRE) 在哪裡搜尋類別檔。 下列範例假設 Personal Communications 是安裝在 C:\Program Files\Personal Communications 中。 JRE 是安裝在 JRE 次目錄下， 而 JAR 檔則是安裝在 samples\JPing 次目錄下。

第一個範例是以 -? 選項執行 JPing， 來顯示用法訊息。

C:\Program Files\Personal Communications>jre\bin\jre -cp .\CPICJAVA.JAR JPing -?

Copyright IBM Corporation 1997. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication
or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.

JPing [-s symb_dest] [-n num_iter] [-d data_len]

JRE 所附的 "-cp .\CPICJAVA.JAR"， 可以告訴您 除了在預設位置和 CLASSPATH 環境變數下搜尋類別之外， 還要在 CPICJAVA.JAR 尋找。

下一個範例假設使用者有配置 CPI-C 附屬資訊記錄 "APINGM4"。
這個範例是以 -s APINGM4 CPI-C 符號式目的名稱重複執行 JPing 10 次 :

C:\Program Files\Personal Communications>jre\bin\jre -cp .\CPICJAVA.JAR JPing -s APINGM4 -n 10

-----------------JPing Opening------------------
          OS Name      = Windows 95
  CPI-C Side Info (-s) = APINGM4
Number Iterations (-n) = 10
      Data Length (-d) = 2000
   Max Buffer (cmembs) = 65535

Allocate Time = 0.05 seconds

Version Exchange Time = 0.66 seconds

Server Error Version: 1
ServerVersion: 2.38

Ping Time = 0.11 seconds
Ping Time = 0.05 seconds
Ping Time = 0.11 seconds
Ping Time = 0.06 seconds
Ping Time = 0.05 seconds
Ping Time = 0.11 seconds
Ping Time = 0.06 seconds
Ping Time = 0.05 seconds
Ping Time = 0.06 seconds
Ping Time = 0.11 seconds

Total Ping Time = 0.77
Average Ping Time = 0.077
-----------------JPing Closing------------------