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

DUMP LKS
►►
DUmp
Notes:
Authorization
Purpose
Operands
(1)
LKS
Usage Notes
vaddr
1
.n
Privilege Class: G
(2)
*dumpid
1 Do not put blanks between operands that relate to a single DUMP request.
2 You can assign only one dump identifier per command.
Use DUMP LKS to dump the state entries of the guest linkage stack.
DUMP LKS
vaddr
dumps the branch or program-call linkage-stack state entry that contains the
specified guest virtual address within the current home address space
designated by guest control register 13. The default is the current linkage-stack
state entry pointed to by guest control register 15.
1
n is a decimal number, up to eight digits, specifying the number of branch and
program-call linkage-stack state entries to be dumped. The dump starts with the
specified/current entry and moves back toward the first entry on the
linkage-stack. The default is 1, and 0 is treated as 1.
*dumpid
is an asterisk followed by a 1-character to 97-character identifier that is to be
assigned to the dump (may be truncated to 80 characters for a z/Architecture
guest). If specified, *dumpid must be the last operand you enter on the
command line.
1. This command is valid only if the virtual machine is an ESA virtual machine.
2. The first linkage-stack state entry is the oldest state entry (the first one put on
the stack). The last linkage-stack state entry is the current state entry (the most
recent one put on the stack).
3. Unlike other DUMP command operands, using LKS does not define the default
for subsequent operands of the current DUMP function.
4. The virtual address specified in vaddr must fall within the branch or program-call
linkage-stack state entry, including the first and last bytes of the linkage-stack
state entry.
5. A linkage-stack state entry is an entry on the linkage stack that describes the
environment in an address space (such as access registers, general-purpose
registers and PSWs).
►◄
Chapter 2. CP Commands 389