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   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 V5R2.0. Last updated on 12 Apr 2006 at 17:03:47 EDT.
Copyright IBM Corporation, 1990, 2005