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:
|
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.
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. |