LSOBJ Back to Index page
 
Prolog 
Control Block Contents 
   LSOBJ DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  LSOBJ Prolog Top of page
 
 NAME       : HCPLSOBJ
 DESCRIPTION: LOGICAL SUBCHANNEL OBJECT
 DSECT      : LSOBJ
 FUNCTION   : THE LOGICAL SUBCHANNEL OBJECT (LSO) DEFINES A LOGICAL
              SUBCHANNEL AS IT IS SIMULATED BY THE LOGICAL CHANNEL
              SIMULATOR. THERE IS ONE LSO FOR EACH LOGICAL DEVICE. THE
              LSO CONTAINS ALL OF THE INFORMATION NEEDED TO SIMULATE A
              SUBCHANNEL. ACCESS TO THE LSO IS AVAILABLE ONLY THROUGH THE
              LSO MANAGERS, HCPLSO AND HCPLSM.
 LOCATED BY : RDEVLSOP  FIELD OF HCPRDEV  (LSO POINTER)
 CREATED BY : HCPLSOCR
 DELETED BY : HCPLSODD
 RELOCATION CONSIDERATIONS : None
 
 
  LSOBJ Control Block Content Top of page
 

 LSOBJ DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure LSOBJ LOGICAL SUBCHANNEL OBJECT SUBCHANNEL INFORMATION BLOCK 0000 0 Bitstring 52 LSOSCHIB THE SCHIB, AS ARCHITECTED. THE CONTENTS OF THE SCHIB ARE MAPPED BY THE HCPSCHIB COPY FILE 0034 52 Bitstring 4 * RESERVED FOR FUTURE USE OPERATION REQUEST BLOCK 0038 56 Bitstring 32 LSOORB THE ORB, AS ARCHITECTED. THE CONTENTS OF THE ORB ARE MAPPED BY THE HCPORBLK COPY FILE 0058 88 Bitstring 4 * RESERVED FOR FUTURE USE MEASUREMENT BLOCK 005C 92 Bitstring 64 LSOMEAS (0) 005C 92 Bitstring 32 LSOMBLK The 32-byte measurement block, as architected. The contents of the MBLK are mapped by the HCPSCMBK COPY file 005C 92 Bitstring 64 LSOMBLG The 64-byte measurement block, as architected. The contents of the MBLG are mapped by the HCPSCGBK COPY file SUBCHANNEL CONTROL BLOCK THE SUBCHANNEL CONTROL BLOCK USED TO MANAGE THE OPERATION OF THE LOGICAL SUBCHANNEL. IN COMBINATION WITH THE SCHIB AND ORB, THIS STRUCTURE REPRESENTS THE STATE OF THE LOGICAL SUBCHANNEL. 009C 156 Signed 2 LSOSCCTL (0) Subchannel Operation Controls 009C 156 Address 1 LSOSEQCD SUBCHANNEL SEQUENCE CODE. THIS IS USED TO DETECT OUT-OF-SEQUENCE CALLS BY BY A DEVICE SIMULATOR. WHEN A LOGOUT IS TAKEN, THIS VALUE IS PLACED IN THE ESW. VALID SEQUENCE CODE VALUES 00000000 LSOSEQC0 0 START PENDING OR CHANNEL PROGRAM ENDED 00000001 LSOSEQC1 1 COMMAND FETCHED, WAITING FOR DATA TRANSFER OR STATUS 00000002 LSOSEQC2 2 PRIMARY STATUS RECEIVED WITHOUT ANY DATA TRANSFER, WAITING FOR SECONDARY STATUS 00000003 LSOSEQC3 3 DATA HAS BEEN TRANSFERRED, MORE DATA TRANSFER OR STATUS EXPECTED 00000004 LSOSEQC4 4 SECONDARY STATUS RECEIVED, READY FOR NEXT COMMAND FETCH 00000006 LSOSEQC6 6 PRIMARY STATUS RECEIVED AFTER DATA HAS BEEN TRANSFERRED, WAITING FOR SECONDARY STATUS 009D 157 Address 1 LSOESWSC SEQUENCE CODE THAT WAS CHECK POINTED AT THE TIME OF ERROR. 009E 158 Address 1 LSOOPQD I/O OPERATION QUEUED FLAG. VALID VALUES ARE AS FOLLOWS: 00000000 LSONOPQD 0 NO OPERATION IS QUEUED 000000FF LSOSFQD 255 AN OPERATION IS QUEUED FOR START 009F 159 Bitstring 1 * Reserved for future use 00A0 160 Bitstring 4 * RESERVED FOR FUTURE USE TOD clock times taken at various points of channel simulation. They are used to compute the channel measurements at the end of an operation. 00A8 168 Dbl-Word 8 LSOSSTIM TOD VALUE WHEN THE START FUNCTION BEGAN 00B0 176 Dbl-Word 8 LSOSATIM TOD VALUE WHEN THE SUBCHANNEL WENT ACTIVE 00B8 184 Dbl-Word 8 LSOSCTIM TOD VALUE WHEN THE START FUNCTION ENDED. The following variables define the channel command word that is currently directing the subchannel. 00C0 192 Address 4 LSOCURCA THE ADDRESS OF THE CCW THAT WAS LAST FETCHED 00C4 196 Bitstring 1 LSOCCMD THE CURRENT CHANNEL COMMAND 00C5 197 Bitstring 1 LSOCFLGS THE CURRENT COMMAND FLAGS 00C6 198 Bitstring 2 LSOCTNDC COUNT OF CONSECUTIVE NON- DATA TRANSFER TYPE CCWS 00C8 200 Bitstring 8 LSOCURDA (0) THE ADDRESS OF THE CURRENT 00C8 200 Bitstring 4 * DATA AREA. WHEN IDA IS IN 00CC 204 Bitstring 4 LSOCCWDA EFFECT, THIS VALUE COMES FROM AN IDAW. OTHERWISE, IT COMES FROM THE CCW. The following variables are used to control data transfer. 00D0 208 Bitstring 1 LSOCRTC THE LAST COMMAND CHAINED COMMAND. THIS IS THE COMMAND THAT CONTROLS THE DIRECTION OF DATA TRANSFER. 00D1 209 Bitstring 3 * RESERVED FOR FURTURE USE 00D4 212 Address 4 LSOIDAWA INDIRECT ADDRESS WORD POINTER. WHEN IDA IS IN EFFECT, THIS POINTS TO THE IDAW THAT IS CURRENTLY CONTROLLING DATA TRANSFER 00D8 216 Address 4 LSOCADDR ADDRESS FIELD FROM CURRENT CCW 00DC 220 Signed 4 LSOIDACT THE NUMBER OF BYTES LEFT IN THE CURRENT IDA AREA. Command retry controls 00E0 224 Address 4 LSOCRTA THE ADDRESS OF THE LAST COMMAND CHAINED CCW. WHEN COMMAND RETRY IS REQUESTED, THE LCS BACKS UP TO THIS CCW. Data structure linkages. 00E4 228 Signed 4 LSOLDOP LOGICAL DEVICE UNIT ADDRESS THIS IS THE VALUE THAT IS PASSED TO THE LOGICAL DEVICE SIMULATOR, INTERFACE DISCONNECT, AND SELECTIVE RESET FUNCTIONS. THE LOGICAL DEVICE SIMULATOR SUPPLIES THIS VALUE AT THE TIME THE LOGICAL DEVICE IS CREATED. IT IS ANTICIPATED THAT THIS VALUE WILL BE THE ADDRESS OF SOME DATA STRUCTURE THAT REPRESENTS THE LOGICAL DEVICE. HOWEVER, THERE IS NO REQUIREMENT FOR IT TO BE AN ADDRESS. IT CAN BE ANY 32-BIT VALUE. 00E8 232 Address 4 LSORDEVP THE ADDRESS OF THE RDEV BLOCK THAT REPRESENTS THIS LOGICAL DEVICE IN THE I/O CONFIGURATION Logical device simulator vector: Addresses of the various LDS functions. 00EC 236 Address 4 LSOLDCSR THE ADDRESS OF THE COMMAND SIMULATOR ROUTINE 00F0 240 Address 4 LSOLDIDR THE ADDRESS OF THE INTERFACE DISCONNECT ROUTINE 00F4 244 Address 4 LSOLDSRR THE ADDRESS OF THE SELECTIVE RESET ROUTINE 00F8 248 Address 4 LSOLDDDR THE ADDRESS OF THE DEVICE DESTRUCTION ROUTINE 00FC 252 Signed 4 LSOCCNT THE CURRENT CCW COUNT Logical Device I/O Interface lockword 0100 256 Dbl-Word 8 LSOIOLCK (3) I/O Interface lock 00000023 LSOSIZE (*-LSOBJ+7)/8 LENGTH OF LSOBJ IN DOUBLE-WORDS
 
 
  LSOBJ Storage Layout Top of page
 
          
