ORG.oclc.util
Class BatchNewtonUpdate

java.lang.Object
  |
  +--ORG.oclc.util.BatchNewtonUpdate

public class BatchNewtonUpdate

extends Object

implements IDbExtSvc

The BatchNewtonUpdate class implements the IDbExtSvc interface and is executed as part of the Z39.50 Extended Services Database Update request. This class will be responsible for applying the online update to the local Newton database. That entails the batch execution of the Newton database update programs.
Upon the successful completion of the online update, the BER update record will be returned to the application layer via the Z39.50 response task package.

The database updates will use pippin, rome, newtsize, and sortnip programs found in the SSDOT exes directory.

The database ini file setting for Online Update are:

[ExtendedServices]
1.2.840.10003.9.5 = ORG.oclc.util.BatchNewtonUpdate

[ExtendedServicesDbUpdate]
exes = /your directory/dbbuilder/bin
logs = /your directory/dbbuilder/dbs/yourdb/updatelogs
databasepercentfull = 95 (default value)
LockServerName = Lock
journalUpdateDir = /your directory/dbbuilder/dbs/yourdb/journal
recordIdTag = 10/1
recordIdFile = /your directory/dbbuilder/dbs/yourdb/recordid.txt
recordIdClass = ORG.oclc.mantis.util.GetRecordIdFromFile

Possible Database Update Error Conditions:
1. Newton database needs grown - no update submitted.
2. Newton database update failed - check logs for reason.
3. Newton database locked - no update submitted.
4. Unable to communicate with the Lock Server - no update submitted.

The BatchNewtonUpdate class will not submit a record update to the Newton database if any of the database files are greater than the databasepercentfull size specified in the ini file. However, if a database update is submitted and fails, then the administrator will need to analyze the online_update.log file generated. Restart files for pippin and rome will be produced for an update to be restarted manually.

See Also:

IDbExtSvc

Constructor Summary

BatchNewtonUpdate()

Method Summary

DataDir	doService(ExtSvcData esdata, ExtSvcHandler eshandler, Object userdata, Db dbobject) Processes an Extended Services Database Update request.
String	toString() Generates the String representation of this object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BatchNewtonUpdate

public BatchNewtonUpdate()

Method Detail

doService

public DataDir doService(ExtSvcData esdata,
                         ExtSvcHandler eshandler,
                         Object userdata,
                         Db dbobject)
                  throws Diagnostic1,
                         AccessControl,
                         Exception

Processes an Extended Services Database Update request.

Specified by:

doService in interface IDbExtSvc

Parameters:

esdata - the Extended Services Data.

eshandler - the Extended Services Handler class that determines what type of Extended Services request is sent, can be used to process the specific information in Extended Services requests.

userdata - the user context information.

dbobject - the Database Object invoking the ES request handler.

toString

public final String toString()

Generates the String representation of this object.

Returns:

the String representation of this object

Overrides:

toString in class Object