编辑 Atom 配置文件

您可以使用 CICS Explorer® 中的 Atom 配置编辑器来修改现有数据或将其他数据添加到 Atom 配置文件。 您可以在编辑器中更新或添加信息,保存更改,然后就会更新 Atom 配置文件的 XML。

关于此任务

Atom 配置编辑器是用于编辑 Atom 配置文件的缺省编辑器。 如果使用此编辑器,您只要输入属性值,因为编辑器会自动创建 XML。 此外,可以使用文本编辑器来直接编辑 XML。 以下步骤描述了如何使用 Atom 配置编辑器来编辑 Atom 配置文件。

过程

  1. 双击 CICS Explorer中 Project Explorer 中的 Atom 配置文件。 缺省情况下,该文件会在 Atom 配置编辑器中打开。
  2. 为编辑器中列出的其他属性输入值。 此外,可以对 Atom 配置向导填充的字段进行编辑。 Atom 向导字段 表描述了由 Atom 配置向导填充的字段。 表 1 描述了 Atom 配置编辑器中的其他字段。 图 1 显示了 CICS Explorer 中的 Atom 配置编辑器,其中包含基于 filea.xml 样本 Atom 配置文件中的 XML 元素完成的所有字段。
    表 1. Atom 配置编辑器字段
    字段 描述
    根 XML 元素 XML 绑定中的顶级数据结构名称。 只有在 XML 绑定中存在多组转换时,才需要此可选属性。
    订阅源 - 链接 URI Web 客户端用于检索 Atom 订阅源的完整路径。 此路径的开头必须和 URIMAP 资源定义中为 Atom 订阅源声明的部分路径匹配。 您可以省略 URI 的模式和主机部分,仅指定路径部分。 CICS 在向客户机返回 Atom 订阅源时,会为 URI 添加方案和主机部分,以符合 Atom 格式规范。
    窗口大小 CICS 在 Atom 订阅源中所返回条目的缺省数目。 如果将该字段保留为空,会使用缺省窗口大小 8。 只有当 Web 客户端使用订阅源链接 URI 或导航 URI 请求部分 Atom 条目列表时,才会应用窗口大小。
    条目 - 链接 URI 标准 URI 路径,可扩展此路径以应用于任何 Atom 条目文档,并使 Web 客户端能够单独检索这些文档。 路径的开始部分必须与您在 URIMAP 资源定义中为 Atom 指定的部分路径相匹配。 标准路径的其余部分必须和订阅源链接 URI 中指定的完整路径不同。 您可以省略 URI 的模式和主机部分,仅指定路径部分。 CICS 在向客户机返回 Atom 订阅源时,会为 URI 添加方案和主机部分,以符合 Atom 格式规范。
    URI Atom 订阅源的公共部分路径。 向导会使用与缺省 URI 字段中输入的值相同的值填充该字段。 然后向导会在该值后附加 /*。 如果使用向导输入的值或输入不同的 URI,CICS 会动态地创建 URIMAP 资源定义。 如果要使用现有的 URIMAP 资源,您可以清除该字段,然而,必须手动管理 URIMAP 资源。
    事务标识 Atom 订阅源的别名事务名称。 如果未指定事务标识,那么会使用 Atom 订阅源的缺省别名事务标识 CW2A。
    用户标识 用于附加别名事务的缺省用户标识。 连接需要认证以便 CICS 直接从客户机请求已认证的用户标识时,不使用缺省用户标识。 改为使用客户机的已认证用户标识,或者,如果认证失败,则拒绝请求。 如果不需要认证而且没有提供缺省用户标识,那么将使用 CICS 缺省用户标识。
    图 1。 CICS Explorer 中的 Atom 配置编辑器,包含基于 filea.xml 样本 Atom 配置文件中的 XML 元素完成的所有字段
    此截屏显示 Atom 配置编辑器,其中包含基于 filea.xml 样本 Atom 配置文件中的 XML 元素完成的所有字段。 此步骤中的表中描述了该向导的附加字段。
  3. 单击 保存 图标 以保存更改。
    以下代码显示了由 Atom 配置编辑器生成的 XML 元素,其中所有字段均根据 filea.xml 样本 Atom 配置文件完成。
    <?xml version="1.0"?>
    <cics:atomservice xmlns:atom="http://www.w3.org/2005/Atom" 
         xmlns:app="http://www.w3.org/2007/app" 
         xmlns:cics="http://www.ibm.com/xmlns/prod/cics/atom/atomservice" 
         version="2" type="feed">
        <cics:feed window="6">
            <cics:resource name="FILEA" type="file">
                <cics:bind xmltransform="FILEAXML"/>
            </cics:resource>
    
        </cics:feed>
        <cics:urimap uri="http://www.example.com/cics/atom/f/filea/*"/>
        <atom:feed>
            <atom:title>Sample CICS file FILEA</atom:title>
            <atom:link rel="self" href="http://www.example.com/cics/atom/f/filea/feed"/>
            <atom:entry>
                <atom:title>FILEA item</atom:title>
                <atom:link rel="self" href="http://www.example.com/cics/atom/f/filea/entry/"/>
                <atom:content cics:resource="FILEA" cics:type="file"/>
            </atom:entry>
        </atom:feed>
    </cics:atomservice>

结果

这样就会以通过编辑器所做的更改来更新 Atom 配置文件。

下一步操作

Atom 配置编辑器只是基本的入门级编辑器,不支持 Atom 配置文件中所有可能出现的属性。 如果要添加未显示在 Atom 配置编辑器中的属性,那么必须使用 XML 编辑器或文本编辑器。 有关可以使用 XML 编辑器或文本编辑器为 Atom 订阅源配置的 XML 元素的更多信息,请参阅 Atom 元素

如果不需要进一步编辑,您可以将捆绑软件项目作为 .zip 文件,导出至本地文件系统,以部署到 CICS 系统中,或将该项目直接导出至 z/OS UNIX。