CDD/Plus RPCSWLUP LIST — VMS CDD+_4.1A
Lists information selected by command qualifiers.
Format:
LIST EVENTS [/qualifiers]
The LIST EVENTS command lets you select the events you want to see listed
in a report of logged errors. You must have RMS access privileges to the
log file.
Additional information available:
Qualifiers
Additional information available:
/BEFORE/EVENT_CODE/FACILITY/IMAGE/INPUT/OUTPUT
/PRINT/PROCESS_NAME/SEVERITY/SINCE/USER
/BEFORE
Lets you set limits on the time period during which listed events
occurred. This qualifier and the /SINCE qualifier let you select
a time range. You need not use the qualifiers together. The format
for time is (dd-mmm-yyyy[:][hh:mm]). You can omit any of the trailing
fields.
Format:
/BEFORE=(dd-mmm-yyyy[:][hh:mm])
When specifying the date and time, observe the following rules:
o The date defaults to the current date.
o The time defaults to 00:00:00.00 for the specified date.
o If you specify any part of the date, you must specify the full
date. You need not specify a time, in which case the time defaults
to 00:00:00.00.
/EVENT_CODE
Selects events by return status code.
Format:
/EVENT_CODE=event-code-1 [,....]
For example:
%RMS-E-FNF, file not found
If some logged events contain the %RMS-E-FNF message, you can select
those events by using /EVENT_CODE=FNF or /EVENT_CODE=(FNF).
Logging all events to the current log file is the default.
/FACILITY
Selects a list of events logged by one or more facility names you
specify. The only facilities that log events in the ACMS Software
Event log are ACMS and SWL. ACMS software errors are logged under
the name ACMSI. To log all events in the current log file is the
default.
Format:
/FACILITY=facility-name-1 [,...]
/IMAGE
Selects the events associated with one or more image names you
specify.
Format:
/IMAGE=image-file-spec-1 [,...]
You must specify a complete file specification, including the
version number.
For example:
LIST EVENTS/IMAGE=_DBA0:[JONES]MYPROG.EXE;3
/INPUT
Names the input log file you want to read.
Format:
/INPUT=file-spec
If you do not specify this qualifier, RPCSWLUP uses the latest version
of SYS$ERRORLOG:RPCSWL.LOG.
/OUTPUT
Stores RPCSWLUP output in a file you specify or to the default file
RPCSWLUPLIS.LIS.
Format:
/OUTPUT=file-spec
If you do not use the /OUTPUT qualifier, RPCSWLUP prints the output on
SYS$OUTPUT by default. If you do use the /OUTPUT qualifier, you must
include a file specification.
Prints a listing file on the system printer.
Format:
/PRINT
If you do not use the /OUTPUT qualifier with the /PRINT qualifier,
RPCSWLUP creates a temporary listing file RPCSWLUPLIS.LIS and deletes it
after the file is printed.
/PROCESS_NAME
Selects all events logged with one or more process names you specify.
Format:
/PROCESS_NAME=process-name-1 [,...]
Logging all events to the current log file is the default.
/SEVERITY
Selects the events for a RPCSWLUP report by the VMS severity code, such
as ERROR, INFORMATIONAL, WARNING, FATAL, or SUCCESS.
Format:
/SEVERITY=severity-code-1 [,...]
You can abbreviate severity codes to 1 character.
/SINCE
Identifies only those events dated after the date and time you
specify.
Format:
/SINCE=(dd-mmm-yyyy[:][hh:mm])
Lets you set limits on the time period during which listed events
occurred. This qualifier and the /BEFORE qualifier let you state
the range of time for the events logged.
When specifying the date and time, any of the trailing fields may
be omitted. However:
o The date defaults to the current date.
o The time defaults to 00:00:00.00 for the specified date.
o If you specify any part of the date, you must specify the full
date. You need not specify a time, in which case the time defaults
to 00:00:00.00.
/USER
Selects all events logged by a process with one or more user names.
Format:
/USER=user-name-1 [,...]
Logging all events in the current log file is the default.