DEVTOOLS ANALYSE/WEB_SITE
Analyse a web site in order to identify missing files and/or
links.
Format
DEVTOOLS ANALYSE/WEB_SITE index-file
Parameters
index-file
Specifies the file which forms the root index for the web site
i.e the file which a web server would serve by default if only
the host is supplied as the URL.
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 analyse op-
eration 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 analyse 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.
/IGNORE=(option[,...])
Specifies which types of URL to ignore when analysing the
web site.
Option Usage
/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.
/RELATIVE
/NORELATIVE (Default)
Specifies whether the internal links should be relative or
absolute.
By default, /NORELATIVE is assumed which implies that
links should be absolute.
/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.
Transfers control from your current process (which then
hibernates) to the specified process.
The DEVTOOLS ATTACH and DEVTOOLS SPAWN com-
mands cannot be used if your terminal has an associated
mailbox.
Note that this command is only available for users with DCL
access.
Parameters
process-name
Specifies the name of a parent process or spawned subpro-
cess to which control passes. The process must already exist,
be part of your current job, and share the same input stream
as your current process. However, the process cannot be your
current process or a subprocess created with the /NOWAIT
qualifier.
Process names can contain from 1 to 15 alphanumeric char-
acters. If a connection to the specified process cannot be
made, an error message is displayed.
Exactly one of the process-name parameter or /IDENTIFICATION
or /PARENT qualifiers must be specified. No combinations
are allowed.
Qualifiers
/IDENTIFICATION=pid
Specifies the process identification (PID) of the process to
which terminal control will be transferred. Leading zeros can
be omitted.
Exactly one of the process-name parameter or /IDENTIFICATION
or /PARENT qualifiers must be specified. No combinations
are allowed.
/PARENT
Indicates that you want to attach to the parent process of
your current process. If you did not access the DEVTOOLS
utility by using the SPAWN command, an error message is
displayed.
Exactly one of the process-name parameter or /IDENTIFICATION
or /PARENT qualifiers must be specified. No combinations
are allowed.
Examples
1.
$ DEVTOOLS ATTACH JONES_2
The ATTACH command transfers the terminal's control
to the subprocess JONES_2.
2.
DEVTOOLS> ATTACH/IDENTIFICATION=30019
The ATTACH command switches control from the cur-
rent process to a process having the PID 30019. Notice
that because the /IDENTIFICATION qualifier is specified,
the process-name parameter is omitted.