Setting Up a Region That Supports CICS Resources › CICS Connections Implementation › CICS Message Filters › Filter Definition › Exclusions and Inclusions

Exclusions and Inclusions

You can exclude and include CICS transient data queues and message IDs. The exclusion keywords are TDQEXC and MSGEXC; the inclusion keywords are TDQINC and MSGINC.

The application of the exclusion and inclusion keywords to transient queues is similar to the application of the keywords to message IDs:

• If only an exclusion keyword is used, then only the messages not explicitly excluded are delivered.
• If only an inclusion keyword is used, then only the messages explicitly included are delivered.
• If both exclusion and inclusion keywords are used, then the following messages are delivered:
  • Messages not explicitly excluded
  • Excluded messages that are explicitly re-included

The following illustration shows a graphical representation of the application of the keywords. The shaded area represents the messages that are delivered to this product.

Example: All CSMT Messages

The following filter passes all CSMT transient data messages to this product.

FILTER NAME=DEFAULT TDQINC=CSMT

Example: CSMT Messages with Conditions

The following filter passes all CSMT transient data messages in dynamically registered CICS regions with names that start with CICS to this product.

FILTER NAME=CICSAMSG JOBNAME=CICS* TDQINC=CSMT

Note: When a filter is used by an explicit PPI connection, the JOBNAME and SYSID keywords in the FILTER statement are ignored.

Example: DFHTC-Prefixed CSMT Messages

The following filter passes all DFHTC-prefixed CSMT transient data messages to this product.

FILTER NAME=TERMCNTLCSMT TDQINC=CSMT MSGINC=DFHTC

The value you specify for an MSGEXC or an MSGINC keyword is the beginning part of a message ID.