SETTIMER

用途

SETTIMER 會顯示所有排定的計時器。 您可以新增、變更、刪除、暫停及重新啟動計時器。

語法

讀取語法圖跳過視覺化語法圖SETTIMERTARGET=system_nameDOMAIN_IDsaplex_nameOUTMODE=LINEAUTONETLOG

參數

目標
如需 TARGET 參數的相關資訊,請參閱 TARGET 參數
OUTMODE
如需 OUTMODE 參數的相關資訊,請參閱 OUTMODE 參數

限制

只有在起始設定 SA z/OS 時,才能使用 SETTIMER 指令。

使用情形

如需如何新增、變更或刪除計時器的指示,請參閱 IBM Z® System Automation 使用手冊中的 設定計時器

範例

如果您輸入 settimer ,則會顯示類似於 圖 1 的畫面。
圖 1. SETTIMER 指令對話框畫面: 顯示排程計時器
 AOFKATI                   SA z/OS  - Command Dialogs      Line  1    of 43     
 Domain ID   = IPSFP     ---------- SETTIMER ----------    Date = 09/09/08      
 Operator ID = NETOP1         System = KEY4                Time = 09:21:21      
 Enter ADD on the COMMAND line to create a new timer entry                      
 or use CMD selections A add, C change, or D delete to delete existing timers.  
                       U Suspend timer, or R Resume to re-activate timer        
 CMD TIMER-ID SCHEDULED TIME    TYPE  TASK     INTERVAL     CLOCK SAVE CTUP     
 --- -------- ----------------- ----- -------- ------------ ----- ---- ----     
     MEMSTORE 09/09/08 15:42:03 EVERY AUTO2    000 00:02:00 GMT   NO            
         Cmd: MEMSTORE 5% 5                                                     
     RGTAMCPU  ** SUSPENDED **  CHRON AUTRGTA  000 00:05:00 GMT   NO            
         Cmd: CHRON  EVERY=(INTERVAL=(00.05.00)) ROUTE=AUTRGTA ID=RGTAMCPU COMMA
              ND='RGTAMCPU'                                                     
     AOFI000F 09/09/08 15:45:52 AFTER PPT                   GMT   NO            
         Cmd: AOFRASCD AOFWRK10 AOFRSMTR MONITOR,HGDDSMTR/MTR/KEY4              
     AOFI0010 09/09/08 15:45:52 AFTER PPT                   GMT   NO            
         Cmd: AOFRASCD AOFWRK13 AOFRSMTR MONITOR,HGMTRINFORM/MTR/KEY4           
                                                                                
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End        PF3=Return                      PF6=Roll        
                 PF8=Forward    PF9=Refresh                    PF12=Retrieve    
  • CMD 欄位可讓您新增、變更或刪除計時器。 有效值為:
    A
    新增計時器,其值與選取的計時器值相同。
    C
    變更現有的計時器。
    D
    刪除計時器。
    U
    暫停計時器。 計時器會從 NetView 刪除,但其所有相關資料會保留在一般廣域變數中。 只能暫停 CHRON 計時器。
    R
    回復 (或重新啟動) 已暫停的計時器。 與子系統相關聯的計時器已獲指派新的計時器 ID (ITMRxxxx)。
  • TIMER-ID 欄位會顯示指派給計時器的名稱。 它不能是 ALL 或以數字或字組 SYS、RST、AOF 或 ING 開頭。 有效字元為 A-Z、0-9、#、@、$、$、!、_ 及?。
  • SCHEDULED TIME 欄位會顯示此計時器設為到期的下一個排定日期和時間。
  • TYPE 欄位顯示計時器的類型。 有三種類型:
    之後
    設為僅在排定計時器時指定的經歷時間之後才發生。 例如,如果您在 12:00 am 指定 2 小時,則計時器將在 02:00 pm 到期。
    設為在指定的日期和時間發生。 只出現一次。
    定期
    設為在間隔欄位中指出的時間間隔,或在每天或每週的特定時間發生。
  • TASK 欄位顯示計時器執行所在的運算子。 這可以是主要程式設計操作員介面作業 (PPT)、自動化操作員或人工操作員。 當計時器已設定且到期時,必須登入此作業。
    它也可以指定群組名稱。 群組名稱必須以加號 (+) 開頭。 如果指定群組名稱,當計時器到期時,指令會在群組中作用中的第一個作業上執行。
    附註: 並非所有指令都可以在 PPT 下執行。
  • INTERVAL 欄位僅適用於每一種類型計時器。 它指出計時器設為發生的時間間隔。 例如, 00:30:00 值表示計時器將每 30 分鐘發出一次指定的指令。
  • CLOCK 欄位指定時間格式。 它可以是 GMT ,表示當地時間變更不會影響指令處理或 LOCAL ,因此在日光節約時間變更時,或在操作員基於其他原因調整 z/OS 時間時,會自動調整時間。
  • SAVE 欄位指定計時器是否要儲存至外部檔案。 這可讓計時器在 NetView 中斷之後還原。 這適用於使用 自訂作業對話框 或操作員介面所建立的計時器。 有效值為「是」或「否」。 預設值為 YES。
  • CTUP 欄位指定在 NetView 關閉時是否啟動計時器。 有效值為「是」或「否」。 如果 CTUP 設為 YES ,當重新啟動 NetView 時,如果計時器在 NetView 關閉時過期,則會發出計時器定義中指定的指令。
    只有在下列情況下,才能將欄位設為 YES:
    • 這是 At 類型計時器 (在特定時間和日期出現一次)。
    • 計時器是使用 自訂作業對話框建立的。
    • 「儲存」欄位設為 YES。
  • 計時器 ID 下方的 Cmd 欄位指定計時器到期時要發出的指令。

