USS Files attributes

The UNIX System Services 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 thefile group owner. Valid value is a positive integer in the range 0 through 2147483647.

Group The group name of the file group owner. Valid value consists of 1 to 8 alphanumeric characters and follows the rules for z/OS userid. A value of ???????? indicates that the group name cannot be resolved from the GID.

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.

Owner The user name of the file owner. Valid value consists of 1 to 8 alphanumeric characters and follows the rules for z/OS userid. A value of ???????? indicates that the user name cannot be resolved from the UID.

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 already listed

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.
indicates the sticky bit is on.
T
indicates the sticky bit is on but the execute bit is turned off.

Size An alias for SizeLo.

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 The numeric user ID of the file owner. Valid value is a positive integer in the range 0 through 2147483647.