BPX1PCT Return and Reason Codes

Using BPX1PCT for HFS returns a non-zero return code and reason code only if the return value is -1. Table 1 contains a list of return and reason codes returned by BPX1PCT for the HFS DisplayBufferLimits, ChangeBufferLimits, DisplayGlobalStats, DisplayFSStats, and ExtendFS commands.

Table 1. BPX1PCT - Return Codes and Reason Codes
Return Code	Reason Code	Description	Command
0	0	Successful completion
EINVAL	5B360106	The HFS pfsctl service ExtendFS function was called with an invalid PCTL_EXT_UNIT parameter.	ExtendFS only

	5B360108	The HFS pfsctl ExtendFS function was called with an extend value of zero.	ExtendFS only
EFAULT	5B360102	The HFS pfsctl service was called with an unsupported command code.

	5B360103	The data area address provided for the HFS pfsctl command is zero.

	5B360107	The HFS pfsctl service ChangeBufferLimits or ExtendFS function was called by an unauthorized caller.
EMVSERR	5B360101	An error occurred during the add local recovery routine function.
ENOBUFS	5B360104	The data area length provided for the HFS pfsctl command was less than the minimum size required to complete the request.
ENOENT	5B360105	An HFS pfsctl service was called with an unmounted HFS.unted	DisplayFSStats and ExtendFS only.
ENOSPC	5B27C005	DADSM error occurred; no space available to extend the HFS data set	ExtendFS only

	>80000000	File system was in an HFS Out of Space error state and the extend amount was insufficient to meet the requirement to complete the sync shadow write. The reason code contains the 2's complement of the additional number of tracks required.	ExtendFS only
EIO	5B27C00A	DADSM error occurred; I/O error VTOC	ExtendFS only
EMVSPFSPERM	5B27xxxx	Unexpected error encountered	ExtendFS only

	5BB3xxxx	Unexpected error encountered	ChangeBufferLimits only
EMVSPARM	5B36000E	VMAX below minimum (VMAX set to minimum)	ChangeBufferLimits only

	5B36000F	FMIN exceeded VMAX (FMIN set to VMAX)	ChangeBufferLimits only

	5B360010	FMIN at maximum available (FMIN set to maximum)	ChangeBufferLimits only
	5B360014	VMAX below FMIN (VMAX set to FMIN)	ChangeBufferLimits only

Table 2 shows the GFUMPCTL structure for the DisplayBufferLimits and the ChangeBufferLimits commands:

Table 2. Structure for the DisplayBufferLimits and ChangeBufferLimits Commands (GFUMPCTL)
Offsets	Type	Length	Name	Description
0 (0)	STRUCTURE	28	PCTL_BFRLIMITS_TYPE
0 (0)	CHARACTER	1	PCTL_BL_FLGS	Flags
	1... ....	1	PCTL_BL_ACTION	`off`: display buffer limits `on`: change buffer limits
1 (1)	CHARACTER	1	PCTL_BL_LIMIT	Limits to be modified
	1... ....		PCTL_BL_VMAX	Modify VMAX request
	.1.. ....		PCTL_BL_FMIN	Modify FMIN request
2 (2)	CHARACTER	1	*	Reserved
4 (4)	SIGNED	4	PCTL_BL_VMAX_VAL	Modify VMAX value
8 (8)	SIGNED	4	PCTL_BL_FMIN_VAL	Modify FMIN value
12 (C)	CHARACTER	16	*	Reserved
28 (1C)	CHARACTER		PCTL_BL_END

Table 3 shows the GFUMPCTL structure for the DisplayGlobalStats command:

