|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
LKSBK
Control Block Contents
LKSBK DSECT
Cross Reference (Contains links to field and bit definitions)
LKSBK Prolog
NAME : HCPLKSBK
DESCRIPTION: Linkage Stack block
DSECT : LKSBK
FUNCTION : The LKSBK maps the storage associated with a linkage
stack section.
LOCATED BY : Is a mapping for the entries in a
linkage stack section.
CREATED BY : n/a
DELETED BY : n/a
SERIALIZED : The user of the Control Block is responsi-
ble for the serialization which is:
Instruction stream or Console Funct. Mode
LKSBK Control Block Content
LKSBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure LKSBK Linkage Stack block
stack section entry
Mapping for a Linkage stack state entry
0000 0 Bitstring 160 LKSENTRY (0) Map the contents of a linkage
stack state entry.(The declared
length (160) does not include the
state descriptor length(8)).
Values of general purpose registers
0000 0 Bitstring 64 LKSGPRS (0) General Purp. Regs. of the caller
.... .... LKSGPRH0 LKSGPRS+0,2 GPR halfword 0
.... .... LKSGPRB0 LKSGPRS+0,1 GPR byte 0
.... ...1 LKSGPRB1 LKSGPRS+1,1 GPR byte 1
.... ..1. LKSGPRH1 LKSGPRS+2,2 GPR halfword 1
.... ..1. LKSGPRB2 LKSGPRS+2,1 GPR byte 2
.... ..11 LKSGPRB3 LKSGPRS+3,1 GPR byte 3
0000 0 Signed 4 LKSGPR0 General purpose register 0
0004 4 Signed 4 LKSGPR1 General purpose register 1
0008 8 Bitstring 52 LKSGR214 (0) General purpose registers 2-14
0008 8 Signed 4 LKSGPR2 General purpose register 2
000C 12 Signed 4 LKSGPR3 General purpose register 3
0010 16 Signed 4 LKSGPR4 General purpose register 4
0014 20 Signed 4 LKSGPR5 General purpose register 5
0018 24 Signed 4 LKSGPR6 General purpose register 6
001C 28 Signed 4 LKSGPR7 General purpose register 7
0020 32 Signed 4 LKSGPR8 General purpose register 8
0024 36 Signed 4 LKSGPR9 General purpose register 9
0028 40 Signed 4 LKSGPR10 General purpose register 10
002C 44 Signed 4 LKSGPR11 General purpose register 11
0030 48 Signed 4 LKSGPR12 General purpose register 12
0034 52 Signed 4 LKSGPR13 General purpose register 13
0038 56 Signed 4 LKSGPR14 General purpose register 14
003C 60 Signed 4 LKSGPR15 General purpose register 15
Values of Access Registers
0040 64 Bitstring 64 LKSARS (0) Access registers of the caller
.1.. .... LKSARH0 LKSARS+0,2 AR halfword 0
.1.. .... LKSARB0 LKSARS+0,1 AR byte 0
.1.. ...1 LKSARB1 LKSARS+1,1 AR byte 1
.1.. ..1. LKSARH1 LKSARS+2,2 AR halfword 1
.1.. ..1. LKSARB2 LKSARS+2,1 AR byte 2
.1.. ..11 LKSARB3 LKSARS+3,1 AR byte 3
0040 64 Signed 4 LKSAR0 Access register 0
0044 68 Signed 4 LKSAR1 Access register 1
0048 72 Bitstring 52 LKSAR214 (0) Access registers 2-14
0048 72 Signed 4 LKSAR2 Access register 2
004C 76 Signed 4 LKSAR3 Access register 3
0050 80 Signed 4 LKSAR4 Access register 4
0054 84 Signed 4 LKSAR5 Access register 5
0058 88 Signed 4 LKSAR6 Access register 6
005C 92 Signed 4 LKSAR7 Access register 7
0060 96 Signed 4 LKSAR8 Access register 8
0064 100 Signed 4 LKSAR9 Access register 9
0068 104 Signed 4 LKSAR10 Access register 10
006C 108 Signed 4 LKSAR11 Access register 11
0070 112 Signed 4 LKSAR12 Access register 12
0074 116 Signed 4 LKSAR13 Access register 13
0078 120 Signed 4 LKSAR14 Access register 14
007C 124 Signed 4 LKSAR15 Access register 15
Control field
0080 128 Dbl-Word 8 LKSCR384 (0) CR3 and pieces of CRs 8,4
0080 128 Signed 4 LKSCR3 (0) Control register 3
0080 128 Bitstring 2 LKSPKM PSW-key mask of caller
0082 130 Bitstring 2 LKSSASN Secondary ASN of caller
0084 132 Signed 2 LKSCR8H1 (0) CR8 bits 0-15
0084 132 Bitstring 2 LKSEAX Extended authorization index
0086 134 Signed 2 LKSCR4H2 (0) CR4 bits 16-31
0086 134 Bitstring 2 LKSPASN Primary ASN of caller
Program Status Word
0088 136 Dbl-Word 8 LKSPSW (0) PSW of caller (points past instr)
for a 390 guest, PSW bits 0-63
for an ESAME guest.
0088 136 Signed 4 LKSPSW0F (0) Caller PSW bits 0-31
0088 136 Bitstring 1 LKSPSW0 Caller PSW byte zero, Syst. Mask
.1.. .... PSWPERA X'40' PROGRAM EVENT RECORDING
ACTIVE
.... .1.. PSWTRAN X'04' ADDRESS TRANSLATE MODE
ACTIVE
.... ..1. PSWIOSM X'02' I/O INTERRUPTION SUMMARY
MASK
.... ...1 PSWEXSM X'01' EXTERNAL INTERRUPT SUMMARY
MASK
1111 11.. PSWIOMSK X'FC' CHANNEL MASK, CHANNELS 0-5
.... ..1. PSWIOSMB X'02' I/O SUMMARY MASK, CHANNEL
6-15
.... ...1 PSWEXSMB X'01' EXTERNAL INTERRUPT SUMMARY
MASK
0089 137 Bitstring 1 LKSPSW1 Caller PSW byte one, key/emwp
1111 .... PSWKEY X'F0' PSW ACCESS KEY EXTRACTION
MASK
.... 1... PSWECMD X'08' EXTENDED CONTROL MODE
ACTIVE
.... .1.. PSWMCHK X'04' MACHINE CHECK SUMMARY MASK
.... ..1. PSWWAIT X'02' PROGRAM WAIT STATE
.... ...1 PSWPROB X'01' PROGRAM PROBLEM STATE
.... ...1 PSWMAPPD X'01' For BC-mode PSWs created by
the 370 Accommodation facility,
this bit being set indicates that
the PSW is really a "mapped" PSW.
See HCPPSW.
008A 138 Bitstring 1 LKSPSW2 Caller PSW byte two, EC mode
Secondary/Cond. Code/Pgm mask
11.. .... PSWASMSK X'C0' ADDRESS SPACE CONTROL MASK
11.. .... PSWHMODE X'C0' HOME-SPACE MODE
1... .... PSWSMODE X'80' SECONDARY MODE
.1.. .... PSWAMODE X'40' ACCESS-REGISTER MODE
..11 .... PSWCOND X'30' PSW CONDITION CODE
..1. .... PSWCOND2 X'20' PSW CONDITION CODE BIT FOR
CC=2,3
...1 .... PSWCOND1 X'10' PSW CONDITION CODE BIT FOR
CC=1,3
.... 1111 PSWPMSK X'0F' FIXO+DECO+EXUN+SIGN PROGRAM
MASK
.... 1... PSWFIXO X'08' FIXED-PT OVERFLOW INTRPT
MASK
.... .1.. PSWDECO X'04' DECIMAL OVERFLOW INTRPT
MASK
.... ..1. PSWEXUN X'02' EXPONENT UNDERFLOW INTRPT
MASK
.... ...1 PSWSIGN X'01' SIGNIFICANCE INTERRUPT MASK
.... .... PSWPMODE X'00' PRIMARY-SPACE MODE
008B 139 Bitstring 1 LKSPSW3 Caller PSW byte three,
008C 140 Signed 4 LKSPSW4F (0) PSW instruction address for a
non-ESAME guest (S/370 bits 32-39
zero) ESAME: bit32 = AMode,
b33-63=0 LKS2PSW has remaining
psw fields
008C 140 Bitstring 1 LKSPSW4 Caller EC PSW byte four, AMode
1... .... PSW31BT X'80' 31-BIT LOGICAL ADDRESSING
MODE
1... .... PSWBA PSW31BT Basic Addressing Mode
.111 1111 PSWHIADR X'7F' INSTRUCTION COUNTER BITS
1-7 - MUST BE ZERO IN 24-BIT
MODE.
.... .... PSW31AMF X'80000000' ADDRESS MODE FULLWORD
MASK - CORRESPONDS TO PSW31BT
008D 141 Bitstring 3 LKSPSW57 Caller EC PSW byte 5,6,7 BC
Instr.
0090 144 Dbl-Word 8 LKSDATA (0) Data for specific types of
entries
Mapping for LKSDATA for a Branch state entry
0090 144 Signed 4 * Reserved
0094 148 Address 4 LKSBADDR (0) Branch address for a branch state
entry for non-ESAME guests
0094 148 Bitstring 1 LKSBADD0 Byte 0
1... .... LKSAMODE X'80' Addressing mode bit for a
branch state entry
0095 149 Bitstring 3 * Reserved
0098 152 Dbl-Word 8 LKSMODFA Modifiable area
000000A0 LKSENLEN *-LKSENTRY Number of bytes to
back up pointer for a state entry
dsect
Mapping for a Linkage stack entry descriptor
- offset is changed in ESA/ME, but no content change
00A0 160 Dbl-Word 8 LKSEDESC (0) Entry descriptor
00A0 160 Bitstring 1 LKSETYPE Entry type
00000001 LKSHEADR 1 Header entry
00000002 LKSTRAIL 2 Trailer entry
00000004 LKSBRSTT 4 Branch and stack state entry
00000005 LKSPCSTT 5 Program call state entry
0000007F LKSETMSK 127 Mask to obtain entry type
1... .... LKSUSUPR X'80' Unstack suppression bit,
valid for header or state entries
00A1 161 Bitstring 1 LKSSECID Section identification
00A2 162 Bitstring 2 LKSRFS Remaining free space in bytes
between this entry and the
trailer entry.
00A4 164 Bitstring 2 LKSNES Next entry size in bytes, zero if
the current entry
00A6 166 Bitstring 2 * Reserved
00000008 LKSEDSIZ *-LKSEDESC Number of bytes in
entry descriptor
Size of state entry = Number of bytes in state entry DSECT + Number of
bytes in entry descriptor
000000A8 LKSENSIZ LKSENLEN+LKSEDSIZ Number of bytes
in state entry
Mapping for LKSDATA for a PC state entry
0090 144 Signed 4 * Reserved
0094 148 Signed 4 LKSPCNUM PC number for a program-call
state entry
Mapping for linkage stack Header or Trailer (non-ESAME guest)
0098 152 Bitstring 8 LKSHDTR (0) Map the contents of the linkage
stack Header or Trailer
0098 152 Signed 4 * Reserved
009C 156 Address 4 LKSBFSA (0) Backward stack-entry address or
forward-section-header address
respectively for header and
trailer entries
009C 156 Bitstring 1 LKSNXST0 Byte 0
1... .... LKSVALID X'80' LLSBFSA pointer is valid.
009D 157 Bitstring 3 *
00000008 LKSHLEN *-LKSHDTR Number of bytes to back
up pointer for a Header or
Trailer DSECT
LKSBK Storage Layout
*** LKSBK - Linkage Stack block
*
* +---------------------------+---------------------------+
* 0 | LKSGPR0 | LKSGPR1 |
* +---------------------------+---------------------------+
* 8 | LKSGPR2 | LKSGPR3 |
* +---------------------------+---------------------------+
* 10 | LKSGPR4 | LKSGPR5 |
* +---------------------------+---------------------------+
* 18 | LKSGPR6 | LKSGPR7 |
* +---------------------------+---------------------------+
* 20 | LKSGPR8 | LKSGPR9 |
* +---------------------------+---------------------------+
* 28 | LKSGPR10 | LKSGPR11 |
* +---------------------------+---------------------------+
* 30 | LKSGPR12 | LKSGPR13 |
* +---------------------------+---------------------------+
* 38 | LKSGPR14 | LKSGPR15 |
* +---------------------------+---------------------------+
* 40 | LKSAR0 | LKSAR1 |
* +---------------------------+---------------------------+
* 48 | LKSAR2 | LKSAR3 |
* +---------------------------+---------------------------+
* 50 | LKSAR4 | LKSAR5 |
* +---------------------------+---------------------------+
* 58 | LKSAR6 | LKSAR7 |
* +---------------------------+---------------------------+
* 60 | LKSAR8 | LKSAR9 |
* +---------------------------+---------------------------+
* 68 | LKSAR10 | LKSAR11 |
* +---------------------------+---------------------------+
* 70 | LKSAR12 | LKSAR13 |
* +---------------------------+---------------------------+
* 78 | LKSAR14 | LKSAR15 |
* +-------------+-------------+-------------+-------------+
* 80 | LKSPKM | LKSSASN | LKSEAX | LKSPASN |
* +------+------+------+------+------+------+-------------+
* 88 |:PSW0 |:PSW1 |:PSW2 |:PSW3 |:PSW4 | LKSPSW57 |
* +------+------+------+------+------+--------------------+
* 90 |///////////////////////////|:BADD0|////////////////////|
* +---------------------------+------+--------------------+
* 98 | LKSMODFA |
* +------+------+-------------+-------------+-------------+
* A0 |:ETYPE|:SECID| LKSRFS | LKSNES |/////////////|
* +------+------+-------------+-------------+-------------+
* A8
*
*** LKSBK - Linkage Stack block
*** Overlay for LKSDATA in LKSBK
*
* +---------------------------+---------------------------+
* 90 |///////////////////////////| LKSPCNUM |
* +---------------------------+---------------------------+
* 98
*
*** Overlay for LKSDATA in LKSBK
*** Overlay for LKSEDESC-LKSHLEN in LKSBK
*
* +---------------------------+------+--------------------+
* 98 |///////////////////////////|:NXST0|////////////////////|
* +---------------------------+------+--------------------+
* A0
*
*** Overlay for LKSEDESC-LKSHLEN in LKSBK
LKSBK Cross Reference
Symbol Dspl Value -------------- ---- ----- LKSAMODE 0094 80 LKSARB0 0040 40 LKSARB1 0040 41 LKSARB2 0040 42 LKSARB3 0040 43 LKSARH0 0040 40 LKSARH1 0040 42 LKSARS 0040 LKSAR0 0040 LKSAR1 0044 LKSAR10 0068 LKSAR11 006C LKSAR12 0070 LKSAR13 0074 LKSAR14 0078 LKSAR15 007C LKSAR2 0048 LKSAR214 0048 LKSAR3 004C LKSAR4 0050 LKSAR5 0054 LKSAR6 0058 LKSAR7 005C LKSAR8 0060 LKSAR9 0064 LKSBADDR 0094 LKSBADD0 0094 LKSBFSA 009C LKSBRSTT 00A0 00000004 LKSCR3 0080 LKSCR384 0080 LKSCR4H2 0086 LKSCR8H1 0084 LKSDATA 0090 LKSEAX 0084 LKSEDESC 00A0 LKSEDSIZ 00A6 00000008 LKSENLEN 0098 000000A0 LKSENSIZ 00A6 000000A8 LKSENTRY 0000 LKSETMSK 00A0 0000007F LKSETYPE 00A0 LKSGPRB0 0000 00 LKSGPRB1 0000 01 LKSGPRB2 0000 02 LKSGPRB3 0000 03 LKSGPRH0 0000 00 LKSGPRH1 0000 02 LKSGPRS 0000 LKSGPR0 0000 LKSGPR1 0004 LKSGPR10 0028 LKSGPR11 002C LKSGPR12 0030 LKSGPR13 0034 LKSGPR14 0038 LKSGPR15 003C LKSGPR2 0008 LKSGPR3 000C LKSGPR4 0010 LKSGPR5 0014 LKSGPR6 0018 LKSGPR7 001C LKSGPR8 0020 LKSGPR9 0024 LKSGR214 0008 LKSHDTR 0098 LKSHEADR 00A0 00000001 LKSHLEN 009D 00000008 LKSMODFA 0098 LKSNES 00A4 LKSNXST0 009C LKSPASN 0086 LKSPCNUM 0094 LKSPCSTT 00A0 00000005 LKSPKM 0080 LKSPSW 0088 LKSPSW0 0088 LKSPSW0F 0088 LKSPSW1 0089 LKSPSW2 008A LKSPSW3 008B LKSPSW4 008C LKSPSW4F 008C LKSPSW57 008D LKSRFS 00A2 LKSSASN 0082 LKSSECID 00A1 LKSTRAIL 00A0 00000002 LKSUSUPR 00A0 80 LKSVALID 009C 80 PSWAMODE 008A 40 PSWASMSK 008A C0 PSWBA 008C 80 PSWCOND 008A 30 PSWCOND1 008A 10 PSWCOND2 008A 20 PSWDECO 008A 04 PSWECMD 0089 08 PSWEXSM 0088 01 PSWEXSMB 0088 01 PSWEXUN 008A 02 PSWFIXO 008A 08 PSWHIADR 008C 7F PSWHMODE 008A C0 PSWIOMSK 0088 FC PSWIOSM 0088 02 PSWIOSMB 0088 02 PSWKEY 0089 F0 PSWMAPPD 0089 01 PSWMCHK 0089 04 PSWPERA 0088 40 PSWPMODE 008A 00 PSWPMSK 008A 0F PSWPROB 0089 01 PSWSIGN 008A 01 PSWSMODE 008A 80 PSWTRAN 0088 04 PSWWAIT 0089 02 PSW31AMF 008C 00 PSW31BT 008C 80
Copyright IBM Corporation, 1990, 2001