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. A valid value is an 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. A valid value is an integer.

Blocksize The size of a physical block of data in bytes. A valid value is an integer.

Creation Time The date and time the directory or file was created. This time is displayed in the following format:

mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Where:

This time is stored as a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

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.
A valid value is a string of up to 8 characters, 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. A valid value is a string of up to 256 characters; the string may not include the slash (/) or null characters.

GID The numeric group ID of the owner of the file. A valid value is an integer.

Group The logical group to which the owner of the file belongs. A valid value is a string of up to 8 characters and follows the rules for z/OS userid.

Last Accessed Time The date and time the file was last accessed for any purpose by any user or process. This time is displayed in the following format:

mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Where:

This time is stored as a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

Last Changed Time The date and time the file was last changed by any user or process. This time is displayed in the following format:

mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Where:

This time is stored as a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

ORIGINNODE The z/OS operating system in your enterprise that an OMEGAMON for z/OS agent is monitoring. A valid value is a string of up to 32 characters.

Owner The user name or number (if the name is unknown) of the userid that created or has been given ownership of the file. A valid value is a string of up to 8 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. The 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 A valid value is a string of up to 1024 characters.

Permissions Defines the permissions that are set for a given user or for a given file. This is the character form of the Access attribute. To analyze permissions for a file, divide the 9 characters 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.
A valid value is a string of up to 9 characters.

Size An alias for SizeLo. This is the true file size for any but exceptionally large files. A valid value is an integer.

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. A valid value is an integer.

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 is the true file size for any but exceptionally large files. A valid value is an integer.

Type The type of file. A valid value is an integer. Values appear on the workspace as follows:

UID The numeric form of the userid that created or has been given ownership of the file. A valid value is an integer.