定制设置过程 DFHMAINJ

稳定功能: 中的服务流运行时和服务流建模器功能已稳定。 IBM Developer for z/OS14.2.3 稳定。 考虑通过使用 z/OS Connect Enterprise Edition 或 CICS® 网络服务 ,或使用 Java 或.NET 编写网络应用程序。 Node.js.另请参阅 " 稳定通知 "和 "终止功能 "。

DFHMAINJ 示例任务为 CICS Service Flow Runtime 创建运行库。 它还会将所有系统库复制到运行时库,并根据可在运行作业之前在 JCL 中编辑的一组参数来定制这些库。

开始之前

在开始定制 JCL 之前,请将成员 DFHMAINJ 从 .SCIZSAMP 库复制到新位置。 复制成员可确保应用系统维护或版本升级时不会覆盖对 DFHMAINJ 的任何修改。

过程

编辑 DFHMAINJ ,如下所示:

  1. 指定有效的工作卡,将 hlqual 更改为 CICS SFR 库的高级限定符,将 syshlq 更改为 SMP/E 安装库的高级限定符。
  2. 提供必需参数的值以及任何可选参数 (如果需要)。
    参数列表参见 DFHMAINJ 参数
  3. 可选: 如果要使用 IBM® Enterprise COBOL for z/OS® V5.1 ,请创建 hlqual.SCIZLOAD 作为 PDSE 数据集。 将 SCIZLOAD 的 CREATE 步骤中的 JCL 从 "DSNTYPE = PDS" 更改为 "DSNTYPE = LIBRARY"。
  4. 可选: 缺省情况下,在对库进行定制之前,将验证 DFHMAINJ 中的参数值。 如果不希望进行验证,请编辑 DFHMAINJ 以在 // REXX 步骤中的 DFHMAINR 调用语句上将 validate 更改为 novalidate
  5. 提交 DFHMAINJ 并检查输出。
    您将在 DFHMAINJ 作业输出的 // SYSTSPRT 中看到以下消息:
    DFHMAI1002I SCIZSAMP customization beginning.                   
    DFHMAI1000I Validation of input parameters is taking place.     
    .
    .
    DFHMAI1011I SCIZSAMP customization ended without errors.
    如果您指定的任何参数值存在问题并且已开启验证,那么不会对库进行定制。 作业输出包含一条或多条 DFHMAI 前缀消息,这些消息告诉您哪些参数值会导致错误。
  6. 可选: 如果已在 CICS 区域中安装并定义了 BTS 存储库,那么可以在运行时环境中使用该存储库,而不使用 CICS SFR 创建的新 BTS 文件。 编辑 .SCIZSAMP 中的成员 DFHMASCC 以除去 BTS 文件的 RDO 定义。
    DFHMASET 在运行时仍会创建新的 BTS 文件,但 CICS SFR未引用该文件。

结果

将创建三个运行时库,并将成员复制到其中:
  • .SCIZSAMP ,包含 JCL ,参数成员和样本作业
  • .SCIZMAC ,包含副本
  • .SCIZLOAD ,包含可执行成员
如果作业失败,那么不会进行任何定制。 当您开启了验证时,如果作业中的某个参数值有问题,那么不会进行任何定制。 作业输出包含一条或多条错误消息,说明未进行定制的原因。 更正错误原因后,请重新运行 DFHMAINJ 以在运行时库上执行定制。

示例

定制的 DFHMAINJ JCL 参数将类似于以下 JCL:
*****************************************************************               
JOB1        //++++++++ JOB ,CLASS=M,REGION=0M,                                  
JOB2        //         NOTIFY=&SYSUID,MSGCLASS=H                                
JOB3        //*                                                                 
*                                                                               
SHLQ        ANTZ.DFHMA000.INC10                                               
QUAL        WARDABL.ANTZTEST                                            
VOLSER      P2P210                                                              
RDOLIST     CICSSFRL                                                             
CSDNAME     WARDABL.ZED3.DFHCSD                                                    
HLQCICS     CTS310.CICS640                                                       
HLQCOBOL    PP.COBOL390.V330                                                      
HLQCEE      CEE                                                                                                
WSDIR_REQ   /zfs/wsbind/file/directory/structure/                    
CONFIG_REQ  /usr/lpp/cicsts/samples/pipelines/\                                 
            \basicsoap11requester.xml                                           
SHELF_REQ   /var/cicsts/                                                        
WSDIR_PROV  /zfs/wsbind/file/directory/structure/                               
CONFIG_PROV /usr/lpp/cicsts/samples/pipelines/\                                 
            \basicsoap11provider.xml                                            
SHELF_PROV  /var/cicsts/                                                        
*                                                                               
*****************************************************************               
*                                                               *               
* Optional values.                                              *               
*                                                               *               
*                                                               *               
*****************************************************************               
PREFIX      TEST                                                         
*                                                                               
/*                                                                              
//