Previous Topic: CICS InterfacesNext Topic: UDAS Interfaces

Installation and Configuration › Interface Configuration Enhancements › UCF Interfaces

UCF Interfaces

With Version 18.0, the UCF interfaces have been configured to make installation and maintenance easier by separating user-generated code from the main UCF interface routines. Because of these changes, you must regenerate all of your UCF interfaces when upgrading to Version 18.0.

The remainder of this section describes changes in the way you link your UCF interfaces.

For information on all of the necessary steps to generate a UCF interface, see the System Operations Guide.

UCF CICS Interface

Prior to Version 18.0, UCF CICS front-end and abort session programs contained all of the executable code for UCF front-end and abort session processing, respectively. Now these programs only contain an options table and a small stub module that calls the main processing routines.

Create a UCF CICS Front-end Program

To create a UCF CICS front-end program

  1. Create a UCFCICS source module as described in the System Operations Guide.
  2. Save the UCFCICS source module in your custom source library.
  3. Assemble and link it into your custom load library by executing the z/OS Assemble and Link-Edit JCL
  4. Substitute the name of your UCFCICS source member and insert the following binder statements: 
     INCLUDE CAGJLOAD(UCFCICX0)     
 INCLUDE CUSTLIB(ucffet)
 INCLUDE CUSTLIB(idmscint)
 INCLUDE CUSTLIB(ucfprint)  (Optional)
 INCLUDE CUSTLIB(usridxit)  (Optional)
 SETOPT PARM(AMODE=31,RMODE=24) 
 ENTRY ucfcicse 
 NAME ucfcics(R)
    ucffet

    Specifies the name of your UCF front-end table.

    idmscint

    Specifies the name of your IDMSCINT interface module.

    ucfprint

    Specifies the name of your UCFPRINT exit routine.

    usridxit

    Specifies the name of your USRIDXIT exit routine.

    ucfcicse

    Specifies the entry point name of your UCFCICS options module:

    Note: Use UCFCXEP1 or the name specified as the label on the assembler instruction that invokes the #UCFCICS macro. The assembler label is optional. You cannot use UCFCXEP1 as the assembler label.

    ucfcics

    Specifies the name of your UCF CICS front-end load module.

  5. Define the ucfcics program in the CICS CSD.

    For a template, see the definition of PROGRAM(UCFCICS) in the sample CICSCSD. Note that the program must be defined as RESIDENT.

Create a UCF CICS Abort Session Program

To create a UCF CICS abort session program

  1. Create a UCFCICSZ source module as described in the System Operations Guide.
  2. Save the UCFCICSZ source module in your custom source library.
  3. Assemble and link it into your custom load library by executing the z/OS Assemble and Link-edit JCL
  4. Substitute the name of your UCFCICSZ source member and insert the following binder statements: 
     INCLUDE CAGJLOAD(UCFCIZX0)     
 INCLUDE CUSTLIB(idmscint)
 ENTRY CICZEP 
 SETOPT PARM(AMODE=31,RMODE=24) 
 NAME ucfcicz(R)
    idmscint

    Specifies the name of your IDMSCINT interface module.

    ucfcicz

    Specifies the name of your UCF CICS abort session load module.

  5. Define the ucfcicz program in the CICS CSD.

    For a template, see the definition of PROGRAM(UCFCICZ) in the sample CICSCSD. Note that the program must be defined as RESIDENT.

UCF Batch Interface

Prior to Version 18.0, UCF batch front-end and print support programs contained all the executable code for UCF front-end processing. Now these programs only contain an options table and a small set of executable code that calls the main processing routines that reside in separate modules.

Create a UCF Batch Front-end Program

To create a UCF batch front-end program

  1. Create a UCFBTCH source module as described in the System Operations Guide.
  2. Save the UCFBTCH source module in your custom source library.
  3. Assemble and link it into your custom load library by executing the z/OS Assemble and Link-edit JCL
  4. Substitute the name of your UCFBTCH source member and insert the following binder statements: 
     INCLUDE CUSTLIB(idmsopti)  (Optional) 
 ENTRY ucfbtche 
 SETOPT PARM(REUS=NONE,AMODE=31,RMODE=24 )
 NAME dcucfbtc(R)
    idmsopti

    Specifies the name of your IDMSOPTI module.

    ucfbtche

    Specifies the entry point name of your UCF Batch front end load module.

    Note: Use UCFBTCHX or the name specified as the label on the assembler instruction that invokes the #UCFBTCH macro.

    dcucfbtc

    Specifies the name of your UCF batch front-end load module.

Create a UCF Batch Print Support Program

To create a UCF batch print support program

  1. Create a UCFBTCH source module as described in the System Operations Guide.
  2. Save the UCFBTCH source module in your custom source library.
  3. Assemble and link it into your custom load library by executing the z/OS Assemble and Link-Edit JCL
  4. Substitute the name of your UCFBTCH source member and insert the following binder statements: 
     INCLUDE CUSTLIB(idmsopti)  (Optional) 
 ENTRY ucfbatpe 
 SETOPT PARM(REUS=NONE,AMODE=31,RMODE=24)
 NAME ucfbatp(R)
    idmsopti

    Specifies the name of your IDMSOPTI module.

    ucfbatpe

    Specifies the entry point name of your UCF Batch print support load module.

    Note: Use UCFBTCHX or the name specified as the label on the assembler instruction that invokes the #UCFBTCH macro.

    ucfbatp

    Specifies the name of your UCF batch printer support load module.

UCF DC Interface

Prior to Version 18.0, UCF DC front-end programs contained all the executable code for UCF front-end processing. Now these programs only contain an options table and a small set of executable code that calls the main processing routines that reside in separate modules.

Create a UCF DC Front-end Program

To create a UCF DC front-end program

  1. Create a UCFOPTS source module as described in the System Operations Guide.
  2. Save the UCFOPTS source module in your custom source library.
  3. Assemble and link it into your custom load library by executing the z/OS Assemble and Link-edit JCL
  4. Substitute the name of your UCFOPTS source member and insert the following binder statements: 
     INCLUDE CAGJLOAD(RHDCDBDC) 
 INCLUDE CUSTLIB(ucffet)
 SETOPT PARM(AMODE=31) 
 ENTRY DBDCEP1 
 NAME ucfdbdc(R)
    ucffet

    Specifies the name of your UCF front-end table.

    ucfdbdc

    Specifies the name of your UCF DC front-end load module.

UCF TSO Interface

Prior to Version 18.0, UCF TSO front-end programs contained all the executable code for UCF front-end processing. Now these programs only contain an options table and a small set of executable code that calls the main processing routines that reside in separate modules.

Create a UCF TSO Front-end Program

To create a UCF TSO front-end program

  1. Create a UCFTSO source module as described in the System Operations Guide.
  2. Save the UCFTSO source module in your custom source library.
  3. Assemble and link it into your custom load library by executing the z/OS Assemble and Link-Edit JCL
  4. Substitute the name of your UCFTSO source member and insert the following binder statements: 
     INCLUDE CUSTLIB(idmsopti)  (Optional) 
 ENTRY UCFTSOX 
 SETOPT PARM(REUS=NONE,AMODE=31,RMODE=24)
 NAME ucftso(R)
    idmsopti

    Specifies the name of your IDMSOPTI module.

    ucftso

    Specifies the name of your UCF TSO front-end load module.