Purpose

The pfsctl (BPX1PCT) application programming interface is used to send requests to a physical file system. It is documented in z/OS UNIX System Services Programming: Assembler Callable Services Reference. zFS is a physical file system and supports several (zFS-specific) pfsctl functions, which are documented in this section.

Parameters

File_system_type

An eight-character field. In the case of zFS, it contains the characters ZFS, followed by five blanks.

Command

An integer. There are four major ZFS commands:

• ZFSCALL_FILESYS (0x40000004)
• ZFSCALL_AGGR (0x40000005)
• ZFSCALL_CONFIG (0x40000006)
• ZFSCALL_STATS (0x40000007)

Each of these commands has a set of subcommands.

Argument_Length

An integer that contains the length of the argument.

Argument

A structure that has the pfsctl parameters followed by the subcommand parameters. The definitions of any structures that have padding bytes added by the compiler, have the padding bytes explicitly declared in the examples.

The following list shows the general format of the Argument for all subcommands, where n depends on the particular subcommand:

Subcommand operation code     int
Parameter0                    int
Parameter1                    int
Parameter2                    int
Parameter3                    int
Parameter4                    int
Parameter5                    int
Parameter6                    int
Buffer[n]                     char[n]                        

Return_value

An integer that contains 0 if the request is successful or -1 if it is not successful.

Return_Code

An integer in which the return code is stored. See z/OS UNIX System Services Messages and Codes for these codes.

Reason_Code

An integer that stores the reason code. If this code is of the form 0xEFnnxxxx, see z/OS Distributed File Service Messages and Codes. Otherwise, see z/OS UNIX System Services Messages and Codes.

Usage notes

There are four major commands, which are summarized in Table 1 and described in detail in the following sections. The zFS pfsctl APIs will work across sysplex members. That is, zFS pfsctl APIs can query and set information on zFS aggregates owned by the current system; they can also access and set file system information from other systems in the sysplex.

The z/OS® UNIX pfsctl (command X'C000000B') can also retrieve zFS reason code text. For more information, see the description of the PC#ErrorText pfsctl command in the usage notes for the BPX1PCT service in z/OS UNIX System Services Programming: Assembler Callable Services Reference.