|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
LSOBJ
Control Block Contents
LSOBJ DSECT
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
Copyright IBM Corporation, 1990, 2002