| 5001 | MPE File Name (REC) Put: No; Verify: Yes; Release 3.0 Returns the fully qualified file name in the record format defined by filename_type. The file name, group name, and account name are each left-justified and padded with blanks.
Note that this item should only be used
for names that can be expressed using MPE-only semantics (for example, NL.PUB.SYS). Item 5036 should be used for HFS syntax or MPE syntax files that will be
represented using an HFS pathname (for example, /SYS/PUB/pxdir/pxfile). If you specify this item for an HFS syntax file, blanks and a warning are returned in
itemstatus_array. Record type: filename_type (Refer to appendix B.) |
| 5002 | UFID (REC) Put: No; Verify: Yes; Release 3.0 Returns the UFID associated with a file name in the record format defined by ufid_type. Record type: ufid_type (Refer to appendix B.) |
| 5003 | Creator Name (CA16) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the name of the user who created the file. It is assumed that the account name of the file and the creator are the same. This should be a legal MPE/iX user name that is left-justified and padded with blanks. Note that with the introduction of the hierarchical file system, the creator concept has been replaced with the concept of the file owner. The creator name item is maintained for backward compatibility, but in the future, you should use
item 5041 to obtain or modify the full file owner name (user and account). |
| 5004 | Creation Timestamp (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the number of microseconds from January 1, 1970 to the time that the file was created. Record type: longint_type (Refer to appendix B.) |
| 5005 | Last Access Timestamp (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the number of microseconds from January 1, 1970 to the time that the file was last accessed. Record type: longint_type (Refer to appendix B.) |
| 5006 | Last Modify Timestamp (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the number of microseconds from January 1, 1970 to the time that
the file was last modified. Record type: longint_type (Refer to appendix B.) |
| 5007 | File Allocation Timestamp (REC) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the number of microseconds from January 1, 1970 to the time that the file was allocated. Record type: longint_type (Refer to appendix B.) |
| 5008 | File Code (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the file code of the file. A negative number indicates that the file is privileged. |
| 5009 | Creator Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the file creator access rights. Bits and their meanings are: - Bits (0:24)
Unused - Bit (24:1)
Read - Bit (25:1)
Write - Bit (26:1)
Execute - Bit (27:1)
Append - Bit (28:1)
Lock - Bit (29:1)
Save - Bit (30:1)
Update - Bit (31:1)
Dir_read
|
| 5010 | File Lockword (CA8) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the lockword of the file. This should be a legal MPE/iX lockword, left-justified and padded with blanks. If a file does not have a lockword, blanks are returned. You cannot use this item for files outside MPE groups since files in
HFS directories cannot have lockwords. POSIX does not recognize the
concept of lockwords, and they cannot be specified using POSIX syntax. |
| 5012 | Foptions (I32) Put: No; Verify: Yes; Release 3.0 Returns the file characteristics in the form of an foptions bit mask.
The bits and their meanings are - Bits ( 0:18)
Unused - Bits (18:3)
File type - Bit (21:1)
File equations - Bit (22:1)
Labeled tape - Bit (23:1)
Carriage control - Bits (24:2)
Record type - Bits (26:3)
File designator - Bit (29:1)
ASCII/binary - Bits (30:2)
File domain
|
| 5013 | Privileged Level (I32) Put: No; Verify: Yes; Release 3.0 Returns the privileged level of the file. This should be a value from 0
to 3 where the lower the number, the higher the privileged level. |
| 5014 | Released (B) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies whether the file is released or secure. True when the file is released and false when the file is secure.
This file aspect can be changed using the RELEASE and SECURE commands if you are the file's creator. |
| 5015 | Temporary (B) Put: No; Verify: Yes; Release 3.0 Returns true if the file is temporary and false if it is permanent. |
| 5016 | Record Size (U32) Put: No; Verify: Yes; Release 3.0 The file's record size in bytes. For variable-length records,
the size of the largest record is returned. |
| 5017 | End of File (U32) Put: No; Verify: Yes; Release 3.0 Returns the current number of bytes in the file. This item should be used as an unsigned integer. The number of records
in the file can be calculated by the formula:
#of records =(EOF - (256*Number of User Labels))/Record Size
|
|
| 5018 | File limit (U32) Put: No; Verify: Yes; Release 3.0 Returns the maximum number of bytes that the file is allowed to have. This item should be used as an unsigned integer. |
| 5019 | Number of User Labels (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of user labels that have been allocated for this file. This should be a value from 0 to 254. |
| 5020 | User Labels Limit (I32) Put: No; Verify: Yes; Release 3.0 Returns the end of the user label area as a byte offset. This value can
be divided by $100 to calculate the number of user labels written. |
| 5021 | Block Size (U32) Put: No; Verify: Yes Returns the block size of the file in bytes. This should be the record
size multiplied by the blocking factor. |
| 5022 | Blocking Factor (I32) Put: No; Verify: Yes; Release 3.0 Returns the blocking factor for the file. This is the number of records
that will be placed in each block and should be a value from 1 to 255. |
| 5023 | Volume Restriction (CA34) Put: No; Verify: Yes; Release 3.0 Returns the file's volume restrictions. The last two characters indicate what the first 32 characters represent, as follows: - ' 0'
File restricted to the volume name located in elements 1..32. - ' 1'
File restricted to the volume class name located in elements 1..32. - ' 2'
File restricted to the volume set name located in elements 1..32.
|
| 5024 | Message File Open/Close Record Count (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of open/close records. This is valid for message files only. For non-message files this value is zero. |
| 5025 | Number of Users (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of users that have this file open on the system. |
| 5026 | Number of Readers (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of users that have this file open with read access. This is valid only for NM files. (Not applicable to the system libraries.) |
| 5027 | Number of Writers (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of users that have this file open with write access. This is valid only for NM files. |
| 5028 | Number of Record Pointers (I32) Put: No; Verify: Yes; Release 3.0 Returns the number of record pointers that are active for this file. This is valid only for NM files. |
| 5029 | Close Disposition (I32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the disposition to be used when the file is closed by the last user accessing it. Values and their meanings are: - 0
Null - 1
Permanent - 2
Temporary (rewind upon close) - 3
Temporary (do not rewind) - 4
Purge - 5
Permanent to temporary (native mode files only)
Equivalent to the HPFOPEN final disposition option. |
| 5030 | Virtual Address (@64) Put: No; Verify: Yes; Release 3.0 Returns the virtual address of the file. |
| 5031 | Any Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the access rights for any user. - Bits (0:24)
Unused - Bit (24:1)
Read - Bit (25:1)
Write - Bit (26:1)
Execute - Bit (27:1)
Append - Bit (28:1)
Lock - Bit (29:1)
Save - Bit (30:1)
Update - Bit (31:1)
Dir_read
|
| 5032 | Group Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the group access rights. - Bits (0:24)
Unused - Bit (24:1)
Read - Bit (25:1)
Write - Bit (26:1)
Execute - Bit (27:1)
Append - Bit (28:1)
Lock - Bit (29:1)
Save - Bit (30:1)
Update - Bit (31:1)
Dir_read
|
| 5033 | Group Librarian Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the group librarian access rights. - Bits (0:24)
Unused - Bit (24:1)
Read - Bit (25:1)
Write - Bit (26:1)
Execute - Bit (27:1)
Append - Bit (28:1)
Lock - Bit (29:1)
Save - Bit (30:1)
Update - Bit (31:1)
Dir_read
|
| 5034 | Account Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the account access rights. - Bits (0:24)
Unused - Bit (24:1)
Read - Bit (25:1)
Write - Bit (26:1)
Execute - Bit (27:1)
Append - Bit (28:1)
Lock - Bit (29:1)
Save - Bit (30:1)
Update - Bit (31:1)
Dir_read
|
| 5035 | Account Librarian Access Rights (U32) Put: Yes; Verify: Yes; Release 3.0 Returns or modifies the account librarian access rights. - Bits (0:24)
Unused - Bit (24:1)
Read - Bit (25:1)
Write - Bit (26:1)
Execute - Bit (27:1)
Append - Bit (28:1)
Lock - Bit (29:1)
Save - Bit (30:1)
Update - Bit (31:1)
Dir_read
|
| 5036 | Pathname (REC) Put: No; Verify Yes; Release 4.5 Returns the pathname in the record format defined by pathname_type.
The name is returned as an absolute pathname (for example, /SYS/PUB/NL). Record type: pathname_type |
| 5037 | Path Identifier (REC) Put: No; Verify: Yes; Release 4.5 Returns the unique path identifier associated with the specified pathname. Record type: path_identifier |
| 5038 | Running Link Count (U32) Put: No; Verify: Yes; Release 4.5 Returns the total number of links that have been performed on this file since
it was created. It does not indicate the current number of links; it is simply a running count.
Use item 5046 to get the current number of links. |
| 5039 | File type (U32) Put: No; Verify: Yes; Release 4.5 Returns the file type. Possible values are: - 0 -
ordinary - 1 -
ksam - 2 -
relative_io - 3 -
nm_ksam - 4 -
circular - 5 -
spool - 6 -
message - 7 -
resv - 8 -
cmfile - 9 -
dir_obj - 10 -
label_table - 11 -
xm_syslog - 12 -
pipe - 13 -
fifo - 14 -
symbolic link - 15 -
device link
|
| 5040 | Record type (U32) Put: No; Verify: Yes; Release 4.5 Returns the file record type. Possible values are: - 0 -
fixed - 1 -
variable - 2 -
undefined - 3 -
cm_spool - 4 -
account directory node - 5 -
user directory node - 6 -
group directory node - 7 -
fileset directory node - 8 -
temporary directory - 9 -
byte_stream - 10 -
hierarchical directory
|
| 5041 | File Owner (CA36) Put: Yes; Verify: Yes; Release 4.5 Returns or modifies the full file owner name. The name is in the format
USER.ACCOUNT and is padded with blanks. Note that this item should be used
instead of item 5003 to get the full file owner. With the Hierarchical File
System, the creator field has been replaced with the concept of a
file owner. This is because file ownership can now change through the
use of the chown function. Note that for MPE directory files existing prior to MPE/iX release 4.5,
the creator field will not be initialized. For those files, blanks will
be returned. |
| 5042 | ACD Required (B) Put: No; Verify: Yes; Release 4.5 Returns true if the file must have an ACD to establish its security policy.
If this flag is false, the file may have an ACD in effect. |
| 5043 | File_group (CA16) Put: No; Verify: Yes; Release 4.5 Returns the name of the file sharing group that the file belongs to. This
field is the text form of the 32 bit GID value from the HPGID.PUB.SYS
file. This value is inherited from the parent directory and may change through
the use of the HPSETOWNER intrinsic. |
| 5044 | State Change Timestamp (REC) Put: Yes; Verify: Yes; Release 4.5 Returns or modifies the number of microseconds from January 1, 1970 to the
time that the file label was last changed. This timestamp is a new field in
the file label which was added to meet POSIX standards. Although this item
gives you control over the timestamp, it should be updated whenever the file
label changes. If you do not specify this item or item 5045, then the
timestamp is updated automatically with the current time during any
AIFFILEGPUT operation that affects the file label. Record type: longint_type (Refer to Data Type Definition.) |
| 5045 | Update State Change Timestamp? (B) Get: No; Put: Yes; Verify: No; Release 4.5 Indicates whether or not to automatically update the state change timestamp
during any AIFFILEGPUT operation which effects the file label. The current
time will be used unless a value is specified in item 5044. If item 5044 is
specified, then the timestamp will be updated with the user specified value
regardless of whether or not this flag is specified. Defaults to true (that is, update timestamp automatically). |
| 5046 | Current Link Count (U32) Put: No; Verify: Yes; Release 4.5 Returns the current number of links (hard links) for this file. |
| 5047 | Number of extents (I32) Put: No; Verify: Yes; Release 4.5 Number of extents used by the file. |
| 5048 | Number of Sectors (I32) Put: No; Verify: Yes; Release 4.5 Number of sectors used by a file. |
| 5051 | Don't Follow Symbolic Link (B) Put: No; Verify: Yes; Release 5.0 This item is used as an option to determine whether the information returned
by AIFFILEGGET is about the symbolic link or the resolved link (resolution
of the symbolic link).
The default is to resolve the symbolic link.
This is only valid when either a pathname or MPE file name is passed to
AIFFILEGGET.
For pathnames, true means AIFFILEGGET does not resolve the last component
of a pathname if it is a symbolic link. For pathnames, false means the full path
is resolved. To locate symbolic links, use 14 the symbolic link file type (of item 5039)
with AIFSYSWIDEGET (The callers can control the information returned by
either setting the passed value to true or false). |
