27.12.2012 Views

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

TRACE: Options<br />

1606 z/<strong>VM</strong>: <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> <strong>and</strong> <strong>Utilities</strong> <strong>Reference</strong><br />

ASCEhexdblword<br />

indicates that an address space control element (ASCE) be used to locate the<br />

address space to be traced.<br />

ASNasn<br />

indicates that an address space number (asn) be used to locate the address<br />

space to be traced. The specified ASN may be one to four hexadecimal digits.<br />

The ASN is used in conjunction with guest ASN translation tables to locate the<br />

STO of the address space to be traced.<br />

ASTEraddr<br />

indicates that an ASN second table entry (ASTE) be used to locate the address<br />

space to be traced. The oper<strong>and</strong> raddr is the guest real address of the ASTE<br />

that contains the segment table origin (STO) of the address space to be traced.<br />

HOME<br />

restricts tracing to events in the guest’s current home address space as pointed<br />

to by the guest control register 13.<br />

PRI<br />

restricts tracing to events in the guest’s current primary address space as<br />

pointed to by the guest control register 1.<br />

SECO<br />

restricts tracing to events in the guest’s current secondary address space as<br />

pointed to by the guest control register 7.<br />

STDhexword<br />

indicates that a segment table designation (STD) be used to locate the address<br />

space to be traced. The STD contains the segment table origin (STO) of the<br />

address space to be traced.<br />

The STD option is not valid in z/Architecture mode.<br />

STOraddr<br />

indicates that a segment table origin (STO) be used to locate the address<br />

space to be traced. The oper<strong>and</strong> raddr is the segment table origin of the<br />

address space to be traced <strong>and</strong> is a guest real address.<br />

The STO option is not valid in z/Architecture mode.<br />

SKIP n<br />

requests that the associated event be completely ignored n times. When used<br />

with the NOSIM option, however, it specifies the number of times that an<br />

instruction is simulated normally.<br />

RUN<br />

specifies that virtual machine execution is not to pause when the specified<br />

event occurs. RUN is assumed if TERMINAL is not specified or assumed. RUN<br />

is incompatible with NORUN, STEP, <strong>and</strong> STOP.<br />

NORun<br />

specifies that virtual machine execution is to pause when the specified event<br />

occurs. NORUN is assumed if TERMINAL is specified or assumed. NORUN is<br />

incompatible with RUN, STEP, <strong>and</strong> STOP.<br />

PAss n<br />

is a repeating SKIP specification. If you do not specify a SKIP option, PASS<br />

takes effect immediately. If you do specify a SKIP count, PASS takes effect<br />

after the SKIP count expires <strong>and</strong> the specified event has been recognized.<br />

For example:<br />

v PASS 2 displays every third event

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!