|
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
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
Copyright IBM Corporation, 1990, 2011