Command  Home
Scalable Graphic

Soft - is your software and documentation
Asset - is something that must be protected
Management - is what we do
Enterprise - is the capability
Computing - is the power
Services - are what we provide


A.    This command creates a shipping order file for an existing packet file or any other file. The shipping order is used by the shipping server to send the file to one or more destinations. mkorder submits to the shipping server a packet that was created with mkreplica –out or syncreplica –out. You can also use mkorder to resubmit packets whose shipping orders have expired, and to transfer other files among sites. A shipping order must be located in the same directory as its associated packet or file. Note: The shipping server deletes a packet after delivering it successfully (except when the destination is the local host). If you use this command to process a file that must be preserved at your site even after it is delivered to another site, you must specify the –copy option.

B.    Note: If packet-pname contains a colon character ( : ), mkorder changes the colon to a period character ( . ) during processing. This change allows packets to be delivered to Windows machines, which do not allow colons in file names.

C.    If a packet cannot be delivered, it is sent through the store-and-forward facility to the administrator at the site of the originating replica. A mail message is sent to the store-and-forward administrator. This occurs after repeated attempts to deliver the packet have failed and the allotted time has expired; it can also occur when the destination host is unknown or a data file does not exist. The store-and-forward configuration settings specify the expiration period, the e-mail address of the administrator, and the notification program.

D.    The date-time argument can have any of the following formats:

date.time | date | time | now

where: date:

= day-of-week | long-date time:

= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ] day-of-week:

= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat long-date:

= d[d]–month[–[yy]yy] month:

= January |... |December |Jan |... |Dec

Specify the time in 24-hour format, relative to the local time zone. If you omit the time, the default value is 00:00:00. If you omit the date, the default value is today. If you omit the century, year, or a specific date, the most recent one is used. Specify UTC if you want the time to be resolved to the same moment in time regardless of time zone. Use the plus (+) or minus (-) operator to specify a positive or negative offset to the UTC time. If you specify UTC without hour or minute offsets, the default setting is Greenwich Mean Time (GMT). (Dates before January 1, 1970 Universal Coordinated Time (UTC) are not valid.)

E.    If a failure occurs on a Windows host that does not have e-mail notification enabled, a message appears in the Windows Event Viewer. The message includes the e-mail-address value specified with this option and a note requesting that this user be informed of the status of the operation. For information about enabling e-mail notification, see the MultiSite Control Panel reference page.

F.    Specifies the storage class of the packet and shipping order. If you also use –ship or –fship, mkorder looks up the storage class in the shipping.conf file on Linux and the UNIX system or in the MultiSite Control Panel on Windows to determine the location of the storage bay to use. If you omit this option but use –ship or –fship, mkorder places the shipping order in the storage bay location specified for the –default class in the shipping.conf file or the MultiSite Control Panel.

G.    Places the shipping order in the specified file instead of in a storage bay. An error occurs if the file already exists

H.    Creates a shipping order for packet-pname. Using –fship invokes shipping_server to send the packet. Using –ship places the shipping order in a storage bay. To send the packet, run shipping_server or set up invocations of sync_export_list –poll with the schedule command. (See the schedule reference page in the IBM Rational ClearCase Command Reference.) –copy is required with –ship, and optional with –fship: With –copy, mkorder copies the packet-pname file to one of the store-and-forward facility's storage bays and places the shipping order in the bay. The copy is deleted after it is delivered successfully to all the destinations specified in the shipping order. Without –copy, mkorder does not copy packet-pname; mkorder places the shipping order in the directory where the file is located. packet-pname is deleted after it is delivered successfully to all the destinations specified in the shipping order.

I.      One or more host names (which must be usable by hosts in different domains) or IP addresses. When sending a MultiSite packet, you must specify the host where the replica resides or is to be created.

Table of Contents

Table of Contents. 3

How do I use the mkorder command.. 3

1.       to ship a text file to a ClearCase MultiSite host.. 3

2.       to ship a replica/synchronisation packet to a ClearCase MultiSite host.. 4


How do I use the mkorder command

1.   to ship a text file to a ClearCase MultiSite host


To ship the file immediately use


.../etc/mkorder -fship -data /home/myfile.txt vobserver.sydney


To  place a shipping order and the file in the store and forward facility (UNIX: /var/adm/rational/clearcase/shipping/ms_ship/outgoing Windows: xxxxx/shipping/ms_ship/outgoing Windows).


.../etc/mkorder –ship -copy -data /home/myfile.txt vobserver.sydney


If the shipping poll cleartool scheduled task is not running or will not run for sometime then you can use the shipping_server to process the shipping order that has been created for the file.



2.   to ship a replica/synchronisation packet to a ClearCase MultiSite host

Create a shipping order for a replica creation packet but place it in the storage bay for a particular storage class. Attempt immediate delivery (–fship), and allow delivery attempts to continue until the beginning of May 18



.../etc/mkorder–data /var/adm/rational/clearcase/shipping/ms_ship/outgoing/repl_samecs_dev –fship –copy –sclass ClassA –pexpire 18-May vobserver.sydney

Shipping order "/var/adm/rational/clearcase/shipping/ms_ship/outgoing/sclass/ClassA/sh_o_to_repl_samecs_dev" generated.

Attempting to forward/deliver generated packets...

-- Forwarded/delivered packet /var/adm/rational/clearcase/shipping/ms_ship/outgoing/sclass/ClassA/sh_o_to_repl_samecs_dev


This website is published "as is". There is no warranty of any kind (express or implied) as to the operation of our site, the accuracy of the information or the services or products referred to on it. All warranties are excluded as far as permitted at law. Neither we nor any third party will be liable for any losses or damage that may result from use of the website or as a consequence of any inaccuracies in, or any omissions from, the information which it contains.