Atom 订阅源样本程序

样本包括：

Atom 订阅源的 DFH0W2F1 - COBOL 样本服务例程

样本服务例程 DFH0W2F1 是一个 COBOL 程序，用于处理针对使用 CICS 样本文件 FILEA 中数据的 Atom 条目的 GET、POST、PUT 和 DELETE 请求。 您可以将这些交互作为一个模型，以便在您自己的服务例程中处理资源。

DFH$W2S1 - C 示例服务例程

样本服务例程 DFH$W2S1 是用 C 语言编写的程序，该程序显示了用户编写的服务例程如何读取 DFHATOMPARMS 容器中的参数、更新元数据和内容容器（例如，DFHATOMTITLE 和 DFHATOMCONTENT）以及更新并返回 DFHATOMPARMS 容器。

有关 DFH$W2S1 工作方式的详细信息，请参阅 针对 Atom 订阅源的DFH$W2S1 C 样本服务例程。

FILEA 中的样本 Atom 订阅源

CICS 提供了一组资源，用于直接从 CICS将 CICS 样本文件 FILEA 作为 Atom 订阅源提供服务。

下表中显示的组件用于为该 Atom 订阅源提供服务。

表 1. 用于运行 DFH0W2F1 的组件

组件	用途	位置
URIMAP 资源 DFH$W2F1	处理针对使用 FILEA 的 Atom 订阅源的 HTTP 请求	CICS 组 DFH$WEB2 或您的副本
ATOMSERVICE 资源 DFH$W2F1	用于生成 Atom 订阅源的名称资源	CICS 组 DFH$WEB2 或您的副本
Atom 配置文件 filea.xml	为 Atom 订阅源文档和 Atom 条目提供元数据和结构	USSHOME/samples/web2.0/atom
XML 绑定 filea.xsdbind 和 XML 模式 filea.xsd	通知 CICS 有关 FILEA 中记录的结构	USSHOME/samples/web2.0/atom

使用这些组件设置 Atom 订阅源时，针对 Atom 订阅源的 Web 客户机请求的 URL 如下：

http://host:port/atom/f/filea/feed

其中，host 和 port 是用于该 Atom 订阅源的 TCPIPSERVICE 资源的主机名和端口号。

Atom 订阅源的样本服务例程位于 SDFHSAMP 样本库中。 Atom 订阅源的样本资源位于以下两个位置：

• CICS 资源组 DFH$WEB2。
• z/OS UNIX 上 CICS 文件根目录的 /samples/web2.0/ 子目录，由 CICS 系统初始化参数 USSHOME 指定。 USSHOME 的默认值是 CICS® TS 6. 3 ， /usr/lpp/cicsts/cicsts63。

资源组 DFH$WEB2 中的 CICS 资源使用路径 /usr/lpp/cicsts/cicsts63/samples/web2.0/(基于 USSHOME的缺省值) 来引用 /samples/web2.0/ 子目录中的文件。 如果 CICS 区域的 USSHOME 系统初始化参数指定了 z/OS UNIX 上 CICS 文件的非默认根目录，则必须完成以下步骤才能使用样本：

1. 将资源组 DFH$WEB2 复制到新的资源组。
2. 修改 DFH$WEB2 组副本中的 URIMAP 资源定义，将 HFSFILE 属性中出现的默认目录（例如 CICS TS 6. 3 的 /usr/lpp/cicsts/cicsts63 ）更改为 CICS 区域用于 CICS z/OS UNIX 上文件的根目录名称。
3. 修改 DFH$WEB2 组副本中的 ATOMSERVICE 资源定义，将 CONFIGFILE 和 BINDFILE 属性中出现的默认目录（例如， /usr/lpp/cicsts/cicsts63 ，用于 CICS TS 6. 3 ）更改为 CICS 区域在 z/OS UNIX 上用于 CICS 文件的根目录名称。