Skip to main content

vserver vscan on-demand-task report show

Contributors
Suggest changes

Display On-Demand reports

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver vscan on-demand-task report show command displays information about the On-Demand reports belonging to the Vserver. A new report record is generated at the end of an On-Demand task run. If you do not specify any parameters, the command displays the following information about all On-Demand tasks:

  • Vserver name

  • Task name

  • Report file path

  • Number of clean files

  • Number of infected files

You can specify the -fields parameter to specify which fields of information to display about On-Demand report. In addition to the fields above, you can display the following fields:

  • Job ID

  • Job duration

  • Number of attempted scans

  • Number of files skipped from scanning

  • Number of already scanned files

  • Number of successful scans

  • Number of failed scans

  • Number of timed-out scans

  • Job start time

  • Job end time

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver

If you specify this parameter, the command displays information only about the On-Demand reports for the specified Vserver.

[-task-name <text>] - Task Name

If you specify this parameter, the command displays information only about the On-Demand reports for the specified task.

[-report-file <text>] - Report File Path

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified report file-path.

[-job-id <integer>] - Job ID

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified job ID.

[-job-duration <[<integer>d][<integer>h][<integer>m][<integer>s]>] - Job Duration

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-attempted-scans <integer>] - Number of Attempted Scans

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-skipped-scans <integer>] - Number of Files Skipped from Scanning

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-already-scanned-files <integer>] - Number of Already Scanned Files

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-successful-scans <integer>] - Number of Successful Scans

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-failed-scans <integer>] - Number of Failed Scans

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-timedout-scans <integer>] - Number of Timedout Scans

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-files-cleaned <integer>] - Number of Clean Files

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-files-infected <integer>] - Number of Infected Files

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-internal-error <integer>] - Number of Internal Error (privilege: advanced)

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-scan-retries <integer>] - Number of Scan Retries (privilege: advanced)

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-job-start-time <MM/DD/YYYY HH:MM:SS>] - Job Start Time

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

[-job-end-time <MM/DD/YYYY HH:MM:SS>] - Job End Time

If you specify this parameter, the command displays information only about the On-Demand reports that have the specified value.

Examples

The following example displays information about all On-Demand reports:

cluster1::> vscan on-demand-task report show
                                                               Files     Files
Vserver     Task Name   Report File Path                     Cleaned  Infected
----------- ----------  ---------------------------------- --------- ---------
vs1         t1          /rep/avod_146_20150902_161439.log       6240         5
vs1         t1          /rep/avod_149_20150903_160313.log        115         0
2 entries were displayed.

The following example displays detailed information about an On-Demand task:

cluster1::> vscan on-demand-task report show -vserver vs1 -task-name t1
            -report-file /rep/avod_146_20150902_161439.log
Vserver: vs1
                            Task Name: t1
                     Report File Path: /rep/avod_146_20150902_161439.log
                               Job ID: 146
                         Job Duration: 76s
            Number of Attempted Scans: 6245
Number of Files Skipped from Scanning: 1286
      Number of Already Scanned Files: 987
           Number of Successful Scans: 6245
               Number of Failed Scans: 0
             Number of Timedout Scans: 0
                Number of Clean Files: 6240
             Number of Infected Files: 5
                       Job Start Time: 9/2/2015 16:14:39
                         Job End Time: 9/2/2015 16:15:55