利用 zmmt 指令來移轉 z/OS 獨立式應用程式伺服器的配置變數
在移轉 WebSphere® Application Server for z/OS® 之前,您必須建立一些要在實際移轉期間執行的「工作控制語言 (JCL)」工作(CNTL 和 DATA 資料集)。 您可以搭配使用 zmmt 指令與回應檔,來建立適當的移轉工作。移轉回應檔含有一組配置變數,可讓您用來建立獨立式應用程式伺服器的移轉工作。

本文討論設定檔配置的移轉。 如果要將應用程式移轉至最新的版本,請使用 WebSphere Application Server Migration Toolkit。 如需相關資訊,請參閱 WASdev 上的 Migration Toolkit。
sptcfg回應檔變數
- 必要關鍵字,指出要建立新的移轉定義
- 是否設定中間符號鏈結
如果您指定中間符號鏈結,就會建立從配置檔案系統指向中間符號鏈結的符號鏈結;否則,所建立的符號鏈結會直接指向產品檔案系統。
- 中間符號鏈結的路徑名稱
這條鏈結將由自訂工作建立,並且指向產品檔案系統目錄。
- 中間符號鏈結的路徑名稱
- 移轉期間建立的設定檔名稱
在 z/OS 平台上,一律是 "default"。
- 應用來寫入產生之移轉定義輸出的完整路徑
- 範本路徑可為下列一值:
- 將包含配置檔案系統的 MVS™ 資料集名稱
在移轉工作建立配置檔案系統時,就會輸入這個名稱。
- 將配置給配置檔案系統的主要磁柱數
在應用程式伺服器中,這個資料集所需的總空間量,會隨所安裝的應用程式大小與數目而增加。
建議事項: 建議的大小下限是 420 個磁柱。 - 將配置給配置檔案系統的次要磁柱數建議事項: 建議的大小下限是 100 個磁柱。
- 要包含上述資料集的 DASD 磁碟機序號,或是 "*",讓 SMS 選取一個磁區
使用 "*" 時,要求先備妥 SMS 自動類別選取 (ACS) 常式,才能選取磁區。如果您未將 SMS 設定成自動處理資料集配置,請明確列出磁區。
- 要寫入應用程式資料與環境檔案的檔案系統目錄裝載點
配置檔案系統是所要移轉之節點配置的實際儲存所在。如果移轉中的節點上已有適當的檔案系統,您可以選擇使用現有的 9.0 版檔案系統。 如果您選擇使用現有的 9.0 版檔案系統,在您執行利用這個工具建立的移轉工作之前,必須確定您在這裡指定的裝載點是存在的。 如果您選擇在移轉中的節點上建立新的 9.0 版檔案系統,必須等到實際移轉程序期間,您執行選用的 BBOMBHFS 或 BBOMBZFS 工作之後,才會實際建立新的檔案系統。 不論哪一種情況,您都必須在這裡指定裝載點的正確值。
- 檔案系統的類型可為下列一值:
- HFS
使用「階層式檔案系統」來配置與裝載配置檔案系統資料集
- ZFS
使用「zSeries 檔案系統」來配置與裝載配置檔案系統資料集
- HFS
- 用於產生之移轉工作的可自訂「工作」陳述式
所有將為您自訂的移轉工作都需要一個工作陳述式。請針對您的安裝架構,輸入有效的工作陳述式。移轉建立程序會在所有產生的工作中,為您更新工作名稱,因此,您不需操心工作陳述式的那一部分。如果需要接續行,請用接續行取代備註行。
- 將包含產生之工作與指示的目標 z/OS 資料集高階限定元註: 您可以指定多層次高階限定元,來作為資料集的高階限定元。
- 您要如何移轉已安裝的應用程式可為下列一值:註: 不論這裡設定了什麼值,WebSphere Application Server 系統應用程式都會進行移轉。
- 用來啟動移轉後之控制器的 JCL 啟動程序名稱
當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定控制器程序的新名稱,或使用舊名稱。
- 用來啟動移轉後之服務者的 JCL 啟動程序名稱
當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定服務者程序的新名稱,或使用舊名稱。
- 用來啟動移轉後之常駐程式的 JCL 啟動程序名稱
當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定常駐程式程序的新名稱,或使用舊名稱。
- 用來啟動移轉後之附屬項的 JCL 啟動程序名稱
當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定附屬項程序的新名稱,或使用舊名稱。
- 要以指定的新名稱 (true) 來更新配置中的 START 指令,或是保留相同的名稱 (false)。
如果您指定了 JCL 程序的新名稱,就必須將 WebSphere Application Server 配置中對應的 START 指令更新成符合新的程序名稱。 如果要執行這項配置更新,請將這個變數指定為 true。
如果您選擇使用相同的程序名稱,請將這個變數指定為 false。對於您要移轉的節點,如果您不希望具有給定程序類型(例如,所有服務者)的所有伺服器皆採用一致的程序名稱,建議您將這個變數指定為 false。在此情況下,必須保留相同的 START 指令,並手動使用移轉期間所產生作為範本的程序,來取代那些程序。
附註: - WASPostUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
- WASPreUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
- 建立設定檔期間,要啟用 (true) 或停用 (false) 追蹤
- 在建立起始目錄、呼叫設定檔與移轉工具,以及移轉的最終處理階段期間,要啟用 (true) 或停用 (false) 追蹤
- 移轉時之來源配置的裝載點
- 移轉時之來源配置的起始目錄
- 配置給 JVM 資料堆的起始記憶體。
- 安裝含有 Snoop、Hello 和 HitCount Servlet 的預設應用程式
- 指定是否部署範例應用程式。註: WebSphere Application Server, Network Deployment Cell 中不支援這些應用程式。
請安裝範例應用程式,以使用應用程式伺服器,並評估最新的技術進展。不建議將範例應用程式部署至正式作業應用程式伺服器環境。
- 在移轉期間,供 Java 虛擬機器用來建立和儲存暫存檔的 Java 暫存目錄。
- 指出來源設定檔是否向管理代理程式登錄。
- 配置給 JVM 資料堆的資料堆大小上限。
- 來源管理代理程式的主機名稱。
- 若有啟用安全,此為來源管理代理程式的管理安全密碼。
- 來源管理代理程式的檔案系統路徑。
- 來源管理代理程式使用的 SOAP 連線埠。
- 若有啟用安全,此為來源管理代理程式的使用者名稱。
- 目標管理代理程式的主機名稱。
- 若有啟用安全,此為目標管理代理程式的管理安全密碼。
- 目標管理代理程式的檔案系統路徑。
- 目標管理代理程式使用的 SOAP 連線埠。
- 若有啟用安全,此為目標管理代理程式的使用者名稱。
- WebSphere Application Server for z/OS 編目程序將複製到其中的現有的程序檔案庫
- 指定下列其中一值,來定義如何處理埠衝突。
- 指定下列其中一值,來定義要在新設定檔中使用哪些埠值。
- WebSphere Application Server 9.0 版安裝的產品檔案系統的位置
- 寫入先前配置的備份和移轉追蹤的目錄。
移轉期間,需要舊版配置的備份副本。這個備份的預設位置為 /tmp/migrate。 如果 /tmp 檔案系統沒有足夠的空間來儲存備份配置,您可以指定另一個位置。 如果您選擇置換備份副本的預設位置,最佳作法是保留相同的命名慣例,而只用另一個路徑來取代 /tmp 部分,例如 /myTemp/migrate。
- 在暫存目錄下建立目錄,以包含暫時移轉資料集與備份配置資料時,要使用的 ID
- 移轉時之目標配置的裝載點
此值與指定給 zConfigMountPoint 變數的值相同。
- 移轉時之目標配置的起始目錄
- 要移轉儲存在預設工作區使用者根目錄位置 (D) 中的管理主控台自訂「我的作業」設定,或是移轉儲存在使用者定義之工作區根目錄位置 (U) 中的設定
- 使用者定義的工作區根目錄位置
- 是否設定中間符號鏈結
如果您指定中間符號鏈結,就會建立從配置檔案系統指向中間符號鏈結的符號鏈結;否則,所建立的符號鏈結會直接指向產品檔案系統。
- 中間符號鏈結的路徑名稱
這條鏈結將由自訂工作建立,並且指向產品檔案系統目錄。
- 中間符號鏈結的路徑名稱
移轉獨立式應用程式伺服器的回應檔範例
create
EnableIntermediateSymlink=false
EnableJavaTmpDir=true
intermediateSymlinkPreference=N
profileName=default
profilePath=<root>/profiles/ZMigSASrv01
templatePath=<root>/profileTemplates/zos-migStandalone
zConfigHfsName=OMVS.WAS90.CONFIG.HFS
zConfigHfsPrimaryCylinders=420
zConfigHfsSecondaryCylinders=100
zConfigHfsVolume=*
zConfigMountPoint=/wasv9config
zFilesystemType=HFS
zJobStatement1=(ACCTNO,ROOM),'USERID',CLASS=A,REGION=0M
zJobStatement2=//*
zJobStatement3=//*
zJobStatement4=//*
zTargetHLQ=SAS
zmbAdjunctProcName=BBO9CRA
zmbAppInstallDirLine1=/wasv9config/AppServer/profiles/default/installedApps
zmbAppInstallDirLine2=
zmbAppMigrationPreference=D
zmbControllerProcName=BBO9ACR
zmbDaemonProcName=BBO9DMN
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=AppServer
zmbInitialHeapSize=512
zmbInstallDefaultApp=false
zmbInstallSamples=false
zmbJavaTempDirectory=/tmp
zmbManagedBaseNode=true
zmbMaxHeapSize=768
zmbNewAdminAgentHostname=localhost
zmbNewAdminAgentProfilePath=/WebSphere/V9R0/AdminAgent
zmbNewAdminAgentSoapPort=8880
zmbOldAdminAgentHostname=localhost
zmbOldAdminAgentProfilePath=/WebSphere/V7R0/AdminAgent
zmbOldAdminAgentSoapPort=8879
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9ASR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05160419
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=AppServer
zmbWorkspaceRootPreference=D