Defining threshold jobs

Use the SBMPxx parameter on the QCFIN function. This parameter identifies the threshold for which the job is running.

You must set the xx value of this parameter to either AB, BC, CD, or UT to define a threshold job that is to be scheduled.

If you specify this parameter for each job, only the job that is processing the highest threshold is allowed to run in order to eliminate message queue thrashing; the lower threshold jobs are terminated with AIB reason code E000.

If multiple jobs are scheduled at the same time and this parameter is not specified for each job, it is unpredictable which job will run, and unexpected results can occur.

Define this parameter for the QCFIN parameters that are being supplied to threshold jobs AB, BC, CD, and UT.

  • For the threshold AB unload job, specify the function statement SBMPxx as shown in this example:
    FUNCTION UNLOAD QUEUETYPE=(ALL),SBMPAB
    
  • For the threshold BC unload job, specify the function statement SBMPxx as shown in this example:
    FUNCTION UNLOAD QUEUETYPE=(ALL),SBMPBC
    
  • For the threshold CD unload job, specify the function statement SBMPxx as shown in this example:
    FUNCTION UNLOAD QUEUETYPE=(ALL),SBMPCD
    
  • For the threshold UT unload job, specify the function statement SBMPxx as shown in this example:
    FUNCTION UNLOAD QUEUETYPE=(ALL),SBMPUT
    

The following example of an ONTHRESHOLDAB(procname) PROCLIB member forces an automatic browse of committed Queue Manager records.

**************************************************************
*  QCF IMS CONTROL REGION EXTENSIONS PROCLIB MEMBER AUTOAB   *
*  INPUT TO QCF SERVER                                       *
**************************************************************
*------------------------------------------------------------*
* 1-to 4-character IMS ID name.                              *
*------------------------------------------------------------*
IMS(IMS1)                     /* IMS name = IMS1 */ 
*------------------------------------------------------------*
* Define the data set and member that contains the QCF input *
* command stream. 1-to 44-character for PDS name             *
* 1-to 8-character for member name                           *
*------------------------------------------------------------*
QCFIN(DSN(USER.PRIVATE.PROCLIB),MEM(AQCFABIN)                 
*------------------------------------------------------------*
* Define 1-to 44-character data set name to be used for the  *
* QCF print output                                           *
*------------------------------------------------------------*
QCFPRINT(USRT002.QCF31AB.QCFPRINT)                              
*------------------------------------------------------------*
* Define 1-to 44-character data set name to be used for the  *
* QCF unload output                                          *
*------------------------------------------------------------*
BROWSE(USRT002.QCF31AB.UNLOAD)                                  

The following example of an ONTHRESHOLDBC(procname) PROCLIB member forces an automatic unload of committed Queue Manager records.

***********************************************************************
*  QCF IMS CONTROL REGION EXTENSIONS PROCLIB MEMBER AUTOBC            *
*  INPUT TO QCF SERVER                                       *
***********************************************************************
*---------------------------------------------------------------------*
* 1- to 4-character IMS ID name.                                      *
*---------------------------------------------------------------------*
IMS(IMS1)                     /* IMS name = IMS1 */
*---------------------------------------------------------------------*
* Define the data set and member that contains the QCF input          *
* command stream. 1-to 44-character for PDS name                      *
* 1 to 8 character for member name                                    *
*---------------------------------------------------------------------*
QCFIN(DSN(USER.PRIVATE.PROCLIB),MEM(AQCFBCIN)                          
*---------------------------------------------------------------------*
* Define 1-to 44-character data set name to be used for the           *
* QCF print output                                                    *
*---------------------------------------------------------------------*
QCFPRINT(USRT002.QCF31BC.QCFPRINT)                                       
*---------------------------------------------------------------------*
* Define 1-to 44-character data set name to be used for the           *
* QCF unload output                                                   *
*---------------------------------------------------------------------*
UNLOAD(USRT002.QCF31BC.UNLOAD)
Note: For details of the configuration values for the IMS Queue Control Facility extensions ONTHRESHOLDnn PROCLIB member, see Extensions ONTHRESHOLDnn PROCLIB member reference.