Showing Segments with BR*Tools

Use

You can use BR*Tools  for Oracle to show information about database segments.

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 segments.

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 owner (owner)

-f dbshow -o|-owner

Database table (table)

-f dbshow -t|-table

Database index (index)

-f dbshow -i|-index

If required, in Database table or Database index you can enter the names of multiple tables or indexes by using wildcards. For more information, see “Selecting Objects“ in Segment Management with BR*Tools.

In Database tablespace and Database owner, you can specify multiple objects but you cannot  use wildcards.

BRSPACE processes all the segments in the specified tablespace(s), or all segments belonging to the specified owner(s), table(s), or index(es).

                                               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 sginfo 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 sginfo

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 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 segments.

BRSPACE displays the List of database segments:

List Entry

Meaning

Pos.

List sequence number

Owner

Segment owner

Type

Segment type: table, index, tabpart, indpart, lobseg, lobind, cluster, rollback, temp, cache

Segment

Segment name

Partition

Partition name if applicable

Tablespace

Tablespace name

Size[KB]

Segment size

Extents

Number of extents

NextExt[KB]

Next extent size

MaxExts

Maximum number of extents possible

       2.         To see more information, select one or more segments.

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 segment:

List Entry

Meaning

Segment type (type)

Segment type: table, index, tabpart, indpart, lobseg, lobind, cluster, rollback, temp, cache

Tablespace name (tablespace)

Tablespace name

Segment size in KB (size)

Segment size

Number of extents (extents)

Number of extents

Next extent size in KB (next)

Next extent size

Maximum number of extents (maxext)

Maximum number of extents possible

       3.      If you specified multiple segments, 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.