File Information Attributes

The File Information attributes provide file, path, and time information for the files in your monitored systems. The File Information group contains these attributes.


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:

Position

Meaning

1st

Set userid of the file upon execution

2nd

Permissions for the file owner

3rd

Permissions for the group

4th

Permissions for other users

See also: permissions

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 MVS userid.

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 MVS 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.

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 OS/390 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.