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

Options
PSWA range
FRom range
Range range
specifying the program status word address (PSWA) restricts instruction tracing
to a given address range. It permits a trap to be taken if the PSWA (commonly
known as the instruction counter) points to an instruction in the specified range.
The range may be a single address, a pair of addresses separated by a hyphen
(-), or an address followed by a period (.) followed by a byte count. An
instruction is considered to be within the range if the first byte is within the
range.
The FROM option is not supported for the TRACE AIF command.
The instruction addresses specified for the range cannot exceed
FFFFFFFF FFFFFFFF.
FROM and RANGE are synonyms for PSWA used in those subcommands
where a potential for confusion exists. For example, TRACE BRANCH allows
two instruction ranges to be specified, a FROM range and an INTO range.
FROM and RANGE are allowed wherever PSWA is allowed.
For executed instructions (that is, instructions that are issued by means of the
assembler language EXECUTE instruction), the instruction is within the range if
either:
v The first byte of the EXECUTE instruction is within the range
v The first byte of the target instruction is within the range.
For external interrupts, the PSW address at the time of the interrupt is
inspected to see if it is within the range.
TRACE: Options
When a program event recording (PER) event is reflected to your virtual
machine, the PER event address is checked.
For any other program exception, the old PSW instruction address is inspected
if a nullification exception occurs; for all others, the old PSW instruction address
is adjusted by the instruction length.
ALEThexword
indicates that access register translation be used to locate the address space to
be traced. The access list entry token (ALET) is used in conjunction with the
guest access register translation tables to locate the STO of the address space
to be traced.
ALEThexword.ALraddr
restricts tracing to events in an address space using the specified access list
entry token (ALET) and access list (AL). The ALET and AL are used in
conjunction with the guest access register translation tables to locate the STO
of the address space to be traced.
AREGareg
indicates that access register translation be used to locate the address space to
be traced. The access register (areg) is specified as one hexadecimal or two
decimal digits. The access list entry token (ALET) within the access register is
used in conjunction with the guest access register translation tables to locate
the STO of the address space to be traced.
Chapter 2. CP Commands 1605