|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SFSCB
Control Block Contents
SFSCB DSECT
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 28 SFSUCTA1 UCT anchor block
00C8 200 Bitstring 28 SFSUCTA2 UCT anchor block
00E4 228 Bitstring 28 SFSUCTA3 UCT anchor block
0100 256 Bitstring 28 SFSUCTA4 UCT anchor block
011C 284 Bitstring 28 SFSUCTA5 UCT anchor block
0138 312 Bitstring 28 SFSUCTA6 UCT anchor block
Logical block processing fields
0154 340 Bitstring 124 SFSWBNL Logical block number list
01D0 464 Bitstring 124 SFSWBAL 4K buffer address list
Work unit processing
024C 588 Address 4 SFSWUIDC Initial counter value
0250 592 Address 4 SFSWUBAS Base work unit
.... ...1 SFSWUBAI 1 Initial base work unit ID value
.... 1... SFSWURES 8 Number of reserved workunit IDs
.... ...1 SFSREADO 1 Read/Only ID
.... ..1. SFSATOMC 2 Atomic write ID
.... ..11 SFSSSLOG 3 Session services logging ID
.... .1.. 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 168 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 168 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 168 SFSC2PDC Make room for PDCB
SFSODT
0514 1300 Bitstring 248 SFSODT ODT for general usage
SPSCA
060C 1548 Bitstring 208 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 (200) Initialize array to zeros
...1 1..1 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 12 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.
.... ..11 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 40 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 40 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 40 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
Symbol Dspl Value -------------- ---- ----- SFSAFLG 0910 80 SFSARCF 0034 SFSARCHB 090C SFSARCHD 0030 SFSARCL 0038 SFSARCM 0938 80 SFSASFLG 0910 SFSASRCM 0934 SFSATOMC 0250 02 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 04 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 19 SFSFPLEN 0844 000000C8 SFSFPLST 0844 SFSFPOOL 0000 SFSFRESH 0098 80 SFSFRSH6 0098 10 SFSFSSM 09DC SFSFUBNA 0944 SFSFUBNP 0944 03 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 01 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 03 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 01 SFSWUBAS 0250 SFSWUCUR 0258 SFSWUCU1 0258 SFSWUCU2 025C SFSWUFLG 02B8 SFSWUIDC 024C SFSWUPOP 02B8 40 SFSWURES 0250 08 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 1 May 2002 at 14:04:26 EDT.
Copyright IBM Corporation, 1990, 2002