Table 3. Structure for the DisplayGlobalStats Command (GFUMPCTL)
Offsets	Type	Length	Name	Description
0 (0)	(0) STRUCTURE	200	PCTL_GLOBALSTATS_TYPE
0 (0)	CHARACTER	8	PCTL_GS_CURR_TIME	Current timestamp
8 (8)	CHARACTER	8	*	Reserved
16 (10)	SIGNED	4	PCTL_GS_TOTVIRT	Combined total virtual (in pages) in use by all buffer pools
20 (14)	SIGNED	4	PCTL_GS_TOTFIX	Combined total fixed (in pages) in use by all buffer pools
24 (18)	CHARACTER	28	PCTL_GS_BP1	Stats for buffer pool 1
24 (18)	UNSIGNED	2	PCTL_GS_BP1_BFRSIZE	Size of each buffer (in pages)
26 (1A)	UNSIGNED	2	PCTL_GS_BP1_DSCNT	Number of data spaces in pool
28 (1C)	SIGNED	4	PCTL_GS_BP1_TOTVIRT	Total virtual used by this pool
32 (20)	SIGNED	4	PCTL_GS_BP1_TOTFIX	Total fixed used by this pool
36 (24)	UNSIGNED	8	PCTL_GS_BP1_FIXD_Y	Times a buffer was already fixed prior to an I/O request
44 (2C)	UNSIGNED	8	PCTL_GS_BP1_FIXD_N	Times a buffer was not already fixed prior to an I/O request
52 (34)	CHARACTER	28	PCTL_GS_BP2	Stats for buffer pool 2
52 (34)	UNSIGNED	2	PCTL_GS_BP2_BPRSIZE	Size of each buffer (in pages)
54 (36)	UNSIGNED	2	PCTL_GS_BP2_DSCNT	Number of data spaces in pool
56 (38)	SIGNED	4	PCTL_GS_BP2_TOTVIRT	Total virtual used by this pool
60 (3C)	SIGNED	4	PCTL_GS_BP2_TOTFIX	Total fixed used by this pool
64 (40)	UNSIGNED	8	PCTL_GS_BP2_FIXD_Y	Times a buffer was already fixed prior to an I/O request
72 (48)	UNSIGNED	8	PCTL_GS_BP2_FIXD_N	Times a buffer was not already fixed prior to an I/O request
80 (50)	CHARACTER	28	PCTL_GS_BP3	Stats for buffer pool 3
80 (50)	UNSIGNED	2	PCTL_GS_BP3_BFRSIZE	Size of each buffer (in pages)
82 (52)	UNSIGNED	2	PCTL_GS_BP3_DSCNT	Number of data spaces in pool
84 (54)	SIGNED	4	PCTL_GS_BP3_TOTVIRT	Total virtual used by this pool
88 (58)	SIGNED	4	PCTL_GS_BP3_TOTFIX	Total fixed used by this pool
92 (5C)	UNSIGNED	8	PCTL_GS_BP3_FIXD_Y	Times a buffer was already fixed prior to an I/O request
100 (64)	UNSIGNED	8	PCTL_GS_BP3_FIXD_N	Times a buffer was not already fixed prior to an I/O request
108 (6C)	CHARACTER	28	PCTL_GS_BP4	Stats for buffer pool 4
108 (6C)	UNSIGNED	2	PCTL_GS_BP4_BFRSIZE	Size of each buffer (in pages)
110 (6E)	UNSIGNED	2	PCTL_GS_BP4_DSCNT	Number of data spaces in pool
112 (70)	SIGNED	4	PCTL_GS_BP4_TOTVIRT	Total virtual used by this pool
116 (74)	SIGNED	4	PCTL_GS_BP4_TOTFIX	Total fixed used by this pool
120 (78)	CHARACTER	8	PCTL-GS_BP4_FIXD_Y	Times a buffer was already fixed prior to an I/O request
128 (80)	CHARACTER	8	PCTL_GS_BP4_FIXD_N	Times a buffer was not already fixed prior to an I/O request
136 (88)	CHARACTER	8	PCTL_GS_META_Y	Times metadata in cache on a lookup
144 (90)	CHARACTER	8	PCTL_GS_META_N	Times metadata not in cache on a lookup
152 (98)	CHARACTER	8	PCTL_GS_RPN0_Y	Times RPN0 in cache on read/write
160 (A0)	CHARACTER	8	PCTL_GS_RPN0_N	Times RPN0 not in cache on read/write
168 (A8)	CHARACTER	32	*	Reserved
200 (C8)	CHARACTER		PCTL_GS_END

Table 4 contains the GFUMPCTL structure DisplayFSStats command:

