SecureTime API Toolkit
Toolkit Home  

DGS_TIMESTAMP_PARA


The DGS_TIMESTAMP_PARA structure contains configuration information for toolkit operation.  Specifies which time stamp servers to use and server failover choices.   This structure defined by the calling program and is then used as input to other DigiStamp toolkit functions.

typedef struct _DGS_TIMESTAMP_PARA {
    char   *acctId;
    void   *password;
    BOOL   sslFlag;
    char   *listOfServers[16];
    BOOL   roundRobin;
    INT    timeOut;
    INT    retryNum;
    INT    serverTimeOut;
 } DGS_TIMESTAMP_PARA, *DGS_TIMESTAMP_PARA;

Members

acctId
Your DigiStamp account ID
password
Your DigiStamp account password. Please note that your password will never be trnsmitted over the wire.
sslFlag
Flag to indicate if the communication to DigiStamp server should be done over SSL
listOfServers
Array of null terminated strings. The order in which to use specific DigiStamp servers.  Current servers are "TSA1" and "TSA2".  TSA1 is located in Dallas TX and TSA2 is in Virginia.  The test server are "TSATEST1" and "TSATEST2".  If not specified then the default "TSA1" is assumed.
roundRobin
Use the time-stamp servers in the list in a round-robin fashion.  This has no effect if there are not multiple server names provided in the listOfServers.
timeOut
How long to wait for a response from the time-stamp server before failing.   In some configurations the toolkit will not be able to extend the timeout beyond operating system setttings.
retryNum
If a "timeOut" condition occurs then how many times should the time-stamp request be retried.  If a list of multiple servers has been specified then the next server in the list will be accessed for the time-stamp request.    Default is 3.
serverTimeOut
If a specific time-stamp server failed to respond before timeOut, then how long should be wait before it is used again in a time stamp request.  If only one server name in ListOfServers then this has no effect.  Default is 5 minutes.

Remarks

The client application should create this structure just once and then reuese for each subsequent call to create a time stamp.  None of the DigiStamp toolkit APIs modify the values of the fields within the structure.

  18 April, 2000

Home

  Feedback      Related Links   Contact Us   Mailing List    Privacy Statement
Copyright 2000-2005 DigiStamp, Inc.
All Rights Reserved
SecureTime, IPVault, IPProtector, and e-TimeStamp  are service marks of the DigiStamp, Inc.