UTLTOOLS TYPE
Displays the contents of a file or group of files on the current
output device.
Format
UTLTOOLS TYPE filespec[,...]
Parameter
filespec[,...]
Specifies the name of an existing file to be displayed. The
asterisk (
*
) and the percent sign (%) wildcard characters
are allowed. If you do not specify the device or directory,
the UTLTOOLS TYPE command uses your current default
device and directory.
Description
This command is similar to the DCL TYPE command with
the addition of some extra qualifiers.
The command is the equivalent of the UTLTOOLS
COPY/SEQUENTIAL command, which forces appropri-
ate conversion to sequential format. This has the useful
feature that using the UTLTOOLS TYPE command on a
GZIPped file (i.e. one that has a file type ending in GZ),
displays the decompressed contents of the file.
Qualifiers
/BACKUP
Modifies the time value specified with the /BEFORE or
/SINCE qualifier. /BACKUP selects files according to the
dates of their most recent backups. This qualifier is incom-
patible with the other qualifiers that also allow you to select
files according to time attributes: /CREATED, /EXPIRED and
/MODIFIED. If you specify none of these four time qualifiers,
the default is /CREATED.
/BEFORE[=time]
Selects only those files dated prior to the specified time. You
can specify time as an absolute time, as a combination of ab-
solute and delta times, or as one of the following keywords:
TODAY (default), TOMORROW, or YESTERDAY. Specify
one of the following qualifiers with /BEFORE to indicate the
time attribute to be used as the basis for selection: /BACKUP,
/CREATED (default), /EXPIRED or /MODIFIED.
See the OpenVMS DCL Concepts Manual for complete
information on specifying time values.
/BY_OWNER[=uic]
Selects only those files whose owner user identification code
(UIC) matches the specified owner UIC. The default UIC is
that of the current process.
Specify the UIC using standard UIC format as described in
the OpenVMS DCL Concepts Manual.
/CONFIRM
/NOCONFIRM (default)
Controls whether a request is issued before each type oper-
ation to confirm that the operation should be performed on
that file. The following responses are valid:
YES NO QUIT
TRUE FALSE
Ctrl/Z
1 0 ALL
Return
You can use any combination of uppercase and lowercase
letters for word responses. Word responses can be abbrevi-
ated to one or more letters (for example, T, TR, or TRU for
TRUE), but these abbreviations must be unique. Affirmative
answers are YES, TRUE, and 1. Negative answers include:
NO, FALSE, 0, and pressing the Return key. Entering QUIT
or pressing Ctrl/Z indicates that you want to stop processing
the command at that point. When you respond by enter-
ing ALL, the command continues to process, but no further
prompts are given. If you type a response other than one of
those in the list, DCL issues an error message and redisplays
the prompt.
/CREATED
Modifies the time value specified with the /BEFORE or
/SINCE qualifier. /CREATED selects files based on their
dates of creation. This qualifier is incompatible with the
other qualifiers that also allow you to select files according to
time attributes: /BACKUP, /EXPIRED and /MODIFIED. If
you specify none of these four time qualifiers, the default is
/CREATED.
/EXCLUDE=(file-spec[,...])
Excludes the specified files from the type operation. You
can include a directory but not a device in the file specifica-
tion. Wildcard characters are allowed in the file specification.
However, you cannot use relative version numbers to exclude
a specific version. If you provide only one file specification,
you can omit the parentheses.
/EXPIRED
Modifies the time value specified with the /BEFORE or
/SINCE qualifier. /EXPIRED selects files according to their
expiration dates. (The expiration date is set with the SET
SECURITY/EXPIRED command.) The /EXPIRED quali-
fier is incompatible with the other qualifiers that also allow
you to select files according to time attributes: /BACKUP,
/CREATED and /MODIFIED. If you specify none of these
four time qualifiers, the default is /CREATED.
/LOG[=(option[,...]) (default)
/NOLOG
Outputs messages to the output file depending upon the
option(s) specified.
The following log options are available:
/MODIFIED
Modifies the time value specified with the /BEFORE or
/SINCE qualifier. /MODIFIED selects files according to
the dates on which they were last modified. This quali-
fier is incompatible with the other qualifiers that also allow
you to select files according to time attributes: /BACKUP,
/CREATED and /EXPIRED. If you specify none of these four
time modifiers, the default is /CREATED.
/OUTPUT[=output-file-spec]
/NOOUTPUT
Specifies the output file specification for the command.
By default, /OUTPUT=SYS$OUTPUT is assumed. The
/NOOUTPUT qualifier means that no output will be pro-
duced by the command.
/SELECT=(keyword[,...])
Allows you to select files based on a number of criteria.
Choose one of the following keywords:
ACL
NOACL
Selects files that have an asso-
ciated ACL or files that do not
(NOACL keyword).
ATTRIBUTES=(option[,...]) Selects files which have partic-
ular attributes. The following
options are supported:
DIRECT
INDEXED
RELATIVE
SEQUENTIAL
RFM=type Selects
files which
have the
specified
record
format.
Valid
record
formats
include:
STREAM
STREAMCR
STREAMLF
UNDEFINED
VARIABLE
VFC
[NO]NODE
[NO]DEVICE
[NO]DIRECTORY
[NO]NAME
[NO]TYPE
[NO]VERSION
/SELECT=FILE qualifier can-
not be used with the /FULL
qualifier.
ONLINE
NOONLINE
Selects files that are online or
shelved.
PRESHELVED
NOPRESHELVED
Selects files that are preshelved
or not preshelved.
SHELVABLE
NOSHELVABLE
Selects files that are shelvable
or not shelvable.
SIZE=(option[,...]) Selects files according to their
size. Possible options are:
Selects
files whose
block
size falls
within the
specified
MINIMUM
and
MAXIMUM
range.
/SINCE=[time]
Selects only those files dated after the specified time. You
can specify time as an absolute time, a combination of ab-
solute and delta times, or as one of the following keywords:
TODAY (default), TOMORROW, or YESTERDAY. Specify
one of the following qualifiers with /BEFORE to indicate the
time attribute to be used as the basis for selection: /BACKUP,
/CREATED (default), /EXPIRED or /MODIFIED.
See the OpenVMS DCL Concepts Manual for complete
information on specifying time values.