Sample Test Scenarios

Edit online

The following examples show different applications of the DGAXPRCT exit using DGAXPRCT Parameter Tables to define which IBM® Connect:Direct® Processes to run and not run.

Specify Which Processes Run

In this example, IBM Connect:Direct executes all Processes that start with ACH or are named DITEST01 or DITEST02. All other Processes are placed in the Hold queue.

* Enable processing. Only permit processes matching one of the patterns
* to execute. Hold processes that don't execute.
EH
I
PACH*
PDITEST01
PDITEST02
L

Specify Which Processes to Exclude

In this example, IBM Connect:Direct does not execute any Process that starts with ACH or is named DITEST01 or DITEST02. All other Processes are executed.

* Exclude matching processes.  Permit all others to execute.
EH
X
PACH*
PDITEST01
PDITEST02
L

Permit Process Execution by Remote Node and Submitter User ID/Node

In this example, IBM Connect:Direct executes all Processes that match one of the following criteria:

  • The remote node name is DI.NODE1
  • A remote node whose name starts with DI0017
  • Any IBM Connect:Direct submitter ID from node DI0049
  • The specific IBM Connect:Direct submitter ID ACHAPP from any node

All Processes not matching one of the above criteria are flushed from the queue.

* Only permit matching processes to execute.  Flush those that do not.
EF
I
NDI.NODE1
NDI0017*
S*@DI0049
SACHAPP@*
L

Combine Matching Criteria for a More Specific Match

In this example, IBM Connect:Direct executes all Processes that match one or more of the following criteria:

  • Processes that begin with XYZ
  • Processes that begin with ABC whose remote node is NODE1

All Processes not matching one of the above criteria are flushed from the queue.

* Only permit matching processes to execute.  Flush those that do not.
EF
I
PXYZ*
PABC*,NODE1
L

Use the "R" (Reverse) Matching Criteria

In this example, IBM Connect:Direct performs the following actions:

  • Executes all Processes that begin with XYZ
  • Executes all Processes that begin with ABC whose remote node is NODE1
  • Excludes all Processes that begin with ABC and whose remote node is NODE1 when submitted by JOE@NODE2 from execution

All other Processes are flushed from the queue.

* Only permit matching processes to execute.  Flush those that do not.
EF
I
PXYZ*
RABC*,NODE1,JOE@NODE2
PABC*,NODE1
L
Note: When using the "R" (Reverse) matching criteria, always specify the most specific matching criterion first and the most generic matching criterion last.

Stop the DGAXPRCT Exit

In this example, the DGAXPRCT Exit will exclude Processes from being executed, and display a non-zero return code signifying an error along with message ID NPRX003E . The remainder of the table is ignored (including the “F” code to flush Processes from the queue) and all Processes are placed in the Hold queue.

To resume testing and use the DGAXPRCT exit again, change the "D" command code to an "E."

* Execute no processes at all.  Put them in the hold queue and return.
DF
I
PACH*
PDITEST01
PDITEST02
L