When an OLAP DML statement is executed through SQL, using the POUTFILEUNIT option enables you to see the work that the statement is doing as it progresses instead of waiting until the execution of the SQL call is complete.
POUTFILEUNIT = -1 |fileunit
(Default) Specifies that Oracle OLAP is currently not logging data.
Specifies a destination, such as an open disk file, to which Oracle OLAP sends information on the progress of an operation. The fileunit can be the value of the OUTFILEUNIT option or the results of the FILEOPEN function.
When you change the value of POUTFILEUNIT from fileunit to
-1, Oracle OLAP disassociates the file identified by fileunit from POUTFILEUNIT and suspends logging to that file; however, but Oracle OLAP does not close that file. You can resume logging to that file by issuing another POUTFILEUNIT.
To close the file before suspending logging, issue a FILECLOSEPOUTFILEUNIT before you change the value of POUTFILEUNIT from fileunit to
ALLOCATE, the AGGREGATE command, and AGGREGATE function send the following types of information:
Progress of the verification of the hierarchy of a dimension
Progress of the building of intermediate computation structures
The execution of the allocation or aggregation
Errors or anomalous behavior that Oracle OLAP encounters in allocating or aggregating the source data to the target variable cells, such as skipped deadlocks in an allocation.
In this example, a FILEOPEN statement opens a file named
progress.txt in the
userfiles directory object and returns the file handle to the POUTFILEUNIT option. The file receives status messages from the AGGREGATE command. When the aggregation is complete, a FILECLOSE statement closes the file.
POUTFILEUNIT=FILEOPEN('userfiles/progress.txt' WRITE) AGGREGATE sales units USING gpct.aggmap FILECLOSE POUTFILEUNIT
The following statement sets POUTFILEUNIT to the current outfile destination. When the current outfile destination is the OLAP Worksheet window, remember that you cannot do other work in your session until the operation completes.