Edit the DGAXPRXCT Parameter Table

You can use the ISPF text editor to create the DGAXPRXCT Parameter Table which defines which IBM® Connect:Direct® Processes can and cannot run. This table is stored as a Partitioned Dataset (PDS) member.

You must preallocate the data set with the following attributes:

DSORG=PO
LRECL=80
RECFM=FB
BLKSIZE=multiple of 80

Each table entry or record consists of a single-character command code in column one. Most command codes have a parameter which begins in column two and varies according to the command code function.

Note: The order of the entries in the table is important; the first match stops the table scan and the action requested is taken (allow the process to execute, flush the process, etc.).
Command Code Description Subparameters/Examples
* Comment line. * Only run the following processes.
E Enables DGAXPRCT. This command code must be the first non-comment entry in the table. The second column in this entry must contain one of the following values which indicates the disposition of a process if it is not allowed to run.

H – Places the Process in the Hold queue with a status of HE (Held in Error)

R – Places the Process in the Timer queue in session retry until number of retries is exceeded. Once this number is exceeded, the Process is placed in the Hold queue with a status of RH (Restart Hold).

F – Flushes the process from the queue

D Disallows DGAXPRCT execution and fails Process execution with a non-zero (error) return code and message NPRX003E. You can also leave the disposition code in column two to make it easier to change from "E" to "D" and vice versa without having to change column two to a blank for command code “D.”
P Matches Processes based on a full or partial Process name. Supports the wild card trailing asterisk (*). Can be used to enable or disable Process execution for a particular application by using naming conventions to match an application.

In addition, remote node and/or submitter@submitter-node can be specified to further qualify the match.

The combined format is:

Pprocnam[,remote-node[,submitter@submitter-node]]

PCOPY – Matches a single Process

PEOM* – Matches all Processes beginning with “EOM” for the End of Month Processing application

P* – Matches all Processes\

PCOPY,RNODE,SUE@NODE1 – Matches Process COPY that was submitted by SUE on NODE1 and whose remote node is RNODE.

PCOPY,,SUE@NODE1 – Matches Process COPY that was submitted by SUE on NODE1.

PCOPY,RNODE – Matches Process COPY whose remote node is RNODE.

P*,*,SUE@NODE1 – Matches all Processes submitted by SUE on NODE1.

R Reverses the action to be taken on a match.

If the match is found in an include list, the Process is excluded.

If the match is found in an exclude list, the Process is included.

The combined format is:

Rprocnam[,remote-node[,submitter@submitter-node]]

The syntax is the same as for the "P" command code.

In this example, all Processes whose remote node begins with RNODE are excluded from execution except those whose remote node is RNODE3.

X
R*,RNODE3
NRNODE*
L
N Matches Processes based on a full or partial remote node name. Supports the wild card trailing asterisk (*). NCD.NODE1 – Matches a single remote node name

NCD.NODEA* – Matches all remote node names beginning with "CD.NODEA"

N* – Matches all remote node names

Note: P*,CDNODE1 is equivalent to NCDNODE1 and can be specified as R*,CDNODE1 to reverse the action.
S Matches Processes based on a full or wild card IBM Connect:Direct submitter ID and a full or partial submitter node combination. The format is <id>@<node>. SACTQ0ACD@TPM002 – Matches a specific submitter ID and node combination.

S*@TPM002 – Matches all submitter IDs from node TPM002

SACTQ0ACD@* – Matches submitter ID ACTQ0ACD from all nodes

SACTQ0ACD@TPM* - Matches submitter ID ACTQ0ACD from all nodes beginning with "TPM"

S*@* – Matches all submitter IDs from any node. This is another way to match all Processes.

Note: P*,*,SUE@NODE1 is equivalent to SSUE@NODE and can be specified as R*,*,SUE@NODE1 to reverse the action.
I Includes Processes for execution that match the patterns in the table which follow this command code. Either “I” or “X” must be the second non-comment entry in the table. Processes which do not match a pattern in the table are not executed.
Note: To choose which command code to use to select Processes, determine which group is smaller and use the corresponding command Code. For example, if the number of Processes to be executed is smaller than the number of Processes to exclude from execution, specify “I” as the command code and add patterns to match that group of Processes.
ER
I
NCD.BOSTON

Includes for execution only those Processes whose remote node is CD.BOSTON. Excluded Processes are placed in the Timer queue in session retry

X Excludes from execution those Processes that match the patterns in the table which follow this command code. Either “X” or “I” must be the second non-comment entry in the table. Processes which do not match a pattern in the table are executed.
EH
X
SDALLASOPS@*

Excludes Processes for execution submitted by DALLASOPS from any node

L Last entry in table.