The USS File Information attributes provide file, path, and time information for the files in your monitored systems.
Access Defines the access permissions associated with the file. Valid value is a positive integer that has a 3-digit octal number. Access is the numeric form of the Permissions attribute. From left to right, the digits have the following meanings:
1st |
Set user ID of the file upon execution |
2nd |
Permissions for the file owner |
3rd |
Permissions for the group |
4th |
Permissions for other users |
Blocks The number of blocks of size Blocksize used to store the data for the file. Valid value is a positive integer in the range 0 through 2147483647, and includes the use of the *AVG, *MAX, *MIN, or *SUM functions.
Blocksize The size of a physical block of data in bytes. Valid value is a positive integer in the range 0 through 2147483647, and includes the use of the *AVG, *MAX, *MIN, or *SUM functions.
Creation Time The date and time the directory or file was created. Valid value is a timestamp in the form mm/dd/yy hh:mm:ss.
Extended Attributes The file's extended attributes. Each character position represents one of the extended attributes as follows:
a |
In the first position, indicates that the program runs as APF-authorized if linked with AC-=1. |
p |
In the second position, indicates the program is “program-controlled”. |
s |
In the third position, indicates the program runs in a shared address space. |
- |
A dash in any of these positions indicates that the attribute is not set. |
Valid value is an 8-byte character string, of which only the first three positions are used.
File The name of the file or directory. Use file names to identify a regular file, directory, special character file, pipe, link, symbolic link, or socket. Valid value is a string of 1 through 255 characters; the string may not include the slash (/) or null characters.
GID The numeric group ID of the owner of the file. Valid value is a positive integer in the range 0 through 2147483647.
Group The logical group to which the owner of the file belongs. Valid value consists of up to 8 alphanumeric characters and follows the rules for z/OS userid.
ORIGINNODE The monitored z/OS operating system on which UNIX System Services is hosted. Valid value is a character string with a maximum length of 32 bytes.
Last-Accessed Time The date and time the file was last accessed for any purpose by any user or process. Valid value is a timestamp in the form mm/dd/yy hh:mm:ss.
Last-Changed Time The date and time the file was last changed by any user or process. Valid value is a timestamp in the form mm/dd/yy hh:mm:ss.
Links The number of files that are linked to the same data. Use links information to understand how many references are made to the same file data. In order to remove the data pointed to by a file, all links to the file must be deleted as well. Valid value is a positive integer in the range 0 through 2147483647, and includes the use of the *AVG, *MAX, *MIN, or *SUM functions.
Owner The user name or number (if the name is unknown) of the userid that created or has been given ownership of the file. Valid value consists of up to 8 alphanumeric characters and follows the rules for z/OS userid.
Path Specifies the file(s) of directory type that are selected to access a file. Use paths to organize files to more easily find information; for example, by project, type, purpose, or access permission. Valid value is a sequence of directory files, separated by the slash (/), pointing to a set of files. The length of the path is limited to 1024 characters including the slash character. An example path is /u/IBM/Candle/OE/src
Permissions Defines the permissions that are set for a given user or for a given file. This is a 9-character field. Permissions is the character form of the Access attribute.
To analyze permissions for a file, divide the 9 characters that comprise this attribute into three sets of 3. From left to right, these sets show permissions for:
rwx |
the owner of the file |
rwx |
the owner's group |
rwx |
persons other than those above (others) |
For files:
r |
the file can be read |
w |
the file can be written to |
x |
the file can be executed |
blank |
the corresponding permission is not granted |
For directories:
r |
the directory can be read |
w |
entries in the directory can be created, moved, copied, or removed |
x |
the directory can be searched |
blank |
the corresponding permission is not granted |
Note: for both files and directories, the following characters can appear only in the execution permission (x) position:
s |
In the owner permissions section indicates that the set-userid bit is on. In the group permissions section indicates that the set group ID bit is on. |
S |
provides the same indication as s, but the execute bit is turned off. |
t |
indicates the sticky bit is on. |
T |
indicates the sticky bit is on but the execute bit is turned off. |
SizeHi For files greater than 4 gigabytes, the value that, when multiplied by 4GB and added to the value in the Size field, represents the size of the file. Valid value is a positive integer in the range 0 through 2147483647, and includes the use of the *AVG, *MAX, *MIN, or *SUM functions.
SizeLo The value contained in the first 32 bits of the 64-bit value z/OS UNIX System Services uses to contain the file size. This value will represent the true file size for any but exceptionally large files. Valid value is a positive integer in the range 0 through 2147483647, and includes the use of the *AVG, *MAX, *MIN, or *SUM functions.
Type The type of file. A file can be one of the following types:
Dir |
Directory File |
Char |
Character Special File |
File |
Regular File |
Pipe |
Named Pipe (FIFO) File |
Link |
Symbolic Link |
Block |
Reserved for Block |
Socket |
Socket File |
UID Represents the numeric form of the userid that created or has been given ownership of the file. Valid value is a positive integer in the range 0 through 2147483647.