利用 zmmt 指令來移轉 z/OS 聯合節點的配置變數

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

支援的配置 支援的配置:

本文討論設定檔配置的移轉。 如果要將應用程式移轉至最新的版本,請使用 WebSphere Application Server Migration Toolkit。 如需相關資訊,請參閱 WASdev 上的 Migration Toolkit

sptcfg

回應檔變數

create
必要關鍵字,指出要建立新的移轉定義
intermediateSymlinkPreference
是否設定中間符號鏈結

如果您指定中間符號鏈結,就會建立從配置檔案系統指向中間符號鏈結的符號鏈結;否則,所建立的符號鏈結會直接指向產品檔案系統。

IntermediateSymlink
中間符號鏈結的路徑名稱

這條鏈結將由自訂工作建立,並且指向產品檔案系統目錄。

profileName
移轉期間建立的設定檔名稱

在 z/OS 平台上,一律是 default

profilePath
應用來寫入產生之移轉定義輸出的完整路徑
templatePath
範本路徑
可為下列一值:
  • zos-migDmgr

    移轉部署管理程式

  • zos-migFederated

    移轉聯合節點

  • zos-migStandalone

    移轉獨立式應用程式伺服器

zConfigHfsName
將包含配置檔案系統的 MVS™ 資料集名稱

在移轉工作建立配置檔案系統時,就會輸入這個名稱。

zConfigHfsPrimaryCylinders
將配置給配置檔案系統的主要磁柱數

在應用程式伺服器中,這個資料集所需的總空間量,會隨所安裝的應用程式大小與數目而增加。

建議事項: 建議的大小下限是 420 個磁柱。
zConfigHfsSecondaryCylinders
將配置給配置檔案系統的次要磁柱數
建議事項: 建議的大小下限是 100 個磁柱。
zConfigHfsVolume
要包含上述資料集的 DASD 磁碟機序號,或是 "*",讓 SMS 選取一個磁區

使用 "*" 時,要求先備妥 SMS 自動類別選取 (ACS) 常式,才能選取磁區。如果您未將 SMS 設定成自動處理資料集配置,請明確列出磁區。

zConfigMountPoint
要寫入應用程式資料與環境檔案的檔案系統目錄裝載點
zFilesystemType
檔案系統的類型
可為下列一值:
  • HFS

    使用「階層式檔案系統」來配置與裝載配置檔案系統資料集

  • ZFS

    使用「zSeries 檔案系統」來配置與裝載配置檔案系統資料集

zJobStatement1 . . . n
用於產生之移轉工作的可自訂「工作」陳述式

所有將為您自訂的移轉工作都需要一個工作陳述式。請針對您的安裝架構,輸入有效的工作陳述式。移轉建立程序會在所有產生的工作中,為您更新工作名稱,因此,您不需操心工作陳述式的那一部分。如果需要接續行,請用接續行取代備註行。

zTargetHLQ
將包含產生之工作與指示的目標 z/OS 資料集高階限定元
註: 您可以指定多層次高階限定元,來作為資料集的高階限定元。
zmbAdminUserid
管理所移轉的節點時,要使用的管理者使用者 ID

必須提供此項,才能在移轉程序期間執行必要的管理動作。

zmbAdminPassword
管理所移轉的節點時,要使用的管理者使用者 ID 密碼

必須提供此項,才能在移轉程序期間執行必要的管理動作。

zmbControllerProcName
用來啟動移轉後之控制器的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定控制器程序的新名稱,或使用舊名稱。

zmbServantProcName
用來啟動移轉後之服務者的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定服務者程序的新名稱,或使用舊名稱。

zmbDaemonProcName
用來啟動移轉後之常駐程式的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定常駐程式程序的新名稱,或使用舊名稱。

zmbAdjunctProcName
用來啟動移轉後之附屬項的 JCL 啟動程序名稱

當移轉至 9.0 版時,您必須升級您的 JCL 啟動程序。 移轉期間,會為您產生新的啟動程序。您可以指定附屬項程序的新名稱,或使用舊名稱。

zmbReplaceStartedProcedureNames
要以指定的新名稱 (true) 來更新配置中的 START 指令,或是保留相同的名稱 (false)。

如果您指定了 JCL 程序的新名稱,就必須將 WebSphere Application Server 配置中對應的 START 指令更新成符合新的程序名稱。 如果要執行這項配置更新,請將這個變數指定為 true。

如果您選擇使用相同的程序名稱,請將這個變數指定為 false。對於您要移轉的節點,如果您不希望具有給定程序類型(例如,所有服務者)的所有伺服器皆採用一致的程序名稱,建議您將這個變數指定為 false。在此情況下,必須保留相同的 START 指令,並手動使用移轉期間所產生作為範本的程序,來取代那些程序。

