Skip to main content

vserver vscan on-demand-task report show

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>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