mkorder

Crée une instruction de livraison utilisée par la fonction store-and-forward

Conditions d'utilisation

Produit Type de commande
MultiSite sous-commande multiutil
Plateforme
UNIX®
Windows®

Syntaxe

mkorder
–dat/a nomchemin-paquet [ –scl/ass nom-classe-stockage ] [ –pex/pire date-heure ] [ –not/ify adresse-e-mail ] [ –c commentaire | –cq | –cqe | –nc ] [ –shi/p –cop/y | –fsh/ip [ –cop/y ] | –out nomchemin-ordre ] destination ...

Description

Cette commande crée un fichier d'instruction de livraison pour un fichier de paquet ou tout autre fichier. L'instruction de livraison est utilisée par le serveur de livraison pour envoyer le fichier à sa ou ses destinations.

mkorder soumet au serveur de livraison un paquet créé avec la commande mkreplica –out ou syncreplica –out. Vous pouvez également utiliser mkorder pour soumettre de nouveau les paquets dont les instructions de livraison ont expiré, et pour transférer des fichiers entre les sites. Une instruction de livraison doit figurer dans le même répertoire que le paquet ou fichier associé.

Remarque : Le serveur de livraison supprime le paquet une fois qu'il a réussi à l'envoyer (sauf lorsque la destination est l'hôte local). Si vous utilisez cette commande pour traiter un fichier qui doit être conservé sur votre site, même après sa livraison à un autre site, vous devez indiquer l'option –copy.

Restrictions

Aucune.

Options et arguments

Indication du fichier de paquet

Valeur par défaut
Aucune.
–dat/a nomchemin-paquet
Nom de chemin du paquet ou du fichier.
Remarque : Si nomchemin-paquet contient un caractère deux points (:), mkorder remplace les deux points par un point (.) pendant le traitement. Ce changement permet de livrer les paquets aux ordinateurs exécutant Windows, qui n'autorisent pas les deux points dans les noms de fichier.

Indication de l'emplacement de stockage de l'instruction de livraison

Valeur par défaut
Crée une instruction de livraison dans le répertoire contenant le fichier nomchemin-paquet.
–scl/ass nom-classe
Indique la classe de stockage du paquet et de l'instruction de livraison. Si vous utilisez également –ship ou –fship, la commande mkorder consulte la classe de stockage indiquée dans le fichier shipping.conf (sous UNIX) ou dans MultiSite Control Panel (sous Windows) pour déterminer l'emplacement de la baie de stockage à utiliser.

Si vous omettez cette option mais utilisez –ship ou –fship, mkorder place l'instruction de livraison dans la baie de stockage indiquée pour la classe –default du fichier shipping.conf ou de MultiSite Control Panel.

–shi/p –cop/y –fsh/ip [ –cop/y ]
Crée une instruction de livraison pour nomchemin-paquet. L'option –fship appelle shipping_server pour envoyer le paquet. L'option –ship place l'instruction de livraison dans une baie de stockage. Pour envoyer le paquet, exécutez shipping_server ou définissez des appels de sync_export_list –poll avec la commande schedule. (Voir la page de référence de schedule dans IBM Rational ClearCase Command Reference.)

Vous devez utiliser –copy avec –ship. L'utilisation de –copy avec –fship est facultative :

  • Avec l'option –copy, mkorder copie le fichier nomchemin-paquet dans l'une des baies de stockage de la fonction store-and-forward et place l'instruction de livraison dans la baie. La copie est supprimée une fois qu'elle a été livrée à toutes les destinations indiquées dans l'instruction de livraison.
  • Sans l'option –copy, mkorder ne copie pas nomchemin-paquet ; mkorder place l'instruction de livraison dans le répertoire contenant le fichier. nomchemin-paquet est supprimé une fois qu'il a été livré à toutes les destinations indiquées dans l'instruction de livraison.
–out nomchemin-ordre
Place l'instruction de livraison dans le fichier précisé, au lieu de la baie de stockage. Une erreur se produit si le fichier existe déjà.

Traitement des échecs de livraison de paquets

Valeur par défaut
Si un paquet ne peut être livré, il est renvoyé à l'administrateur du site de la réplique d'origine, à l'aide de la fonction store-and-forward. Un message électronique est envoyé à l'administrateur store-and-forward. Cette situation survient lorsque plusieurs tentatives de livraison de paquet ont échoué et que le délai alloué est dépassé, si l'hôte de destination est inconnu, ou qu'un fichier de données n'existe pas. Les paramètres de configuration de store-and-forward précisent le délai d'expiration, l'adresse e-mail de l'administrateur et le programme de notification.
–pex/pire date-heure
Indique l'heure à laquelle la fonction store-and-forward arrête d'essayer de livrer le paquet et génère un message électronique d'échec. Cette option supplante le délai d'expiration indiqué pour la classe de stockage dans le fichier shipping.conf (UNIX) ou MultiSite Control Panel (Windows).

L'argument date-heure peut avoir n'importe lequel des formats suivants :

date.heure | date | heure | now
où :
date :
= jour-de-la-semaine | date-longue
heure :
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
jour-de-la-semaine :
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
date-longue:
= d[d]mois[[yy]yy]
mois:
= January |... |December |Jan |... |Dec

Précisez l'heure au format 24 heures, dans le fuseau horaire local. Si vous n'indiquez pas l'heure, la valeur par défaut est 00:00:00. Si vous n'indiquez pas la date, la valeur par défaut est today. Si vous n'indiquez pas le siècle, l'année ou une date spécifique, la valeur la plus récente est utilisée. Précisez UTC si vous souhaitez que l'heure soit résolue quel que soit le fuseau horaire. Utilisez l'opérateur plus (+) ou moins (-) pour indiquer un décalage positif ou négatif par rapport à l'heure UTC. Si vous précisez UTC sans décalage horaire en heure ou minutes, le réglage par défaut est Greenwich Mean Time (GMT). (Les dates antérieures au 1er janvier 1970 Universal Coordinated Time (UTC) ne sont pas valides.)

Exemples :
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC
–not/ify adresse-e-mail
Le message d'échec de livraison est envoyé à l'adresse e-mail indiquée.

En cas d'échec sur un hôte Windows où la notification par e-mail n'est pas activée, un message s'affiche dans l'observateur d'événements de Windows. Il mentionne l'adresse-e-mail indiquée par cette option, ainsi qu'une note demandant d'informer cet utilisateur du statut de l'opération. Pour plus d'informations sur l'activation de la notification par e-mail, voir la page de référence de MultiSite Control Panel.

Enregistrements d'événements et commentaires

Valeur par défaut
–nc (pas de commentaire).
–c commentaire | –cq | –cqe | –nc
Indique le commentaire à insérer dans l'instruction de livraison. Avec l'option –c, la chaîne de commentaires doit être entrée sur la même ligne, en même temps que la commande. En général, vous devez la mettre entre guillemets doubles. Avec les options –cq et –cqe, la commande vous invite à insérer un commentaire. Avec –nc, aucun commentaire n'est inséré dans l'instruction de livraison.

Indication de la destination

Valeur par défaut
Aucune.
destination ...
Un ou plusieurs noms d'hôtes (qui doivent être utilisables par des hôtes appartenant à des domaines différents) ou adresses IP. Lors de l'envoi d'un paquet MultiSite, vous devez indiquer le serveur de synchronisation pour la réplique.

Exemples

Dans ces exemples, chaque commande a été découpée en plusieurs lignes, pour en faciliter la lecture. Cependant, chacune doit être entrée en une seule ligne.

  • Créez une instruction de livraison pour le fichier p1, qui se trouve dans la baie de stockage par défaut. Conservez l'instruction de livraison dans la même baie de stockage que p1, et précisez que le fichier doit être envoyé à l'hôte 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
    Ordre de livraison "c:\Program Files\Rational\ClearCase\var
    \shipping\cq_default\outgoing\p1_order" généré.
  • Créez une instruction de livraison dans la baie de stockage par défaut, pour un fichier défini à livrer à l'hôte goldengate. Indiquez que admin doit être averti si la livraison du fichier a échoué.
    /opt/rational/clearcase/etc/mkorder –data /usr/tmp/to_goldengate –sclass 
    cq_default –ship –copy –notify admin goldengate
    Ordre de livraison "/var/adm/rational/clearcase/shipping/cq_default/outgoing/sh_o_to_
    goldengate" généré.
  • Créez une instruction de livraison pour le même fichier, mais placez-la dans la baie de stockage correspondant à une classe de stockage donnée. Faites une tentative de livraison immédiate (–fship), et autorisez la poursuite des tentatives de livraison jusqu'au 18 mai.
    mkorder –data c:\tmp\to_goldengate –fship –copy –sclass ClassA –pexpire 18-May 
    goldengate
    Ordre de livraison "c:\tmp\sclass\ClassA\sh_o_to_goldengate" généré.
    Tentative de réacheminer/distribuer les paquets générés...
    -- Paquet réacheminé/distribué 
    c:\tmp\sclass\ClassA\sh_o_to_goldengate

Fichiers

rép-principal-ccase/config/services/shipping.conf


Retour d'informations