UPDATE SCRIPT(更新 IBM Spectrum Protect Script)

請使用這個指令來變更指令行,或新增指令行到 IBM Spectrum Protect™ Script 中。

限制: 您無法在 IBM Spectrum Protect Script 內重新導向指令的輸出。 請改用執行 Script 然後指定指令重新導向的方式。 例如, 要將 script1 的輸出導向 c:\temp\test.out 目錄,請執行 Script,並依下列範例指定指令重新導向:
run script1 > c:\temp\test.out

專用權類別

要發出這個指令時,管理者先前必須已經定義 Script,或者具有系統專用權。

語法

讀取語法圖表略過語法圖表
>>-UPDate SCRipt--script_name----------------------------------->

>--+-----------------------------------+------------------------>
   '-command_line--+-----------------+-'   
                   '-Line -=--number-'     

>--+-----------------------------+-----------------------------><
   '-DESCription--=--description-'   

參數

script_name(必要)
指定要更新的 Script 名稱。
command_line
指定在 Script 中要處理的全新或更新指令。 當您發出這個指令時,您必須更新指令、說明,或同時更新兩者。

指令可以包含替代變數,並且只要您指定接續字元 (-) 作為指令的最後一個字元,即可讓指令橫跨多個指令行。 您最多可以為指令指定 1200 個字元。 若指令包含空格,則必須以引號括住。 若您指定這個參數,就可以選擇指定下列參數。

您可以選擇對此參數指定 SERIALPARALLEL Script 指令,以循序、同時,或循序和同時的方式來執行指令。 您可以同時執行多個指令,等它們完成後再繼續進行下一個指令。 指令會循序式執行,直到遇到 parallel 指令為止。

可以使用條件式邏輯流程陳述式。 這些陳述式包括 IF、EXIT 和 GOTO。

Line
為指令指定行號。 若您沒有指定行號,則指令行會附加到指令行現存的序列。 附加的指令行會以序列中最後一個行號加五,作為指定的行號。 例如,若 Script 最後一行的行號是 015,則附加指令的指定行號是 020。

若您指定行號,指令將取代現存的指令行(若號碼與現存的行號相同)。 否則指令會插入到指定的指令行(若行號沒有對應到指令行序列的現存行號)。

DESCription
為 Script 指定說明。 您最多可以為說明指定 255 個字元。 若說明包含空白字元,則應該以引號括住。

範例:將指令新增至 Script 的尾端

假設您已定義以下包含三行的 Script,(名稱為 QSAMPLE),且您想要將 QUERY SESSION 指令新增至 Script 的尾端。
 001  /* 此為 Script 範本*/
 005  QUERY STATUS
 010  QUERY PROCESS 
 
update Script qsample "query session"
在處理指令之後,Script 現在由下列這幾行組成:
 001  /* 此為 Script 範本*/
 005  QUERY STATUS 
 010  QUERY PROCESS
 015  QUERY SESSION
 

範例:更新 Script 中的特定一行

在上一個範例的 Script 中變更第 010 行,改為處理 QUERY STGPOOL 指令而非 QUERY PROCESS 指令:
update Script qsample "query stgpool" line=010
在處理指令之後,Script 現在由下列這幾行組成:
 001  /* 此為 Script 範本*/
 005  QUERY STATUS 
 010  QUERY STGPOOL
 015  QUERY SESSION
 

範例:將指令插入 Script 的中間

在上一個範例的 Script 中,將新的指令行 (QUERY NODE) 插入到 QSAMPLE Script 中的 QUERY STATUS 指令行後面:
update script qsample "query node" 
line=007
在處理指令之後,Script 現在由下列這幾行組成:
 001  /* 此為 Script 範本*/
 005  QUERY STATUS
 007  QUERY NODE
 010  QUERY STGPOOL
 015  QUERY SESSION

相關指令

表 1. UPDATE SCRIPT 的相關指令
指令 說明
COPY SCRIPT 建立 Script 副本。
DEFINE SCRIPT 將 Script 定義至 IBM Spectrum ProtectIBM Spectrum Protect 伺服器。
DELETE SCRIPT 刪除 Script 或者從 Script 中刪除個別行。
QUERY SCRIPT 顯示 Script 的相關資訊。
RENAME SCRIPT 將 Script 重新命名為新名稱。
RUN 執行 Script。