Using the Command Line Interface › ca_log - Log Command › ca_log - View Options

ca_log - View Options

There are several options you can use for viewing logs.

The ca_log command includes the following log viewing options:

ca_log [-cahost <hostname>][-entiredomain]

-view <logname>[<view options>]

-jobID <ID>
-groupbyjob 
-before <mm/dd/yyyy>
-after <mm/dd/yyyy>
-monitor
-sev

Note: To properly display all Unicode characters in the output of a command, you must first set the environmental variable "ARCSERVE_UNICODE_DISPLAY_CMDL" to a value of 1 prior to running the command as follows:

C:\Documents and Settings\cb>set ARCSERVE_UNICODE_DISPLAY_CMDL=1 

To view these Unicode characters correctly, you will also we need to redirect the output of ca_log after setting the environmental variable as follows:

C:\>ca_log -view activity.log >UNICODE_log.txt

• logname

  Displays the logs specified by the log name according to one or several view options.

• -jobID <ID>

  Displays the specified logs by job ID or job list ID for the activity log.

  For example:

  • ca_log –view activity.log -jobID 5
  • ca_log –view activity.log -jobID 1,2,3 (split by comma)
• -groupbyjob

  Available only when the filename to be viewed is an activity log. Specifies that the ca_log -view command will display logs grouped by job ID first, and then logs for jobs without a job ID. The job logs will also group master jobs and its child jobs logs together before other logs.

  Without this switch included, the activity log will be displayed in time order.

  With this switch included, the activity log will be displayed and grouped by job.

  For example, the output would be as follows:

  • Logs of job1 in activity log
  • Logs of job2 in activity log ...
  • Logs of jobn in activity log
  • Logs in activity log without job id.
• -before <mm/dd/yyyy>

  Displays all entries with the specified log name before date mm/dd/yyyy.

  Note: You can use the -before and -after options together to display logs across a period of time.

• -after <mm/dd/yyyy>

  Displays all entries with the specified log name after date mm/dd/yyyy.

  Note: You can use the -before and -after options together to display logs across a period of time.

• -monitor

  Displays logs with the specified log name and keeps it open indefinitely. The log name is updated in real time as additional entries to the log are recorded.

  Keeps the ca_log command from terminating after displaying the last specified log, and continues to read and display additional logs from the log file as they become available.

• -sev

  Displays the severity level of each entry with the specified log name. The severity levels are displayed after the date column. The severity levels are:

  I - Information

  W - Warning

  E - Error

  Note: The -sev option can be used in conjunction with the -jobID, ‑before, and -after options.