| 1/CA | File name (8 bytes):
The file name component for the file referenced in
formaldesig is returned as the value. If the file name is
not expressible using MPE-only semantics, a file system error code (391) is
returned in the associated itemerror. |
| 2/CA | Group name (8 bytes):
The group name component for the file referenced in
formaldesig is returned as the value. If the group name is
not expressible using MPE-only semantics, a file system error code (391) is
returned in the associated itemerror. |
| 3/CA | Account name (8 bytes):
The account name component for the file referenced in
formaldesig is returned as the value. If the account name
is not expressible using MPE-only semantics, a file system error code (391)
is returned in the associated itemerror. |
| 4/CA | File creator name (8 bytes):
An unqualified form of the file owner's name is returned as the value. The
file owner is not necessarily the file's creator.
A symbolic zero (ASCII 48 in decimal) is returned as the file owner for
root directories, MPE accounts, and MPE groups created prior to release 4.5.
If the file is not located in the account where the file owner is a member,
a blank file owner name is returned. Use itemnum=43 to
obtain the full file owner name. |
| 5/U32 | Security matrix for access:
Returns the file's security matrix. This value does not indicate the actual
security enforced for a file, since group and account security masks can
also restrict access. This field is ignored if an ACD is active on a file. |
| 6/U16 | File creation date:
The date in CALENDAR intrinsic format. Either creator (C) or
manager (AM if file is within account, otherwise SM) access required.
Zero is returned as the creation date for root directories, MPE accounts,
and MPE groups created prior to release 4.5. |
| 7/U16 | Last access date:
The date in CALENDAR intrinsic format. May not be up-to-date when
the file is open.
Zero is returned as the last access date for root directories, MPE accounts,
and MPE groups created prior to release 4.5. |
| 8/U16 | Last modification date:
The date in CALENDAR intrinsic format. May not be up-to-date when
the file is open.
Zero is returned as the modification date for root directories, MPE
accounts, and MPE groups created prior to release 4.5. |
| 9/I16 | File code of disk file |
| 10/U16 | Number of user
labels written:
May not be up-to-date when the file is open. |
| 11/U16 | Number of user
labels available:
May not be up-to-date when the file is open. |
| 12/I32 | Total number of
logical records possible in the file:
Equivalent to the file limit measured in logical records. |
| 13/U16 | File options:
The record format extension bit is returned as the foption (1:1) bit. Byte
stream record format is represented as a record format extension of one
with a variable record format (foption (8:2) bits equal to 01).
Directories, symbolic links, device links, pipes and FIFO's cannot be
represented by foption. If the object referenced by
filenum is is an object, MPE error 399 is returned in the
associated itemerror.
Refer to the foption figure. |
| 14/I16 | Record size:
Maintained for compatibility with MPE V/E-based systems. (If a zero is
returned, use itemnum 30 instead.) |
| 15/I16 | Block size:
Maintained for compatibility with MPE V/E-based systems. (If a zero is
returned, use itemnum 31 instead.) |
| 16/I16 | Maximum number of
extents:
Maintained for compatibility with MPE V/E-based systems. (If a zero is
returned, use itemnum 32 instead.) |
| 17/I16 | Last extent size:
Indicates sectors. May not be up-to-date when the file is open. |
| 18/I16 | Extent size:
Indicates sectors. (If a zero is returned, use itemnum 32
instead.) |
| 19/U32 | Number of logical
records in file:
Equivalent to EOF. May not be up-to-date when the file is open. |
| 20/U32 | File allocation time:
The time when file was last restored (in CLOCK intrinsic format).
Zero is returned as the file allocation time for root directories, MPE
accounts, and MPE groups created prior to release 4.5. |
| 21/U16 | File allocation date:
The date when the file was last restored (in CALENDAR intrinsic format).
Zero is returned as the file allocation date for root directories, MPE
accounts, and MPE groups created prior to release 4.5. |
| 22/I32 | Number of
open/close records:
MSG files only. May not be up-to-date when the file is open. |
| 23/CA | Device name (8 bytes) |
| 24/U32 | Last modification time:
The time when the file was last modified (in CLOCK intrinsic
format). May not be up-to-date when the file is open. |
| 25/CA | First user label
(user label 0) (256 bytes):
May not be up-to-date when the file is open. For all but PM files, Manager
capabilitiy (AM if file is within account, otherwise SM) or read/write
(R/W) access required. For PM files, Manager capability is required;
otherwise, FLABELINFO fails with FSERR93. |
| 27/REC | Unique file
identifier (UFID) (20 bytes) |
| 28/U32 | Total number of
bytes allowed in file:
Equivalent to the file limit measured in bytes. May not be up-to-date when
the file is open. If the file limit of the file is larger than 4gb, this
item will return FSERR 311. Item number 62 returns the file limit of the
file in bytes, in a 64-bit value which can safely be used for all files. |
| 29/U32 | Start of file offset:
Indicates the byte offset where user data starts. |
| 30/U32 | Record size (indicates bytes |
| 31/U32 | Block size (indicates bytes) |
| 32/U32 | Extent size (indicates bytes) |
| 33/CA | File lockword (8 bytes):
Returned if you are the file creator, account manager, or system
manager. |
| 34/CA | Volume restriction (34 bytes):
The last two characters indicate the type of restriction, as follows:
| 0 | File is placed on the specified volume at creation |
| 1 | File can be placed on any volume containing the specified
class at creation |
| 2 | File can be placed on any volume within the specified
volume set at creation (Default) |
|
| 35/CA | Volume set names (32 bytes)
No restrictions. |
| 36/U32 | Transaction
management log set id (4 bytes)
No restrictions. |
| 37/U16 | Logical device number |
| 38/REC | Terminated
HFS-syntax system absolute pathname:
Upon input, the first four bytes are interpreted as a 32-bit unsigned
integer specifying the maximum available buffer size in bytes. This maximum
available buffer size does not include the four bytes used to represent
this size. Upon output, the first four bytes represent the pathname length
excluding the null terminator as a 32-bit unsigned integer. The pathname is
returned in bytes following the pathname length. Bytes beyond the pathname
terminator are undefined. If the maximum available buffer size is incorrect
upon input, variables allocated near the buffer can be overwritten or a
bounds violation could occur. A zero pathname length is returned for
unnamed new files and when an error occurs. Zero is the minimum buffer
length upon input for this itemnum.
Format of the buffer on input:
byte #1 #2 #3 #4 | #1 ... #N
+----+----+----+----+----+ ... +----+
| maximum | |
| length = N | |
+----+----+----+----+----+ ... +----+
Format of the buffer on output:
byte #1 #2 #3 #4 | #1 ... #L ... #N
+----+----+----+----+----+ ... +----+ ... +----+
| length = | / | | \0 | | |
| (L - 1) | | | | | |
+----+----+----+----+----+ ... +----+ ... +----+
|
| 39/U32 | The current number
of hard links to the file |
| 40/I32 | Time of last file
access (clock format):
The bit assignments are:
bits 0-7 = hours
bits 8-15 = minutes
bits 16-23 = seconds
bits 24-31 = tenths of seconds
|
| 41/I32 | Time of last file
status change (clock format):
The bit assignments are:
bits 0-7 = hours
bits 8-15 = minutes
bits 16-23 = seconds
bits 24-31 = tenths of seconds
|
| 42/U16 | Date of the last
file status change (calendar format):
The bit assignments are:
bits 0-7 = years since 1900
bits 8-15 = day of the year
|
| 43/CA | File owner (32 bytes):
The full file owner name. Unused characters are filled with blanks. A
symbolic zero (ASCII 48 in decimal) is returned as the file owner for root
directories, accounts, and MPE groups created prior to release 4.5. |
| 44/I32 | File owner identifier:
The file owner identifier (UID). Zero is returned as the file owner ID for
root directories, MPE accounts, and MPE groups created prior to release 4.5. |
| 45/CA | File group (32 bytes):
The file group name. Unused characters are filled with blanks. A symbolic
zero (ASCII 48 in decimal) is returned as the group for root directories
where GIDs have not been explicitly assigned. |
| 46/I32 | File group identifier:
The file group identifier (GID). Zero is returned as the group ID for root
directories where GIDs have not been explicitly assigned. |
| 47/U32 | File type:
Following are valid file types that can be returned:
0 = Ordinary file
1 = KSAM/3000
2 = RIO
3 = KSAM XL
4 = CIR
5 = Native Mode Spool File
6 = MSG
7 = KASM64
8 = N/A
9 = Directory
10-11= N/A
12 = Pipe
13 = FIFO
14 = Symbolic Link
15 = Device Link
16 = TTY Device link
17 = RAID Device link
|
| 48/U32 | Record type:
Following are valid record types that can be returned:
0 = fixed
1 = variable
2 = undefined
3 = spool block
4 = root directory
5 = N/A
6 = account directory
7 = group directory
8 = N/A
9 = byte stream
10 = hierarchical directory
|
| 49/I64 | Current file size (in bytes):
The value returned represents the current position of the end-of-file (EOF)
and may not reflect the number of bytes actually occupied by the file on
disk if the file is sparsely allocated. |
| 50/I32 | KSAM XL and KSAM64 File Version:
This item returns a value indicating the version number of a KSAM XL or
KSAM64 file. A value of 1 indicates an original type KSAM XL file. A value
of 2 indicates the next generation KSAM XL file. A value of zero is
returned if the file is not a KSAM XL file. A value of 4 indicates a KSAM64
file. |
| 51/I32 | KSAM XL/64 Parameters:
This item returns the ksamparam for KSAM XL/64 files, which
is an array that specifies the characteristics for up to 16 keys for the
file. |
| 52/I32 | MPE/iX Device Type:
This item returns the following values for the following types of devices:
0=Disk device
1=Tape device
2=Terminal device
3=Printer device
4=Remote device
5=Ports device
6=Reserved
7=Streams device
8=Sockets device
|
| 53/I16 | Secure/Release:
This item returns a value indicating whether the file is currently secured
or released. A value of 1 indicates that the file is secured. A value of
zero indicates that the file is released. |
| 54/I32 | Setuid flag
This item returns a value indicating whether or not the setuid flag is on for
the specified file. When the setuid flag is on for a program file (the value is
1), the program will execute under the identity of the file's owner rather than
assuming the identity of the process that invoked the program. A value of zero
indicates the flag is off. |
| 55/I32 | Setgid flag
This item returns a value indicating whether or not the setgid flag is on
for the specified file. When the setgid flag is on for a program file (the
value is 1), the program will execute with the GID membership of the file
rather than assuming the GID membership of the invoking process. A value of
zero indicates that the flag is off. |
| 56/I32 | File compressed flag
This value indicates whether or not the data in the specified file is
compressed or not.
| 0 | data is not compressed |
| 1 | data is compressed |
|
| 57/I32 | File migrated flag
This value indicates wheter or not the data in the specidfied file has been
migrated off of disk.
| 0 | data has not been migrated |
| 1 | data has been migrated |
|
| 58/I32 | Number of
sectors allocated to file (32)
This value returns the number of 256 byte disk sectors that are currently
allocated to this file. Note that this value is limited to returning valid
data for files 512MB and less. To safely get this information for all file
sizes, use item 63 , which returns the same value in a 64-bit
integer. |
| 59/I32 | Number of extents in the file
This value returns the number of extents (contiguously allocated chunks of
disk space) that are allocated to this file. |
| 60/I32 | File create time
The time when the file was created (in CLOCK intrinsic format). |
| 61/I32 | Number of Accessors
Returns the number of times the file has been opened at the moment of the
call. Note that additional opens or closes may occur immediately after this
value is computed., rendering the value stale. |
| 62/I64 | 64-bit file limit in bytes
This item is identical to item 28, except that the file size is returned in
a 64-bit integer which can safely be used for files of all sizes. |
| 63/I64 | 64-bit
number of sectors allocated to file
This item is identical to item 58, except that the value is returned in a
64-bit integer making it safe for use with files of all sizes. |
| 64/I32 | Large file flag
This flag indicates whether or not the specified file's file limit is large
(greater than 4GB- 64KB or 4,294,901,760 bytes) Note that this applies to
the file limit or potential capacity of the file only, and not to the
actural amount of disk space allocated to the file.
| 0 | file is not large |
| 1 | file is large |
|
Complete PDF