mkorder

建立由儲存及轉遞機能所使用的移轉順序

適用性

產品 指令類型
MultiSite multiutil 次指令
平台
UNIX®
Windows®

用法概要

mkorder
–dat/a packet-pname [ –scl/ass storage-class-name ] [ –pex/pire date-time ] [ –not/ify e-mail-address ] [ –c comment | –cq | –cqe | –nc ] [ –shi/p –cop/y | –fsh/ip [ –cop/y ] | –out order-pname ] destination ...

說明

這個指令為一個現有的封包檔案或任何其他檔案建立一個移轉順序檔案。移轉伺服器會利用移轉順序, 將檔案傳送到一個或多個目的地。

mkorder 對移轉伺服器送出以 mkreplica –out or syncreplica –out 建立的封包。您也可以使用 mkorder 重送移轉順序已過期的封包, 並且在站台之間轉送其他檔案。移轉順序必須位於和其相關聯的封包或檔案相同的目錄中。

註: 移轉伺服器 將封包順利遞送之後加以刪除(目的地為本端主機時除外)。如果您使用這個指令來處理必須保存於您的站台上之檔案,即使它已被遞送至另一個站台,您還是必須指定 –copy 選項。

限制

無。

選項及引數

指定封包檔案

預設
無。
–dat/a packet-pname
封包或檔案的路徑名稱。
註: 如果 packet-pname 包含一個冒號字元 (:),mkorder 在處理程序期間會將冒號變更為句號字元 (.)這是在處理期間完成的。這項變更可讓封包分送到執行 Windows 且不容許檔名中有冒號的電腦。

指定放置移轉順序的位置

預設
packet-pname 檔案所在的目錄中建立移轉順序。
–scl/ass class-name
指定封包及移轉順序的儲存類別。若同時還使用 –ship–fship,則 mkorder 會在 Linux 和 UNIX 系統上查閱 shipping.conf 檔中的儲存類別,或在 Windows 上查閱「多站台控制台」中的儲存類別,以判斷所要使用的儲存體儲存區位置。

若省略此選項,但使用 –ship–fship,則 mkorder 會在針對在 shipping.conf 檔或「多站台控制台」中的 –default 類別指定的儲存體儲存區位置中放置移轉順序。

–shi/p –cop/y –fsh/ip [ –cop/y ]
packet-pname 建立移轉順序。使用 –fship 呼叫shipping_server 來傳送封包。使用 –ship 在儲存體儲存區中放置移轉順序。如果要傳送封包,請執行 shipping_server 或以 schedule 指令設定 sync_export_list –poll 的呼叫。(請參閱 IBM Rational ClearCase 指令參考手冊 中的 schedule 參照頁面。)

您必須搭配 –ship 使用 –copy;搭配 –fship 使用 –copy,則是選用作法:

  • 利用 –copymkorderpacket-pname 檔案複製到儲存及轉遞機能的儲存體儲存區之一,並在儲存區中放置移轉順序。將複本成功傳送到移轉順序中指定的所有目的地之後, 會將複本刪除。
  • 沒有 –copymkorder 就不會複製 packet-pnamemkorder 在檔案所在的目錄中放置移轉順序。將 packet-pname 成功傳送到移轉順序中 指定的所有目的地之後,會加以刪除。
–out order-pname
在指定的檔案而非儲存體儲存區中放置移轉順序。如果檔案已存在,就會有錯誤發生。

處理封包遞送失敗

預設
如果無法遞送封包,會透過儲存及轉遞機能傳送給起源之複本的站台管理者。郵件訊息會傳送給儲存及轉遞管理者。一再試圖遞送封包失敗,而且分配的時間過期之後,就會發生這種情況;目的地主機不明或是資料檔不存在,也會發生這種情況。儲存及轉遞配置設定會指定期限、管理者的電子郵件位址以及通知程式。
–pex/pire date-time
指定儲存及轉遞機能停止嘗試遞送封包並產生失敗郵件訊息的時間。這個選項置換針對在 shipping.conf 檔案 (UNIX) 或「多站台控制台」(Windows) 中的儲存類別所指定的期限。

date-time 引數可以擁有下列任一格式:

date.time | date | time | now
其中:
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

依照當地時區,以 24 小時制指定時間。 如果省略時間,預設值是 00:00:00。如果省略 date,預設值是 today。 如果省略世紀、年份或特定日期,則會使用最近的世紀、年份或日期。 如果您希望不論時區為何,都將時間解析成相同時刻,請指定 UTC。 您可以使用加號 (+) 或減號 (-) 運算子來指定 UTC 時間的正負時差。如果您指定 UTC,而不含小時或分鐘時差, 預設值是格林威治標準時間 (GMT)。(1970 年 1 月 1 日世界標準時間 (UTC) 之前的日期無效。)

範例:
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC
–not/ify e-mail-address
會將遞送失敗的訊息傳送到指定的電子郵件位址。

若在未啟用電子郵件通知的 Windows 主機上發生失敗,Windows Event Viewer 中會顯示一則訊息。這個訊息包含以此選項指定的 e-mail-address 值,以及要求通知這位使用者作業狀態的一項附註。 如需啟用電子郵件通知的相關資訊,請參閱 MultiSite 控制台 參照頁面。

事件記錄及註解

預設
–nc(無註解)。
–c comment | –cq | –cqe | –nc
指定要放到移轉順序中的註解。使用 –c,註解字串必須是單一指令行記號;一般來說,您必須以雙引號加以含括。使用 –cq–cqe,這個指令提示您輸入註解。使用 –nc,沒有註解置於移轉順序中。

指定目的地

預設
無。
destination ...
一個或多個主機名稱(必須能讓不同網域的主機使用)或 IP 位址。傳送 MultiSite 封包時,您必須為複本指定同步化伺服器。

範例

在這些範例中會斷行以便於閱讀,您必須在實際的一行中輸入每一個指令。

  • 針對位於預設儲存體儲存區中的檔案 p1 建立移轉順序。 將相同儲存體儲存區中的移轉順序儲存為 p1,並指定將檔案傳送到主機 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.
  • 針對要遞送到主機 goldengate 的指定檔案,在預設的儲存體儲存區中建立移轉順序。 指定如果未成功遞送檔案時,必須通知 admin
    /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.
  • 針對相同的檔案建立移轉順序,但是將此移轉順序放在特定儲存類別的儲存體儲存區中。試圖立即遞送 (–fship),並容許試圖遞送的作業繼續下去,直到 5 月 18 日那天為止。
    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

檔案

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


意見