Powertech Antivirus Scan (AVSCAN)

The AVSCAN command scans the Integrated File System (IFS) for viruses.

Parameters

File or Directory (OBJ)

The file or directory name to scan.

NOTE: You can see a list of files and directories on the system using the WRKLNK command. To scan a NFS mountable directory, specify the path as hostname:pathname.
/ All files and directories on the system will be scanned
file or directory The specified file or directory will be scanned.
Directory subtree (SUBTREE)

Specifies if files contained in subfolders relative to the starting path are scanned.

*ALL Files within subfolders of the starting path will be scanned. If the subfolders also contain subfolders, they will also be scanned, and so on. If you want to exclude a folder within a subfolder, see the Exclude paths (EXCL) parameter.
*NONE Do not scan subfolders. If the subfolders contain additional files and folders, they will not be scanned.
Heuristic analysis (HEURISTIC)

Include heuristic analysis to find new viruses. When you use heuristic analysis, the scanning engine employs heuristic technology to detect new viruses in executable files (programs). Without this option, the engine can only find viruses that are already known.

*YES Include heuristic analysis to find new viruses. This attribute slows the engine's performance.
*NO Do not use heuristic analysis.
Macro analysis (MACRO)

Specifies if you want to treat embedded macros, that have code resembling a virus, as if they were viruses. This parameter is similar to Heuristic analysis but scans for new viruses in compound document formats; for example Microsoft OLE formats such as Word documents. You can use both Macro Analysis and Heuristic Analysis as parameters, and the engine determines which heuristics to implement based on the file type.

*YES Include macro analysis to find new viruses. This attribute slows the engine's performance.
*NO Do not use macro analysis.
Potentially unwanted programs (PROGRAMS)

Specifies if you want scanning activities to include detection of some widely available applications, such as password crackers or remote access utilities that can be used maliciously or can pose a security threat.

*NO Do not scan for potentially unwanted programs.
*YES Scan for potentially unwanted programs.
Scan archives (ARCHIVES)

Specifies if you want scanning activities to include archive files. Archive files contain imbedded files and usually end with one of the following extensions: .ZIP, .CAB, .LZH, JAR and .UUE.

This option will also permit scanning of MSCompress files, which display the ??_ extension.

*YES Scan archive files to find new viruses. This attribute slows the engine's performance.
*NO Do not scan archive files.
Scan MIME (MIME)

Specifies if you want to check files for MIME encoded content.

*YES Check files for MIME content.
*NO Do not check files for MIME content.
Clean infected files (CLEAN)

Specifies if infected files should be cleaned whenever possible.

*YES Clean infected files by removing the virus.
*NO Do not clean infected files.
Action if not cleaned (CLEANFAIL)

Specifies the action to perform on infected files that could not be cleaned.

*QRN Move the infected file to the /Quarantined directory. The open of the file will be prevented.
*DELETE Delete the infected file. The open of the file will be prevented.
*NONE No action will be performed. The open of the file will be prevented.
Scan file types (FILES)

Specifies the types of files to include in scanning activities.

*DFT Scan only file types that are most susceptible to virus infection. This option safely narrows the scope of scan operations to files that are susceptible to virus infection and reduces the amount of time devoted to scanning files.

*ALL Scan all files. This attribute slows the engine's performance, but offers you the best protection against infection.

*ALLMACRO Expands scanning activities to include an examination of all files to determine if they contain known macro viruses. This attribute slows the engine's performance but offers you the best protection against infection from macro viruses. This option is faster than the *ALL files option, which examines every file for program viruses and macro viruses.
Force (FORCE)

Specifies if you want to recognize or override the object's scan settings when performing this scan. The object's scan settings can be seen using the WRKLNK command and choosing option 8 to view the object's attributes as seen below:

Object scanning ..........................: *YES

Scan status ...........................: *SUCCESS
Scan signatures different ......: No
Binary scan ...........................: Yes
CCSID scan ..........................: 0

The scan settings for an object can be changed using the CHGATR ATTR(*SCAN) command.

*NONE The object's scan settings will be utilized. This is the default. Objects set to 'Object scanning *NO' will not be scanned. Objects set to 'Object scanning *CHGONLY' will not be scanned unless the object has changed ('Scan status *REQUIRED').
*ALL All files will be scanned regardless of the 'Object scanning' parameter, provided the virus definitions have been updated to a newer level since the object was last scanned ('Scan signatures different *YES'). This option can be useful to periodically scan objects that would normally be skipped from scanning.
*NOSCAN Files that have been configured with 'Object scanning *NO' will be scanned, provided the virus definitions have been updated to a newer level since the object was last scanned ('Scan signatures different *YES').  
*CHGONLY Files that have been configured with 'Object scanning *CHGONLY' will be scanned even though the object has not changed, provided the virus definitions have been updated to a newer level since the object was last scanned ('Scan signatures different *YES').
Exclude files or paths (EXCL)

Specifies the list of directories (and subdirectories) to exclude from scanning. To exclude a single file, use the command CHGATR OBJ(file-name) ATR(*SCAN) VALUE(*NO), where file-name is the fully qualified path of the object you want to exclude.

*NONE All files will be scanned.
path-name Specifies the list of directories to exclude from scanning. This will exclude the specified directory and all of its subdirectories from the on-access scanning.
Logging Level (LOGLVL)

Specifies the level of detail that will be printed on the scan report.

*DETAILED Several directory levels will be printed.
*SUMMARY One directory level will be printed.
*FULL All directory levels will be printed.
1-99 Specifies the number of directory levels to print.
Output (OUTPUT)

Specifies where output from program should be sent.

* The output is sent to the display. If the job is a batch job, the output is spooled to an output queue.
path-name The output is sent to an IFS stream file.
Timeout minutes (TIMEOUT)

The time-out is applied after the scanning of each directory. If the configured time-out is reached after only some of the files in a directory have been scanned, the scanning will continue until all files in that directory have been scanned.

*NONE The operation will run as long as necessary to completion without timing out.
minutes The operation will time out after the specified number of minutes.
Restart (RESTART)

Specifies if the scan is to restart from a previous timeout.

*NO The scan will start from the specified start path.
*YES The scan will resume from the last directory of the previous start path. If the previous scan completed without timeout, then the scan will start from the specified start path.