EMC Solutions Enabler CLI Command Reference

Chapter 1: SYMCLI Commands

symrdb

Displays detailed mapping information about one or more schemas, tables, files, tablespaces, or segments that are defined in a specified database instance.

SYNOPSIS symrdb [-h] -type <DbType> [-db <DbName>] [-kb|-blocks|-mb] list [TBS | FILE [-datalog] | SCHEMA | TABLE]

[-v] [-unalloc] show [-no_extents | -expand | -collapse]

[TBS <TbsName>|FILE <FileName>|SCHEMA <SchemaName> |

TABLE <TableName>] symrdb [-h] [-v] -type <DbType> [-db <DbName>]

[-kb|-blocks|-mb] list [FILE | SEG | TABLE] -tbs <TbsName> list [FILE | SEG | TABLE] -schema <SchemaName> symrdb [-h] -type <DbType> [-db <DbName>] [-kb|-blocks|-mb]

[-no_extents | -expand | -collapse] show -tbs <TbsName>

[FILE <FileName>|SEG <SegmentName>|TABLE <TableName>] show -schema <SchemaName>

[FILE <FileName>|SEG <SegmentName>|TABLE <TableName>] symrdb [-h] [-v] -type <DbType> [-db <DbName>]

[-sid <SymmID>] [-rdfg <GrpNum>] [-R1|-R2]

[-bcv | -nobcv | -vdev] [-data] [-log] [-control]

[-force] rdb2dg <DgName> [-dgtype REGULAR | RDF1 | RDF2] rdb2cg <CgName> [-cgtype REGULAR | RDF1 | RDF2]

554 EMC Solutions Enabler CLICommand Reference

[-apidb | -rdf_consistency] symrdb [-h] [-v] -type <DbType> [-db <DbName>]

-tbs <TbsName> [-sid <SymmID>] [-rdfg <GrpNum>]

[-R1|-R2] [-bcv | -nobcv | -vdev] [-force] tbs2dg <DgName> [-dgtype REGULAR | RDF1 | RDF2] tbs2cg <CgName> [-cgtype REGULAR | RDF1 | RDF2]

[-apidb | -rdf_consistency] symrdb [-h] [-v] -type <DbType> [-db <DbName>] show -config [-all] symrdb [-h] [-v] [-i <Interval>] [-c <Count>] stats stats_option symrdb [-h] startup db_startup_options symrdb [-h] shutdown db_shutdown_options

DESCRIPTION

The symrdb command displays mapping information specific to a schema, table, file, tablespace, or segment in a database instance. Detailed information can be obtained for tablespaces, schemas, files and tables by specifying the -v option with the list command, or issuing the show command.

The symrdb rdb2cg and rdb2dg commands are used to convert a specified database into a composite group or device group. The symrdb tbs2cg and tbs2dg commands are used to convert a specified tablespace into a composite group or device group.


symrdb 555


For database objects that are defined on Symmetrix devices, you can obtain logical-to-physical information of where the file, table, schema, or tablespace extents are mapped on Symmetrix devices.

The database user login information must be supplied with the SYMCLI_RDB_CONNECT environment variable. The user login information is specified in the following format, "username/password@service". The username and password must be non NULL.

Note: For Oracle, the database user specified must have one of the following in order to run this utility:

- "select any table" privilege (Oracle8i and earlier)

- SELECT_CATALOG_ROLE (Oracle9i and later)

- DBA role

If list is specified without a key word, and neither -tbs or -schema are present on the command line, the default is to list the database names. If -db, -tbs, or -schema are present on the command line, the default is to list the tables of the specified database, tablespace, or schema.

Given a database name, you can obtain a list of:

- files defined to make up the database

- schemas defined within the database

- tablespaces defined within the database

- tables defined within the database

Given a database name and tablespace or schema name, you can obtain a list of:

- files that make up the tablespace or schema

- segments defined within the tablespace or schema


- tables defined within the tablespace or schema

