Liberty 功能部件
CICS® 支持 WebSphere® Application Server Liberty 中的功能部件，这使 Java™ EE 应用程序能够部署到 Liberty JVM 服务器中。
表 2-10 中的所有功能部件都与 CICS 集成方式 Liberty 相关。 除非另有说明，否则这些功能部件在 CICS 标准方式 Liberty 中也受支持，没有任何限制。 表 11 提供了一组 CICS 功能部件，用于将 Liberty 功能部件与 CICS 服务质量集成。
不得同时使用 Java EE 6 和 Java EE 7 中的功能部件。 有关编辑 server.xml的信息，请参阅 服务器配置。
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| beanValidation-1.0 | 提供基于注释的模型，用于验证 JavaBeans。 | |
| beanValidation-1.1 | 提供基于注释的模型，用于验证 JavaBeans。 | |
| cdi-1.2 | 提供了一种机制，可以将 EJB 或受管 Bean 之类的组件注入 JSP 或 EJB 之类的其他组件。 | |
| ejbLite-3.2 | 启用对写入 EJB 规范的 EJB Lite 子集的 Enterprise JavaBeans 的支持。 | 要点: 使用与 EJB 相关的功能部件时，事务属性 NotSupported 受 JTA Liberty 事务系统 (而不是 CICS 工作单元) 的尊重。
|
| el-3.0 | 启用对企业语言 (EL) 3.0 规范的支持。 | |
| jaxrs-2.0 | 为 Liberty 中的 Java API for RESTful Web Services (JAX-RS) 提供支持。 | |
| jaxrsClient-2.0 | 启用对 Java Client API for JAX-RS 2.0的支持。 | jaxrsClient-2.0 功能由 jaxrs-2.0启用。 配置 JAX-RS 2.0 客户机。 |
| jdbc-4.1 | 允许配置 DataSources 以从应用程序访问数据库。 | 创建含针对 Liberty 的类型 2 连接的缺省 CICS DB2 DataSource 注: jdbc-4.0 和 jdbc-4.1 实现位于同一 DB2® JCC 驱动程序中，并且互斥。
|
| jndi-1.0 | 支持 Liberty 的服务器配置中的单个 Java 命名和目录接口 (JNDI) 条目定义。 | |
| jpa-2.1 | 启用对使用应用程序管理的 JPA 和容器管理的 JPA 的应用程序的支持。 | 注: 如果您正在使用 jpa-2.1 ，并且已应用 CICS APAR PI67640(提供 Liberty 的修订包 16.0.0.4 ) ，那么可能会看到以下警告消息:CWWJP9991W Exception Description: Server platform class is
not valid: null可忽略此消息。
|
| jsf-2.2 | 提供对使用 JavaServer Faces (JSF) 框架的 Web 应用程序的支持。 | |
| jsonp-1.0 | 支持定义 Java API 以处理 JavaScript 对象表示法。 包含对 JSON 解析，生成，变换和查询函数的支持。 | |
| jsp-2.3 | 启用对 servlet 和 JavaServer Pages (JSP) 应用程序的支持。 | Java EE 和 Liberty 应用程序 |
| managedBeans-1.0 | 为容器管理的不同 Java EE 组件类型提供公共基础。 向受管 Bean 提供的公共服务包括资源注入、生命周期管理和使用拦截器。 | |
| servlet-3.1 | 提供对编写为 Java Servlet 规范的 HTTP Servlet 的支持。 | Java EE 和 Liberty 应用程序 限制: 使用 servlet 登录和注销 API 不会将用户标识传播到 CICS 任务。
|
| webProfile-7.0 | 提供支持 Java EE 7 Web 概要文件所需的 Liberty 功能部件的方便组合。 | |
| websocket-1.0 | 使 Web 浏览器或客户机应用程序与 Web 服务器应用程序能够使用一个全双工连接进行通信。 | |
| websocket-1.1 | 使 Web 浏览器或客户机应用程序与 Web 服务器应用程序能够使用一个全双工连接进行通信。 |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| appClientSupport-1.0 | 使 Liberty 服务器能够处理客户机模块并支持远程客户机容器。 | 提示: 应用程序客户机模块同时在客户机和服务器中运行。 客户机执行应用程序的特定于客户机的逻辑。 代码的其他部分在服务器上的客户机容器中运行，并将数据从服务器上运行的业务逻辑传输到客户机。 有关更多信息，请参阅 准备和运行应用程序客户机。
|
| batch-1.0 | 启用对 JSR-352中定义的 Java Batch 1.0 API 的支持。 此功能部件不支持打包在企业捆绑软件归档 (EBA) 中的 Java 批处理应用程序。 | |
| concurrent-1.0 | 允许创建受管执行程序，然后允许应用程序提交可并发运行的任务。 | 限制: Liberty JVM 服务器不支持事务属性
ManagedTask.SUSPEND 。限制: 连接到新线程的事务的用户标识始终是连接到父事务的用户标识。
限制: 使用
ManagedThreadFactory 将创建标准 Java 线程，而不是 CICS支持的 Java 线程。 |
| 启用对写入 EJB 3.2 规范的 Enterprise JavaBeans 的支持。 | 企业 JavaBeans (EJB) 要点: 使用与 EJB 相关的功能部件时，事务属性 NotSupported 受 JTA Liberty 事务系统 (而不是 CICS 工作单元) 的尊重。
|
|
| ejbHome-3.2 | 提供对 EJB 2.x API 的支持。 | |
| ejbPersistentTimer-3.2 | 提供对持久 EJB 计时器的支持。 | 限制: 持久存储 EJB 计时器不支持 DB2 JDBC 类型 2 连接。
|
| ejbRemote-3.2 | 提供对远程 EJB 接口的支持。 | |
| jacc-1.5 | 启用对 Java Authorization Contract for Containers (JACC) V 1.5的支持。 | 开发 Java Authorization Contract for Containers (JACC) 授权提供程序 |
| jaspic-1.1 | Java Authentication SPI for Containers (JASPIC) 允许 Java EE Application Server 使用定制认证。 JASPIC 提供程序在 JSR-196中定义。 如果在同一服务器中配置了 JASPIC 提供程序和 TAI ，那么 TAI 没有任何作用。 因此， JASPIC 是标准 Java EE 技术，也是比 TAI for Java EE 应用程序更可移植的解决方案。 | |
| j2eeManagement-1.1 | 提供一组接口，用于管理和监视 JEE 应用程序服务器中的应用程序。 | |
| javaMail-1.5 | 使应用程序能够使用 JavaMail 1.5 API。 | |
| javaee-7.0 | 组合支持 Java EE 7.0 Full Platform 的 Liberty 功能部件。 | |
| jaxb-2.2 | 支持在 Java 类和 XML 表示之间进行映射。 | |
| jaxws-2.2 | 提供对 SOAP Web Service 的支持。 | |
| jca-1.7 | 允许配置资源适配器以从应用程序访问企业信息系统 (EIS)。 | Java EE 连接器体系结构 (JCA) 限制: 在 JCA API
javax.resource.spi.BootstrapContext.createTimer()创建的线程中不支持使用 JCICS API 和 DB2 JDBC 类型 2 连接功能。 对于相同的效果，请使用并发 API (javax.enterprise.concurrent.ManagedScheduledExecutorService)。 |
| jcaInboundSecurity-1.0 | 允许 JCA 入站资源适配器通过扩展 javax.resource.spi.work.SecurityContext 抽象类来流动安全上下文。 |
|
| mdb-3.2 | 允许使用写入 EJB 3.2 规范的消息驱动的 Enterprise JavaBeans 。 MDB 允许以异步方式处理 Java EE 组件中的消息。 | |
| wasJmsClient-2.0 | 通过 JMS API 为应用程序提供对 Liberty 中托管的消息队列的访问权。 | Java 消息服务（JMS） |
| wasJmsSecurity-1.0 | 启用嵌入式消息传递服务器以认证和授权来自客户机的访问权。 | Java 消息服务（JMS） |
| wasJmsServer-1.0 | 在服务器中启用嵌入式消息传递服务器。 应用程序可以使用 wasJmsClient 功能对消息进行操作。 |
Java 消息服务（JMS） |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| json-1.0 | 提供对 JavaScript 对象表示法 (JSON4J) 库的访问权，该库为 Java 环境提供一组 JSON 处理类。 | |
| jta-1.1 | 支持 Java 事务 API (JTA)。 注: Java 事务 API 是受保护的 Liberty 功能部件。
|
Java 事务 API (JTA) |
| jta-1.2 | 支持 Java 事务 API (JTA)。 注: Java 事务 API 是受保护的 Liberty 功能部件。
|
Java 事务 API (JTA) |
| mongodb-2.0 | 提供对 MongoDB Java 驱动程序的支持，并允许在服务器配置中配置远程数据库实例。 应用程序通过 MongoDB API 与这些数据库进行交互。 |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| blueprint-1.0 | 支持部署使用 OSGi 蓝图容器规范的 OSGi 应用程序。 | 限制: 事务属性NotSupported不受 Liberty JVM 服务器支持。
|
| osgi.jpa-1.0 | 此功能部件被同时包含 OSGi 功能部件的 blueprint-1.0 和 jpa-2.0 功能部件取代。 这些功能部件都添加至服务器后，将自动添加此功能部件。 |
|
| wab-1.0 | 提供对企业捆绑软件 (EBA) 中的 Web 应用程序捆绑软件 (WAB) 的支持。 | 创建 OSGi 应用程序项目 注:
wab-1.0 功能部件是 CICS 所必需的，并作为 cicsts:core-1.0 和 cicsts:standard-1.0的一部分进行安装。 |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| microProfile-1.0 | 将支持 Micro Profile for Enterprise Java 的 Liberty 功能部件组合在一起。 | |
| microProfile-1.2 | 将支持 Micro Profile 1.2 for Enterprise Java 的 Liberty 功能部件组合在一起。 | 此功能部件需要 Java 8。 |
| mpConfig-1.1 | 提供统一的机制来访问配置，提供多个源的单一视图。 | 此功能部件需要 Java 8。 |
| mpFaultTolerance-1.0 | 提供对用于企业 Java 的 MicroProfile 容错 API 的支持。 | 此功能部件需要 Java 8。 限制: MicroProfile 容错 1.0 不设计用于处理事务 (UOW 和 JTA 等)。 不应在注释 @Bulkhead， @CircuitBreaker， @Fallback， @Retry 或 @Timeout的方法中对 CICS 资源进行更新。
|
| mpHealth-1.0 | 提供对用于企业 Java 的 MicroProfile 运行状况 API 的支持。 | 此功能部件需要 Java 8。 |
| mpJwt-1.0 | 支持 Web 应用程序或微服务使用 JSON Web 令牌 (JWT) 来认证用户，而不是已配置的用户注册表。 | 此功能部件需要 Java 8。 属性 属性 |
| mpMetrics-1.0 | 提供对用于企业 Java 的 MicroProfile 度量 API 的支持。 | 此功能部件需要 Java 8。 |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| batchManagement-1.0 | 为 Java 批处理容器提供受管批处理支持。 这包括批处理 REST 管理界面、作业日志记录支持以及命令行实用程序，以进行外部调度程序集成。 | |
| distributedMap-1.0 | 提供可通过 DistributedMap API 访问的本地高速缓存服务。 |
|
| localConnector-1.0 | 允许使用 JVM 内置的本地 JMX 连接器访问服务器中的 JMX 资源。 | Java 管理扩展 API (Java Management Extensions API ， JMX) |
| monitor-1.0 | 使用 JMX 客户机启用 Liberty 运行时组件的性能监视。 | Java 管理扩展 API (Java Management Extensions API ， JMX) |
| osgiConsole-1.0 | 启用了 OSGi 控制台来辅助运行时调试。 | 对 Java 应用程序进行故障诊断 |
| restConnector-1.0 | 支持 JMX 客户机通过基于 REST 的连接器进行远程访问，并且需要 SSL 和用户安全性配置。 | Java 管理扩展 API (Java Management Extensions API ， JMX) |
| sessionDatabase-1.0 | 启用与使用 JDBC的数据源的 HTTP 会话的持久性。 | |
| webCache-1.0 | 对 Web 响应启用本地高速缓存。 它包含 distributedMap 功能部件，并对 Web 应用程序响应执行自动高速缓存，以提高响应时间和吞吐量。 |
|
| wmqJmsClient-2.0 | 通过 JMS 2.0 API 为应用程序提供对 IBM MQ 上托管的消息队列的访问权。 |
限制: 仅当 JMS 应用程序使用客户机方式传输连接到 IBM MQ 时才支持。 需要 IBM MQ Resource Adapter for Liberty 的 V9.0.1 。
重要信息: 此限制也适用于 CICS 标准方式 Liberty。
|
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| appSecurity-1.0 | 提供保护服务器运行时环境和应用程序的支持。 appSecurity-2.0 supercedes appSecurity-1.0。 |
为 Liberty JVM 服务器配置安全性 |
| appSecurity-2.0 | 提供保护服务器运行时环境和应用程序的支持。 appSecurity-2.0 取代 appSecurity-1.0。 |
为 Liberty JVM 服务器配置安全性 |
| jwt-1.0 | 允许运行时创建 JWT 令牌。 | |
| ldapRegistry-3.0 | 支持将 LDAP 服务器用作用户注册表。 可以使用任何支持 LDAP V3.0 的服务器。 可配置多个 LDAP 注册表，然后对它们进行联合以获得单个逻辑注册表视图。 | 使用已分发的身份映射为 Liberty JVM 服务器配置安全性 |
| oauth-2.0 | 支持 Web 应用程序集成 OAuth 2.0 以认证和授权用户。 | 使用 OAuth 2.0 进行授权 |
| openidConnectClient-1.0 | 支持 Web 应用程序集成 OpenID Connect Client 1.0 以认证用户，而不是认证已配置的用户注册表。 | |
| openidConnectServer-1.0 | 支持 Web 应用程序集成 OpenID Connect Server 1.0 以认证用户，而不是认证已配置的用户注册表。 | |
| ssl-1.0 | 提供对安全套接字层 (SSL) 连接和 SAF 密钥环的支持。 | 使用 RACF 为 Liberty JVM 服务器配置 SSL (TLS) |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| zosTransaction-1.0 | 使 Liberty 能够在 z/OS® 资源恢复服务 (RRS) ，应用程序服务器的事务管理器和资源管理器之间同步和管理事务活动。 | 只有在 CICS 标准方式 Liberty 中使用 BINDINGS 方式传输连接到 IBM MQ 的 JMS 应用程序才支持 限制:
zosTransaction-1.0 。 |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| beanValidation-1.0 | 提供基于注释的模型，用于验证 JavaBeans。 | |
| beanValidation-1.1 | 提供基于注释的模型，用于验证 JavaBeans。 | |
| cdi-1.0 | 提供了一种机制，可以将 EJB 或受管 Bean 之类的组件注入 JSP 或 EJB 之类的其他组件。 | |
| ejbLite-3.1 | 启用对写入 EJB 规范的 EJB Lite 子集的 Enterprise JavaBeans 的支持。 | 限制: 事务属性NotSupported不受 Liberty JVM 服务器支持。
|
| jndi-1.0 | 支持 Liberty 的服务器配置中的单个 Java 命名和目录接口 (JNDI) 条目定义。 | |
| jpa-2.0 | 启用对使用应用程序管理的 JPA 和容器管理的 JPA 的应用程序的支持。 | |
| jsf-2.0 | 提供对使用 JavaServer Faces (JSF) 框架的 Web 应用程序的支持。 | |
| jsp-2.2 | 启用对 servlet 和 JavaServer Pages (JSP) 应用程序的支持。 | Java EE 和 Liberty 应用程序 |
| servlet-3.0 | 提供对编写为 Java Servlet 规范的 HTTP Servlet 的支持。 | Java EE 和 Liberty 应用程序 限制: 使用 servlet 登录和注销 API 不会将用户标识传播到 CICS 任务。
|
| webProfile-6.0 | 提供支持 Java EE 6 Web 概要文件所需的 Liberty 功能部件的方便组合。 |
| Liberty 功能部件 | Liberty 功能部件描述 | 在 CICS 中使用此功能 |
|---|---|---|
| jaxb-2.2 | 支持在 Java 类和 XML 表示之间进行映射。 | |
| jaxrs-1.1 | 为 Liberty 中的 Java API for RESTful Web Services (JAX-RS) 提供支持。 | |
| jaxws-2.2 | 提供对 SOAP Web Service 的支持。 | |
| jca-1.6 | 允许配置资源适配器以从应用程序访问企业信息系统 (EIS)。 | Java EE 连接器体系结构 (JCA) 限制: 在 JCA API
javax.resource.spi.BootstrapContext.createTimer()创建的线程中不支持使用 JCICS API 和 DB2 JDBC 类型 2 连接功能。 相反，对于相同的效果，请使用并发 API (javax.enterprise.concurrent.ManagedScheduledExecutorService)。 |
| jcaInboundSecurity-1.0 | 允许 JCA 入站资源适配器通过扩展 javax.resource.spi.work.SecurityContext 抽象类来流动安全上下文。 |
|
| jdbc-4.0 | 允许配置 DataSources 以从应用程序访问数据库。 | 创建含针对 Liberty 的类型 2 连接的缺省 CICS DB2 DataSource 注:
jdbc-4.0 和 jdbc-4.1 实现位于同一 DB2 JCC 驱动程序中，并且互斥。 |
| jms-1.1 | 允许配置资源适配器以使用 Java 消息服务 API 访问消息传递系统。 | Java 消息服务（JMS） |
| jmsMdb-3.1 | 允许使用 JMS 消息驱动的 Enterprise JavaBeans。 MDB 允许以异步方式处理 Java EE 组件中的消息。 | |
| mdb-3.1 | 允许使用消息驱动的 Enterprise JavaBeans。 MDB 允许以异步方式处理 Java EE 组件中的消息。 | |
| wasJmsClient-1.1 | 通过 JMS API 为应用程序提供对 Liberty 中托管的消息队列的访问权。 | Java 消息服务（JMS） |
| wasJmsSecurity-1.0 | 启用嵌入式消息传递服务器以认证和授权来自客户机的访问权。 | Java 消息服务（JMS） |
| wasJmsServer-1.0 | 在服务器中启用嵌入式消息传递服务器。 应用程序可以使用 wasJmsClient 功能对消息进行操作。 |
Java 消息服务（JMS） |
有关这些功能部件中的功能的更多信息，请参阅 Liberty 的文档 ( Liberty 概述)。 有关 Liberty 限制的详细信息，请参阅 运行时环境已知限制。
下表提供了一组 CICS 功能部件，用于将 Liberty 功能部件与 CICS 服务质量集成。 可以通过在 JVM 概要文件中指定 CICS_WLP_MODE 来设置 Liberty JVM 服务器方式。
| CICS 功能部件 | CICS Liberty 方式 | 描述 | 使用此 CICS 功能 |
|---|---|---|---|
| cicsts:core-1.0 | 集成方式 | 提供核心 CICS 功能， Java 事务 API (JTA) 1.0 和 wab-1.0。 |
使用集成方式 CICS Liberty 时需要此功能部件。 限制: 在添加或除去此功能部件之前，应禁用 JVM 服务器。
|
| cicsts:defaultApp-1.0 | 集成方式和标准方式 | 验证 Liberty 服务器是否正在运行，并提供有关服务器配置的信息。 使用 FileViewer servlet 浏览 JVM 概要文件， JVM 服务器日志， Liberty server.xml和消息日志。 | 配置 CICS 缺省 Web 应用程序 |
| cicsts:distributedIdentity-1.0 | 集成方式和标准方式 | 提供对分布式身份映射的支持。 | 使用已分发的身份映射为 Liberty JVM 服务器配置安全性 |
| cicsts:jcaLocalEci-1.0 | 集成方式 | 提供本地优化的 JCA ECI 资源适配器，用于调用 CICS 程序。 | 使用 JCA 本地 ECI 资源适配器 限制: 在添加或除去此功能部件之前，应禁用 JVM 服务器。
|
| cicsts:jdbc-1.0 | 集成方式和标准方式 | 支持应用程序访问使用 JDBC的本地 CICS DB2 数据库。 此功能已被 jdbc-4.0 和 jdbc-4.1取代，但与 DriverManager直接配合使用时除外。 | 获取到数据库的连接 限制: 在添加或除去此功能部件之前，应禁用 JVM 服务器。
|
| cicsts:link-1.0 | 集成方式 | 提供支持以启动在 Liberty JVM 服务器中作为 CICS 事务的初始程序运行的 Java EE 应用程序，或者使用来自任何 CICS 程序的 LINK， START或 START CHANNEL 命令来启动该应用程序。 | 从 CICS 程序链接到 Java EE 应用程序 |
| cicsts:security-1.0 | 集成方式和标准方式 | 提供 Liberty 安全性与 CICS 安全性的集成，包括线程身份的传播。 | 为 Liberty JVM 服务器配置安全性 限制: 在添加或除去此功能部件之前，应禁用 JVM 服务器。
|
| cicsts:standard-1.0 | 标准方式 | 支持用户将 Liberty 应用程序从其他平台移植到 CICS ，而无需更改应用程序。 标准方式适用于托管为 Java EE Full Platform 编写并依赖于该平台的应用程序，但不需要与 CICS完全集成。 此功能部件包含 CICS所需的 wab-1.0 。 |
CICS 标准方式 Liberty：Java EE 7 Full Platform 支持，未与 CICS 完全集成 |
| cicsts:zosConnect-1.0 | 集成方式 | 将 z/OS Connect 与 CICS Liberty JVM 服务器集成。 | 配置 z/OS Connect EE 限制: 在添加或除去此功能部件之前，应禁用 JVM 服务器。
|
| cicsts:zosConnect-2.0 | 集成方式 | 将 z/OS Connect 与 CICS Liberty JVM 服务器集成。 | 配置 z/OS Connect EE 限制: 在添加或除去此功能部件之前，应禁用 JVM 服务器。
|