GetTransferRecordsByItemUID Method (PITransferRecordDB object)

             

Get the all the transfer records, over the specified time range associated with the passed PIBatch, PIUnitBatch, or PIModule UniqueID.

 

Syntax

object. GetTransferRecordsByItemUID varSearchStart, varSearchEnd, SourceList, DestinationList, [pAsynchStatus], [varItemUniqueID]

 

The GetTransferRecords method syntax has these parts:

Part

Description

object

An object expression that evaluates to a PITransferRecordDB object.

varSearchStart

A VARIANT containing the search start time. The VARIANT may be a PITime, DATE, String, or numeric. Interpretation of DATE, strings and numerics is consistent with PITime's interpretation.

varSearchEnd

A VARIANT containing the search end time. The VARIANT may be a PITime, DATE, String, or numeric. Interpretation of DATE, strings and numerics is consistent with PITime's interpretation.

SourceList

List of transfer records returned where the passed item is the Source (PITransferRecordList).

DestinationList

List of transfer records where the passed item is the Destination (PITransferRecordList).

pAsynchStatus

Optional asynchronous status object (PIAsyncStatus).

varItemUniqueID

Optional UniqueID of PIUnitBatch, PIBatch or PIModule. If not specified, all transfer records over specified time range are returned.

 

Remarks

This method is used to follow the genealogy of a PIBatch or PIUnitBatch. Or, all transfer records, over a time range, associated with a particular PIModule. The results are returned in two PITransferRecordList's. The SourceList contains all the transfer records where the specified object is the source. The DestinationList contains the transfer records where the specific object is the destination.

 

The pAsynchStatus argument is used for performing asynchronous calls. If this argument is passed, the method returns immediately with the two empty lists (SourceList  and DestinationList). These lists are protected against access (an error of pseASYNCHMODEERR will be returned) until the call is complete.

 

If no PITransferRecord's are found that match the search criteria, empty lists are returned.

 

Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:

Error

Description

pseNOGENSERVER

The underlying server abstraction layer could not be accessed.

 

 

Enabling Operational Intelligence