Table 4. Structure for the DisplayFSStats Command (GFUMPCTL)
Offsets	Type	Length	Name	Description
0 (0)	STRUCTURE	228	PCTL_FSSTATS_TYPE
0 (0)	CHARACTER	44	PCTL_FS_NAME	File system name
44 (2C)	BITSTRING	4	PCTL_FS_FLAGS	Flags from RFS (an internal HFS control block)
44 (2C)	BITSTRING	1	PCTL_FS_RFS_MTAB_FLAGS	MTAB flags
45 (2D)	BITSTRING	1	PCTL_FS_RFS_FLAGS	RFS flags
46 (2E)	BITSTRING	1	PCTL_FS_RFS_SYNC_ERR	RFS error flags
47 (2F)	BITSTRING	1	*	Reserved
48 (30)	CHARACTER	8	PCTL_FS_CURR_TIME	Current timestamp
56 (38)	CHARACTER	8	PCTL_FS_MOUNT_TIME	Mount timestamp
64 (40)	UNSIGNED	2	PCTL_FS_SYNC	SYNC interval (in seconds)
66 (42)	CHARACTER	2	*	Reserved
68 (44)	SIGNED	4	PCTL_FS_SIZE	File system size (in pages)
72 (48)	SIGNED	4	PCTL_FS_USED	Number of pages used in FS
76 (4C)	SIGNED	4	PCTL_FS_AD_ALLOC	Number of pages allocated to AD in FS
80 (50)	UNSIGNED	8	PCTL_FS_SEQ_IO	Number of sequential I/O requests for data
88 (58)	UNSIGNED	8	PCTL_FS_RANDOM_IO	Number of random I/O requests for data
96 (60)	UNSIGNED	8	PCTL_FS_META_Y	Times metadata in cache on a lookup
104 (68)	UNSIGNED	8	PCTL_FS_META_N	Times metadata not in cache on a lookup
112 (70)	UNSIGNED	8	PCTL_FS_RPN0_Y	Times RPN0 in cache on read/write
120 (78)	UNSIGNED	8	PCTL_FS_RPN0_N	Times RPN0 NOT in cache on read/write
128 (80)	UNSIGNED	8	PCTL_FS_IX_TOPS	Number of index new tops
136 (88)	UNSIGNED	8	PCTL_FS_IX_SPLITS	Number of index splits
144 (90)	UNSIGNED	8	PCTL_FS_IX_JOINS	Number of index joins
152 (98)	UNSIGNED	8	PCTL_FS_IX_RDHIT	Number of index page read hits
160 (A0)	UNSIGNED	8	PCTL_FS_IX_RDMISS	Number of index page read misses
168 (A8)	UNSIGNED	8	PCTL_FS_IX_WRHIT	Number of index page write hits
176 (B0)	UNSIGNED	8	PCTL_FS_IX_WRMISS	Number of index page write misses
184 (B8)	UNSIGNED	4	PCTL_FS_PGS_CACHED	Number of data buffer pages cached by this file system
188 (BC)	CHARACTER	4	PCTL_FS_HFRFN	HFRFN from DMIB
192 (C0)	UNSIGNED	4	PCTL_FS_MEM_CNT	Member count from RFS
196 (C4)	UNSIGNED	4	PCTL_FS_APM_CNT	Number of available page maps
200 (C8)	CHARACTER	28	*	Reserved
228 (E4)	CHARACTER		PCTL_FS_END

Table 5 contains the GFUMPCTL structure ExtendFS command:

Table 5. Structure for the ExtendFS Command (GFUMPCTL)
Offsets	Type	Length	Name	Description
0 (0)	STRUCTURE	68	PCTL_EXTENDFS_TYPE
0 (0)	CHARACTER	44	PCTL_EXT_FSNAME	File system name
44 (2C)	CHARACTER	1	PCTL_EXT_FLGS	Flags
	1... ....		PCTL_EXT_NEW_VOL	Extend to new volume
45 (2D)	CHARACTER	1	PCTL_EXT_UNIT	Unit of amount to extend (‘M’, ‘T’ or ‘C’)
46 (2E)	CHARACTER	2	*	Reserved
48 (30)	SIGNED	4	PCTL_EXT_AMT	Amount to be extended
52 (34)	CHARACTER	16	*	Reserved
68 (44)	CHARACTER		PCTL_EXT_END

Table 6. Constants for Extend Units Supported
Type	Value	Name	Description
CHARACTER	1	EXTENDFS_UNIT_MB	Constant (‘M’, Megabytes (MB) for pctl_ext_unit
CHARACTER	1	EXTENDFS_UNIT_TRK	Constant (‘T’, Tracks) for pctl_ext_unit
CHARACTER	1	EXTENDFS_UNIT_CYL	Constant (‘C’, Cylinders) for pctl_ext_unit