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

 

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   32 LSOMBLK        THE MEASUREMENT BLOCK, AS
                                        ARCHITECTED
     * * THE CONTENTS OF THE MBLK * ARE MAPPED BY THE * HCPSCMBK 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.
007C  124 Signed       2 LSOSCCTL (0)
     * * SUBCHANNEL OPERATION * CONTROLS *
007C  124 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
007D  125 Address      1 LSOESWSC       SEQUENCE CODE THAT WAS CHECK
                                        POINTED AT THE TIME OF ERROR.
007E  126 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
007F  127 Bitstring    1 *              Reserved for future use
0080  128 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. *
0088  136 Dbl-Word     8 LSOSSTIM       TOD VALUE WHEN THE START FUNCTION
                                        BEGAN
0090  144 Dbl-Word     8 LSOSATIM       TOD VALUE WHEN THE SUBCHANNEL
                                        WENT ACTIVE
0098  152 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. *
00A0  160 Address      4 LSOCURCA       THE ADDRESS OF THE CCW THAT WAS
                                        LAST FETCHED
00A4  164 Bitstring    1 LSOCCMD        THE CURRENT CHANNEL COMMAND
00A5  165 Bitstring    1 LSOCFLGS       THE CURRENT COMMAND FLAGS
00A6  166 Bitstring    2 LSOCTNDC       COUNT OF CONSECUTIVE NON- DATA
                                        TRANSFER TYPE CCWS
00A8  168 Signed       4 LSOCCNT        THE CURRENT CCW COUNT
00AC  172 Address      4 LSOCADDR       ADDRESS FIELD FROM CURRENT CCW
     * * THE FOLLOWING VARIABLES * ARE USED TO CONTROL DATA * TRANSFER. *
00B0  176 Bitstring    1 LSOCRTC        THE LAST COMMAND CHAINED COMMAND.
                                        THIS IS THE COMMAND THAT CONTROLS
                                        THE DIRECTION OF DATA TRANSFER.
00B1  177 Bitstring    3 *              RESERVED FOR FURTURE USE
00B4  180 Address      4 LSOIDAWA       INDIRECT ADDRESS WORD POINTER.
                                        WHEN IDA IS IN EFFECT, THIS
                                        POINTS TO THE IDAW THAT IS
                                        CURRENTLY CONTROLLING DATA
                                        TRANSFER
00B8  184 Address      4 LSOCURDA       THE ADDRESS OF THE CURRENT DATA
                                        AREA. WHEN IDA IS IN EFFECT, THIS
                                        VALUE COMES FROM AN IDAW.
                                        OTHERWISE, IT COMES FROM THE CCW.
00BC  188 Signed       4 LSOIDACT       THE NUMBER OF BYTES LEFT IN THE
                                        CURRENT IDA AREA.
     * * COMMAND RETRY CONTROLS *
00C0  192 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 *
00C4  196 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.
00C8  200 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. *
00CC  204 Address      4 LSOLDCSR       THE ADDRESS OF THE COMMAND
                                        SIMULATOR ROUTINE
00D0  208 Address      4 LSOLDIDR       THE ADDRESS OF THE INTERFACE
                                        DISCONNECT ROUTINE
00D4  212 Address      4 LSOLDSRR       THE ADDRESS OF THE SELECTIVE
                                        RESET ROUTINE
00D8  216 Address      4 LSOLDDDR       THE ADDRESS OF THE DEVICE
                                        DESTRUCTION ROUTINE
00DC  220 Bitstring    4 *              RESERVED FOR FUTURE USE
     * * Logical device I/O * Interface lockword. *
00E0  224 Dbl-Word     8 LSOIOLCK (3)   I/O Interface lock
          0000001F       LSOSIZE        (*-LSOBJ+7)/8 LENGTH OF LSOBJ IN
                                        DOUBLE-WORDS

 

LSOBJ Storage Layout

          
*** LSOBJ - LOGICAL SUBCHANNEL OBJECT
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       LSOSCHIB                        =
*     |                           +---------------------------+
*  30 |                           |///////////////////////////|
*     +---------------------------+---------------------------+
*  38 |                                                       |
*     =                        LSOORB                         =
*     |                                                       |
*     +---------------------------+---------------------------+
*  58 |///////////////////////////|                           |
*     +---------------------------+                           |
*  60 |                                                       |
*     =                       LSOMBLK                         =
*     |                           +------+------+------+------+
*  78 |                           |:SEQCD|:ESWSC|:OPQD |//////|
*     +---------------------------+------+------+------+------+
*  80 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  88 |                       LSOSSTIM                        |
*     +-------------------------------------------------------+
*  90 |                       LSOSATIM                        |
*     +-------------------------------------------------------+
*  98 |                       LSOSCTIM                        |
*     +---------------------------+------+------+-------------+
*  A0 |         LSOCURCA          |:CCMD |:CFLGS|  LSOCTNDC   |
*     +---------------------------+------+------+-------------+
*  A8 |         LSOCCNT           |         LSOCADDR          |
*     +------+--------------------+---------------------------+
*  B0 |:CRTC |////////////////////|         LSOIDAWA          |
*     +------+--------------------+---------------------------+
*  B8 |         LSOCURDA          |         LSOIDACT          |
*     +---------------------------+---------------------------+
*  C0 |         LSOCRTA           |         LSOLDOP           |
*     +---------------------------+---------------------------+
*  C8 |         LSORDEVP          |         LSOLDCSR          |
*     +---------------------------+---------------------------+
*  D0 |         LSOLDIDR          |         LSOLDSRR          |
*     +---------------------------+---------------------------+
*  D8 |         LSOLDDDR          |///////////////////////////|
*     +---------------------------+---------------------------+
*  E0 |                                                       |
*     =                       LSOIOLCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  F8
*
*** LSOBJ - LOGICAL SUBCHANNEL OBJECT

 

LSOBJ Cross Reference

Symbol         Dspl Value
-------------- ---- -----
LSOCADDR       00AC
LSOCCMD        00A4
LSOCCNT        00A8
LSOCFLGS       00A5
LSOCRTA        00C0
LSOCRTC        00B0
LSOCTNDC       00A6
LSOCURCA       00A0
LSOCURDA       00B8
LSOESWSC       007D
LSOIDACT       00BC
LSOIDAWA       00B4
LSOIOLCK       00E0
LSOLDCSR       00CC
LSOLDDDR       00D8
LSOLDIDR       00D0
LSOLDOP        00C4
LSOLDSRR       00D4
LSOMBLK        005C
LSONOPQD       007E 00000000
LSOOPQD        007E
LSOORB         0038
LSORDEVP       00C8
LSOSATIM       0090
LSOSCCTL       007C
LSOSCHIB       0000
LSOSCTIM       0098
LSOSEQCD       007C
LSOSEQC0       007C 00000000
LSOSEQC1       007C 00000001
LSOSEQC2       007C 00000002
LSOSEQC3       007C 00000003
LSOSEQC4       007C 00000004
LSOSEQC6       007C 00000006
LSOSFQD        007E 000000FF
LSOSIZE        00E0 0000001F
LSOSSTIM       0088

This information is based on z/VM V4R2.0. Last updated on 18 Oct 2001 at 08:14:48 EDT.
Copyright IBM Corporation, 1990, 2001