Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

LSOBJ

Prolog  

Control Block Contents  
   LSOBJ DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


LSOBJ Prolog

 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


LSOBJ DSECT

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

          
*** 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

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 V6R2.0. Last updated on 21 Nov 2011 at 11:09:06 EDT.
Copyright IBM Corporation, 1990, 2011