Showing Free Extents with BR*Tools 

Use

You can use BR*Tools  for Oracle to show information about free extents.

Procedure

...

       1.      Start the procedure using BRGUI or BRTOOLS, or from the command line:

¡        BRGUI or BRTOOLS:

                                                  i.       Choose Segment management → Additional segment functions  → Show free extents.

BRGUI or BRTOOLS displays the menu BRSPACE main options for showing database information, where you specify the options with which you call BRSPACE.

                                                ii.       Set the required options:

Menu Entry	Equivalent BRSPACE Command Option
BRSPACE profile (profile)	-p|-profile
Database user/password (user)	-u|-user
Database tablespace (tablespace)	-f dbshow -s|-tablespace
Database file (file)	-f dbshow -f|-file

If required, in Database tablespace and Database file, you can specify multiple objects but you cannot  use wildcards.

BRSPACE processes all free extents for the specified objects.

                                               iii.       Choose Continue.

BRGUI or BRTOOLS displays a further menu, Additional BRSPACE options for showing database information, where you specify the additional options with which you call BRSPACE.

Menu Entry	Equivalent BRSPACE Command Option
Create log file (log)	-f dbshow -l|-log
Confirmation mode (confirm)	-c|-confirm
Extended output (output)	-o|-output
Scrolling line count (scroll)	-s|-scroll
Message language (language)	-l|-language
BRSPACE command line (command)	This shows you the BRSPACE -f dbshow -c feinfo command that is to be executed using the current settings.

                                               iv.       Choose Continue

BRGUI or BRTOOLS prompts you to start BRSPACE.

                                                 v.       Choose Continue to start BRSPACE.

¡        Command line:

...

Enter at least the following command:

brspace –f dbshow –c feinfo

You can enter more parameters if required. For more information, see BRSPACE -f dbshow.

BRSPACE starts and you see a message that includes Start of BRSPACE processing. From now on, BRSPACE writes a detail log if you set the option Create log file (parameter –l|-log).

If you started BRSPACE from the command line without the information class name (-c|-class) – that is, with brspace –f dbshow – BRSPACE displays the Show database information main menu.

Choose Show database segment information → Show free extents.

BRSPACE displays the List of free extents:

List Entry	Meaning
Pos.	List sequence number
Tablespace	Tablespace name
File Id	File ID
Block Id	Block ID
Size[KB]	Extent size

       2.      To see more information, select one or more free extents.

These examples only apply to input in character mode.

To select the first three entries in the list, enter 1-3.

To select the first and third entries, enter 1,3.

To select the first three entries and the fifth, enter 1-3,5.

To select all entries, enter 0.

BRSPACE displays Information about free extent:

List Entry	Meaning
Tablespace name (tablespace)	Tablespace name
Data file (file)	Data file name
File Id. (file_id)	File ID
Relative file number (file_no)	Relative file number
Block Id. (block_id)	Block ID
Extent size in KB (size)	Extent size

       3.      If you specified multiple free extents, choose Continue to scroll through.

Results

If you set the option Create log file (parameter –l|-log), check the results in the BRSPACE logs.

·        The summary log space<DBSID>.logdisplays the return code.

·        The detail log s<encoded timestamp>.dbw displays the details.

For more information on how to view the logs with BR*Tools, see Showing Logs and Profiles with BR*Tools.