Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Qualifiers

/BEFORE

/EVENT_CODE

/FACILITY

/IMAGE

/INPUT

/OUTPUT

/PRINT

/PROCESS_NAME

/SEVERITY

/SINCE

/USER

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

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.

/PRINT

 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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026