The PFS initialization structure (BPXYPFSI, referred to as the
PFSI) contains the following fields (each name is prefixed with the
characters
pfsi_):
- Field
- Description
- Supplied Fields
- ver
- The version number of this PFSI.
- ook
- An indication that this PFS is running outside the kernel.
- alone
- An indication that this PFS is the only PFS running in the address
space.
- new
- An indication that this is the first time this PFS has been initialized
in the address space.
- romntclient
- Set on to indicate that the PFS does not support simultaneous
R/O mounts from multiple systems; the LFS is responsible for making
R/O file systems available for sharing in a sysplex system.
The
default value is off. This indicates that the PFS supports sharing
of R/O file systems in a sysplex.
- rwmntsysplex
- Set on to indicate that the PFS does not support simultaneous
R/W mounts from multiple systems; the LFS is responsible for making
R/W file systems available for sharing in a sysplex system.
The
default value is off. This indicates that the PFS supports sharing
of R/W file systems in a sysplex.
- initcompecb
- The ECB that the PFS posts when its initialization is complete.
- pfsecb
- The ECB that the LFS posts when z/OS UNIX is stopped.
The PFS must be waiting on this ECB.
- restart
- The address of the restart option byte. The PFS
sets this byte any time during its processing, to control if and how
it is to be restarted if it should terminate.
- dumpptr
- The address of dump information. This information is used by the
PFS to add significant LFS areas to the dumps that are taken by the
PFS.
- pfsid
- The PFS identifier that is used with osi_sleep and osi_wakeup.
- asname
- The value of the ASNAME parameter of the FILESYSTYPE statement.
- ep
- The value of the ENTRYPOINT parameter of the FILESYSTYPE statement.
- Returned Fields
- pfsanchor
- The PFS initialization token. This token value is passed back
to the PFS on every subsequent call from the LFS as part of the token_structure,
which is the first parameter of every call. This field typically contains
the address of the PFS's main anchor block.
- vfso
- The address of the PFS's VFS operation vector table.
- vnop
- The address of the PFS's vnode operation vector table.
- srb
- An indication that SRB mode is supported.
- asyio
- An indication that asynchronous I/O is supported.
- usethreads
- An indication that the PFS is requesting support for the osi_thread
service. This field can be set only by PFSs that are running outside
the kernel.
- disableLLA
- An indication that the LFS should not provide lookup lookaside
function for this PFS. If there is not a strict one-to-one correspondence
between the spelling of a file name in a directory and the vnode-inode
pair that represents the file, the PFS should set this bit. For example,
if '/usr/dl/fl,attr=fb' and '/usr/dl/fl' represent
the same file in the /usr/d1 directory, you must disable the
LFS lookup lookaside function. If directories are remote and files
may be removed from them remotely, the LFS's LLA cache should also
be disabled.
- stayalone
- An indication that the LFS should not initialize any other PFSs
in this address space. This field can be set only by PFSs that are
running outside the kernel.
- immeddel
- An indication that the PFS supports deleting a removed file's
data when its open count becomes zero, rather than waiting for vn_inactive to
free the space.
- cpfs
- An indication that the PFS is written in C, and is requesting
that the LFS invoke it with pre-initialized C environments.
- datoffmove
- An indication that the PFS supports DATOFF move for page read
operations. For more information, see Reading from and writing to files.
- pfstype
- The type of the PFS. This identifies the PFS as a local file PFS,
a remote file PFS, or a socket PFS.
- pipebuf
- pathconf() _PC_PIPE_BUF value, if applicable
- maxcanon
- pathconf() _PC_MAX_CANON value, if applicable
- maxinput
- pathconf() _PC_MAX_INPUT value, if applicable
- chownrstd
- pathconf() _PC_CHOWN_RESTRICTED value, if applicable
- vdisable
- pathconf() _PC_VDISABLE value, if applicable.
Pathconf() values
that are not constant for all files supported by the PFS may be reported
through the vn_pathconf operation.
- compon
- The PFS's three-letter component (or module) prefix.
- compid
- The PFS's five-letter component (or product) ID.
The component
prefix and ID are used in dump titles for dumps that are taken by
the LFS when there is an abnormal end in the PFS from which it does
not recover.
- modind
- An indication that the PFS is supplying indirect addresses in
the VFS and vnode operations vector tables for the various VFS and
vnode operations routines.
- complow
- The low value for the PFS reason code high byte. For more information,
see PFS support for reason code error text.
- comphigh
- The high value for the PFS reason code high byte. For more information,
see PFS support for reason code error text.