OPTIONS parameter
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.
RUCSAFLT
- Traces restricted-use CSA (RUCSA) fault events.
- SAF
- Traces invocations of SAF from RSM:
- SAFCHK
- Traces SAF Verification events issued from RSM.
- SAFEXTR
- Traces SAF Environment Extract events issued from RSM.
- SAFCREAT
- Traces SAF Environment Create events issued from RSM.
- SAFDELET
- Traces SAF Environment Delete events issued from RSM.
- 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.