Format Options for Criteria

Debugging Facility (DBUG) › DBUG Panel Descriptions › DBUG Interception Specifications Panel (14) › Format Options for Criteria

Format Options for Criteria

Format Options for Criteria

If requesting monitor mode, or optionally, if requesting local or remote mode, specify criteria to limit the interception of requests in one of the following forms:

A simple logical expression, consisting of a special CA Datacom CICS Services keyword, an optional offset, a relational operator, and a comparison value.

►►─ keyword ─┬──────┬─ operator ─ literal ────────────────────────────────────►◄
             └─ +n ─┘

The negation of a simple logical expression, consisting of a logical expression within parentheses, prefixed with NOT or ¬.

►►─ NOT ─ (keyword ─┬──────┬─ operator ─ literal) ────────────────────────────►◄
                    └─ +n ─┘

Compound or complex logical expressions, consisting of one or more simple logical expressions (including the negated form), separated by the logical operator AND or OR.

►►─ keyword ─┬──────┬─ operator ─ literal ─┬─ AND ─┬─ keyword ─┬──────┬───────►
             └─ +n ─┘                      └─ OR ──┘           └─ +n ─┘

 ►─ operator ─ literal ───────────────────────────────────────────────────────►◄

NOT

(Optional) Specifies that interception is to exclude matches to the logical expression which follows. The logical expression which follows must be enclosed within parentheses. Both NOT and its symbol, ¬, are valid. (If the negation is omitted, the interception includes, rather than excludes, matches to the logical expression.)

keyword

(Required) One of the following keywords listed by type, where C means character and B means unsigned binary.

Keyword	Type	Length	Derivation for Literal
CMD	C	5	Command Code in Request Area
ELM	C	Up to 480	Element List specifying the data elements to be retrieved, updated or added.
KYN	C	5	Key Name in Request Area.
KYV	C	1-360	Key Value in Request Area.
PGM	C	8	Application program name.
RC	C	2	Return Code in Request Area.
TBL	C	3	Table Name in Request Area.
TRN	C	4	CICS transaction ID.
WRK	C	Up to 4096	Work Area used to send and receive elements.
INRC	B	1	Internal Return Code in Request Area.
DBID	B	5	Database ID in Request Area.
MUF	C	1-99	Number of the MUF on which the request is processed.

+n

(Optional) The integer offset within the intercepted entity at which the comparison to the specified literal begins. (If omitted, comparison begins at the initial character.)

operator (relational)

(Required) Use one of the following relational operators to specify the nature of the comparison between the keyword and the literal:

Relational Operators	Meaning
EQ, =	Equal to
NE, ¬=, =¬, <>	Not equal to
GT, >	Greater than
GE, =>, >=, ¬<, <¬	Greater than or equal to
LT, <	Less than
LE, <=, =<, ¬>, >¬	Less than or equal to

literal

(Required) Literals in the logical expression must represent valid values for the specified keyword, such as 'DBOC' for the TRN keyword, or 014 for DBID. Syntax varies by type of comparison value, that is to say whether literal is a string, an integer value, or a hexadecimal value. Valid comparison types vary by keyword type. Use the following syntax when expressing literals to be compared with keywords of type C (character string) and B (unsigned binary):

Keyword Type	Syntax for Literal
C	Either of the following: 'string' A character string in single quotes. String literals may include from one character to the number of characters associated with the keyword, where the physical length of the string determines the number of characters evaluated during the comparison. "hexadecimal" A hexadecimal value in double quotes, with a length up to the maximum length associated with the specified keyword, as documented for keyword in DBUG Interception Specifications Panel.
B	Either of the following: integer value An integer value with no leading zeros, where no punctuation is expected. "hexadecimal" A hexadecimal value in double quotes, where you must specify the full length.

Keyword Type

Syntax for Literal

Either of the following:

'string'

A character string in single quotes. String literals may include from one character to the number of characters associated with the keyword, where the physical length of the string determines the number of characters evaluated during the comparison.

"hexadecimal"

A hexadecimal value in double quotes, with a length up to the maximum length associated with the specified keyword, as documented for keyword in DBUG Interception Specifications Panel.

Either of the following:

integer value

An integer value with no leading zeros, where no punctuation is expected.

"hexadecimal"

A hexadecimal value in double quotes, where you must specify the full length.

operator (logical)

(Optional) Specifies that multiple logical expressions are to be evaluated, where pairs of expressions are connected with one of the following logical operators:

Logical Operators	Meaning
AND, &	logical connective (both)
OR, \|	logical inclusive (either or both)

Optional Criteria Examples

To limit interception to requests meeting a single criteria, specify a simple conditional with a complete value. For example, the maximum length of a character string for the keyword, CMD, is 5. The following limits the interception to the single command, CNTKR. In the first example, the criteria is expressed as a string; in the second, it is expressed as a hexadecimal value.
```
CMD='CNTKR'
```
```
CMD="C3D5E3D2D9"
```
The following specifies interception of requests with a Work Area containing a 4-byte packed field at position one.
```
WRK="0001234C"
```
To request the interception of requests meeting criteria expressed as a partial value beginning with the first character, specify a simple conditional with a partial value. The following expression specifies interception of requests which include any command having CNT as the first three characters, for example, CNTKR, CNTKY or CNTTB.
```
CMD='CNT'
```
The following simple logical expression specifies that the third position of the intercepted command be compared with the literal U to determine whether it matches. In this example, RDUBR, RDUID, RDUKG, RDUKL, RDUKR, RDUKX, RDUKY, RDULE, RDUNE, RDUNK, RDUNR, and RDUNX would qualify.
```
CMD+2='U'
```
The following simple negated logical expression specifies that interception is to exclude any requests which resulted in a CA Datacom/DB return code of 6 (table not open for update); this specification is equivalent to RC¬='06'.
```
NOT (RC EQ '06')
```
The following compound expression specifies that the interception is to include any request where the command's third letter is a U unless that request results in the return code of 6. RC and INRC are appropriate only for interceptions invoked AFTER the request has been processed.
```
CMD+2='U' AND NOT (RC = '06')
```
The following complex expression specifies that the interception is to include any request to database 35 where the command is UPDAT or where the command's third letter is a U. (The parentheses indicate the part of the expression to be evaluated as a unit.)
```
DBID=035 AND (CMD+2='U' OR CMD='UPDAT')
```

Function Key Assignments

Key	Function
PF3	RELEASE Releases the program being intercepted.
PF12	RETURN Returns to Primary Interception Panel, which displays for update the interception criteria currently in use.
Clear	Clears the screen and terminates the maintenance of the interception specifications without any changes.
Enter	Edits the entered data. If any entry contains an error, returns an error message; otherwise, accepts the entered data and redisplays the modified panel.