*** LSOBJ - LOGICAL SUBCHANNEL OBJECT
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       LSOSCHIB                        =
*     |                           +---------------------------+
*  30 |                           |///////////////////////////|
*     +---------------------------+---------------------------+
*  38 |                                                       |
*     =                        LSOORB                         =
*     |                                                       |
*     +---------------------------+---------------------------+
*  58 |///////////////////////////|
*     +---------------------------+
*
*** LSOBJ - LOGICAL SUBCHANNEL OBJECT
          
*** Overlay for LSOMEAS in LSOBJ
*
*                                 +---------------------------+
*     ...                      5C |                           |
*     +---------------------------+                           |
*  60 |                                                       |
*     =                       LSOMBLK                         =
*     |                           +---------------------------+
*     |                           | 7C
*     +---------------------------+
*
*** Overlay for LSOMEAS in LSOBJ
          
*** Overlay for LSOMEAS in LSOBJ
*
*                                 +---------------------------+
*     ...                      5C |                           |
*     +---------------------------+                           |
*  60 |                                                       |
*     =                       LSOMBLG                         =
*     |                           +------+------+------+------+
*  98 |                           |:SEQCD|:ESWSC|:OPQD |//////|
*     +---------------------------+------+------+------+------+
*  A0 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  A8 |                       LSOSSTIM                        |
*     +-------------------------------------------------------+
*  B0 |                       LSOSATIM                        |
*     +-------------------------------------------------------+
*  B8 |                       LSOSCTIM                        |
*     +---------------------------+------+------+-------------+
*  C0 |         LSOCURCA          |:CCMD |:CFLGS|  LSOCTNDC   |
*     +---------------------------+------+------+-------------+
*  C8 |///////////////////////////|         LSOCCWDA          |
*     +------+--------------------+---------------------------+
*  D0 |:CRTC |////////////////////|         LSOIDAWA          |
*     +------+--------------------+---------------------------+
*  D8 |         LSOCADDR          |         LSOIDACT          |
*     +---------------------------+---------------------------+
*  E0 |         LSOCRTA           |         LSOLDOP           |
*     +---------------------------+---------------------------+
*  E8 |         LSORDEVP          |         LSOLDCSR          |
*     +---------------------------+---------------------------+
*  F0 |         LSOLDIDR          |         LSOLDSRR          |
*     +---------------------------+---------------------------+
*  F8 |         LSOLDDDR          |         LSOCCNT           |
*     +---------------------------+---------------------------+
* 100 |                                                       |
*     =                       LSOIOLCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 118
*
*** Overlay for LSOMEAS in LSOBJ
 
 
  LSOBJ Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
