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. |
SFSCB
Cross Reference (Contains links to field and bit definitions)
SFSCB Prolog
Name : DMSSFSCB Description: Shared File System Control Block DSECT : SFSCB Function : This macro maps data used by the CMS file system support of file sharing.
SFSCB Control Block Content
SFSCB DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SFSCB Shared File System Control Block Miscellaneous fields 0000 0 Character 8 SFSFPOOL Current filepool 0008 8 Character 8 SFSPPOOL Primary filepool 0010 16 Address 4 SFSODTAD => List of ODTs 0014 20 Signed 4 SFSSEQCT Sequence counter 0018 24 Dbl-Word 8 SFSTOKEN (0) Unique identifier for SFS object 0018 24 Address 4 SFSTOKAD Object address 001C 28 Signed 4 SFSTOKSQ Object sequence number 00000008 SFSTOKLN *-SFSTOKEN Token length 0020 32 Signed 4 * Reserved 0024 36 Signed 4 SFSOSECB OS ECB for READ and WRITE 0028 40 Address 4 SFSSDE => Common Error Handler 002C 44 Address 4 SFSSDM => Common Message Handler Asynchronous Request fields 0030 48 Signed 4 SFSARCHD (0) Asynchronous Request Chain Header 0030 48 Signed 4 * Reserved 0034 52 Address 4 SFSARCF Points to first ARCE 0038 56 Address 4 SFSARCL Points to last ARCE Caching fields 003C 60 Signed 4 SFSCAWAR (18) Cache Work Area 0084 132 Signed 4 SFSCARET Cache Build Return Code 0088 136 Address 4 SFSCAADT => Cache Build Anchor ADT 008C 140 Address 4 SFSREFST => Rename FST 0090 144 Address 4 SFSREHYP => Rename Hyperblock 0094 148 Address 4 SFSUCCAD => Unaccessed Cache Chain 0098 152 Bitstring 1 SFSCAFLG CACHE FLAGS 1... .... SFSFRESH X'80' Issue Refresh_directory .1.. .... SFSCACLN X'40' Cache end-command cleanup required ..1. .... SFSCACLA X'20' A disk cleanup required ...1 .... SFSFRSH6 X'10' Issue Refresh_directory for Release 6 file pool 0099 153 Bitstring 1 * Reserved 009A 154 Signed 2 SFSUACNT Count of directories on UACC 009C 156 Bitstring 4 SFSCALWM Caching storage low water mark 00A0 160 Signed 4 * Reserved UCT anchors 00A4 164 Signed 4 * (0) Explicit alignment 00A4 164 Address 4 SFSUCTA UCT anchor 00A8 168 Signed 4 SFSUCTC UCT count 00AC 172 Bitstring 0 SFSUCTA1 UCT anchor block 00C8 200 Bitstring 0 SFSUCTA2 UCT anchor block 00E4 228 Bitstring 0 SFSUCTA3 UCT anchor block 0100 256 Bitstring 0 SFSUCTA4 UCT anchor block 011C 284 Bitstring 0 SFSUCTA5 UCT anchor block 0138 312 Bitstring 0 SFSUCTA6 UCT anchor block Logical block processing fields 0154 340 Bitstring 0 SFSWBNL Logical block number list 01D0 464 Bitstring 0 SFSWBAL 4K buffer address list Work unit processing 024C 588 Address 4 SFSWUIDC Initial counter value 0250 592 Address 4 SFSWUBAS Base work unit 00000001 SFSWUBAI 1 Initial base work unit ID value 00000008 SFSWURES 8 Number of reserved workunit IDs 00000001 SFSREADO 1 Read/Only ID 00000002 SFSATOMC 2 Atomic write ID 00000003 SFSSSLOG 3 Session services logging ID 00000004 SFSCOPYF 4 COPYFILE write ID 0254 596 Address 4 SFSWUSTP => Last block of stack storage 0258 600 Character 8 SFSWUCUR (0) Current default work unit ID 0258 600 Signed 4 SFSWUCU1 First half of work unit ID (zeros) 025C 604 Signed 4 SFSWUCU2 Second half of work unit ID 0260 608 Signed 4 SFSWUSTK (22) Stack storage for work units 0260 608 Address 4 * 0264 612 Signed 4 * (2) 026C 620 Signed 4 * (19) 02B8 696 Bitstring 1 SFSWUFLG WORKUNIT FLAGS 1... .... SFSWURET X'80' There are workunits to be returned .1.. .... SFSWUPOP X'40' There are workunits to be popped 02B9 697 Bitstring 1 * (3) Reserved for future use OPEN/CLOSE CATALOG processing 02BC 700 Address 4 SFSRESPA pointer to the address of the response data returned from OPEN CATALOG or CLOSE CATALOG 02C0 704 Signed 4 SFSRESPL length of the response data returned from OPEN CATALOG or CLOSE CATALOG NAMEDEF processing 02C4 708 Address 4 SFSDNT => Dirid NAMDEF Table 02C8 712 Address 4 SFSFNT => File NAMDEF Table 02CC 716 Address 4 SFSMNT => Filemode NAMDEF Table 02D0 720 Address 4 SFSCNT => Command NAMDEF Table 02D4 724 Signed 4 SFSCNTBL (0) Command NAMDEF Table 02D4 724 Address 4 SFSCRES Reserved for future use 02D8 728 Address 4 SFSCFRE Chain of unused NAMEDEF entries 02DC 732 Address 4 SFSCUSED Chain of used NAMEDEF entries 02E0 736 Signed 4 SFSCENT0 (0) Compatability NAMEDEF entry 02E0 736 Address 4 SFSC0NXT => Next entry 02E4 740 Character 16 SFSC0NAM Compatability NAMEDEF 02F4 756 Character 0 SFSC0PDC Make room for PDCB 039C 924 Signed 4 SFSCENT1 (0) First command NAMEDEF entry 039C 924 Address 4 SFSC1NXT => Next entry 03A0 928 Character 16 SFSC1NAM First command NAMEDEF 03B0 944 Character 0 SFSC1PDC Make room for PDCB 0458 1112 Signed 4 SFSCENT2 (0) Second command NAMEDEF entry 0458 1112 Address 4 SFSC2NXT => Next entry 045C 1116 Character 16 SFSC2NAM Second command NAMEDEF 046C 1132 Character 0 SFSC2PDC Make room for PDCB SFSODT 0514 1300 Bitstring 0 SFSODT ODT for general usage SPSCA 060C 1548 Bitstring 0 SFSSPSCA SPSCA for general usage 06DC 1756 Signed 4 * Reserved for future use DMSJNL (NAMELIST) processing fields 06E0 1760 Signed 4 SFSJNLPL (0) Plist to call DMSJNL (NAMELIST) 06E0 1760 Character 255 SFSJNLNK Nickname 07DF 2015 Bitstring 1 SFSJNLMD MESSAGE DISPOSITION FOR DMSMSG 07E0 2016 Address 4 SFSJNLAL Address of userid length, list 07E4 2020 Signed 4 SFSJNLSL Length of storage to be released 07E8 2024 Character 8 SFSJNLFP File pool id 07F0 2032 Character 84 SFSJNLST Storage for 10 userids List of file pools with file space threshold exceeded (SFSFPCNT is number of filemodes available to users) 0844 2116 Character 8 SFSFPLST (25) Array of file pool identifiers 000000C8 SFSFPLEN *-SFSFPLST Length of the array in bytes 0844 2116 Bitstring 1 SFSFPCHR (SFSFPLEN) Initialize array to zeros 00000019 SFSFPCNT 25 Number of names in the array ARCE (asynchronous request chain) storage management 090C 2316 Signed 4 SFSARCHB (0) 090C 2316 Address 4 SFSAVAIL Addr(chain of usable ARCE storage) 0910 2320 Bitstring 1 SFSASFLG ASYNCH FLAGS 1... .... SFSAFLG X'80' Flag whether any asynch processing 0911 2321 Bitstring 1 * (3) Reserved for future use File Attribute Stack related information 0914 2324 Bitstring 0 SFSFASTK Current File Attribute Defaults in DMSFATTR MACRO format Work Unit Table management for Release 1.1 Multiple Userid Support. 0920 2336 Address 4 SFSWUTAP => Array of table entry ptrs. 0924 2340 Address 4 SFSWUTFP => Free storage pool. 0928 2344 Address 4 SFSWUTSP => Deallocation stack. 00000400 SFSWUTAN 1024 # Elements in ptr array. 00001000 SFSWUTAL 4096 # Bytes in ptr array. 00002A30 SFSWUTFL 10800 # Bytes of storage to allocate per free pool storage request. Other Miscellaneous Information 092C 2348 Bitstring 1 SFSOFLAG OTHER MISCELLANEOUS FLAGS 1... .... SFSRECIN X'80' Indicates whether DFSMS Implicit file Recall processing has been inhibited. '1' means RECALL OFF. .1.. .... SFSRORES X'40' Indicates whether R/O access should be respected. (Used by XEDIT & COPYFILE). '1' means RORESPECT set to ON. 092D 2349 Bitstring 1 * (3) Reserved for future use File I/O related information 0930 2352 Address 4 SFSSDF => File I/O Message handler RCM storage management For DMSRCM (File system Record Manager) storage management, store in the SFSCB the pointer (SFSRCMAV) to the first available storage chunk in the page of storage obtained by DMSRCM. Also, store the flag (SFSRCMFL.SFSARCM) that indicates whether asynchronous processing has occurred since the last end-of-command. 0934 2356 Signed 4 SFSASRCM (0) 0934 2356 Address 4 SFSRCMAV Address of the first available storage chunk in the DMSRCMAS subpool 0938 2360 Bitstring 1 SFSRCMFL DMSRCM ASYNCHRONOUS FLAGS 1... .... SFSARCM X'80' When on indicates a prior asynchronous function has occurred 0939 2361 Bitstring 1 * (3) Reserved 093C 2364 Bitstring 1 * (4) Reserved File space Usage Block (FUB) Management 0940 2368 Address 4 SFSFUBPT Pointer to FUB Chain 0944 2372 Signed 4 SFSFUBNA Number of Active FUBs. 00000003 SFSFUBNP 3 Number of pre-allocated FUBs Note. If the value of SFSFUBNP changes then the number of FUBs allocated here in the SFSCB must change accordingly. 0948 2376 Dbl-Word 8 SFSFUB1 (0) First FUB in chain 0948 2376 Character 3 SFSF1EYE File Space Usage Block 094B 2379 Bitstring 1 SFSF1FLG FUB FLAGS FUBPREAL FLAG INDICATES THAT THIS FUB IS PREALLOCATED. THIS FLAG MUST NEVER BE SET TO 0 HERE. 094C 2380 Address 4 SFSF1FPT Pointer to next FUB in chain 0950 2384 Bitstring 0 SFSF1FLD Additional FUB fields 0978 2424 Dbl-Word 8 SFSFUB2 (0) Second FUB in chain 0978 2424 Character 3 SFSF2EYE File Space Usage Block 097B 2427 Bitstring 1 SFSF2FLG FUB FLAGS FUBPREAL FLAG INDICATES THAT THIS FUB IS PREALLOCATED. THIS FLAG MUST NEVER BE SET TO 0 HERE. 097C 2428 Address 4 SFSF2FPT Pointer to next FUB in chain 0980 2432 Bitstring 0 SFSF2FLD Additional FUB fields 09A8 2472 Dbl-Word 8 SFSFUB3 (0) Third FUB in chain 09A8 2472 Character 3 SFSF3EYE File Space Usage Block 09AB 2475 Bitstring 1 SFSF3FLG FUB FLAGS FUBPREAL FLAG INDICATES THAT THIS FUB IS PREALLOCATED. THIS FLAG MUST NEVER BE SET TO 0 HERE. 09AC 2476 Address 4 SFSF3FPT Pointer to next FUB in chain 09B0 2480 Bitstring 0 SFSF3FLD Additional FUB fields 09D8 2520 Address 4 SFSBFSCB Pointer to the DMSBFSCP block 09DC 2524 Address 4 SFSFSSM Pointer to the FSSM anchor Useful Equates 00000099 SFSDIRMX 153 Maximum size of compressed dirid 000009E0 SFSCBSIZ *-SFSCB Length of SFSCB
SFSCB Storage Layout
*** SFSCB - Shared File System Control Block * * +-------------------------------------------------------+ * 0 | SFSFPOOL | * +-------------------------------------------------------+ * 8 | SFSPPOOL | * +---------------------------+---------------------------+ * 10 | SFSODTAD | SFSSEQCT | * +---------------------------+---------------------------+ * 18 | SFSTOKAD | SFSTOKSQ | * +---------------------------+---------------------------+ * 20 |///////////////////////////| SFSOSECB | * +---------------------------+---------------------------+ * 28 | SFSSDE | SFSSDM | * +---------------------------+---------------------------+ * 30 |///////////////////////////| SFSARCF | * +---------------------------+---------------------------+ * 38 | SFSARCL | | * +---------------------------+ | * 40 | | * = SFSCAWAR = * | +---------------------------+ * 80 | | SFSCARET | * +---------------------------+---------------------------+ * 88 | SFSCAADT | SFSREFST | * +---------------------------+---------------------------+ * 90 | SFSREHYP | SFSUCCAD | * +------+------+-------------+---------------------------+ * 98 |:CAFLG|//////| SFSUACNT | SFSCALWM | * +------+------+-------------+---------------------------+ * A0 |///////////////////////////| SFSUCTA | * +---------------------------+---------------------------+ * A8 | SFSUCTC | | * +---------------------------+ | * B0 | | * = SFSUCTA1 = * | | * +-------------------------------------------------------+ * C8 | | * = SFSUCTA2 = * | +---------------------------+ * | | | * +---------------------------+ | * E8 | | * = SFSUCTA3 = * | | * +-------------------------------------------------------+ * 100 | | * = SFSUCTA4 = * | +---------------------------+ * | | | * +---------------------------+ | * 120 | | * = SFSUCTA5 = * | | * +-------------------------------------------------------+ * 138 | | * = SFSUCTA6 = * | +---------------------------+ * | | | * +---------------------------+ | * 158 | | * = SFSWBNL = * | | * +-------------------------------------------------------+ * 1D0 | | * = SFSWBAL = * | +---------------------------+ * 248 | | SFSWUIDC | * +---------------------------+---------------------------+ * 250 | SFSWUBAS | SFSWUSTP | * +---------------------------+---------------------------+ * 258 | SFSWUCU1 | SFSWUCU2 | * +---------------------------+---------------------------+ * 260 | | * = SFSWUSTK = * | | * +-------------------------------------------------------+ * 2B8 * *** SFSCB - Shared File System Control Block *** Overlay for SFSWUSTK in SFSCB * * +---------------------------+---------------------------+ * 260 |///////////////////////////|///////////////////////////| * +---------------------------+---------------------------+ * 268 |///////////////////////////|///////////////////////////| * +---------------------------+///////////////////////////| * 270 |///////////////////////////////////////////////////////| * =///////////////////////////////////////////////////////= * |///////////////////////////////////////////////////////| * +------+--------------------+---------------------------+ * 2B8 |:WUFLG|////////////////////| SFSRESPA | * +------+--------------------+---------------------------+ * 2C0 | SFSRESPL | SFSDNT | * +---------------------------+---------------------------+ * 2C8 | SFSFNT | SFSMNT | * +---------------------------+---------------------------+ * 2D0 | SFSCNT | SFSCRES | * +---------------------------+---------------------------+ * 2D8 | SFSCFRE | SFSCUSED | * +---------------------------+---------------------------+ * 2E0 | SFSC0NXT | | * +---------------------------+ | * | SFSC0NAM | * | +---------------------------+ * | | | * +---------------------------+ | * 2F8 | | * = SFSC0PDC = * | +---------------------------+ * 398 | | SFSC1NXT | * +---------------------------+---------------------------+ * 3A0 | SFSC1NAM | * | | * +-------------------------------------------------------+ * 3B0 | | * = SFSC1PDC = * | | * +---------------------------+---------------------------+ * 458 | SFSC2NXT | | * +---------------------------+ | * | SFSC2NAM | * | +---------------------------+ * | | | * +---------------------------+ | * 470 | | * = SFSC2PDC = * | +---------------------------+ * | | | * +---------------------------+ | * 518 | | * = SFSODT = * | +---------------------------+ * | | | * +---------------------------+ | * 610 | | * = SFSSPSCA = * | +---------------------------+ * 6D8 | |///////////////////////////| * +---------------------------+---------------------------+ * 6E0 | | * = SFSJNLNK = * | +------+ * 7D8 | |:JNLMD| * +---------------------------+--------------------+------+ * 7E0 | SFSJNLAL | SFSJNLSL | * +---------------------------+---------------------------+ * 7E8 | SFSJNLFP | * +-------------------------------------------------------+ * 7F0 | | * = SFSJNLST = * | +---------------------------+ * | | | * +---------------------------+ | * 848 | | * = SFSFPLST = * | +---------------------------+ * | | 90C * +---------------------------+ * *** Overlay for SFSWUSTK in SFSCB *** Overlay for SFSFPLST in SFSCB * * +---------------------------+ * ... 844 | | * +---------------------------+ | * 848 | | * = SFSFPCHR = * | +---------------------------+ * 908 | | SFSAVAIL | * +------+--------------------+---------------------------+ * 910 |:ASFLG|////////////////////| SFSFASTK | * +------+--------------------+ | * | | * +---------------------------+---------------------------+ * 920 | SFSWUTAP | SFSWUTFP | * +---------------------------+------+--------------------+ * 928 | SFSWUTSP |:OFLAG|////////////////////| * +---------------------------+------+--------------------+ * 930 | SFSSDF | SFSRCMAV | * +------+--------------------+---------------------------+ * 938 |:RCMFL|////////////////////|///////////////////////////| * +------+--------------------+---------------------------+ * 940 | SFSFUBPT | SFSFUBNA | * +--------------------+------+---------------------------+ * 948 | SFSF1EYE |:F1FLG| SFSF1FPT | * +--------------------+------+---------------------------+ * 950 | | * = SFSF1FLD = * | | * +--------------------+------+---------------------------+ * 978 | SFSF2EYE |:F2FLG| SFSF2FPT | * +--------------------+------+---------------------------+ * 980 | | * = SFSF2FLD = * | | * +--------------------+------+---------------------------+ * 9A8 | SFSF3EYE |:F3FLG| SFSF3FPT | * +--------------------+------+---------------------------+ * 9B0 | | * = SFSF3FLD = * | | * +---------------------------+---------------------------+ * 9D8 | SFSBFSCB | SFSFSSM | * +---------------------------+---------------------------+ * 9E0 * *** Overlay for SFSFPLST in SFSCB
SFSCB Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----SFSAFLG 0910 80
SFSARCF 0034
SFSARCHB 090C
SFSARCHD 0030
SFSARCL 0038
SFSARCM 0938 80
SFSASFLG 0910
SFSASRCM 0934
SFSATOMC 0250 00000002
SFSAVAIL 090C
SFSBFSCB 09D8
SFSCAADT 0088
SFSCACLA 0098 20
SFSCACLN 0098 40
SFSCAFLG 0098
SFSCALWM 009C
SFSCARET 0084
SFSCAWAR 003C
SFSCBSIZ 09DC 000009E0
SFSCENT0 02E0
SFSCENT1 039C
SFSCENT2 0458
SFSCFRE 02D8
SFSCNT 02D0
SFSCNTBL 02D4
SFSCOPYF 0250 00000004
SFSCRES 02D4
SFSCUSED 02DC
SFSC0NAM 02E4
SFSC0NXT 02E0
SFSC0PDC 02F4
SFSC1NAM 03A0
SFSC1NXT 039C
SFSC1PDC 03B0
SFSC2NAM 045C
SFSC2NXT 0458
SFSC2PDC 046C
SFSDIRMX 09DC 00000099
SFSDNT 02C4
SFSFASTK 0914
SFSFNT 02C8
SFSFPCHR 0844
SFSFPCNT 0844 00000019
SFSFPLEN 0844 000000C8
SFSFPLST 0844
SFSFPOOL 0000
SFSFRESH 0098 80
SFSFRSH6 0098 10
SFSFSSM 09DC
SFSFUBNA 0944
SFSFUBNP 0944 00000003
SFSFUBPT 0940
SFSFUB1 0948
SFSFUB2 0978
SFSFUB3 09A8
SFSF1EYE 0948
SFSF1FLD 0950
SFSF1FLG 094B
SFSF1FPT 094C
SFSF2EYE 0978
SFSF2FLD 0980
SFSF2FLG 097B
SFSF2FPT 097C
SFSF3EYE 09A8
SFSF3FLD 09B0
SFSF3FLG 09AB
SFSF3FPT 09AC
SFSJNLAL 07E0
SFSJNLFP 07E8
SFSJNLMD 07DF
SFSJNLNK 06E0
SFSJNLPL 06E0
SFSJNLSL 07E4
SFSJNLST 07F0
SFSMNT 02CC
SFSODT 0514
SFSODTAD 0010
SFSOFLAG 092C
SFSOSECB 0024
SFSPPOOL 0008
SFSRCMAV 0934
SFSRCMFL 0938
SFSREADO 0250 00000001
SFSRECIN 092C 80
SFSREFST 008C
SFSREHYP 0090
SFSRESPA 02BC
SFSRESPL 02C0
SFSRORES 092C 40
SFSSDE 0028
SFSSDF 0930
SFSSDM 002C
SFSSEQCT 0014
SFSSPSCA 060C
SFSSSLOG 0250 00000003
SFSTOKAD 0018
SFSTOKEN 0018
SFSTOKLN 001C 00000008
SFSTOKSQ 001C
SFSUACNT 009A
SFSUCCAD 0094
SFSUCTA 00A4
SFSUCTA1 00AC
SFSUCTA2 00C8
SFSUCTA3 00E4
SFSUCTA4 0100
SFSUCTA5 011C
SFSUCTA6 0138
SFSUCTC 00A8
SFSWBAL 01D0
SFSWBNL 0154
SFSWUBAI 0250 00000001
SFSWUBAS 0250
SFSWUCUR 0258
SFSWUCU1 0258
SFSWUCU2 025C
SFSWUFLG 02B8
SFSWUIDC 024C
SFSWUPOP 02B8 40
SFSWURES 0250 00000008
SFSWURET 02B8 80
SFSWUSTK 0260
SFSWUSTP 0254
SFSWUTAL 0928 00001000
SFSWUTAN 0928 00000400
SFSWUTAP 0920
SFSWUTFL 0928 00002A30
SFSWUTFP 0924
SFSWUTSP 0928
Last updated on 12 Aug 1999 at 11:13:08 EDT.
Copyright IBM Corporation, 1990, 1999