Configuring type 2 overflow protection using the TSO client

The IMS Queue Control Facility uses the initial configuration values set in the IMS Queue Control Facility data set member IQCQSNUN to implement type 2 overflow protection.

About this task

The following configuration notes apply to configuring type 2 overflow protection:

  • The settings in the IMS Queue Control Facility extensions PROCLIB member determine whether type 2 or type 3 overflow protection is implemented.

    The existence of AREA and FAILSAFE statements in the IMS Queue Control Facility extensions PROCLIB member enables type 3 overflow protection.

    Type 2 protection (the product default) is implemented only if there are no type 3 AREA and FAILSAFE configuration settings specified in the extensions member.

  • The absence of type 3 AREA and FAILSAFE settings in the IMS Queue Control Facility extensions PROCLIB member activates the appropriate type 2 menu option (5) on the QCF Main Menu.

    Use QCF Main Menu option 5 - Tables to configure type 2 overflow protection.

    QCF Main Menu option 6 - Notify, used for type 3 overflow protection, is not active.

  • Configuration changes made with the IMS Queue Control Facility TSO client are valid only for the current IMS session. They are lost when the IMS is terminated.

    To preserve custom values for type 2 overflow protection across multiple IMS sessions, you can start a procedure after any IMS restart that restores those values from member IQCQSNUN.

  • Before you begin the following procedure, ensure that you have selected the appropriate server and IMS ID that reads the appropriate IMS Queue Control Facility extensions PROCLIB member.

Procedure

Perform the following steps to configure type 2 queue overflow protection:

  1. From the QCF Main menu, select option 5 - Tables.

    The Queue Overflow Parameters Sub-Menu panel is displayed.

  2. Select option 1 - Select queue space notification table.

    The Queue Space Notification Tables panel is displayed.

  3. Select option 1 - Edit queue space notification tables.

    The QSN Table Names panel is displayed.

  4. Type the E (Edit) row action in the row representing the current overflow parameters table.

    The Queue Threshold Parameters panel is displayed.

    Figure 1. Queue Threshold Parameters panel
    
     Help                                                                         
    ______________________________________________________________________________ 
                              Queue Threshold parameters                           
    Command ===>                                                                   
                                                                                   
    Press ENTER to continue or END to exit.           APAR . . : PH19814 2020/01/  
      Server . . : IQCSERV9                           JDTE . . : 2020.016          
      IMS ID . . : IMSA                               TIME . . : 14:49:18          
      Member . . : IQCQSNUN                           DATE . . : 2020/01/16        
                                                                                   
     Committed and uncommitted messages: Thresholds.                               
     Queue  upper  threshold  . . . 075  Queue  lower  threshold . . . . 060       
     Queue IQC6101 threshold  . . . 085                                            
                                                                                   
     Committed messages: Job/Procedure names to be called at threshold crossover.  
     Ignore application calls inserting messages to express PCBs . . . . Y         
                                                                                   
     Jobnames  - A-B:  . . . . NOUNLOAD  B-C: . . . NOUNLOAD  C-D: . . . NOUNLOAD  
     Procnames - A-B:  . . . .           B-C: . . .           C-D: . . .           
                                                                                   
     Jobname    - IQC6101  . . NOUNLOAD                                            
     Procname   - IQC6101  . .                                                     
                                                                                   
    
  5. Use this panel to modify the following parameters for committed and uncommitted messages:
    • Queue upper threshold (QTU)
    • Queue lower threshold (QTL)
    • IQC6101 threshold
    • JOB and procedure names for actions (including automatic unload of committed messages) that take place for committed messages when threshold boundaries are exceeded
  6. Press Enter to continue to the configure settings for uncommitted messages.

    The QSN Table Maintenance panel is displayed.

    Figure 2. QSN Table Maintenance panel
    
      Help                                                                         
     ______________________________________________________________________________ 
                                 QSN Table Maintenance                              
     Command ===>                                                                   
                                                                                    
     ENTER to continue, END to go to previous panel.   APAR . . : PH19814 2020/01/  
       Server . . : IQCSERV9                           JDTE . . : 2020.016          
       IMS ID . . : IMSA                               TIME . . : 14:51:49          
       Member . . : IQCQSNUN                           DATE . . : 2020/01/16        
                                                                                    
      Uncommitted messages: Modify QSN entries using the AREAs "ALL" Callers TYPE.  
     For each AREA status Started/Stopped enter a set of Percent/Action(N, S, W).   
                                                                                    
     A: Start . . 100 N  Stop . . 100 N     B: Start . . 050 W  Stop . . 050 W      
     C: Start . . 008 W  Stop . . 005 W     D: Start . . 008 S  Stop . . 005 S      
                                                                                    
      Uncommitted messages: Modify individual entries in the QSN table.             
     For each Caller status Started/Stopped enter a set of Percent/Action(N, S, W). 
                                                                                    
          ___TYP0____ ___APPL____ ___APPC____ ____DC_____ ___OTMA____ ___MSC_____   
     AREA Start  Stop Start  Stop Start  Stop Start  Stop Start  Stop Start  Stop   
     A    100 N 100 N 100 N 100 N 100 N 100 N 100 N 100 N 100 N 100 N 100 N 100 N   
     B    050 W 050 W 050 W 050 W 050 W 050 W 050 W 050 W 050 W 050 W 050 W 050 W   
     C    008 W 005 W 008 W 005 W 008 W 005 W 008 W 005 W 008 W 005 W 008 W 005 W   
     D    008 S 005 S 008 S 005 S 008 S 005 S 008 S 005 S 008 S 005 S 008 S 005 S   
    
  7. Use this panel to modify the following parameters for uncommitted messages:
    • Start and stop percentages individual process types
    • Start and stop actions for individual process types
  8. Press Enter to save or cancel your settings.

    The Update Confirmation panel is displayed.

  9. Type Y or N and press Enter.

    The QSN Table Names panel is displayed.