getNextJournal

getNextJournal(): Integer updating;

The getNextJournal method of the JadeAuditAccess class locates the next journal to be accessed. The file is positioned at the first audit record after the journal header record.

This method returns zero (0) if the audit journal is available. If it is not available, an exception is raised.

If there is a description file associated with the next journal, an attempt is made to load it. The descriptionPath property, if null (""), is assigned a default value and the descriptionFilename property is assigned. The descriptionTS property is assigned only after a successful description load. If the description file is already loaded and its timestamp has not changed it is not reloaded.

If the description file is not available, all methods requiring class or property names as parameters, or in their results, will not function (and they will usually return a false result).