附註:
  • 您的 9.0 版配置所使用的 JCL 程序,必須有別於 7.0 版配置所使用的 JCL 程序。移轉程序會利用這裡指定的程序名稱來建立新的 9.0 版 JCL 程序。
  • 如果您沿用您在 7.0 版配置中使用的相同名稱,移轉程序會與現有程序重疊。如果您使用相同名稱,在執行移轉工作之前,請確定已備份現有的 7.0 版程序,以防日後您需要回復。
zmbEnablePostUpgradeTrace
WASPostUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
zmbEnablePreUpgradeTrace
WASPreUpgrade 程序期間,要啟用 (true) 或停用 (false) 追蹤
zmbEnableProfileTrace
建立設定檔期間,要啟用 (true) 或停用 (false) 追蹤
zmbEnableScriptingTrace
在建立起始目錄、呼叫設定檔與移轉工具,以及移轉的最終處理階段期間,要啟用 (true) 或停用 (false) 追蹤
zmbFromConfigRoot
移轉時之來源配置的裝載點
zmbFromWASHomeDir
移轉時之來源配置的起始目錄
zmbInitialHeapSize
配置給 JVM 資料堆的起始記憶體。
zmbJavaTempDirectory
在移轉期間,供 Java 虛擬機器用來建立和儲存暫存檔的 Java 暫存目錄。
zmbMaxHeapSize
配置給 JVM 資料堆的資料堆大小上限。
zmbProclibName
WebSphere Application Server for z/OS 編目程序將複製到其中的現有的程序檔案庫
zmbResolvePortConflicts
指定下列其中一值,來定義如何處理埠衝突。
  • incrementCurrent

    如果偵測到埠衝突,會從衝突埠來增量埠值,以成為下一個可用的埠值。

  • startingPort
    如果偵測到埠衝突,會從指定值來增量埠值,以成為下一個可用的埠值。
    註: 如果 zmbResolvePortConflictszmbSetPorts 都設為 startingPort,會忽略 zmbResolvePortConflicts 變數。
    zmbStartingPort
    要藉以產生新埠的起始埠值。
zmbSetPorts
指定下列其中一值,來定義要在新設定檔中使用哪些埠值。
  • useOld

    重複使用定義在來源設定檔中的埠值。

  • generateNew

    在目標設定檔中,為每一埠設定自訂值。

  • startingPort

    從指定的埠值增量,來產生新埠。系統會自動解決衝突埠。

    zmbStartingPort
    要藉以產生新埠的起始埠值。
zmbSMPEHome
WebSphere Application Server 9.0 版安裝的產品檔案系統的位置
zmbTempDirectory
寫入先前配置的備份和移轉追蹤的目錄。

移轉期間,需要舊版配置的備份副本。這個備份的預設位置為 /tmp/migrate。 如果 /tmp 檔案系統沒有足夠的空間來儲存備份配置,您可以指定另一個位置。 如果您選擇置換備份副本的預設位置,最佳作法是保留相同的命名慣例,而只用另一個路徑來取代 /tmp 部分,例如 /myTemp/migrate

zmbTimestamp
在暫存目錄下建立目錄,以包含暫時移轉資料集與備份配置資料時,要使用的 ID
zmbToConfigRoot
移轉時之目標配置的裝載點

此值與指定給 zConfigMountPoint 變數的值相同。

zmbToWASHomeDir
移轉時之目標配置的起始目錄
zmbWorkspaceRootPreference
要移轉儲存在預設工作區使用者根目錄位置 (D) 中的管理主控台自訂「我的作業」設定,或是移轉儲存在使用者定義之工作區根目錄位置 (U) 中的設定
zmbUserWorkspaceRoot
使用者定義的工作區根目錄位置

用來移轉聯合節點的回應檔範例

create
EnableIntermediateSymlink=false
EnableJavaTmpDir=false
intermediateSymlinkPreference=N
profileName=default
profilePath=<root>/profiles/ZMigFed01
templatePath=<root>/profileTemplates/zos-migFederated
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=FED
zmbAdjunctProcName=BBO9CRA
zmbAdminPassword=XXXXXXXX
zmbAdminUserid=XXXXXXXX
zmbControllerProcName=BBO9ACR
zmbDaemonProcName=BBO89MN
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=AppServer
zmbInitialHeapSize=512
zmbMaxHeapSize=768
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9ASR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05173538
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=AppServer
zmbWorkspaceRootPreference=D

指出主題類型的圖示 概念主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cmig_zmmt_cmd_fednodevar
檔名:cmig_zmmt_cmd_fednodevar.html