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 V4R3.0. Last updated on 30 Apr 2002 at 16:52:11 EDT.
Copyright IBM Corporation, 1990, 2002