DEFINE SCRIPT（定義 IBM Spectrum Protect Script）

使用這個指令可以定義 IBM Spectrum Protect™ Script 或利用另一個 Script 中的內容來建立新的 IBM Spectrum Protect Script。

可以使用此指令來定義 Script 的第一行。如果要新增後續的字行到 Script，請使用 UPDATE SCRIPT 指令。

提示：

在 Script 內遞送指令時，您必須將伺服器或伺服器群組以括弧括住，並且省略冒號。否則，若語法中含有冒號，發出 RUN 指令並不會遞送該指令。指令而是僅在從中發出 RUN 指令的伺服器上執行。
您無法在 IBM Spectrum Protect Script 內重新導向指令的輸出。請改用執行 Script 然後指定指令重新導向的方式。例如，要將 script1 的輸出導向 c:\temp\test.out 目錄，請執行 Script，並依下列範例指定指令重新導向：
```
run script1 > c:\temp\test.out
```

專用權類別

如果要發出這個指令，您必需具有操作員、原則、儲存體或系統專用權。

語法


>>-DEFine SCRipt--script_name----------------------------------->

                   .-Line--=--001----.     
>--+-command_line--+-----------------+-+------------------------>
   |               '-Line -=--number-' |   
   '-File--=--file_name----------------'   

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

參數

script_name（必要）

指定要定義的 Script 名稱。您最多可以為名稱指定 30 個字元。

command_line

指定在 Script 中第一個要處理的指令。您必須指定這個參數（以及選擇性地指定 LINE 參數）或 FILE 參數。

您指定的指令可以包含替代變數，並且如果您指定接續字元 (-) 作為指令中的最後一個字元，則可讓指令跨越多個指令行。替代變數是以 '$' 字元來指定，後面跟著一個數字，指出在處理 Script 時的參數值。您最多可以為指令行指定 1200 個字元。若指令包含空格，則必須以引號括住。

您可以對 COMMAND_LINE 參數指定 SERIAL 或 PARALLEL Script 指令，以循序、同時，或循序和同時的方式來執行指令。您可以平行執行多個指令，並等待它們完成之後再繼續執行下一個指令。在發現平行指令之前，指令會以循序方式執行。

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

Line: 為指令行指定行號。由於指定使用多個字行來指定，在執行 Script 時，行號是用來判斷處理的順序。第一行（或行 001）為預設值。此為選用參數。

File

指定要將其內容讀取到要定義之 Script 的檔案名稱。該檔案必須位於執行此指令的伺服器上。若您指定 FILE 參數，就不能指定指令行或行號。

您可以藉由查詢另一個 Script，並且指定 FORMAT=RAW 和 OUTPUTFILE 參數來建立 Script。查詢 Script 的輸出會重新導入至您使用 OUTPUTFILE 參數所指定的檔案。如果要建立新的 Script，則會從您以 OUTPUTFILE 參數指定的檔案來讀取要定義的 Script 內容。

DESCription

為 Script 指定說明。您最多可以為說明指定 255 個字元。若說明包含空白字元，則應該以引號括住。此為選用參數。

範例：撰寫 Script 來顯示 AIX 用戶端

定義顯示所有 AIX® 用戶端的 Script。

define Script qaixc "select node_name from nodes where platform_name='AIX'"
  desc='Display aix clients'

範例：撰寫並執行 Script 將指令遞送到伺服器群組

定義並執行將 QUERY STGPOOL 指令遞送至伺服器群組 DEV_GROUP 的 Script。

define Script qu_stg "(dev_group) query stgpool"

run qu_stg

範例：根據現有的 Script 來建立 Script

定義一個 Script，其指令行是從名稱為 MY.SCRIPT 的檔案中讀取而來，並將新 Script 命名為 AGADM。該檔案必須位於伺服器上且由伺服器進行讀取。

define Script agadm file=my.script

指令	說明
COPY SCRIPT	建立 Script 副本。
DELETE SCRIPT	刪除 Script 或者從 Script 中刪除個別行。
QUERY SCRIPT	顯示 Script 的相關資訊。
RENAME SCRIPT	將 Script 重新命名為新名稱。
RUN	執行 Script。
UPDATE SCRIPT	針對 Script 變更或新增行。

DEFINE SCRIPT（定義 IBM Spectrum Protect Script）

專用權類別

語法

參數

範例：撰寫 Script 來顯示 AIX 用戶端

範例：撰寫並執行 Script 將指令遞送到伺服器群組

範例：根據現有的 Script 來建立 Script

相關指令