ETA macros for IMS system customization exits


Although one of the primary purposes of ETA is to eliminate the writing and maintenance of exits, you can write exits that take advantage of options and capabilities that ETA provides. These exits can perform IMS system customizations or other functions that are unique to your facility.

ETA allows you to create the following exits:

  • ETA Autosignon exit (ETAEASNn)
  • ETA Logoff exit (ETAELGFn)
  • ETA Logon exit (ETAELGNn)
  • ETA Signoff exit (ETAESGFn)
  • ETA Signon exit (ETAESGNn)
  • ETA Unsolicited Output exit (ETAEINSn)
  • ETA Greeting Messages exit (ETAEGMEn)
  • ETA Non-Discardable Messages exit (ETAENDMn)

For example, in these ETA exit names, the n at the end of the default exit name is replaced by 5 under IMS Version 13.1 or 6 under IMS Version 14.1.

ETASAMP contains the source and macros that you will need to create these exits. ETACNTL contains the JCL that you will need to assemble the source with the IMS release-dependent stubs.

If you assemble any ETA exit with no modifications, when activated, it will read the options that you specified for that type of processing in the ETA IMSID options panels and use the options that you specified. This includes TSS table searches and all processing options that you specified for successful and unsuccessful TSS table searches.

For example, if you assembled and activated an ETA exit with no modifications, you could expect the following results:

If the applicable IMSID options are...

Then the ETA exit would...

Deactivated or not specified

Use IMS defaults.

Specified through ETA basic features

Perform the customizations specified in the ETA IMSID options.

Specified through a TSS table

Search the TSS table and perform the action or customizations specified in the TSS processing options.

If you modify an ETA exit, the exit will function as you coded it. If the exit fails to produce usable output or is deactivated, the options that are specified in the ETA IMSID options will be used.

For more information, see Creating-and-assembling-ETA-exits.


 

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