RUN（執行 IBM Spectrum Protect Script）

使用這個指令可執行 IBM Spectrum Protect™ Script。 如果要在另一部鼐伺服器上發出這個指令，則您必須在該伺服器上定義要執行的 Script。

只要不會形成迴圈，您可以在 Script 中併入多個 RUN 指令。 例如，您應該避免併入會造成 SCRIPT_A 執行 SCRIPT_B 且 SCRIPT_B 執行 SCRIPT_A 的 RUN 指令。

重要： IBM Spectrum Protect 沒有任何指令可取消已啟動的 Script。 如果要停止 Script，您必須中止伺服器。

專用權類別

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

語法

讀取語法圖表略過語法圖表
>>-RUn--script_name--+------------------------+----------------->
                     | .-,------------------. |   
                     | V                    | |   
                     '---substitution_value-+-'   

   .-Preview -=--No------.  .-Verbose--=--No------.   
>--+---------------------+--+---------------------+------------><
   '-Preview--=--+-No--+-'  '-Verbose--=--+-No--+-'   
                 '-Yes-'                  '-Yes-'     

參數

script_name（必要）
指定您要處理的 Script 名稱。 您指定的名稱不可以是替代字元，例如 $1。
substitution_value
指定一或多個值來替代執行 Script 時的變數。 在 Script 中，替代變數是由一個 '$' 字元加上一個數字組成。 執行 Script 時，IBM Spectrum Protect 會將 Script 中定義的替代變數取代成您和這個指令一起提供的值。 您必須為 Script 中定義的每一個替代變數指定值，否則 Script 將會失敗。 此為選用參數。
Preview
指定是否要預覽 Script 的指令行，而不實際處理 Script。 預設值為 NO。
可能的值為：
Yes
指定要顯示 Script 中所包含的指令行，但不要處理該 Script。
No
指定要顯示 Script 中所包含的指令行，並且要處理該 Script。
Verbose
指定在處理 Script 時是否要顯示 Script 中所用的指令行、變數替代和條件邏輯測試。 若指定 PREVIEW=YES，則系統不處理此參數。 預設值為 NO。
可能的值為：
Yes
指定在處理 Script 時要顯示指令行、變數替代和條件邏輯測試。
No
指定在處理 Script 時不要顯示指令行、變數替代和條件邏輯測試。

範例：使用表格名稱替代變數來檢視 Script 所產生的指令。

如果要執行下列 Script 範例 QSAMPLE，請發出 RUN 指令，並指定表格名稱 ACTLOG 作為替代變數 $1 的值。 在執行指令之前，請利用輸出來預覽 Script 所產生的指令。
001  /* This is a sample SQL Query in wide format */
005  SET SQLDISPLAYMODE WIDE
010  SELECT colname FROM -
015  COLUMNS WHERE TABNAME='$1'
run qsample actlog preview=yes
ANR1461I RUN: Executing command script QSAMPLE.
ANR1466I RUN: Command script QSAMPLE, Line 5 :
              set sqldisplaymode wide.
ANR1466I RUN: Command script QSAMPLE, Line 15 : 
              select colname from columns where tabname='ACTLOG'.
ANR1470I RUN: Command script QSAMPLE completed successfully
              (PREVIEW mode)

範例：執行 Script 來顯示和執行 Script 所產生的指令

執行上一個範例中顯示的 Script，以顯示產生的指令與指令的結果。
run qsample actlog verbose=yes
ANR1461I RUN: Executing command script QSAMPLE.
ANR1466I RUN: Command script QSAMPLE, Line 5 :
              set sqldisplaymode wide.
ANR1466I RUN: Command script QSAMPLE, Line 5 : RC=RC_OK
ANR1466I RUN: Command script QSAMPLE, Line 15 : 
              select colname from columns where tabname='ACTLOG'.
 
COLNAME           
------------------
DATE_TIME         
MSGNO             
SEVERITY          
MESSAGE           
ORIGINATOR        
NODENAME          
OWNERNAME         
SCHEDNAME         
DOMAINNAME        
SESSID            
 
ANR1462I RUN: Command script QSAMPLE, Line 15 : RC=RC_OK
ANR1462I RUN: Command script QSAMPLE completed successfully.

範例：執行 Script，只顯示 Script 中指令的結果

執行前一個範例 Script，而不只顯示 Script 中產生的指令的結果。
run qsample actlog verbose=no
COLNAME           
------------------
DATE_TIME         
MSGNO             
SEVERITY          
MESSAGE           
ORIGINATOR        
NODENAME
OWNERNAME      
SCHEDNAME     
DOMAINNAME      
SESSID            

ANR1462I RUN: Command script QSAMPLE completed successfully.

相關指令

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