Parameters

The parameters for DISPLAY GTZ,TRACKDATA are:

filter

If a filter is specified, only matching tracked instances will be displayed. The filter fields correspond to fields as recorded for a tracked instance via the GTZTRACK macro service.

ALL

All tracked instances are displayed.

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.
can be be surrounded by quotes ('), which do not count toward the maximum length.
will have all lower-case characters (a-z) folded to uppercase (A-Z).

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

SOURCE=source

To be compared to the SOURCE value of a tracked instance (as specified on its GTZTRACK request). Start of change

SOURCE can only be specified for SOURCETYPE=NOPATH. End of change

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.

SOURCETYPE

SOURCETYPE is optional with default ALL.

ALL: Any tracked instances with either a SOURCE or SOURCEPATH value that will be matched. No further filtering on the SOURCE or SOURCEPATH value is provided.
PATH: Only tracked instances with a SOURCPATH 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.

SOURCEPATH=sourcepath

To be compared to the SOURCEPATH value of a tracked instance (as specified on its GTZTRACK request). Start of change

SOURCEPATH can only be specified for SOURCETYPE=PATH. End of change

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=eventdescription

To be compared to the EVENTDESC value of a tracked instance (as specified on its GTZTRACK request).

If EVENTDESC is specified, the eventdesc value

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.

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 hhx or 'hh'X or xhh, where h is a hexadecimal digit, one of 'A-F,a-f,0-9’.
can be specified in decimal format.

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-Za-z), numerics (0-9), national characters (@,$,#), or wildcard characters.
will have all lower-case characters (a-z) folded to uppercase (A-Z).

If EVENTJOB 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'C1' or C1x or 'C1'X or xC1.
can be specified in decimal format, for example as 193.

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

HOMEJOB=homejob

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

L={a|name|name-a}

Specifies the display area (a), console name (name), or both (name-a) where the display is to appear.

If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.

ALL: No comparisons are performed. All entries match the ALL filter. This is the same result as using default (*) values for all filter parameters.

Note: For the output of the DISPLAY GTZ,TRACKDATA command, see the description of message GTZ1002I in z/OS MVS System Messages, Vol 6 (GOS-IEA).

Start of change Example: End of change

GTZ1002I  23.18.28 GTZ TRACKDATA     FRAME LAST   F      E   SYS=SY39    
FOUND 1 MATCHING TRACKED INSTANCE(S)                                     
----------------------------------------------------------------------   
 INSTANCE:      1                   COUNT:         1                     
 EVENTDESC:     'EXCLUDE_ME'                                             
 OWNER:         IBM_GTZ_FCT         SOURCE:        MYSOURCE              
 EVENTDATA:     xC7E3E9C6C3E3C2C5   xC5C6F1F5C6F0F0C4                    
 PROGRAM:       GTZINLPA            PROGRAMOFFSET: x0000000000000000     
 HOMEJOB:       MAINASID            HOMEASID:      x0027                 
 EVENTJOB:      MAINASID            EVENTASID:     x0027                 
 AUTHORIZED:    YES                 FIRST TIME:    2013-01-18 23:10:11