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

DISPLAY Linkage Stack
►►
Notes:
Display
Authorization
Purpose
Operands
Usage Notes
Responses
(1)
LKS
(2)
vaddr
1
.n
1 Do not put blanks between operands that relate to a single DISPLAY request.
Privilege Class: G
Use DISPLAY LKS to see the state entries of a guest linkage stack.
vaddr
displays the branch or program-call linkage-stack state entry that contains the
specified guest virtual address (vaddr) within the current home address space
designated by guest control register 13. The default is the current linkage-stack
state entry identified by guest control register 15.
1
n n is a decimal number, up to eight digits, specifying the number of branch and
program-call linkage-stack state entries to be displayed. The display starts with
the specified/current entry and moves back toward the first entry on the linkage
stack. 1 is the default, and 0 is treated as 1.
1. This command is valid only for 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 DISPLAY command operands, Linkage Stack does not define the
default for subsequent operands of the current DISPLAY 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).
6. For more information, see “Usage Notes” on page 282.
Heading Information
DISPLAY Linkage Stack
2 If vaddr is not specified, the current linkage-stack state entry identified by guest control register 15
is the default.
►◄
Chapter 2. CP Commands 317