The values for the OPTIONS parameter for the CTnRSMxx parmlib member
and reply for a TRACE command follow.
If you turn on the SYSRSM trace without specifying any filters
or options, the component trace records every RSM function and event
in all address spaces and jobs. This trace collects an enormous amount
of data and degrades system performance. Use the SYSRSM filters and
options to limit the amount of data recorded by the component trace.
Specify tracing of specific address spaces, jobs, RSM events, and
RSM functions.
The RSM trace options are divided into three groups:
- Special trace options
- RSM function trace options
- RSM event trace options
Special trace options: These options set the size
of the fixed RSM trace buffers, tell the trace to record common area
activity, and tell the system when to dump the trace data. The options
are:
- BUFF=(x,y)
- Specifies the number and size of the SYSRSM trace buffers, which
reside in fixed high virtual common service area (LIKECSA) storage:
- x
- The number of buffers, from 2 to 7. The default is 3.
- y
- The number of pages per buffer, from 4 to 262,144. The default
is 32.
The storage for each buffer is distributed between
the installed processors in the system. For that reason, it is recommended
to increase the buffer size on systems with a large amount of processors.
The more buffers that are specified, the more often the SRB, which
empties out the fixed buffers, is called (if there is a high virtual
private buffer or an external writer). The larger the buffer, the
greater the burst of events it can contain without losing any trace
entries.
For example, if you specify BUFF=(5,10), the component
trace uses five fixed trace buffers. Each buffer contains 10 pages.
The total amount of fixed storage used is 200 kilobytes.
Note: When
choosing the amount of fixed storage to use for trace buffers, consider
the amount of central storage available.
- COMASID
- Traces activity in the common area page. This is the default.
- NOCOMASID
- Prevents tracing of activity in the common area page.
- DMPREC
- Includes trace data in the SVC dump requested when RSM enters
recovery processing. The SYSRSM trace is suspended while the dump
is in progress. The dump contains the most recent trace data recorded
prior to the problem. With this dump option, which is a default:
- The trace tables are not dumped when RSM enters recovery processing.
- Tracing continues on other processors during recovery processing.
- NODMPREC
- Prevents trace data from being dumped if RSM enters recovery processing.
- DMPOFF
- Causes trace data to be dumped when tracing for RSM is turned
off with a TRACE CT,OFF,COMP=SYSRSM command or with an OFF parameter
in a CTnRSMxx parmlib member.
- NODMPOFF
- Prevents writing of a dump when the TRACE operator command is
entered to stop the trace. This is the default.
Function Trace Options: Function trace options identify
the RSM functions and services to be traced. The options are:
- ALLOC2G
- Traces events for allocating 2G pages.
- ASPCREAT
- Traces events for the address space create function.
- BLOCKMGR
- Traces RSM SCM block
manager events.
- COPYSRVG
- Traces RSM copy services group. The group options, which can
be specified separately, are:
- COPYSERV
- Traces copy services.
- COPYSRVH
- Traces high virtual copy service.
- DFSTEAL
- Traces events for the double frame steal function.
- DIV
- Traces all events in the data-in-virtual services group. The group
options, which can be specified separately, are:
- DIVACCUN
- Trace the DIV ACCESS and DIV UNACCESS services.
- DIVMAP
- Traces the data-in-virtual MAP service.
- DIVMAPLV
- Traces the data-in-virtual MAP service (with LOCVIEW=MAP on previous
ACCESS).
- DIVRES
- Traces the data-in-virtual RESET service.
- DIVRESLV
- Traces the data-in-virtual RESET service (with LOCVIEW=MAP on
previous ACCESS).
- DIVRTR
- Traces the data-in-virtual services router.
- DIVSAVE
- Traces the data-in-virtual SAVE service.
- DIVSLIST
- Traces the data-in-virtual SAVELIST service.
- DIVUNMAP
- Traces the data-in-virtual UNMAP service.
- DSPCONV
- Traces events in the data space convert interface function.
- DSPLIMIT
- Traces events in the data space limit interface function.
- DATASPAC
- Traces all events in the data space and hiperspace group. The
group options, which can be specified separately, are:
- DSPSERV
- Traces all events in the data space services group. The group
options, which can be specified separately, are:
- DSPCREAT
- Traces events in the DSPSERV CREATE service.
- DSPDELET
- Traces events in the DSPSERV DELETE service.
- DSPDRFOF
- Traces events in DSPSERV define DREF off.
- DSPDRFON
- Traces events in DSPSERV define DREF on.
- DSPEXTEN
- Traces events in the DSPSERV EXTEND service.
- DSPLOAD
- Traces events in the DSPSERV LOAD service.
- DSPIOOF
- Traces events in the DSPSERV IOOFF service.
- DSPIOON
- Traces events in the DSPSERV IOON service.
- DSPOUT
- Traces events in the DSPSERV OUT service.
- DSPREL
- Traces events in the DSPSERV RELEASE service.
- DSPSRTR
- Traces events in the DSPSERV router service.
- DSPSRTRD
- Traces events in the DSPSERV disabled RTR service.
- HSPSERV
- Traces all events in the hiperspace services group. The group
options, which can be specified separately, are:
- HSPCACHE
- Traces events in the HSPSERV cache services.
- HSPSCROL
- Traces events in the HSPSERV scroll services.
- DUMPSERV
- Traces the dumping function.
- FAULTS
- Traces all events in the fault services group. The group options,
which can be specified separately, are:
- FLTASP
- Traces all events in the address space faults group. The group
options, which can be specified separately, are:
- FLTADPAG
- Traces disabled address space page faults.
- FLTAEPAG
- Traces enabled address space page faults.
- FLTAESEG
- Traces enabled address space segment faults.
- FLTAHPAG
- Traces address space page faults for address above the 2 gigabytes
bar.
- FLTAHSEG
- Traces address space segment faults for address above the 2 gigabytes
bar.
- FLTAREGN
- Traces address space region faults.
- FLTATYPE
- Traces address space type faults.
- FLTDSP
- Traces all events on the data space faults group. The group options,
which can be specified separately, are:
- FLTDEN
- Traces enabled data space faults.
- FLTDDIS
- Traces disabled data space faults.
- FLTEPROT
- Traces protection faults.
- FREEFRAM
- Traces the free frame function.
- GEN
- Traces all events in the general function group. The group options,
which can be specified separately, are:
- GENDEFER
- Traces general defers.
- GENIOCMP
- Trace general I/O completion.
- GENTERM
- Traces general abends.
- GLRUSTL
- Traces the global LRU Steal function.
- IARVSERV
- Traces all IARVSERV requests. The Virtual Services group options,
which can be specified separately, are:
- VSCHGACC
- Traces IARVSERV CHANGEACCESS requests.
- VSROUTR
- Traces IARVSERV service router.
- VSSHARE
- Traces IARVSERV SHARE requests.
- VSSHSEG
- Traces IARVSERV SHARESEG requests.
- VSUNSHAR
- Traces IARVSERV UNSHARE requests.
- IARV64
- Traces all IARV64 requests. The High Virtual services group options,
which can be specified separately are:
- V6CHACC
- Traces IARV64 CHANGEACCESS requests.
- V6CHGURD
- Traces IARV64 CHANGEGUARD requests.
- V6COUNT
- IARV64 COUNTPAGES requests.
- V6DETACH
- Traces IARV64 DETACH requests.
- V6DISCAR
- Traces IARV64 DISCARDDATA requests.
- V6GETCOM
- Traces IARV64 GETCOMMON requests.
- V6GETSHR
- Traces IARV64 GETSHARED requests.
- V6GETSTR
- Traces IARV64 GETSTOR requests.
- V6LIST
- Traces IARV64 LIST requests.
- V6PAGFIX
- Traces IARV64 PAGEFIX requests.
- V6PAGIN
- Traces IARV64 PAGEIN requests.
- V6PAGOUT
- TracesIARV64 PAGEOUT requests.
- V6PAGUNF
- Traces IARV64 PAGEUNFIX requests.
- V6PROTEC
- Traces IARV64 PROTECT/UNPROTECT requests.
- V6ROUTR
- Traces IARV64 service router.
- V6SHMOMB
- Traces IARV64 SHAREMEMOBJ requests.
- LPGALLOC
- Traces the Large Page Frame Allocation function.
- MACHCHK
- Traces the machine check function.
- PGSER
- Traces all events in the paging services group. The group options,
which can be specified separately, are:
- PGANY
- Traces events in the page anywhere service.
- PGFIX
- Traces events in the page fix service.
- PGFREE
- Traces events in the page free service.
- PGLOAD
- Traces events in the page load service.
- PGOUT
- Traces events in the page out service.
- PGPROT
- Traces events in the page protect service.
- PGREL
- Traces events in the page release service.
- PGSRTR
- Traces events in the paging service routers.
- PGUNPROT
- Traces events in the page unprotect service.
- QFSTEAL
- Traces events for the quad frame steal function.
- RECONFIG
- Traces the reconfiguration function.
- RPBPMGMT
- Traces the RSM cell pool management function.
- RSMPIN
- Traces the RSMPIN services.
- SUBSPACE
- Traces all events in the subspace group. The group options, which
can be specified separately, are:
- SSPCONV
- Traces the subspace conversion services.
- IARSUBSP
- Traces the subspace services group. The group options, which can
be specified separately, are:
- SSPIDENT
- Traces the IARSUBSP IDENTIFY service.
- SSPCREAT
- Traces the IARSUBSP CREATE service.
- SSPASSIG
- Traces the IARSUBSP ASSIGN service.
- SSPUNAS
- Traces the IARSUBSP UNASSIGN service.
- SSPDELET
- Traces the IARSUBSP DELETE service.
- SSPSHARE
- Traces the IARSUBSP SHARE service.
- SSPUNID
- Traces the IARSUBSP UNIDENTIFY service.
- SSPSRTR
- Traces the IARSUBSP router.
- SWAP
- Traces all events in the swap services group. The group options,
which can be specified separately, are:
- REALSWAP
- Traces events during in-real swap processing.
- SWAPIN
- Traces events in the swap-in service.
- SWAPOUT
- Traces events in the swap-out service.
- TRACE*
- Traces the trace function. This function is always traced.
- UIC
- Traces the unreferenced interval count function.
- UMCPU
- Traces the free CPU related frames function.
- VIO
- Traces the virtual I/O function.
- VR
- Traces the V=R allocation function.
- VSM
- Traces all events in the VSM services group. The group options,
which can be specified separately are:
- VSMFRMN
- Traces events in the FREEMAIN service.
- VSMGTMN
- Traces events in the GETMAIN service.
- WAITSER
- Traces RSM Wait function.
- XCHUP
- Traces the exchange up function.
- XMPOST
- Traces the cross memory posting function.
Event Trace Options: Event trace options identify
the events for RSM to collect trace data. The options are:
- ESTOR
- Traces all events in the expanded storage management group. The
group options, which can be specified separately, are:
- ESGET
- Traces get expanded storage.
- ESENQ
- Traces enqueue expanded storage.
- ESDEQ
- Traces dequeue expanded storage.
- ESFREE
- Traces free expanded storage.
- FUNCREQ
- Traces the function request event.
- PAGEREQ
- Traces all events in the page request group. The group options,
which can be specified separately, are:
- PAGEA2R
- Traces requests to move a page from auxiliary to central storage.
- PAGEDEF
- Traces requests to move a page to central storage was deferred
for lack of a frame
- PAGEIPTE
- Traces requests to invalidate a page table entry.
- PAGEP2R
- Traces requests to move a page from permanent to central storage.
- PAGEREL
- Traces requests related to I/O in-progress or related to a defer
event.
- PAGER2A
- Traces requests to move a page from central storage to auxiliary
storage.
- PAGER2P
- Traces requests to move a page from central storage to permanent
storage.
- PAGER2R
- Traces requests to move a page from central storage to central
storage.
- PGEVENTS
- Traces all events in the page fix/free group. The group options,
which can be specified separately, are:
- FIX
- Traces a page being fixed.
- FREE
- Traces a page being freed.
- REGIONGR
- Traces all events in the region table group. The group options,
which can be specified separately, are:
- CREG1ST
- Traces the creation of a region 1st table.
- CREG2ND
- Traces the creation of a region 2nd table.
- CREG3RD
- Traces the creation of a region 3rd table.
- RSTOR
- Traces all events in the frame management group. The group options,
which can be specified separately, are:
- HVFGRP
- Traces events for frame management of high virtual frames. The
group options, which can be specified separately, are:
- HVFRDEQ
- Traces when a frame is dequeued from the high virtual frame queue.
- HVFRENQ
- Traces when a frame is enqueued onto the high virtual frame queue.
- HVPGTDEQ
- Traces when a frame is dequeued from the high virtual page table
frame queue.
- HVPGTENQ
- Traces when a frame is enqueued onto the high virtual page table
frame queue.
- RSDEQ
- Traces all events in the dequeue frame group. The group options,
which can be specified separately, are:
- RSDDEFER
- Traces when a frame is dequeued from the deferred FREEMAIN frame
queue or the orphan frame queue.
- RSDFIX
- Traces when a frame is dequeued from the fixed frame queue or
the local quad frame queue.
- RSDGDFER
- Traces when a frame is dequeued from the general defer frame queue.
- RSDPAG
- Traces when a frame is dequeued from the pageable frame queue.
- RSDSBUF
- Traces when a frame is dequeued from the central storage buffer
frame queue.
- RSDSQA
- Traces when a frame is dequeued from the SQA frame queue.
- RSDVRW
- Traces when a frame is dequeued from the V=R waiting frame queue.
- RSENQ
- Traces all events in the enqueue frame group. The group options,
which can be specified separately, are:
- RSEDEFER
- Traces when a frame is enqueued onto the deferred or orphan frame
queue.
- RSEFIX
- Traces when a frame is enqueued onto to the fixed frame queue
or the local quad frame queue.
- RSEPAG
- Traces when a frame is enqueued onto to the pageable frame queue.
- RSESBUF
- Traces when a frame is enqueued onto to the central storage buffer
frame queue.
- RSEGDFER
- Traces when a frame is enqueued on the general defer frame queue.
- RSESQA
- Traces when a frame is enqueued onto to the SQA frame queue.
- RSEVRW
- Traces when a frame is enqueued onto to the V=R waiting frame
queue.
- RSFREE
- Traces all events in the free frame group. The group options,
which can be specified separately, are:
- FREE2G
- Traces when a 2G frame group is freed.
- PLFREE
- Traces when a pageable large (1 MB) frame is freed.
- PSFREE
- Traces when a single pageable large (1 MB) frame is freed.
- QFFREE
- Traces when a quad group is freed.
- QHFREE
- Traces when a quad holding frame is freed.
- QSFREE
- Traces when a single quad frame is freed.
- RSFDBL
- Traces when a double frame is freed.
- RSFSNG
- Traces when a single frame is freed.
- RSGET
- Traces all events in the get frame group. The group options, which
can be specified separately, are:
- GET2G
- Traces when a 2G frame group is gotten.
- LSGET
- Traces when a single large frame is gotten.
- PLGET
- Traces when a pageable large frame (1 MB) group is obtained.
- PSGET
- Traces when a single pageable large (1 MB) frame group is obtained.
- QFGET
- Traces when a quad group is gotten.
- QHGET
- Traces when a quad holding frame is gotten.
- QSGET
- Traces when a single quad frame is gotten.
- RSGDBL
- Traces when a double frame is gotten.
- RSGSNG
- Traces when a single frame is gotten.
- SCMBLKMG
- Traces SCM Block
Manager events. The group options, which can be specified separately,
are:
- SCMEVACA
- Traces SCM Evacuation
Add to Table.
- SCMFREE
- Traces the SCM Block
Manager Free Block.
- SCMICHNG
- Traces SCM Block
Manager Increment Change.
- SCMOBT
- Traces the SCM Block
Manager Obtain Block.
- SCMOFLIN
- Traces SCM Block
Manager Offline Event.
- SCMTRANS
- Traces SCM Transfer
Block ID Event
- SCMSTART
- Start of SCM Evacuation
- SCMEND
- End of SCM Evacuation
- SCMSTASP
- Start SCM Evacuation
Address Space
- SCMENDAS
- End SCM Evacuation
Address Space
- SCMSTDSP
- Start SCM Evacuation
Data Space
- SCMENDSP
- End SCM Evacuation
Data Space
- SCMPOOLG
- Get a blockid from a pool
- SCMPOOLF
- Free a blockid to a pool
- SCMEVACR
- Evacuate SCM from
stg range
- SCMDFGST
- Start SCM Defragmentation
- SCMADDIN
- Add SCM increment
- SCMADDEX
- Add SCM extent
- SHRDATA
- Traces all events in the IARVSERV services group. The group options,
which can be specified separately, are:
- GRPCREAT
- Traces the creation of new sharing groups.
- GRPDEL
- Traces the deletion of existing sharing groups.
- GRPPART
- Traces the partitioning of existing sharing groups.
- VIEWADD
- Traces the addition of views to sharing groups.
- VIEWCHG
- Traces the changing of storage attributes of the view.
- VIEWDEL
- Traces the deletion of views from sharing groups.
- VIEWMOVE
- Traces the move of existing views from one sharing group to another.
- SHRINT
- Traces High Virtual Shared Interest events. The group options,
which can be specified separately, are:
- SHRADD
- Traces adding shared interest.
- SHRDEL
- Traces removing shared interest.
- STORMOD
- Traces all events in the storage state modification group. The
group options, which can be specified separately, are:
- CLONEPAG
- Traces the page table entry copied to a subspace.
- CLONESEG
- Traces the segment table entry copied to a subspace.
- TRACEB
- Traces the trace buffer event. This event is always traced.
- WORKUNIT
- Traces all events in the net event trace group. The group options,
which can be specified separately, are:
- ENABLE
- Traces requests to enable a unit of work.
- SUSPEND
- Traces requests to suspend a unit of work.
- RESUME
- Traces requests to resume a unit of work.
- XEPLINK
- Traces all events in the external entry point linkage group. The
group options, which can be specified separately, are:
- XEPENTRY
- Traces entry to the entry point.
- XEPEXIT
- Traces exit from the entry point.