CPI-C for Java

最近越来越受到人们的关注的一种 Internet 技术就是 Java；它是由 Sun Microsystems 公司开发的一种支持网络的计算环境。 由于以下两个原因，Java 这种技术广受欢迎：

1. 它与平台无关，因此应用程序只需要编写一次就可以在各种计算机上运行。
2. 它可以动态下载；即，代码可以驻留在一台服务器上，在需要时流向客户机，因此缩减了客户机安装成本。

IBM 创建的 Java 与用于通信的公共编程接口(CPI-C)进行了绑定；CPI-C 是用于 SNA LU 6.2 的开放式 API。 它提高了 Java 对需要高度可靠的企业内部网的适应能力。

CPI-C for Java 工具箱提供了以下能力：

• 只需编写 CPI-C for Java 应用程序一次，就可以在任何支持 CPI-C for Java 的平台上运行
• 将客户机方的应用程序移植到 CPI-C for Java，并用现有的 APPC 和 CPI-C 服务器应用程序运行，而无需对服务器应用程序做任何更改
• 在当今新 Java 世界中利用现有 CPI-C 编程技巧

JPing 样本程序

JPing 是个样本 CPI-C Java 应用程序，它类似于 ASUITE 的 "APING" 客户机应用程序。 JPing 将数据与在网关或工作站上运行的 APING 服务器进程（APINGD）进行交换。 从命令行运行 JPing，它的操作由在启动时给出的命令行变量控制。

类文件 JPing.class 包括在 Java Archive (JAR) 文件 CPICJAVA.JAR 中。 运行样本时，必须告诉 Java 运行时环境 (JRE) 到哪里搜索类文件。 下例假设个人通信安装在 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]

"-cp .\CPICJAVA.JAR" 选项用在 JRE 上是为了表明类搜索除 包括缺省位置和 CLASSPATH 环境变量之外，还应该包括 CPICJAVA.JAR。

下例假设用户配置了 CPI-C 辅助信息记录 "APINGM4"。
该例运行的 JPing 带有 -s APINGM4 CPI-C 符号目的地名称，用于 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------------------