Net Vampire Job files




The best way of adding Jobs to Net Vampire is by creating *.NVJ files and moving them to the Net Vampire\Data\Jobs\ directory. The program monitors this directory and adds Jobs to the list as soon as it detects a new Job file. You can modify or delete these files as well. Deleting a file will delete the corresponding Job immediately, changes in the file will take affect when the next download attempt starts.

NVJ files follow the syntax of Windows INI files. you can create them either programmatically or with a text editor.

In addition, you can create an *.NVC file in the Net Vampire\Data\State\ directory before creating NVJ to specify the initial state of the Job - for example, State=2 will start the Job immediately.

You can monitor the Job status by reading its NVC file and checking the size of the partially received (*.NVP) file in the Net Vampire\Data\Partial\ directory. Please note that the user may override the partial directory. The new path is then stored in the HKCU\SOFTWARE\Net Vampire\System\PartialDir Registry key.

Table 1. Net Vampire file types
File Description
Net Vampire\Data\Jobs\*.nvj Job settings. See Table 2.
Net Vampire\Data\State\*.nvc Job state. See Table 3.
Net Vampire\Data\State\*.nvl Session log. Do not write to this file.
Net Vampire\Data\Sites\*.nvs Site settings and statistics. Do not write to this file.
Net Vampire\Data\Partial\*.nvp Partially received files. Check the size of these files to monitor the progress of downloads.

Each Job must be assigned a unique ID. The ID is an integer value between 0x00000001 and 0x7FFFFFFF. It is advised that you start the enumeration of your ID's with a high value, such as 0x30000000, to avoid potential conflicts with existing Jobs. The NVJ, NVC, NVL and NVP files that belong to a Job have the same file name, which is the 8-digit hex encoded Job ID, and only differ with the file extension.


Table 2. NVJ file structure
Key Purpose Data type
[SETTINGS]
LocID The ID of the currently used file location in the [LOCATIONS] section ID
Title The Job description line string
LocalFile The name of the destination file if different from the original file name string
LocalFolder The destination directory or category. Put the category name in the angle brackets string
StartTime The start time of the Job time
Priority The Job priority, 1(lowest) to 9(highest) integer
Regular Re-schedule the next start after completion boolean
Period Time interval between the starts in the Regular mode integer
PeriodUnits Period units: 0=days, 1=hours, 2=minutes. integer
OnlyNewer Download only newer files in the Regular mode boolean
MultiCopies Save multiple copies of the file in the Regular mode boolean
ConnPerFile Reserved integer
RetryIfSize Retry if file size is less than MinFileSize boolean
MinFileSize Minimum file size for the RetryIfSize option integer
AllowConcurrPerFile Reserved boolean
Strip Strip proxy messages from the received file boolean
Referer The Referer field of the HTTP request string
UserAgent The User-Agent field of the HTTP request string
IgnoreDateChange Resume the download even if the file date/time changed boolean
RestoreDirs Append the source site name and directory to LocalFolder boolean
[LOCATIONS]
<ID> Remote file location (URL) string



Table 3. NVC file structure
Key Purpose Data type
[STATE]
State The current Job state: 0=Stopped, 1=Scheduled, 2=Active, 6=Completed, 7=Failed, 8=NoFile, 9=Regular. integer
FileSize The remote file size integer, read only
FileTime The remote file date and time time, read only
Attempt The current attempt number integer, read only
FinalName The current location of the received file string, read only
IsHtml The file is HTML formatted boolean, read only

Key values are represented according to these rules:

ID: 8-digit hex encoded integer
boolean: 0=false, 1=true
time: a string representation of the floating point value where the integral part is the number of days that have passed since 12/30/1899, and the fractional part is fraction of a 24 hour day that has elapsed.



END OF DOCUMENT