ols(1) — Commands

Name

ols − list and generate statistics for files

Syntax

ols [−l] [−A] [−1] [−a] [−d] [−f] [−T trace-file] application-address::file [,application-address::file...]

Description

Each file has a set of file atttributes. File attributes are characteristics whose values identify and describe a file and record its history. The FTAM directory utility allows you to display FTAM file attributes for files by using the ols command. The basic ols command produces a minimal display containing only the file designation as it appears on the remote system. The -A option produces a full directory display, which contains information on all the supported FTAM file attributes.

Options

−l Lists the document type, owner, size in bytes, and time of last modification for each file.

The document type field indicates the file’s document type (FTAM-1, FTAM-2, FTAM-3, or NBS-9).

The next field contains ten characters. The first character indicates whether the file is a directory (d) or a regular file (-). The remaining characters are interpreted as three sets of three characters each. The first set of three characters refers to the file-access permissions for the user; the next set, for the user-group; and the last set, for all others. You will see only the permissions for the user. The other permissions and those that are unsupported will be indicated by a dash (-). The permissions are indicated as follows:

r if the file is readable.
w if the file is writable.
x if the file is executable.
- if the indicated permission is not granted.

−AGives all the information available on the remote file. This information includes the file’s permitted actions, FTAM document type, string significance, creation and revision dates, file availability, and file size.

Note that the constraint set name and abstract syntax name pair could be printed instead of the FTAM document type, the maximum string length, the string significance, and the universal class number attributes.

−1 Displays one entry per line. This is the default when output is not to a terminal.

−a Displays all entries including those beginning with a period (.).

−d Displays names of directories only, not contents. Use this option with -l to get the status of a directory.

−f Displays names in the order they exist in a directory. See dir(5) for further information. Entries beginning with a period (.) are also listed. This option is the default and overrides the -l option.

−T trace-file
Specifies that a trace file be created with the indicated file name. You must use the ositrace command to analyze this trace file.

application-address
Specifies the FTAM system on which the remote files are located.

file Specifies a remote file.

Restrictions

The ols command does not list local file attributes.