### EasyCics编程知识点详解
#### 一、EasyCICS概览
**1.1 EasyCICS定义**
EasyCICS是一种专门为CICS/TX Series设计的应用接口，它简化了与CICS/TX Series的交互过程，使开发者能够更轻松地进行联机事务处理(OLTP)应用程序的开发。自1999年推出EasyCICS v1.0以来，该接口迅速获得了广泛的认可，并在各行各业中得到广泛应用。
**1.2 易用性与适用范围**
EasyCICS适用于所有级别的CICS/TX Series用户，无论是初学者还是专家都能够从中获益。对于那些仅希望通过CICS/TX Series服务器访问IBM主机系统的用户来说，EasyCICS提供的功能可能较为有限。
**1.3 支持的平台**
- **服务器端支持平台**：
- AIX
- HP-UX
- Solaris
- Windows NT/2000/XP
- **客户端支持平台**：
- AIX
- HP-UX
- Solaris
- Windows NT/2000/XP
- Windows 9X
- Linux
- DOS
#### 二、入门程序示例
**2.1 GETTIME示例解析**
GETTIME是一个简单的示例程序，用于展示如何使用EasyCICS获取服务器当前时间。此示例包含了服务器端和服务端的实现方式。
**2.1.1 服务器端实现（C语言）**
```c
#include <time.h>
#include "easycics.h"
void main() {
struct tm *newtime;
time_t aclock;
if (InitEasyCics()) ExitEasyCics(); // [A] 初始化EasyCICS
BeginWrite(); // [B] 开始写操作
time(&aclock);
newtime = localtime(&aclock);
SetValue("TIME", asctime(newtime)); // [C] 设置时间值
ExitEasyCics(); // [D] 结束EasyCICS
}
```
- `[A]` 表示初始化EasyCICS环境。
- `[B]` 开始写入数据到EasyCICS。
- `[C]` 设置一个名为“TIME”的变量，其值为服务器当前时间。
- `[D]` 结束EasyCICS环境。
**2.1.2 客户端实现**
1. **ANSI C 客户端示例**
```c
#include "ec.h"
void main() {
char s[200];
ConnectServer("CICSNT01", "TEST", "TEST"); // [A] 连接到服务器
CallProgramAndCommit("GETTIME"); // [B] 调用并提交程序
GetValue("TIME", s); // [C] 获取返回的时间值
puts(s);
}
```
- `[A]` 连接到指定的服务器。
- `[B]` 调用并提交GETTIME程序。
- `[C]` 获取名为“TIME”的变量值。
2. **Visual Basic 示例**
```vb
Sub main()
Dim oEc As Object
Dim r%
Set oEc = CreateObject("EasyCics.App") ' [A] 创建EasyCics对象
r = oEc.ConnectServer("CICSNT01", "TEST", "TEST") ' [B] 连接到服务器
oEc.CallProgramAndCommit "GETTIME" ' [C] 调用并提交程序
MsgBox oEc.GetValue("TIME") ' [D] 显示获取的时间值
End Sub
```
- `[A]` 创建EasyCics对象。
- `[B]` 连接到服务器。
- `[C]` 调用并提交GETTIME程序。
- `[D]` 获取并显示时间值。
3. **Java 示例**
```java
import easycics.*;
public class GetTime {
static public void main(String astrArg[]) {
try {
App oEc = new easycics.App(); // [A] 创建EasyCics对象
oEc.ConnectServer("CICSNT01", "TEST", "TEST"); // [B] 连接到服务器
oEc.CallProgramAndCommit("GETTIME"); // [C] 调用并提交程序
System.out.println(oEc.GetValue("TIME")); // [D] 输出时间值
} catch (Exception e) {
e.printStackTrace();
}
}
}
```
- `[A]` 创建EasyCics对象。
- `[B]` 连接到服务器。
- `[C]` 调用并提交GETTIME程序。
- `[D]` 输出时间值。
#### 三、总结
EasyCICS是一个强大的工具，它极大地简化了与CICS/TX Series的交互过程。通过提供丰富的API和跨平台的支持，EasyCICS使得开发者能够快速构建高效且可靠的OLTP应用程序。无论是C语言还是其他高级语言如Java或Visual Basic，开发者都可以利用EasyCICS来创建功能强大的应用程序。这些示例程序不仅展示了EasyCICS的基本使用方法，也为进一步探索和开发提供了基础。