新增計時器或變更現有計時器,會導致「新增/變更計時器」畫面,類似於 圖 2

圖 2. SETTIMER 指令對話框畫面: 新增或變更計時器
 AOFKATIR                  SA z/OS  - Command Dialogs                           
 Domain ID   = IPSFP     ---------- SETTIMER ----------    Date = 11/27/06      
 Operator ID = NETOP1           Add/Change Timer           Time = 12:38:41      
                                                                                
 Timer ID         =>  MEMSTORE     on System :  SAT1                            
 Type             =>  EVERY        AFTER, AT or EVERY                           
 When?                                                                          
 - Interval       =>        days  0-365    and   00:02:00 hh:mm:ss (AFTER EVERY)
            From  =>             hh:mm:ss  To             hh:mm:ss (EVERY)      
 - Day of Week    =>                       at             (AT or EVERY)         
 - Specific date  =>             mm/dd/yy  at             (AT)                  
                                                                                
 Task             =>  AUTO2       Operator ID, PPT or Group name                
 Save             =>  NO          No, Yes     Timer clock =>  GMT    GMT, LOCAL 
                                                                                
 Notify           =>                                                            
 Remark           =>                                                            
 CHRON parameters =>                                                            
                                                                                
 Timer command => MEMSTORE 5% 5                                                 
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End        PF3=Return                      PF6=Roll        
                 PF8=Forward    PF9=Refresh                    PF12=Retrieve    

若要設定計時器,請填寫欄位 (請注意,如果您變更計時器,則無法變更 計時器 ID 欄位)。

請利用這個畫面中的下列欄位來定義不同類型的計時器何時到期:
計時器類型 欄位
之後 間隔: 在執行計時器之前要經過的天數 (0-365)。
星期幾: 指定星期幾 (星期一至星期日)。 只需要前三個字元 (例如, FRI 代表 Friday)。

特定日期: 指定日期 (以 mm/dd/yy 表示法表示) 和時間 (以 hh:mm:ss 表示法表示)。 如果未輸入,則小時和秒預設為零。 如果時間以 X 或多個 X 開始,而不是以數字開始,則指令會設為從下一個時間增量開始。

定期 間隔: 在執行計時器之前要經過的天數 (0-365)。

開始/結束: 您也可以指定間隔開始及結束的日期和時間。 如果省略,計時器會從午夜到午夜執行。

星期幾: 指定星期幾 (星期一至星期日)。 只需要前三個字元 (例如, FRI 代表 Friday)。 您也可以針對星期幾、WEEKDAY 或 WEEKEND 指定 DAILY。

使用 通知 欄位來指定 CHRON 參數 NOTIFY 的值,該參數定義當 CHRON 指令處理中發生特定事件時,向哪個 BNH549I 訊息傳送通知。 它支援四種事件類型 IGNORE、PURGE、REMOVE 及 RUN。 此欄位會自動以括弧括住。

使用 註解 欄位來指定 CHRON 參數 REM 的值,它可以是指定參考資訊資料的任何字串。 欄位會自動以引號括住。

使用 CHRON 參數 欄位來指定其他 CHRON 參數,例如 REFRESH 或 RECOVERY。

您也可以指定 EVERY 參數的子選項,例如 REMOVE、Remafter、DAYSMON、Calendar、MXREPEAT、OFF 或 FOR。

計時器指令 欄位中輸入要在計時器到期時執行的指令。 此指令可以跨越三個輸入欄位,如果計時器指令不符合這些欄位,則這些輸入欄位會受到保護。 您可以使用 PF4 鍵來清除指令欄位。