Additional data selection can be done with a component-supplied or user-written routine. You can use the OPTIONS parameter to pass parameters to data selection and formatting routines.
CTRACE
{ QUERY[(compname) [SUB((name[.name]...))]] }
{ }
{ [SYSNAME(name)] COMP(name) [SUB((name[.name]...))] }
-------- Report Type Parameters ----------------------------
[ SHORT ]
[ SUMMARY ]
[ FULL ]
[ TALLY ]
-------- Data Selection Parameters -------------------------
[ GMT|LOCAL ]
[ START(mm/dd/yy,hh.mm.ss.dddddd) ]
[ STOP(mm/dd/yy,hh.mm.ss.dddddd) ]
[ EXCEPTION ]
[ LIMIT(nnnnnnnn) ]
[ ENTIDLIST(entidlist) ]
[ USEREXIT(exitname) ]
[ OPTIONS((component routine parms)) ]
-------- Address Space Selection Parameters ----------------
[ ALL ]
[ CURRENT ]
[ ERROR ]
[ TCBERROR ]
[ ASIDLIST(asidlist) ]
[ JOBLIST(joblist)|JOBNAME(joblist) ]
-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.
[ ACTIVE | MAIN | STORAGE ]
[ DSNAME(dsname) | DATASET(dsname) ]
[ FILE(ddname) | DDNAME(ddname) ]
[ PATH(path-name) ]
[ FLAG(severity) ]
[ PRINT | NOPRINT ]
[ TERMINAL | NOTERMINAL ]
[ TEST | NOTEST ]
Specify QUERY with no component name to request a list of the names of components or applications that have traces defined in a dump or trace data set. For multiple-trace components, the report lists each SUB level trace name for that component.
GMT, LOCAL and OPTIONS are the only data selection parameters that may be specified with QUERY. GMT is the default.
QUERY is the default parameter on the CTRACE subcommand. If you specify CTRACE with no additional parameters, IPCS will process a general query request.
The SYSNAME parameter allows only trace entries from a particular system to be processed for a particular trace.
Do not specify a partial trace name for formatting.
Report type parameters, data selection parameters, and address space selection parameters control the output produced by this parameter.
To identify components for which you can view component trace entries, use QUERY. z/OS MVS Diagnosis: Tools and Service Aids identifies the value for the COMP parameter for each component that supports tracing.
If you need only to format entry identifier definitions, specify a small number in the LIMIT parameter to avoid reading all the trace entries. Otherwise, if you do not place a limit on the number of trace entries processed, TALLY finds the number of occurrences of each trace entry and the average interval, in microseconds, between occurrences.
*
m/dd/yy
mm/d/yy
m/d/yy
mm/dd/yy
hh.mm.ss.dddddd
hh.mm.ss.dd
hh.mm.ss
h.m.s
hh.mm
hh
ENTIDLIST(X'00800020',3,X'12345678':X'22000000')
This exit routine can select, gather, and format entries. See z/OS MVS IPCS Customization for more information about user exits.
Use these parameters to obtain data from specific address spaces, which you specify by their address space identifiers (ASIDs). If you omit these parameters, the default is ALL. For more information, see the select ASID service in z/OS MVS IPCS Customization.
The ASID can be 1 through 65535. An ASID can be expressed in the notation X'nnn', F'nnn', or B'nnn'. An unqualified number is assumed to be fixed.
See Standard subcommand return codes for a description of the return codes produced by the CTRACE subcommand.
COMMAND ===> ctrace query
CTRACE produces the following output. The report shows the complete name of all traces defined in a dump, organized by component names. In this example, COMP1 is a HEAD level component name for a multiple trace component. Five traces are defined under COMP1.
COMPONENT TRACE QUERY SUMMARY
COMPONENT SUB NAME
0001 COMP1 ASID(0010).FUNC2.SVC2
0002 COMP1 ASID(0020).FUNC1.SVC3
0003 COMP1 ASID(0200).FUNC2.SVC3
0004 COMP1 ASID(0200).FUNC1.SVC3
0005 COMP1 ASID(0012).FUNC1.SVC1
0006 COMP2 FUNCA
0007 COMP2 FUNCB
0008 COMP3
0009 COMP4
.
.
.
COMMAND ===> ctrace query(COMP1)
CTRACE produces the following output. The report is similar to the general query report, listing only the traces from the COMP1 component name.
COMPONENT TRACE QUERY SUMMARY
COMPONENT SUB NAME
0001 COMP1 ASID(0010).FUNC2.SVC2
0002 COMP1 ASID(0020).FUNC1.SVC3
0003 COMP1 ASID(0200).FUNC2.SVC3
0004 COMP1 ASID(0200).FUNC1.SVC3
0005 COMP1 ASID(0012).FUNC1.SVC1
COMMAND ===> ctrace query(COMP1) sub((ASID(0200)))
CTRACE produces the following output.
COMPONENT TRACE QUERY SUMMARY
COMPONENT SUB NAME
0001 COMP1 ASID(0200).FUNC2.SVC3
0002 COMP1 ASID(0200).FUNC1.SVC3
COMMAND ===> ctrace query(COMP1) sub((ASID(0200).func2.svc3))
CTRACE produces the following output.
COMPONENT TRACE QUERY SUMMARY
COMP(COMP1) SUBNAME((ASID(0200).FUNC2.SVC.))
START = 01/05/90 14:37:48.963576 GMT
STOP = 01/05/90 14:39:21.354861 GMT
COMMAND ===> ctrace query(COMP1) sub((ASID(0200).func2.svc3)) full
CTRACE produces the following output.
COMPONENT TRACE QUERY SUMMARY
COMP(COMP1) SUBNAME((ASID(0200).FUNC2.SVC.))
START = 01/05/90 14:37:48.963576 GMT
STOP = 01/05/90 14:39:21.354861 GMT
OPTIONS: COMASID,DMPREC,BUFF=(7,50)
COMMAND ===> ctrace comp(sysrsm) lim(10)
CTRACE produces the following output.
COMPONENT TRACE SHORT FORMAT
COMP(SYSRSM)
**** 01/05/90
MNEMONIC ENTRY ID TIME STAMP DESCRIPTION
-------- -------- --------------- -----------
RSGSNG 00000006 14:37:48.926973 Get Single Frame
RSEPAG 00000008 14:37:48.927078 Enqueue Pageable Frame
XEPEXIT 00000002 14:37:48.927177 External Entry Point Exit
XEPENTRY 00000001 14:37:48.927734 External Entry Point Entry
RSGSNG 00000006 14:37:48.927853 Get Single Frame
RSEPAG 00000008 14:37:48.927953 Enqueue Pageable Frame
XEPEXIT 00000002 14:37:48.928052 External Entry Point Exit
XEPENTRY 00000001 14:37:48.928554 External Entry Point Entry
RSGSNG 00000006 14:37:48.928668 Get Single Frame
RSEPAG 00000008 14:37:48.928772 Enqueue Pageable Frame
COMMAND ===> ctrace comp(sysrsm) lim(10) summary
CTRACE produces the following output.
COMPONENT TRACE SUMMARY FORMAT
COMP(SYSRSM)
**** 01/05/90
MNEMONIC ENTRY ID TIME STAMP DESCRIPTION
-------- -------- --------------- -----------
RSGSNG 00000006 14:37:48.926973 Get Single Frame
FUNC1... VSMGTMN VSM Getmain Service
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 88084001 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 88084000
RSEPAG 00000008 14:37:48.927078 Enqueue Pageable Frame
FUNC1... VSMGTMN VSM Getmain Service
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 88004001 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 88004000
XEPEXIT 00000002 14:37:48.927177 External Entry Point Exit
FUNC1... VSMGTMN VSM Getmain Service
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 80000001 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 80000000
XEPENTRY 00000001 14:37:48.927734 External Entry Point Entry
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 00000003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 00000000
RSGSNG 00000006 14:37:48.927853 Get Single Frame
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 08084003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 08084000
RSEPAG 00000008 14:37:48.927953 Enqueue Pageable Frame
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 08004003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 08004000
XEPEXIT 00000002 14:37:48.928052 External Entry Point Exit
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 00000003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 00000000
XEPENTRY 00000001 14:37:48.928554 External Entry Point Entry
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 00000003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 00000000
RSGSNG 00000006 14:37:48.928668 Get Single Frame
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 08084003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 08084000
RSEPAG 00000008 14:37:48.928772 Enqueue Pageable Frame
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 08004003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 08004000
COMMAND ===> ctrace comp(sysrsm) lim(10) full
COMPONENT TRACE FULL FORMAT
COMP(SYSRSM)
**** 01/05/90
MNEMONIC ENTRY ID TIME STAMP DESCRIPTION
-------- -------- --------------- -----------
RSGSNG 00000006 14:37:48.926973 Get Single Frame
FUNC1... VSMGTMN VSM Getmain Service
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 88084001 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 88084000
KEY..... 0036 ADDR.... 01B32DC0 ALET.... 00000000
19001200
KEY..... 0001 ADDR.... 012A6000 ALET.... 00000000
012A26A0 0125FBEC FFC00000 03000000 00000000 7FFE4000 01B77F00 00000000
RSEPAG 00000008 14:37:48.927078 Enqueue Pageable Frame
FUNC1... VSMGTMN VSM Getmain Service
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 88004001 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 88004000
KEY..... 0036 ADDR.... 01B32DC0 ALET.... 00000000
1900
KEY..... 0001 ADDR.... 012A6000 ALET.... 00000000
01A12AAC 0129A7E0 81C00000 03000000 0000000A 00989000 01B77F00 00000000
XEPEXIT 00000002 14:37:48.927177 External Entry Point Exit
FUNC1... VSMGTMN VSM Getmain Service
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 80000001 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 80000000
KEY..... 0036 ADDR.... 01B32DC0 ALET.... 00000000
1900
KEY..... 0016 ADDR.... 00000000 ALET.... 00000000
XEPENTRY 00000001 14:37:48.927734 External Entry Point Entry
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 00000003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 00000000
KEY..... 0036 ADDR.... 01B2FDC0 ALET.... 00000000
0400
KEY..... 002F ADDR.... 0098A000 ALET.... 00000000
KEY..... 0032 ADDR.... 00F2B088 ALET.... 00000000
070C2000 81ED81AE
RSEPAG 00000008 14:37:48.927953 Enqueue Pageable Frame
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 08004003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 08004000
KEY..... 0036 ADDR.... 01B2FDC0 ALET.... 00000000
0400
KEY..... 0001 ADDR.... 012A26A0 ALET.... 00000000
01A12AAC 012A6000 81C00000 03000000 0000000A 0098A000 01B14E80 00000000
XEPEXIT 00000002 14:37:48.928052 External Entry Point Exit
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 00000003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 00000000
KEY..... 0036 ADDR.... 01B2FDC0 ALET.... 00000000
0400
KEY..... 0016 ADDR.... 00000004 ALET.... 00000000
KEY..... 0017 ADDR.... 04000E00 ALET.... 00000000
KEY..... 0027 ADDR.... 7FF14228 ALET.... 00000000
KEY..... 0002 ADDR.... 012A26A0 ALET.... 00000000
XEPENTRY 00000001 14:37:48.928554 External Entry Point Entry
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 00000003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 00000000
KEY..... 0036 ADDR.... 01B2FDC0 ALET.... 00000000
0400
KEY..... 002F ADDR.... 0098B000 ALET.... 00000000
KEY..... 0032 ADDR.... 00F2B088 ALET.... 00000000
070C2000 8243D124
RSGSNG 00000006 14:37:48.928668 Get Single Frame
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 08084003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 08084000
KEY..... 0036 ADDR.... 01B2FDC0 ALET.... 00000000
04001200
KEY..... 0001 ADDR.... 0129E7E0 ALET.... 00000000
01292A80 0125FBEC FFC00000 03000000 00000000 02F1C000 01B77700 00000000
RSEPAG 00000008 14:37:48.928772 Enqueue Pageable Frame
FUNC1... FLTAEPAG Enabled Addr Space Page Faults
JOBN1... CONSOLE ASID1... 000A PLOCKS.. 08004003 CPU..... 0001
JOBN2... CONSOLE ASID2... 000A RLOCKS.. 08004000
KEY..... 0036 ADDR.... 01B2FDC0 ALET.... 00000000
0400
KEY..... 0001 ADDR.... 0129E7E0 ALET.... 00000000
01A12AAC 012A26A0 81C00000 03000000 0000000A 0098B000 01B77700 00000000
COMMAND ===> ctrace tally comp(sysrsm) lim(22)
CTRACE produces the output shown in Figure 3.
COMPONENT TRACE TALLY REPORT
COMP(SYSRSM)
TRACE ENTRY COUNTS AND AVERAGE INTERVALS (IN MICROSECONDS)
FMTID COUNT INTERVAL MNEMONIC DESCRIBE
-------- ----- ---------- -------- ----------------------------
00000001 4 855 XEPENTRY External Entry Point Entry
00000002 4 944 XEPEXIT External Entry Point Exit
00000003 0 FIX Page Being Fixed
00000004 0 FREE Page Being Freed
00000005 0 RSGDBL Get Double Frame
00000006 3 847 RSGSNG Get Single Frame
00000007 0 RSEFIX Enqueue Fixed Frame
00000008 3 847 RSEPAG Enqueue Pageable Frame
00000009 0 RSESQA Enqueue SQA Frame
0000000A 0 RSESBUF Enqueue Storage Buffer Frame
0000000B 0 RSEDEFER Enqueue Deferred Frame
0000000C 0 RSEVRW Enqueue V=R Waiting Frame
0000000D 0 RSDFIX Dequeue Fixed Frame
0000000E 3 170 RSDPAG Dequeue Pageable Frame
0000000F 0 RSDSQA Dequeue SQA Frame
00000010 0 RSDSBUF Dequeue Storage Buffer Frame
00000011 0 RSDDEFER Dequeue Deferred Frame
00000012 0 RSDVRW Dequeue V=R Waiting Frame
00000013 0 RSFDBL Free Double Frame
00000014 3 162 RSFSNG Free Single Frame
00000015 0 ESGET Get Expanded Storage
00000016 0 ESENQ Enqueue Expanded Storage
00000017 0 ESDEQ Dequeue Expanded Storage
00000018 0 ESFREE Free Expanded Storage
00000019 0 PAGER2A Page Request Real to Auxiliary
0000001A 0 PAGER2P Page Request Real to Permanent
0000001B 0 PAGER2E Page Request Real to Expanded
0000001C 0 PAGER2R Page Request Real to Real
0000001D 0 PAGEA2R Page Request Auxiliary to Real
0000001E 0 PAGEP2R Page Request Permanent to Real
0000001F 0 PAGEE2R Page Request Expanded to Real
00000020 0 PAGEREL Page Request Related
00000021 0 PAGEDEF Page Request Deferred
00000022 0 FUNCREQ Function Request
00000023 2 ] 16 min. TRACEB Trace Buffer
Total trace entries: 22