|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
LSOBJ
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 12 LSOORB THE ORB, AS ARCHITECTED * * THE CONTENTS OF THE ORB * ARE MAPPED BY THE * HCPORBLK COPY FILE * 0044 68 Bitstring 4 * RESERVED FOR FUTURE USE MEASUREMENT BLOCK 0048 72 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. 0068 104 Signed 2 LSOSCCTL (0) * * SUBCHANNEL OPERATION * CONTROLS * 0068 104 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 0069 105 Address 1 LSOESWSC SEQUENCE CODE THAT WAS CHECK POINTED AT THE TIME OF ERROR. 006A 106 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 006B 107 Bitstring 1 * Reserved for future use 006C 108 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. * 0070 112 Dbl-Word 8 LSOSSTIM TOD VALUE WHEN THE START FUNCTION BEGAN 0078 120 Dbl-Word 8 LSOSATIM TOD VALUE WHEN THE SUBCHANNEL WENT ACTIVE 0080 128 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. * 0088 136 Address 4 LSOCURCA THE ADDRESS OF THE CCW THAT WAS LAST FETCHED 008C 140 Bitstring 1 LSOCCMD THE CURRENT CHANNEL COMMAND 008D 141 Bitstring 1 LSOCFLGS THE CURRENT COMMAND FLAGS 008E 142 Bitstring 2 LSOCTNDC COUNT OF CONSECUTIVE NON- DATA TRANSFER TYPE CCWS 0090 144 Signed 4 LSOCCNT THE CURRENT CCW COUNT 0094 148 Address 4 LSOCADDR ADDRESS FIELD FROM CURRENT CCW * * THE FOLLOWING VARIABLES * ARE USED TO CONTROL DATA * TRANSFER. * 0098 152 Bitstring 1 LSOCRTC THE LAST COMMAND CHAINED COMMAND. THIS IS THE COMMAND THAT CONTROLS THE DIRECTION OF DATA TRANSFER. 0099 153 Bitstring 3 * RESERVED FOR FURTURE USE 009C 156 Address 4 LSOIDAWA INDIRECT ADDRESS WORD POINTER. WHEN IDA IS IN EFFECT, THIS POINTS TO THE IDAW THAT IS CURRENTLY CONTROLLING DATA TRANSFER 00A0 160 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. 00A4 164 Signed 4 LSOIDACT THE NUMBER OF BYTES LEFT IN THE CURRENT IDA AREA. * * COMMAND RETRY CONTROLS * 00A8 168 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 * 00AC 172 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. 00B0 176 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. * 00B4 180 Address 4 LSOLDCSR THE ADDRESS OF THE COMMAND SIMULATOR ROUTINE 00B8 184 Address 4 LSOLDIDR THE ADDRESS OF THE INTERFACE DISCONNECT ROUTINE 00BC 188 Address 4 LSOLDSRR THE ADDRESS OF THE SELECTIVE RESET ROUTINE 00C0 192 Address 4 LSOLDDDR THE ADDRESS OF THE DEVICE DESTRUCTION ROUTINE 00C4 196 Bitstring 4 * RESERVED FOR FUTURE USE * * Logical device I/O * Interface lockword. * 00C8 200 Dbl-Word 8 LSOIOLCK (3) I/O Interface lock 0000001C LSOSIZE (*-LSOBJ+7)/8 LENGTH OF LSOBJ IN DOUBLE-WORDS
LSOBJ Storage Layout
*** LSOBJ - LOGICAL SUBCHANNEL OBJECT * * +-------------------------------------------------------+ * 0 | | * = LSOSCHIB = * | +---------------------------+ * 30 | |///////////////////////////| * +---------------------------+---------------------------+ * 38 | LSOORB | * | +---------------------------+ * 40 | |///////////////////////////| * +---------------------------+---------------------------+ * 48 | | * = LSOMBLK = * | | * +------+------+------+------+---------------------------+ * 68 |:SEQCD|:ESWSC|:OPQD |//////|///////////////////////////| * +------+------+------+------+---------------------------+ * 70 | LSOSSTIM | * +-------------------------------------------------------+ * 78 | LSOSATIM | * +-------------------------------------------------------+ * 80 | LSOSCTIM | * +---------------------------+------+------+-------------+ * 88 | LSOCURCA |:CCMD |:CFLGS| LSOCTNDC | * +---------------------------+------+------+-------------+ * 90 | LSOCCNT | LSOCADDR | * +------+--------------------+---------------------------+ * 98 |:CRTC |////////////////////| LSOIDAWA | * +------+--------------------+---------------------------+ * A0 | LSOCURDA | LSOIDACT | * +---------------------------+---------------------------+ * A8 | LSOCRTA | LSOLDOP | * +---------------------------+---------------------------+ * B0 | LSORDEVP | LSOLDCSR | * +---------------------------+---------------------------+ * B8 | LSOLDIDR | LSOLDSRR | * +---------------------------+---------------------------+ * C0 | LSOLDDDR |///////////////////////////| * +---------------------------+---------------------------+ * C8 | | * = LSOIOLCK = * | | * +-------------------------------------------------------+ * E0 * *** LSOBJ - LOGICAL SUBCHANNEL OBJECT
LSOBJ Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----LSOCADDR 0094
LSOCCMD 008C
LSOCCNT 0090
LSOCFLGS 008D
LSOCRTA 00A8
LSOCRTC 0098
LSOCTNDC 008E
LSOCURCA 0088
LSOCURDA 00A0
LSOESWSC 0069
LSOIDACT 00A4
LSOIDAWA 009C
LSOIOLCK 00C8
LSOLDCSR 00B4
LSOLDDDR 00C0
LSOLDIDR 00B8
LSOLDOP 00AC
LSOLDSRR 00BC
LSOMBLK 0048
LSONOPQD 006A 00000000
LSOOPQD 006A
LSOORB 0038
LSORDEVP 00B0
LSOSATIM 0078
LSOSCCTL 0068
LSOSCHIB 0000
LSOSCTIM 0080
LSOSEQCD 0068
LSOSEQC0 0068 00000000
LSOSEQC1 0068 00000001
LSOSEQC2 0068 00000002
LSOSEQC3 0068 00000003
LSOSEQC4 0068 00000004
LSOSEQC6 0068 00000006
LSOSFQD 006A 000000FF
LSOSIZE 00C8 0000001C
LSOSSTIM 0070
Last updated on 3 Aug 1999 at 12:11:58 EDT.
Copyright IBM Corporation, 1990, 1999