mkorder

Crea una orden de envío para que el recurso de almacenamiento y reenvío la utilice

Conceptos relacionados
Resolución de problemas en las operaciones con MultiSite
Referencia relacionada
mkreplica
Panel de control de MultiSite
shipping.conf
shipping_server
syncreplica

Aplicabilidad

Producto Tipo de mandato
MultiSite Submandato multiutil
Plataforma
UNIX
Windows

Sinopsis

mkorder
–dat/a nombrev-paquete [ –scl/ass nombre-clase-almacenamiento ] [ –pex/pire fecha-hora ] [ –not/ify dirección-correo-e ] [ –c comentario | –cq | –cqe | –nc ] [ –shi/p –cop/y | –fsh/ip [ –cop/y ] | –out nombrev-pedido ] destino ...

Descripción

Este mandato crea un archivo de orden de envío para un archivo de paquete existente o cualquier otro archivo. El servidor de envíos utiliza la orden de envío para enviar el archivo a uno o varios destinos.

mkorder envía al servidor de envíos un paquete que se creó con mkreplica –out o syncreplica –out. También puede utilizar mkorder para volver a enviar los paquetes cuyas órdenes de envío han caducado y para transferir otros archivos entre sitios. Una orden de envío debe encontrarse en el mismo directorio que su paquete o archivo asociado.

Nota: El servidor de envíos suprime un paquete después de entregarlo satisfactoriamente (salvo cuando el destino es el host local). Si utiliza este mandato para procesar un archivo que debe conservarse en el sitio aunque se entregue en otro sitio, debe especificar la opción –copy.

Restricciones

Ninguna.

Opciones y argumentos

Especificación del archivo de paquete

Valor por omisión
Ninguna.
–dat/a nombrev-paquete
Nombre de vía de acceso del paquete o archivo.
Nota: Si nombrev-paquete contiene un carácter de dos puntos ( : ), mkorder cambia dicho carácter por un carácter de punto ( . ) durante el proceso. Este cambio permite que los paquetes se entreguen a sistemas ejecutando Windows, que no permite caracteres de dos puntos en los nombres de archivo.

Especificación del lugar donde se coloca la orden de envío

Valor por omisión
Crea una orden de envío en el directorio en que se encuentra el archivo nombrev-paquete.
–scl/ass nombre-clase
Especifica la clase de almacenamiento del paquete y la orden de envío. Si también utiliza –ship o –fship, mkorder busca la clase de almacenamiento en el archivo shipping.conf en Linux y en el sistema UNIX o el Panel de control de MultiSite en Windows para determinar la ubicación de la bahía de almacenamiento que desea utilizar.

Si omite esta opción pero utiliza –ship o –fship, mkorder coloca la orden de envío en la ubicación de la bahía de almacenamiento especificada para la clase –default en el archivo shipping.conf o el Panel de control de MultiSite.

–shi/p –cop/y –fsh/ip [ –cop/y ]
Crea una orden de envío para nombrev-paquete. El uso de –fship invoca shipping_server para enviar el paquete. El uso de –ship coloca la orden de envío en una bahía de almacenamiento. Para enviar el paquete, ejecute shipping_server o configure invocaciones de sync_export_list –poll con el mandato schedule. (Consulte la página de referencia de schedule en la publicación IBM Rational ClearCase Command Reference.)

Debe utilizar –copy con –ship; la utilización de –copy con–fship es opcional:

  • Con –copy, mkorder copia el archivo nombrev-paquete en una de las bahías de almacenamiento del recurso de almacenar y reenviar y coloca la orden de envío en la bahía. La copia se suprime después de entregarse satisfactoriamente a todos los destinos especificados en la orden de envío.
  • Sin –copy, mkorder no copia nombrev-paquete; mkorder coloca la orden de envío en el directorio donde se encuentra el archivo. nombrev-paquete se suprime después de entregarse satisfactoriamente a todos los destinos especificados en la orden de envío.
–out nombrev-orden
Coloca la orden de envío en el archivo especificado en vez de hacerlo en una bahía de almacenamiento. Si el archivo ya existe, se producirá un error.

Manejo de anomalías de entrega de paquetes

