Instruction Manual

SWID Server Interface
Software Identification (SWID) User’s Guide—527243-004
6-7
Using SWID as a Server
GetOrigFpts Command
This command is used to obtain only the original fingerprint of a disk file when the file
code is known and when the first 2048 bytes are read by the application process.
With the GetOrigFpts command, the application can use either of the next two
methods.
GetOrigFpts Command - File Name Method
In this case, the file name is provided in the fname field. All other fields must be nulls.
The application gives only one file name and no file set in the fname field. If the
fname is invalid, SWID replies with errors ReplyLen = 0 and Reply Error = 13.
GetOrigFpts Command - File Code and Buffer Method
The application indicates the file code by using the fcode field. It also lists the first
2048 bytes of the file provided in the buf field. The buflen field contains 2048. When
using this method, the fname field must contain nulls.
The rectype of FO-REC is always set to default when you use the GetOrigFpts
command. For the record structure of def-rec, see GetFpts Command on page 6-3.
If the original fingerprint cannot be computed for whatever reason, the original error
field of def-rec contains a -2 to indicate *n/a*.
DisplayStatistics Command
This command is used to obtain the run statistics of a SWID server process. The reply
from SWID consists of one FO-REC record with a rectype of ds. The record structure
of ds-rec is:
* SWID Formatted Input: GetOrigFpts Command Structure
def GetOrigFpts-Rec.
03 rectype type binary 16 value is 1.
03 fname type character 36.
03 fcode type binary 16.
03 buflen type binary 16
must be 0 thru 2048.
03 buf type character 1
occurs 0 to 2048 times
depending on GetOrigFpts-Rec.buflen.
end.
*SWID Formatted Input DisplayStatistics Command Structure
def ds-rec.
03 DispStats-Rec type binary 16 must be 9.
end.