LSOCADDR       00D8
LSOCCMD        00C4
LSOCCNT        00FC
LSOCCWDA       00CC
LSOCFLGS       00C5
LSOCRTA        00E0
LSOCRTC        00D0
LSOCTNDC       00C6
LSOCURCA       00C0
LSOCURDA       00C8
LSOESWSC       009D
LSOIDACT       00DC
LSOIDAWA       00D4
LSOIOLCK       0100
LSOLDCSR       00EC
LSOLDDDR       00F8
LSOLDIDR       00F0
LSOLDOP        00E4
LSOLDSRR       00F4
LSOMBLG        005C
LSOMBLK        005C
LSOMEAS        005C
LSONOPQD       009E 00000000
LSOOPQD        009E
LSOORB         0038
LSORDEVP       00E8
LSOSATIM       00B0
LSOSCCTL       009C
LSOSCHIB       0000
LSOSCTIM       00B8
LSOSEQCD       009C
LSOSEQC0       009C 00000000
LSOSEQC1       009C 00000001
LSOSEQC2       009C 00000002
LSOSEQC3       009C 00000003
LSOSEQC4       009C 00000004
LSOSEQC6       009C 00000006
LSOSFQD        009E 000000FF
LSOSIZE        0100 00000023
LSOSSTIM       00A8
 
This information is based on z/VM 7.1.0 Last updated on 22 Jun 2018 at 11:50:39 EDT.
Copyright IBM Corporation, 1990, 2018