Creating and assembling ETA exits


You can create an ETA exit that takes advantage of ETA’s capabilities. Once you have created the exit, you must use JCL that is provided with ETA to assemble and link the exit and the appropriate IMS release-dependent ETA code.

Before you begin

You must know the location of ETASAMP and ETACNTL. Contact your ETA system administrator.

If you want the ETA exit to make use of customization information that is specified in the ETA IMSID options or in a TSS table, you must use the ETA online interface to specify these options or create the TSS table. For instructions on specifying customization through the ETA online interface, see IMS-customization-by-IMSID. For instructions on creating TSS tables, see Utilities-for-Translate-Subsystem-Services-feature.

To create and assemble ETA exits

  1. Create an ETA exit by modifying statements, as necessary, in one of the following macros:

    If you want to create an ETA exit that controls...

    Then modify sample exit...

    Logon options

    ETMELN1X

    Logoff options

    ETMELF1X

    Signon options

    ETMESN1X

    Signoff options

    ETMESF1X

    Autosignon options

    ETMEAS1X

    Unsolicited output options

    ETMEIN1X

    DFS3649A, DFS3650I, or DFS2467I options

    ETMEGM1X

    Non-discardable messages options

    ETMEND1X

  2. Modify the appropriate JCL in ETACNTL as necessary. You must specify the IMS release-dependent stub that will be assembled with the macro.

    Important

    Change only the required parameters that are listed in the JCL. Changing the JCL name and other parameters may cause the assembly to fail.

    If you want to create an ETA exit that controls...

    Then modify JCL in...

    Logon options

    ETA#ELN1

    Logoff options

    ETA#ELF1

    Signon options

    ETA#ESN1

    Signoff options

    ETA#ESF1

    Autosignon options

    ETA#EAS1

    Unsolicited output options

    ETA#EIN1

    DFS3649A, DFS3650I, or DFS2467I options

    ETA#EGE1

    Non-discardable messages options

    ETA#END1

  3. Use the JCL to assemble and link the ETA exit that you created.
  4. Repeat this task for other ETA exits as needed.
  5. Repeat this task for other IMS systems as needed.

Where to go from here

You must perform the following actions:

  • Use the ETA Exit Processing panel to activate the exit. See Deactivating-and-reactivating-exits for instructions.
  • Modify the appropriate selection option in the ETA IMSID options so that ETA will recognize the exit and use it to specify IMS system customization. See one of the following sections for information and instructions:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*