|
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. |
LNKBK
Cross Reference (Contains links to field and bit definitions)
LNKBK Prolog
NAME : HCPLNKBK
DESCRIPTION: ISFC Link Definition Block
STATUS : VM/ESA Version 2, Release 2.0
DSECT : LNKBK
FUNCTION : This block is used to maintain status information
for an ISFC link device. The information in the LNKBK
is needed for any ISFC link operation. The line driver
uses a link extension block (addressed by LNKEXTBK)
for information that is used exclusively for line
driver operations.
LOCATED BY : RDEVCFLK (pointer) If RDEVCFAT is ON, then it contains
the address of the LNKBK for this device.
HCPBUTLT (anchor) the first LNKBK in the chain.
CREATED BY : Operation of the 'ACTIVATE ISLINK' command.
DELETED BY : Operation of the 'DEACTIVE ISLINK' command.
SERIALIZED : The respective LNKBK lock (LNKLKWRD) must be held in order
to update any field in the LNKBK. The RDEV lock must
be held in order to change RDEVCFLK.
LNKBK Control Block Content
LNKBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure LNKBK ISFC Link Definition Block Link Description. 0000 0 Character 8 LNKTYPE Link Type 0008 8 Character 16 LNKNAME Link Name String 0018 24 Address 4 LNKNEXT Address of the next LNKBK 001C 28 Address 4 LNKEXTBK Address of Driver Link Extension 0020 32 Signed 4 LNKDEVNO Link Device Address (base) 0024 36 Signed 4 LNKDEVCT Link Device Count 0028 40 Character 4 LNKDEVID Link Base Address (printable) 002C 44 Bitstring 4 * Reserved Link Status. Notes : Any line driver that intends to use the LNKENTQL interface should maintain link status using these values. 0030 48 Bitstring 1 LNKSTAT Link status: 00000001 LNKIDLE 1 - Idle 00000002 LNKBUSY 2 - Busy 00000003 LNKWRITE 3 - Write in progress 00000004 LNKREAD 4 - Read in progress 00000005 LNKRESET 5 - Reset in progress 00000006 LNKATTN 6 - Handling link attention 00000007 LNKFATAL 7 - Fatal I/O on link 00000008 LNKINIT 8 - Initialization in progress 00000008 LNKDEACT 8 - Deactivation in progress 0031 49 Bitstring 1 LNKSTATE Link state 00000001 LNKUP 1 - The link is up 00000002 LNKDOWN 2 - The link is down 0032 50 Bitstring 1 LNKFLAG Supplemental status: 1... .... LNKINPRG X'80' - Initialization in progress .1.. .... LNKDLPRG X'40' - Delete in progress ..1. .... LNKBLDPD X'20' - Call to BuildLink is pending ...1 .... LNKDUPND X'10' - Duplicate ISFC Node detected .... 1... LNKSUSPD X'08' - This link is suspended 0033 51 Bitstring 5 * Reserved Link Lock controls. 0038 56 Dbl-Word 8 LNKLKWRD (3) Lockword for Link Lock 0050 80 Bitstring 8 LNKLKTRC LNKBK lock trace values Link Monitor controls. 0058 88 Bitstring 8 LNKLINST Local link instance number 0060 96 Bitstring 8 LNKRINST Remote link instance number 0068 104 Signed 4 LNKIOCMP I/O Completion Count 006C 108 Signed 4 LNKIOSAV Save I/O Completions 0070 112 Signed 2 LNKLMCNT Link Monitor iteration number 0072 114 Bitstring 1 LNKMONFL Link Monitor Flags 1... .... LNKMONIT X'80' - Monitor this link .1.. .... LNKMONOK X'40' - Monitor Response Received 0073 115 Bitstring 1 * Reserved 0074 116 Signed 4 LNKIOTOD TOD clock at last I/O request Type 09 Accounting Record (Link Statistics) columns 29-78. Notes : Map LNKACOLS using HCPACOBK at ACOCFLS. 0078 120 Bitstring 50 LNKACOLS (29-78) for Type 09 Accounting 00AA 170 Bitstring 6 * Reserved Link Termination. 00B0 176 Character 8 LNKUSER Command invoker's userid Miscellaneous fields. 00B8 184 Signed 4 LNKMSNUM Last message number displayed 00BC 188 Bitstring 4 * Reserved Line Driver Entry Points. 00C0 192 Dbl-Word 8 LNKENTS (0) Entry Point Table 00C0 192 Address 4 LNKENTBL Addr(build link routine) 00C4 196 Address 4 LNKENTDL Addr(delete link routine) 00C8 200 Address 4 LNKENTAL Addr(activate link routine) 00CC 204 Address 4 LNKENTRL Addr(reset link routine) 00D0 208 Address 4 LNKENTQL Addr(query link routine) 00D4 212 Address 4 LNKENTWL Addr(write link routine) 00D8 216 Address 4 LNKENTIC Addr(interrupt completion) 00DC 220 Address 4 LNKENTUI Addr(unsolicited interrupt) 00000020 LNKENTZ *-LNKENTS Length of LNKENTS table Link Data QUEBK. Notes : QUESIZE is defined in HCPQUEBK, so modules using this control block must also COPY HCPQUEBK. **** THE VALUE OF QUESIZE FOR DATAMAP IS 6 00E0 224 Dbl-Word 8 LNKQUEBK (QUESIZE) QUEBK for Link Data Link I/O QUEBK. Notes : QUESIZE is defined in HCPQUEBK, so modules using this control block must also COPY HCPQUEBK. **** THE VALUE OF QUESIZE FOR DATAMAP IS 6 0110 272 Dbl-Word 8 LNKIOQBK (QUESIZE) QUEBK for Link I/O Link Device Table. 00000010 LNKDEVMX 16 **** THE VALUE OF LNKDEVMX FOR DATAMAP IS 16 0140 320 Address 4 LNKDEVTB (LNKDEVMX) Table of LDVBK pointers 00000030 LNKSIZE (*-LNKBK+7)/8 Size, in doublewords, of LNKBK
LNKBK Storage Layout
*** LNKBK - ISFC Link Definition Block * * +-------------------------------------------------------+ * 0 | LNKTYPE | * +-------------------------------------------------------+ * 8 | LNKNAME | * | | * +---------------------------+---------------------------+ * 18 | LNKNEXT | LNKEXTBK | * +---------------------------+---------------------------+ * 20 | LNKDEVNO | LNKDEVCT | * +---------------------------+---------------------------+ * 28 | LNKDEVID |///////////////////////////| * +------+------+------+------+---------------------------+ * 30 |:STAT |:STATE|:FLAG |//////////////////////////////////| * +------+------+------+----------------------------------+ * 38 | | * = LNKLKWRD = * | | * +-------------------------------------------------------+ * 50 | LNKLKTRC | * +-------------------------------------------------------+ * 58 | LNKLINST | * +-------------------------------------------------------+ * 60 | LNKRINST | * +---------------------------+---------------------------+ * 68 | LNKIOCMP | LNKIOSAV | * +-------------+------+------+---------------------------+ * 70 | LNKLMCNT |:MONFL|//////| LNKIOTOD | * +-------------+------+------+---------------------------+ * 78 | | * = LNKACOLS = * | +-----------------------------------------+ * A8 | |/////////////////////////////////////////| * +-------------+-----------------------------------------+ * B0 | LNKUSER | * +---------------------------+---------------------------+ * B8 | LNKMSNUM |///////////////////////////| * +---------------------------+---------------------------+ * C0 | LNKENTBL | LNKENTDL | * +---------------------------+---------------------------+ * C8 | LNKENTAL | LNKENTRL | * +---------------------------+---------------------------+ * D0 | LNKENTQL | LNKENTWL | * +---------------------------+---------------------------+ * D8 | LNKENTIC | LNKENTUI | * +---------------------------+---------------------------+ * E0 | | * = LNKQUEBK = * | | * +-------------------------------------------------------+ * 110 | | * = LNKIOQBK = * | | * +-------------------------------------------------------+ * 140 | | * = LNKDEVTB = * | | * +-------------------------------------------------------+ * 180 * *** LNKBK - ISFC Link Definition Block
LNKBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----LNKACOLS 0078
LNKATTN 0030 00000006
LNKBLDPD 0032 20
LNKBUSY 0030 00000002
LNKDEACT 0030 00000008
LNKDEVCT 0024
LNKDEVID 0028
LNKDEVMX 0110 00000010
LNKDEVNO 0020
LNKDEVTB 0140
LNKDLPRG 0032 40
LNKDOWN 0031 00000002
LNKDUPND 0032 10
LNKENTAL 00C8
LNKENTBL 00C0
LNKENTDL 00C4
LNKENTIC 00D8
LNKENTQL 00D0
LNKENTRL 00CC
LNKENTS 00C0
LNKENTUI 00DC
LNKENTWL 00D4
LNKENTZ 00DC 00000020
LNKEXTBK 001C
LNKFATAL 0030 00000007
LNKFLAG 0032
LNKIDLE 0030 00000001
LNKINIT 0030 00000008
LNKINPRG 0032 80
LNKIOCMP 0068
LNKIOQBK 0110
LNKIOSAV 006C
LNKIOTOD 0074
LNKLINST 0058
LNKLKTRC 0050
LNKLKWRD 0038
LNKLMCNT 0070
LNKMONFL 0072
LNKMONIT 0072 80
LNKMONOK 0072 40
LNKMSNUM 00B8
LNKNAME 0008
LNKNEXT 0018
LNKQUEBK 00E0
LNKREAD 0030 00000004
LNKRESET 0030 00000005
LNKRINST 0060
LNKSIZE 0140 00000030
LNKSTAT 0030
LNKSTATE 0031
LNKSUSPD 0032 08
LNKTYPE 0000
LNKUP 0031 00000001
LNKUSER 00B0
LNKWRITE 0030 00000003
Last updated on 3 Aug 1999 at 12:14:56 EDT.
Copyright IBM Corporation, 1990, 1999