Valor por omisión
Si no puede entregarse un paquete, éste se envía mediante el recurso de almacenar y reenviar al administrador del sitio de la réplica de origen. Se envía un mensaje al administrador del recurso de almacenar y reenviar. Esto se produce después de que hayan fallado intentos repetidos de entregar el paquete y el tiempo asignado se haya agotado; también puede producirse cuando se desconozca el host de destino o un archivo de datos no exista. Los valores de configuración del recurso de almacenar y reenviar especifican el periodo de caducidad, la dirección de correo electrónico del administrador y el programa de notificación.
–pex/pire fecha-hora
Especifica la hora a la que el recurso de almacenar y reenviar deja de intentar entregar el paquete y genera en su lugar un mensaje de correo de anomalía. Esta opción altera temporalemnte el periodo de caducidad especificado para la clase de almacenamiento en el archivo shipping.conf (UNIX) en el Panel de control de MultiSite (Windows).

El argumento fecha-hora puede tener cualquiera de los formatos siguientes:

fecha.hora | fecha | hora | now
donde:
fecha:
= día-de-semana | fecha-larga
hora:
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
día-de-semana:
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
fecha-larga:
= d[d]mes[[aa]aa]
mes:
= January |... |December |Jan |... |Dec

Especifique la hora en formato de 24 horas, relativa al huso horario local. Si omite la hora, el valor predeterminado es 00:00:00. Si omite la fecha, el valor predeterminado es today (hoy). Si omite el siglo, el año o una fecha específica, se utiliza la más reciente. Especifique UTC si desea que la hora se resuelva en el mismo momento independientemente del huso horario. Utilice el operador más (+) o menos (-) para especificar un desplazamiento positivo o negativo respecto a la hora UTC. Si especifica UTC sin desplazamientos de hora o minuto, el valor predeterminado es GMT (hora del meridiano de Greenwich). (Las fechas anteriores al 1 de enero de 1970 UTC (Hora Universal Coordinada) no son válidas.)

Ejemplos:
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC
–not/ify dirección-correo-e
El mensaje de anomalía de entrega se envía a la dirección de correo electrónico especificada.

Si se produce una anomalía en un host Windows que no tiene habilitada la notificación por correo electrónico, aparecerá un mensaje en el Visor de sucesos de Windows. El mensaje incluye el valor dirección-correo-e especificado con esta opción y una nota que solicita que se informe a este usuario del estado de la operación. Para obtener información sobre cómo habilitar la notificación por correo electrónico, consulte la página de referencia del Panel de control de MultiSite.

Registros de suceso y comentarios

Valor por omisión
–nc (sin comentarios).
–c comentario | –cq | –cqe | –nc
Especifica que se coloque un comentario en la orden de envío. Con –c, la serie del comentario debe ser una única señal de línea de mandatos; habitualmente deberá ir entre comillas. Con –cq y –cqe, el mandato le solicitará un comentario. Con –nc, no se colocará ningún comentario en la orden de envío.

Especificación del destino

Valor por omisión
Ninguna.
destino ...
Uno o más nombres de host (que los hosts deben poder utilizar en distintos dominios) o direcciones IP. Cuando envía un paquete de MultiSite, debe especificar el servidor de sincronización de la réplica.

Ejemplos

En estos ejemplos, las líneas se quiebran para una mayor facilidad de lectura. Debe entrar cada mandato en una sola línea física.

  • Cree una orden de envío para el archivo p1, que se encuentra en la bahía de almacenamiento por omisión. Almacene la orden de envío en la misma bahía de almacenamiento como p1 y especifique que el archivo debe enviarse al 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.
  • Cree una orden de envío en la bahía de almacenamiento por omisión para un archivo especificado que deba entregarse en el host goldengate. Especifique que debe notificarse a admin si el archivo no se entrega satisfactoriamente.
    /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.
  • Cree una orden de envío para el mismo archivo, pero colóquela en la bahía de almacenamiento para una clase de almacenamiento concreta. Intente realizar una entrega inmediata (–fship) y permita que continúen los intentos de entrega hasta el inicio del 18 de mayo.
    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

Archivos

dir_inicio-ccase/config/services/shipping.conf


Comentarios