To execute the symrdb utility, you must have the proper application software installed and environment variables set.

You can specify the database type, database, schema, and tablespace name from environment variables.

The command line options take priority over the environment variables as follows:

Environment Variable Use to Specify Instead of

-------------------- -------------- ----------

SYMCLI_RDB_TYPE database type -type

SYMCLI_RDB_NAME database name -db

SYMCLI_SCHEMA_NAME schema name -schema

SYMCLI_TBS_NAME tablespace name -tbs

In Oracle, the database name does not need to be specified. The default will be taken from the instance represented by the connection arguments.

If a name specified on the command line contains special shell characters, those characters must be escaped with a

\\ back slash. (e.g. $, ', \\, etc.)

If symrdb is being run in client/server mode and the required RDBMS environment variables are set in the client's environment, they will be sent to the server to be used.

On DB2, for additional information about what some of the configuration values mean, please refer to

"Administration Guide: Performance" or Configuration


symrdb 557

Chapter 1: SYMCLI Commands parameters in the DB2 Information Center.

ARGUMENTS list Lists the defined databases (or object type when a keyword is specificed) for the database instance. For Oracle, the name of the database instance is returned.

rdb2cg Translates the specified database into a composite group.

rdb2dg Translates the specified database into a device group.

show Shows database names, states pertaining to the connected server, status and usage of each of the databases. When a keyword is specified, detailed logical-to-physical mapping information about that object is returned.

stats Shows performance statistics about a specified database (type). The current supported databases are Oracle, SQL Server,

Sybase, and IBMUDB.

tbs2cg Translates the specified database table space into a composite group. Only data database files are translated.

tbs2dg Translates the specified database tablespace into a device group. Only data database files are translated.

KEYWORDS


FILE Specifies the action on defined files for a specified database instance.

REGULAR Specifies a device or composite group type of regular.

RDF1 Specifies a device or composite group type of RDF1.

RDF2 Specifies a device or composite group type of RDF2.

SCHEMA Specifies the action on defined schemas for a specified database instance, tablespace, or schema.

SEG Specifies the action on defined segments for a specified tablespace or schema.

TABLE Specifies the action on defined tables for a specified database instance, tablespace, or schema.

TBS Specifies the action on defined tablespaces for a specified database instance.

OPTIONS

-all Displays all the possible database configuration values (use with -config).

-apidb Creates the CG in the SYMAPI DB only.

-bcv Associates only BCV devices to the target group.

-blocks Displays size information in 512-byte


symrdb 559

Chapter 1: SYMCLI Commands blocks.

-c Indicates the number (count) of times to display statistics. If this option is not specified and an interval (-i) is specified, stats will be displayed continuously.

-cgtype Specifies a composite group type.

-collapse Collapses the extents of a database object, if possible. This is the default.

-config Displays the database configuration value.

-control Specifies to only operate on control database files. Default is all database files.

-data Specifies to only operate on data database files.

-datalog Displays "data and log" as a separate file type item. The default is to treat data and log as file type data. Used for Sybase only.

-db Specifies a relational database name.

-dgtype Specifies a device group type.

-expand Expands the extents of a database object, if possible.

-force Attempts to force the operation even though one or more devices in the database or tablespace may already be part of another

DG or CG group.


-h Provides brief, online help information.

-i Repeats the interval in seconds.

The default interval is 30 seconds.

The minimum interval is 5 seconds.

For passive actions the minimum interval is

15 seconds. Passive actions are actions that do not acquire an exclusive lock.

-kb Displays size information in Kilobytes.

-log Operates only on log database files.

-mb Displays size information in Megabytes.

This is the default.

-nobcv Adds only standard devices to the target group. The default behavior is to add both standard and BCV devices.

-no_extents Excludes extents information from the display.

-R1 Adds R1 devices to the target device group.

-R2 Adds R2 devices to the target device group.

-rdf_consistency

Creates a CG, allowing it to be enabled for RDF consistency once devices have been added to the CG.

-rdfg Selects RDF devices that belong to the specified Symmetrix RA (RDF) group number.


symrdb 561


-schema Specifies a database schema name.

-sid Specifies the unique Symmetrix ID.

-target Identifies the database statistics output options, refers to the stats_option on ora_options, sybase_options, sqlserver_options, and ibmudb_options.

-tbs Specifies a database tablespace name.

-type Specifies a database type (DbType).

-unalloc Displays unallocated space, for Sybase database file only.

-v Provides a more detailed, verbose listing.

-vdev Adds VDEVs to the target group.

PARAMETERS

CgName The composite group name.

DbName A specific database name.

db_startup_options

See below for specific database options.

db_shutdown_options

See below for specific database options.

DbTarget The metrics available for the specified database statistic.

DbType The database type. Supported values are:


- Oracle

- SQLServer

- Sybase

- MVSDB2

- IBMDB2

- IBMUDB

- Informix

- Exchange

- Exchange2007

- SharePoint

DgName The device group name.

FileName A specific database filename.

GrpNum The RDF (RA) group number.

SchemaName A specific database schema name.

SegmentName A specific database segment name.

stats_option See below for specific database options.

SymmID The 12-digit ID of the Symmetrix array.

TableName A specific database table name.

TbsName A specific database tablespace name.

Oracle Startup/Shutdown/Stats Options:

Startup...

symrdb [-h] startup -type Oracle

[ [FORCE] [RESTRICT] [PFILE=filename] [QUIET]

[MOUNT [-db dbname] |

[ [OPEN | OPEN_READ_ONLY | OPEN_READ_WRITE |


symrdb 563


OPEN_READ_WRITE_RECOVER | OPEN_RECOVER]

[-db dbname] ] | NOMOUNT]] |

[ [PFILE=filename] MIGRATE [QUIET]] where:

Option or

Keyword Description

--------- ---------------------------dbname Identifies the database name to mount or open. Refer to Oracle documentation for the definition.

filename Specifies a filename to be used while starting up the instance.

FORCE Shuts down the current Oracle instance (if it is running) with the shutdown option ABORT, before restarting it.

MIGRATE Starts the database in OPEN MIGRATE mode and sets system initialization parameters to specific values required to enable the database upgrade or downgrade scripts to run.

MOUNT Mounts the database; does not open it.

NOMOUNT Causes the database not to be mounted upon instance startup.

OPEN Mounts and opens the database.

OPEN_READ_ONLY

Specifies READ ONLY to restrict users to read-only transactions, and prevent


them from generating redo logs.

OPEN_READ_WRITE

Specifies READ WRITE to open the database in read/write mode, allowing users to generate redo logs. This is the default.

OPEN_READ_WRITE_RECOVER

Specifies READ WRITE to open the database in read/write mode, and

Specifies that media recovery should be performed, if necessary, before starting the instance.

OPEN_RECOVER

Specifies to open the database, and that media recovery should be performed, if necessary, before starting the instance.

QUIET Suppresses the display of System

Global Area information for the starting instance.

RESTRICT Allows only Oracle users with the

RESTRICTED SESSION system privilege to connect to the database.

Shutdown...

symrdb [-h] shutdown -type Oracle

[ABORT | IMMEDIATE | NORMAL |TRANSACTIONAL [LOCAL]] where:

Keyword Description

--------- ----------------------


symrdb 565


ABORT Proceeds with the fastest possible shutdown. Does not wait for calls to complete or users to disconnect.

IMMEDIATE Does not wait for current calls to complete, prohibits further connects, and closes and dismounts the database.

Finally, shuts down the instance.

Does not wait for connected users to disconnect. Does not require instance recovery on next startup.

LOCAL Specifies a transactional shutdown only on the local instance.

NORMAL Waits for currently connected users to disconnect from the database, prohibits further connects, and closes and dismounts the database. Finally, shuts down the instance. Does not require instance recovery on the next startup.

NORMAL is the default option.

TRANSACTIONAL

Shuts down an instance while minimizing interruption to clients.

No client can start a new transaction on the instance.

Stats...

symrdb stats -type Oracle -target

< INSTANCE | SESSION | FILE | ALL > where:

Keyword Description


--------- ----------------------

INSTANCE Specifies instance stats.

SESSION Specifies session stats.

FILE Specifies file stats.

Sybase Startup/Shutdown/Stats Options:

Startup...

symrdb startup -type Sybase

-f runserver_file [-m] [-t delay_time] where:

Keyword Description

--------- ---------------------delay_time Estimated time to startup the

Sybase server in seconds.

-m Starts database in a single user mode.

runserver_file

The absolute path name of a runserver file used as a reference each time you restart a Sybase server.

Shutdown...

symrdb shutdown -type Sybase

[-f srvname] [-w {wait | nowait}] where:

Keyword Description

--------- ----------------------


symrdb 567

Chapter 1: SYMCLI Commands nowait Shuts down the server immediately.

srvname Specifies a logical name by which the backup server is known in the server's sysservers system table.

wait Brings the server down gracefully.

Stats...

symrdb stats -type Sybase -target

< SERVER | OBJECT | DEVICE | ALL > where:

Keyword Description

--------- ----------------------

OBJECT Specifies object stats.

DEVICE Specifies device stats.

SERVER Specifies server stats.

568

SqlServer Startup/Shutdown/Stats Options:

Startup...

symrdb startup -type SqlServer

-s instance [-c] [-f] [-m] [-n] [-x]

[-p master_file_path] [-e error_log_path]

[-l master_log_path] [-g virtual_addr_space]

[-t trace_number] where:

Keyword Description

--------- ----------------------

-c Shortens startup time.

EMC Solutions Enabler CLICommand Reference

-f Starts an instance with minimal configuration.

error_log_path

Names the error log file.

instance Specifies the instance name to start.

-m Starts an instance in single-user mode.

master_file_path

Names the master database file.

master_log_path

Names the master database log file.

-n Does not use the Windows application log to record an SQL Server event.

trace_number

Specifies a trace number.

virtual_addr_space

Displays the amount of virtual address space in megabytes.

-n Does not use the Windows application log to record an SQL Server event.

-x Disables the keeping of CPU time and cache-hit ratio statistics to allow maximum performance.

Shutdown...

symrdb shutdown -type SqlServer -s instance


symrdb 569

Chapter 1: SYMCLI Commands where:

Keyword Description

--------- ---------------------instance Instance name to be shut down.

Stats...

symrdb stats -type SqlServer -target

< INSTANCE | DATABASE | OBJECT | FILE | ALL > where:

Keyword Description

--------- ----------------------

INSTANCE Specifies instance stats.

DATABASE Specifies database stats.

FILE Specifies file stats.

OBJECT Specifies object stats.

IBMUDB Startup/Shutdown/Stats Options:

Startup...

symrdb startup -type IBMUDB

[ [-n node

[ADDNODE -u hostname -p port

[-c computer] [-nt netname]

[NODE | CATALOG -tsn tablespace_node] ] |

[RESTART [-u hostname] [-p port] [-nt netname]] |

[STANDALONE]] ] where:

Keyword or

Option Description


--------- ----------------------

ADDNODE Issues the ADD NODE command.

computer Specifies the computer name.

CATALOG Indicates that the containers for the temporary tablespaces should be the same as those for the catalog node of each database.

hostname Specifies the system name.

netname Specifies the net name.

NODE Indicates that the containers for the temporary tablespaces should be the same as those for the specified node.

node Specifies the node number.

port Specifies the port number.

profile Specifies the name of the profile.

RESTART Issues the RESTART DATABASE command.

STANDALONE Starts the node in STANDALONE mode.

tablespace_node

Specifies the node number from which the temporary tablespace definitions should be obtained.

username/password

Specifies how it is set in the environment variable SYMCLI_RDB_CONNECT.

The parameters are mandatory with


symrdb 571

Chapter 1: SYMCLI Commands option ADDNODE on Windows, but is ignored on other operating systems.

Shutdown...

symrdb shutdown -type IBMUDB

[ [FORCE | DROP] [DROP_ACT | CONTINUE | TERMINATE]

[-f profile] [-n node] ] where:

Keyword or

Option Description

--------- ----------------------

CONTINUE Subsequent call. Continue processing after a prompt.

DROP Drops the node from the db2nodes.cfg

file.

DROP_ACT Initial call.

FORCE Issues the FORCE APPLICATION (ALL) command.

node Specifies the node number.

profile Specifies the name of the profile.

TERMINATE Subsequent call. Terminate processing after a prompt.

Stats...

symrdb stats -type Ibmudb -target

< DATABASE | TABLE | TABLESPACE | ALL >


where:

Keyword Description

--------- ----------------------

DATABASE Specifies database stats.

TABLE Specifies table stats.

TABLESPACE Specifies tablespace stats.

RETURN CODES

Code # Code Symbol

----------------

0 CLI_C_SUCCESS

1 CLI_C_FAIL

EXAMPLES

To define the database login parameters to be user = scott, passwd = tiger, and service = acme, enter: setenv SYMCLI_RDB_CONNECT scott/tiger@acme

To list all tables that reside in tablespace tbl_space1, enter: symrdb -type Oracle -tbs tbl_space1 list TABLE

To display a detailed listing of the table name EMP that resides in schema SCOTT, enter: symrdb -type Oracle -schema SCOTT show TABLE EMP

To display a detailed listing of the table name

SYS$TABLE that resides in tablespace tbl_space1, and to display the extent information in expanded mode


symrdb 573

Chapter 1: SYMCLI Commands and size in megabytes, enter: symrdb -type Oracle -tbs tbl_space1 show TABLE SYS\\$TABLE -expand -mb

To define the database name HR as the default database name, enter: setenv SYMCLI_RDB_NAME HR

To define the database login parameters to be user = sa, passwd = sa_pass, and service = local, enter: setenv SYMCLI_RDB_CONNECT "sa/sa_pass@local"

To list all tablespaces that define the database named master, enter: symrdb -type SQLServer -db master list TBS

To list all files that define the database named master, enter: symrdb -type SQLServer -db master list FILE

To list all tables that reside in the database named master, enter: symrdb -type SQLServer -db master list TABLE

To create a REGULAR device group named newdg with only the R1-BCV devices from the SQL Server database named master, enter: symrdb -type SQLSERVER -db master rdb2dg newdg

-R1 -bcv -dgtype REGULAR


To create a composite group named newcg with the R1 and R1-BCV devices from the Oracle tablespace named tbl_space1, enter: symrdb -type ORACLE -tbs tbl_space1 tbs2cg newcg

-cgtype RDF1 -R1

To start up an Oracle data manager with mode

OPEN READ ONLY, enter: symrdb startup -type ORACLE OPEN_READ_ONLY

To shut down an Oracle data manager with mode

NORMAL, enter: symrdb shutdown -type ORACLE NORMAL

To display statistics about a session of a specified database Oracle every 30 seconds for one hour, enter: symrdb stats -type ORACLE -i 30 -c 120 -target SESSION

H:M:S sessionID memory

A B C

A Time of day

B Session ID

C memory usage per second

NOTE: All the statistics values are per second.


symrdb 575

EMC Solutions Enabler CLI Command Reference

symrdb

Related manuals

Table of contents

EMC Solutions Enabler CLI Command Reference

symrdb

Related manuals

Dell

Solutions Enabler

Dell

Solutions Enabler

Dell

Solutions Enabler

Dell

Solutions Enabler

Table of contents