code: private void setFileSpaceLeft()
                      throws ObjectManagerException
      {
          if (Tracing.isAnyTracingEnabled() && trace.isEntryEnabled())
              trace.entry(this, cclass,
                          "setFileSpaceLeft",
                          new Object[] { new Long(fileLogHeader.fileSize), new Long(fileLogHeader.startByteAddress),
                                        new Long(filePosition) }
                              );
  
          // Assume we have wrapped around the end of the file, the space left is between the current
          // file position and the start of the log file.
          long newFileSpaceLeft = fileLogHeader.startByteAddress - filePosition;
          if (newFileSpaceLeft <= 0) // If we have not wrapped. 
              newFileSpaceLeft = newFileSpaceLeft + fileLogHeader.fileSize - FileLogHeader.headerLength * 2;
          fileSpaceLeft = newFileSpaceLeft;
  
          if (Tracing.isAnyTracingEnabled() && trace.isEntryEnabled())
              trace.exit(this,
                         cclass,
                         "setFileSpaceLeft",
                         new Object[] { new Long(fileSpaceLeft) });
      }
docs: Sets the amount of space still left in the log file.
  
  @throws ObjectManagerException