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