cqreg

Gestisce le informazioni sulla serie di database e sulla connessione database nel registro ClearQuest sul sistema UNIX e Linux

Riepilogo

Il comando cqreg si trova nella directory bin della directory di installazione ClearQuest.

Descrizione

È possibile creare, eliminare e spostare i database ClearQuest solo su un sistema Windows utilizzando il Tool di manutenzione oppure il Designer. Si utilizza il comando cqreg per gestire le informazioni di connessione associate alle serie di database e ai database ClearQuest in modo da poter accedere ai database sul sistema UNIX e Linux. Il comando cqreg consente di eseguire queste attività:

  • Notificare le informazioni sui database registrati
  • Associare una directory di installazione ClearQuest a una directory di registro database
  • Stabilire una connessione a un repository di schemi e aggiornare il registro database dopo che un database è stato creato o eliminato utilizzando il Tool di manutenzione o il Designer

È anche possibile aggiungere e rimuovere connessioni database dal client ClearQuest in esecuzione su un sistema UNIX o Linux.

Opzioni ed argomenti

-dbset dbset_name
Nome della connessione database. Per impostazione predefinita, questa è la versione ClearQuest.
-all
Esegue il comando su tutte le serie di database e i database in esse contenuti.
-verbose
-errors
-terse
Controlla la quantità di output visualizzata dal comando. Se omesso, per impostazione predefinita è -errors.
-effort_only
Visualizza cosa fa il sottocomando senza eseguire l'azione associata.
-force
Forza il sottocomando a sostituire i dati o i file di registro esistenti che altrimenti non verrebbero sovrascritti.
-home cq_home
Identifica la directory di installazione di ClearQuest. Questo valore sovrascrive il valore della variabile di ambiente $CQ_HOME, se impostata.
-version version
Utilizzare con il sottocomando cqreg show per identificare la versione del prodotto ClearQuest a cui si applica il sottocomando. Se questa opzione viene omessa, viene utilizzata la versione associata alla release corrente.
-cq_databases cq_databases
Specifica l'ubicazione di directory nella quale vengono memorizzate le connessioni database. Questo valore sovrascrive il valore della variabile di ambiente $CQ_DATABASES, se impostata.
-associate
Utilizzare con il sottocomando cqreg initialize per associare la directory di installazione ClearQuest con una directory di registro database. Se questa opzione viene omessa, il sottocomando cqreg initialize inizializza solo la directory di registro, senza effettuare l'associazione.
registry_directory
Utilizzare con il sottocomando cqreg initialize per specificare la directory di registro. Se questa opzione viene omessa, viene utilizzato uno dei seguenti valori, elencati in ordine decrescente:
  • Il valore di -cq_databases cq_databases, se specificato
  • Il valore della variabile di ambiente $CQ_DATABASES, se impostata
  • Il valore predefinito
-v/endor db_vendor
Il fornitore del database. Sono validi i seguenti valori:
  • Oracle
  • SQL_Server
  • DB2
-s/erver server
Il server di database.
-d/atabase db_name
Per DB2 e SQL Server, il nome del database utilizzato per il repository di schemi. Per Oracle, il SID (System Identifier) del sistema di gestione database.
-u/ser user_name
Il nome utente per accedere al database.
-p/assword password
La password per accedere al database.
-co connect_options
Le opzioni di connessione. Rivolgersi all'amministratore di sistema per le opzioni di connessione specifiche per l'ambiente. Consultare anche l'argomento della guida relativo all'amministrazione di Rational ClearQuest nelle proprietà del database del fornitore.
-help
Visualizza informazioni sull'utilizzo

Sottocomandi

cqreg show
Notifica le informazioni di connessione per le serie di database e i database registrati.
cqreg initialize
Associa una directory di installazione ClearQuest a una directory di registro database. Se il file .Databases già esiste quando si esegue il sottocomando cqreg initialize, esso non viene sostituito a meno che non si utilizzi l'opzione -force.
Attenzione: Il sottocomando cqreg initialize viene eseguito come parte dell'installazione di ClearQuest. Eseguire questo sottocomando solo se si desidera associare una directory di installazione ClearQuest a una directory di registro database differente.
cqreg add_dbset
Registrare una serie di database e i database nel registro ClearQuest o aggiornare le informazioni di connessione esistenti. Eseguire questo sottocomando dopo aver creato il repository di schemi e i database utente utilizzando il Designer.
cqreg register
Questo sottocomando è obsoleto. Utilizzare invece il comando cqreg add_dbset .
cqreg drop_dbset
Annullare la registrazione di una serie di database e dei database dal registro ClearQuest. Eseguire questo sottocomando dopo che una serie di database è stata spostata a un host differente per annullare la registrazione della serie di database. Eseguire quindi il comando cqreg add_dbset per registrare la serie di database sul nuovo host.

Se non si specifica un nome connessione con, rispettivamente, l'opzione e l'argomento -dbset dbset_name quando si esegue il sottocomando cqreg drop_dbset, viene utilizzata la connessione predefinita.

cqreg unregister
Questo sottocomando è obsoleto. Utilizzare invece il comando cqreg drop_dbset .
cqreg refresh
Aggiorna il registro database dalle informazioni nel repository di schemi. Utilizzare questo sottocomando dopo aver utilizzato il Tool di manutenzione o il Designer per creare, modificare o eliminare un database o dopo aver spostato i repository di schemi e i database. Se il sottocomando cqreg refresh non ristabilisce la connessione, utilizzare i sottocomandi cqreg drop_dbset e cqreg add_dbset per eliminare e ricreare le informazioni di connessione database.

Esempi

  • Mostrare le informazioni di connessione su tutte le serie di database e tutti i database registrati:
    cqreg show -all
  • Aggiornare il registro database per la serie di dati UCM_dbset con le informazioni nel repository di schemi:
    cqreg refresh -dbset UCM_dbset
  • I seguenti sono degli esempi di aggiunta di connessioni rispettivamente per i database Oracle, SQL Server e DB2:
    Per Oracle:
    cqreg add_dbset -v Oracle -s cqtest1 -d CQ1 -u admin -p admin_pwd -dbset CQ_DEV1 -co "PORT=50100"
    Per SQL Server:
    cqreg add_dbset -v SQL_Server -s cqtest2 -d msitea -u admin -p pwd -dbset CQ_DEV1 
    Per DB2:
    cqreg add_dbset -v DB2 -s db2tcpnode -d msiteb -u admin -p pwd -dbset CQ_DEV3
  • Annullare la registrazione della serie di database UCM_dbset:
    cqreg drop_dbset -dbset UCM_dbset

Feedback