mkorder

Crea un ordine di invio per utilizzare la funzione di memorizzazione e inoltro

Applicabilità

Prodotto Tipo di comando
MultiSite comando secondario multiutil
Piattaforma
UNIX
Windows

Riepilogo

mkorder
–dat/a nomep-pacchetto [ –scl/ass nome-classe-memorizzazione ] [ –pex/pire data-ora ] [ –not/ify indirizzo-e-mail ] [ –c commento | –cq | –cqe | –nc ] [ –shi/p –cop/y | –fsh/ip [ –cop/y ] | –out nomep-ordine ] destinazione ...

Descrizione

Questo comando crea un file di ordini di invio per un file del pacchetto esistente o qualsiasi altro file. Il server di invio utilizza l'ordine di invio per inviare il file ad una o più destinazioni.

mkorder inoltra un pacchetto al server di invio creato con mkreplica –out o syncreplica –out. È anche possibile utilizzare mkorder per reinoltrare i pacchetti i cui ordini di invio sono scaduti e per trasferire altri file tra i siti. L'ordine di invio deve essere situato nella stessa directory del pacchetto o del file associato.

Nota: il server di invio elimina un pacchetto dopo averlo consegnato correttamente (tranne quando la destinazione è l'host locale). Se si utilizza questo comando per elaborare un file che deve essere conservato nel sito anche dopo che tale file è stato consegnato in un altro sito, è necessario specificare l'opzione –copy.

Limitazioni

Nessuno.

Opzioni ed argomenti

Specifica del file del pacchetto

Valore predefinito
Nessuno.
–dat/a nomep-pacchetto
Il nome del percorso del pacchetto o file.
Nota: se nomep-pacchetto contiene il carattere due punti ( : ),mkorder modifica i due punti in un punto ( . ) durante l'elaborazione. Questa modifica consente ai pacchetti di essere consegnati ai computer Windows, che non consentono i due punti nei nomi dei file.

Specifica dell'ubicazione dell'ordine di invio

Valore predefinito
Crea un ordine di invio nella directory dove è contenuto il file nomep-pacchetto.
–scl/ass nome-classe
Specifica la classe di memoria del pacchetto e dell'ordine di invio. Se si utilizza anche –ship o –fship, mkorder cerca la classe di memoria nel file shipping.conf in Linux e UNIX o nel pannello di controllo MultiSite in Windows per determinare il percorso del vano di memoria da utilizzare.

Se si omette questa opzione ma su utilizza –ship o –fship, mkorder pone l'ordine di invio nell'ubicazione del vano di memoria specificata per la classe –default nel file shipping.conf o nel Pannello di controllo MultiSite.

–shi/p –cop/y –fsh/ip [ –cop/y ]
Crea un ordine di invio per nomep-pacchetto. Utilizzando –fship viene richiamato shipping_server per inviare il pacchetto. Mediante –ship l'ordine di invio viene posto nel vano di memoria. Per inviare il pacchetto, eseguire shipping_server o impostare i richiami di sync_export_list –poll con il comando schedule. (Consultare la pagina di riferimento di schedule nel manuale IBM Rational ClearCase Command Reference.)

È necessario utilizzare –copy con –ship; l'utilizzo di –copy con –fship è facoltativo:

  • Con –copy, mkorder copia il file nomep-pacchetto in uno dei vani di memoria della funzione di memorizzazione ed inoltro e inserisce l'ordine di invio nel vano. La copia viene eliminata dopo la consegna corretta a tutte le destinazioni specificate nell'ordine di invio.
  • Senza –copy, mkorder non copia nomep-pacchetto; mkorder inserisce l'ordine di invio nella directory in cui è contenuto il file. nomep-pacchetto viene eliminato dopo la consegna corretta a tutte le destinazioni specificate nell'ordine di invio.
–out nomep-ordine
Inserisce l'ordine di invio nel file specificato e non in un vano di memoria. Se si verifica un errore se il file già esiste.

Gestione degli errori relativi alla consegna del pacchetto

Valore predefinito
Se un pacchetto non può essere consegnato, esso viene inviato mediante la funzione di memorizzazione e inoltro all'amministratore nel sito della replica di origine. Viene inviato un messaggio di posta all'amministratore di memorizzazione e inoltro. Questo si verifica dopo vari tentativi di consegna del pacchetto non riusciti quando il tempo assegnato è scaduto; ciò si verifica anche quando l'host di destinazione è sconosciuto o il file di dati non esiste. Le impostazioni di configurazione di memorizzazione ed inoltro specificano il periodo di scadenza, l'indirizzo e-mail dell'amministratore e il programma di notifica.
–pex/pire data-ora
Specifica l'ora in cui la funzione di memorizzazione ed inoltro interrompe i tentativi di consegna del pacchetto e genera, invece, un messaggio di posta di errore. Questa opzione sovrascrive il periodo di scadenza specificato per la classe di memorizzazione nel file shipping.conf file (UNIX) o nel pannello di controllo MultiSite (Windows).

L'argomento data-ora può disporre di uno dei seguenti formati:

data.ora | data | ora | now
dove:
data:
= giorno-della-settimana | data-lunga
ora:
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
giorno-della-settimana:
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
data-lunga:
= g[g]mese[[aa]aa]
mese:
= January |... |December |Jan |... |Dec

Specificare l'ora nel formato 24 ore, relativa al fuso orario locale. Se si omette l'ora, il valore predefinito è 00:00:00. se si omette la data, il valore predefinito è today. Se si omette il secolo, l'anno o una data specifica, viene utilizzata quella più recente. Specificare UTC se si desidera utilizzare l'ora da risolvere simultaneamente senza considerare il fuso orario. Utilizzare l'operatore più (+) o meno (-) per specificare la variazione positiva o negativa per l'ora UTC. Se si specifica UTC senza le variazioni dei minuti e delle ore, l'impostazione predefinita è GMT (Greenwich Mean Time). (Le date precedenti al 1° Gennaio 1970 UTC (Universal Coordinated Time) non sono valide.)

Esempi:
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • ERROR! SEGMENT DATA CORRUPTED, SEGDATA=0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC
–not/ify indirizzo-e-mail
Il messaggio di errore di consegna viene inviato all'indirizzo e-mail specificato.

Se si verifica un errore su un host Windows che non ha la notifica e-mail abilitata, viene visualizzato un messaggio nel Visualizzatore di eventi Windows. Il messaggio include il valore indirizzo-e-mail specificato con questa opzione e una nota che richiede a questo utente di essere informato sullo stato dell'operazione. Per informazioni sull'abilitazione della notifica e-mail, consultare la pagina di riferimento del Pannello di controllo MultiSite.

Record di eventi e commenti

Valore predefinito
–nc (nessun commento).
–c commento | –cq | –cqe | –nc
Specifica un commento da inserire nell'ordine di invio. Con –c, la stringa di commento deve essere un token della riga comandi singolo; di solito, è necessario racchiuderla tra virgolette. Con –cq e –cqe, il comando richiede un commento dell'utente. Con –nc, non viene posto alcun commento nell'ordine di invio.

Specifica della destinazione

Valore predefinito
Nessuno.
destinazione ...
Uno o più nomi host (che devono poter essere utilizzati dagli host in diversi domini) o indirizzi IP. Quando si invia un pacchetto MultiSite, è necessario specificare il server di sincronizzazione per la replica.

Esempi

In questi esempi, le righe sono interrotte per agevolare la lettura. È necessario immettere ogni comando su una singola riga.

  • Creare un ordine di invio per il file p1, ubicato nel vano di memoria predefinito. Memorizzare l'ordine di invio nello stesso vano di memoria di p1 e specificare che il file deve essere inviato all'host goldengate.
    mkorder –data "c:\Program Files\Rational\ClearCase\var\shipping\cq_default\
    outgoing\p1" –sclass cq_default  –out "c:\Program Files\Rational\ClearCase\var\
    shipping\cq_default\outgoing\p1_order" goldengate
    Shipping order "c:\Program Files\Rational\ClearCase\var
    \shipping\cq_default\outgoing\p1_order" generated.
  • Creare un ordine di invio nel vano di memoria predefinito per un file specificato che deve essere consegnato all'host goldengate. Indicare che l'amministratore (admin) deve essere informato con una notifica se il file non viene consegnato correttamente.
    /opt/rational/clearcase/etc/mkorder –data /usr/tmp/to_goldengate –sclass 
    cq_default –ship –copy –notify admin goldengate
    Shipping order "/var/adm/rational/clearcase/shipping/cq_default/outgoing/sh_o_to_
    goldengate" generated.
  • Creare un ordine di invio per lo stesso file, ma posizionarlo nel vano di memoria per una classe di memorizzazione particolare. Tentare la consegna immediata (–fship) e consentire altri tentativi di consegna fino al 18 Maggio.
    mkorder –data c:\tmp\to_goldengate –fship –copy –sclass ClassA –pexpire 18-May 
    goldengate
    Shipping order "c:\tmp\sclass\ClassA\sh_o_to_goldengate" generated.
    Attempting to forward/deliver generated packets...
    -- Forwarded/delivered packet 
    c:\tmp\sclass\ClassA\sh_o_to_goldengate

File

ccase-home-dir/config/services/shipping.conf


Feedback