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

Prolog  

Control Block Contents  

SFSCB DSECT

Storage Layout  

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


This information is based on VM/ESA 2.4.0.
Last updated on 12 Aug 1999 at 11:13:08 EDT.
Copyright IBM Corporation, 1990, 1999