Parameters

The parameters for SETGTZ EXCLUDE are:
filter
Any tracked instance which matches the whole filter (all the filter pieces, OWNER, SOURCE,... match their GTZTRACK based counterparts) will be excluded from being recorded (for future GTZTRACK calls), or will be cleared from the facility (for past GTZTRACK data which has already been recorded).
OWNER=owner
To be compared to the OWNER value of a tracked instance (as specified on its GTZTRACK request).
If OWNER is specified, the owner value
  • has to be a 1-16 character string.
  • can contain wildcard characters anywhere in the string
    • an asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
  • can only contain alphabetic characters (A-Z,a-z), numerics (0-9), national characters (@,$,#), an underscore ('_'), a period (.), a dash (-), a slash (/), or wildcard characters.
  • will have all lower-case characters (a-z) folded to uppercase (A-Z) for comparisons.

If OWNER is not specified, a default value of * (match all) is assumed.

SOURCETYPE
SOURCETYPE is optional with default ALL.
ALL
Any tracked instances with either a SOURCE or SOURCEPATH value will be matched. No further filtering on the SOURCE or SOURCEPATH value is provided.
PATH
Only tracked instances with a SOURCEPATH will be matched. Optionally a specific SOURCEPATH filter value can be specified. Tracked instances with a SOURCE value will not be matched.
NOPATH
Only tracked instances with a SOURCE will be matched. Optionally a specific SOURCE filter value can be specified. Tracked instances with a SOURCEPATH value will not be matched.
SOURCE=source
To be compared to the SOURCE value of a tracked instance (as specified on its GTZTRACK request). SOURCE can only be specified for SOURCETYPE=NOPATH.
If SOURCE is specified, the source value
  • has to be a 1-8 character string.
  • can contain wildcard characters anywhere in the string
    • an asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
  • can only contain alphabetic characters (A-Z,a-z), numerics (0-9), national characters (@,$,#), or wildcard characters.
  • will have all lower-case characters (a-z) folded to uppercase (A-Z).

If SOURCE is not specified, a default value of * (match all) is assumed.

SOURCEPATH=sourcepath
To be compared to the SOURCEPATH value of a tracked instance (as specified on its GTZTRACK request). SOURCEPATH can only be specified for SOURCETYPE=PATH.
If SOURCEPATH is specified, the sourcepath value
  • has to be a 1-1024 character string.
  • has to be surrounded by quotes ('), which do not count toward the maximum length, if it contains any other characters than 'A-Z,a-z,0-9,#,$,@,",.,*,?,_,/,-,%'.
  • can contain wildcard characters anywhere in the string
    • an asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
    • a single asterisk (*) can be specified without any quotes.
  • can contain any EBCDIC character, but not just blanks or X'00'. IBM recommends to use printable characters.
  • is case sensitive. If quotes are used, it will not have its alphabetic characters folded to upper-case. If quotes are not used, will have its alphabetic characters folded to upper-case.
    Note: The pathnames are case sensitive, so IBM recommends to use quotes when specifying this value.
  • will not have its trailing blanks removed when quotes are used.

If SOURCEPATH is not specified, a default value of * (match all) is assumed.

EVENTDESC=event-description-filter-text
To be compared to the EVENTDESC value of a tracked instance (as specified on its GTZTRACK request).
If EVENTDESC is specified, the event-description-filter-text
  • has to be a 1-64 character string.
  • has to be surrounded by quotes ('), which do not count toward the maximum length, if it contains any other characters than 'A-Z,a-z,0-9,#,$,@,",.,*,?,_,/,-,%'.
  • can contain wildcard characters anywhere in the string. An asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
  • can contain any EBCDIC character, but not just blanks or X'00'. IBM® recommends to use printable characters.
  • if unquoted:
    • will not have its alphabetic characters folded to upper-case and will be compared case-sensitive.
    • will not have its trailing blanks removed.
Note: The event description is case sensitive, so IBM recommends to use quotes when specifying this value.

If EVENTDESC is not specified, a default value of * (match all) is assumed.

EVENTDATA=eventdata
To be compared to the EVENTDATA value of a tracked instance (as specified on its GTZTRACK request).
If EVENTDATA is specified, the eventdata value
  • is interpreted as a 16 byte binary value.
  • can be specified in hexadecimal format: One of X'hh' or 0hhx or 'hh'X or xhh, with hh representing 1 to 32 hexadecimal digits (A-F,a-f,0-9).
  • can be specified as a decimal number.

If EVENTDATA is not specified, a default value of * (match all) is assumed.

EVENTJOB=eventjob
To be compared to the event address space job name, as derived from the EVENTASID value of a tracked instance (as specified on its GTZTRACK request).
If EVENTJOB is specified, the eventjob value
  • has to be a 1-8 character string.
  • can contain wildcard characters anywhere in the string. An asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
  • can only contain alphabetic characters (A-Z,a-z), numerics (0-9), national characters (@,$,#), or wildcard characters.
  • will have all lower-case characters (a-z) folded to uppercase (A-Z).

If EVENTJOBNAME is not specified, a default value of * (match all) is assumed.

EVENTASID=eventASID
To be compared to the EVENTASID value of a tracked instance (as specified on its GTZTRACK request).
If EVENTASID is specified, the eventASID value
  • is interpreted as a 16 bit binary value.
  • can be specified in hexadecimal format, for example as X'82C1' or 082C1x or '82C1'X or x82C1.
  • can be specified in decimal format, for example as 33473.

If EVENTASID is not specified, a default value of * (match all) is assumed.

PROGRAM=program
To be compared to the program name, as derived from the EVENTADDR value of a tracked instance (as specified on its GTZTRACK request). PROGRAM can only be specified for PROGRAMTYPE=NOPATH.
If PROGRAM is specified, the program value
  • is interpreted as a 1-8 character string.
  • can contain wildcard characters anywhere in the string:
    • an asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
  • can only contain alphabetic characters (A-Z,a-z), numerics (0-9), national characters (@,$,#), or wildcard characters.
  • will have all lower-case characters (a-z) folded to uppercase (A-Z).

If PROGRAM is not specified, a default value of * (match all) is assumed.

PROGRAMTYPE=programtype
PROGRAMTYPE is optional with default ALL.
ALL
Any tracked instances with either a PROGRAM or PROGRAMPATH value will be matched. No further filtering on the PROGRAM or PROGRAMPATH value is provided.
PATH
Only tracked instances with a PROGRAMPATH will be matched. Optionally a specific PROGRAMPATH filter value can be specified. Tracked instances with a PROGRAM value will not be matched.
NOPATH
Only tracked instances with a PROGRAM will be matched. Optionally a specific PROGRAM filter value can be specified. Tracked instances with a PROGRAMPATH value will not be matched.
PROGRAMPATH=programpath
To be compared to the program path name, as derived from the EVENTADDR value of a tracked instance (as specified on its GTZTRACK request). PROGRAMPATH can only be specified for PROGRAMTYPE=PATH.
If PROGRAMPATH is specified, the programpath value
  • has to be a 1-1024 character string.
  • has to be surrounded by quotes ('), which do not count toward the maximum length, if it contains any other characters than 'A-Z,a-z,0-9,#,$,@,",.,*,?,_,/,-,%'.
  • can contain wildcard characters anywhere in the string. An asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
  • can contain any EBCDIC character, but not just blanks or binary zeros. IBM recommends to use printable characters.
  • is case sensitive. If quotes are used, it will *not* have its alphabetic characters folded to upper-case. If quotes are not used, will have its alphabetic characters folded to upper-case.
    Note: The pathnames are case sensitive, so IBM recommends to use quotes when specifying this value.
  • will not have its trailing blanks removed when quotes are used.

If PROGRAMPATH is not specified, a default value of * (match all) is assumed.

PROGRAMOFFSET=programoffset
To be compared to the program offset, as derived from the EVENTADDR value of a tracked instance (as specified on its GTZTRACK request).
If PROGRAMOFFSET is specified, the programoffset value
  • is interpreted as an 8 byte binary value.
  • can be specified in hexadecimal format, for example as X'C2' or 0C2x or 'C2'X or xC2.
  • can be specified in decimal format, for example as 193.

If PROGRAMOFFSET is not specified, a default value of * (match all) is assumed.

HOMEJOB=homejobname
To be compared to the home address space job name as derived from the dispatchable unit under which a tracked instance's GTZTRACK request was executed.
If HOMEJOB is specified, the homejob value
  • has to be a 1-8 character string.
  • can contain wildcard characters anywhere in the string
    • an asterisk (*) will match any character sequence of zero or more characters and a question mark (?) will match a single arbitrary character.
  • can only contain alphabetic characters (A-Z,a-z), numerics (0-9), national characters (@,$,#), or wildcard characters.
  • will have all lower-case characters (a-z) folded to uppercase (A-Z).
HOMEASID=homeASID
To be compared to the ID of the home address space as derived from the dispatchable unit under which a tracked instance's GTZTRACK request was executed.
If HOMEASID is specified, the homeASID value
  • is interpreted as a 16 bit binary value.
  • can be specified in hexadecimal format, for example X'82C1' or 082C1x or '82C1'X or x82C1.
  • can be specified in decimal format, for example as 33473.

If HOMEASID is not specified, a default value of * (match all) is assumed.

Parent topic: SETGTZ EXCLUDE command