Updates to IMS Queue Control Facility V3.1 User's Guide

Product documentation


Abstract

Updates that apply to IMS Queue Control Facility V3.1 User's Guide (SC18-9875-06)

Content

The most recent update is listed first.

      Update 7

      Date of change: October 29, 2012

      Topic: IMS Queue Control Facility return codes

      Change description: Text added to return code 04.

      Job Successful.
        1. Function LOAD - No request for messages to be sent to scrap log. However, messages were sent to scraplog.
        2. Function LOAD - Specifying certain type of messages to be loaded. Other messages to go to scrap log. However, some messages that should be loaded go to scrap log.
        3. Function LOAD - Unable to open scraplog data set.
        4. Functions BROWSE/UNLOAD/RECOVER - Unable to open BROWSE/UNLOAD/RECOVER data sets.
        5. Function RECOVER for shared queues - There ae no messages on the cold queue.
        6. Start of changeFunction BROWSE/LOAD/UNLOAD/RECOVER - Action to some destinations rejected due to insufficient authority.End of change

      Update 7

      Date of change: October 29, 2012

      Topic: Messages

      Change description: New message added.

      Start of change
      IQC7018I

      Actions to some destinations rejected due to insufficient authority USERID=userid.

      Explanation

      This is an information message issued by the QCF batch jobs indicating that some destinations are not accessible for combination of IMSid function/userid.

      System action

      Processing continues.

      User response

      None. Information only.

      Module

      IQCXCTRL

      Parent topic: IMS Queue Control Facility messages
      End of change



      Update 6

      Date of change: October 29, 2012

      Topic: Multiple topics

      Change description: Made the following replacement in 5 topics:

                – TRANSACTION (Serial transaction queue)
                – TRANSACTION (Suspend transaction queue)
                – TRANSACTION (Transaction ready queue (remote and local))
      Replaced with: – SERIAL ( serial transaction queue)
                – SUSPEND (Suspend transaction queue)
                – TRANSACTION (Transaction ready queue (remote and local))
      • Queue type
      • ALL
      • APPC
      • COLD
      • DEADQ
      • LONG
      • LTERM
      • OTMA
      • REMOTE (Remote MSNAME queue)
      • SHORT
      • Start of changeSERIAL (Serial transaction queue)End of change
      • Start of changeSUSPEND (Suspend transaction queue)End of change
      • TRANSACTION (Transaction ready queue (remote and local))

      Update 5

      Date of change: October 29, 2012

      Topic: FUNCTION statement

      Change description: Made the following replacement:

                TRANSACTION SERIAL | SUSPEND

                The transaction ready queue is to be retrieved.

                  SERIAL
                  The serial transaction queue is to be retrieved.
                  SUSPEND
                  The suspended transaction queue is to be retrieved.
      Replaced with: SERIAL
                The serial transaction queue is to be retrieved.
                SUSPEND
                The suspended transaction queue is to be retrieved.
                TRANSACTION
                The transaction ready queue is to be retrieve

      TOPSHORTMSGWTO (TOPSM)
      Triggers WTO for the top nn destinations using the short message queue, where nn is any selected number up to 99 (nonshared queues, only). This parameter is valid with the QUERY function.
      Restriction: TOPSHORTMSGWTO / TOPSM is mutually exclusive with TOPLONGMSGWTO / TOPLM, TOPLASTACTIVWTO / TOPLA, or TOPALLMSGWTO / TOPAM. Specifying more than one of these parameters simultaneously results in an error condition that terminates processing.
      Start of changeSERIALEnd of change
      Start of changeThe serial transaction queue is to be retrieved. End of change
      Start of changeSUSPENDEnd of change
      Start of changeThe suspended transaction queue is to be retrieved.End of change
      Start of changeTRANSACTIONEnd of change
      Start of changeThe transaction ready queue is to be retrieved. End of change
      UNLOCK
      All messages that meet the selection criteria are requeued from the cold queue.
      Parent topic: Using IMS Queue Control Facility functions


      Update 4

      Date of change: October 29, 2012

      Topic: Multiple topics

      Change description: Made TRANSACTION, SERIAL, and SUSPEND same level keywords. Change made in 5 topics.

      >--+-----------------------------------------+--+--------+------>
         |             .-, choose one or more-.    |  '-RCT=
      y,-'   
         |             V .-COLD-------------. |    |               
         '-QUEUETYPE=(---+-ALL--------------+-+-),-'               
                         +-APPC-------------+                      
                         +-LONG-------------+                      
                         +-LTERM------------+                      
                         +-OTMA-------------+                      
                         +-REMOTE-----------+                      
                         +-SHORT------------+                      
                         +-SERIAL-----------+                      
                         +-SUSPEND----------+                      
                         '-TRANSACTION------'  

      Update 3

      Date of change: October 29, 2012

      Topic: Messages

      Change description: Message number updated.

      Start of change
      Start of changeIQC7002EEnd of change

      QCF INITIALIZATION ERROR IN MODULE module details

      Explanation

      This is a general initialization error that indicates that an early QCF initialization module was unable to perform a function that was trying to bring up the QCF address space.

      This is a variable text message. The variable text that is displayed depends on the error that was encountered, where the value of module is the name of the module that detected the error. And the value of details are the further details that are related to the specific error where: the first parameter is usually the resource that failed initialization, such as module name, thread type, or some other resource. The resource that failed initialization must end in a zero. The next parameter is usually the return code from the failing function. And the last parameter is additional descriptive text, if it is needed.

      The variable text can be one of the following errors:

      • Unknown error
      • Unable to create (BPEBPCRE) buffer pool
      • Module load (BPELOAD) errors
      • Module load and call (BPELOADC) errors
      • Unable to BPEBPGET needed storage
      • Error reading a PROCLIB data set
      • Error parsing a configuration data set
      System action

      Processing continues.

      User response

      If this error persists, contact IBM® software support.

      Module

      IQCZIN10, IQCZPAR0

      Parent topic: IMS Queue Control Facility messages
      End of change

      Update 2

      Date of change: September 21, 2012

      Topic: Messages

      Change description: Message number updated, message text revised, and system action revised.

      Start of change
      Start of changeIQC3306EEnd of change

      The UNLOAD DD statement conditional disposition cannot be DELETE. If unspecified, the normal_disp is KEEP or CATALOG.

      Explanation

      The UNLOAD DD statement in the JCL has either DELETE specified as the conditional disposition of the UNLOAD data set, or the conditional disposition of the UNLOAD data set has not been specified.

      System action

      Start of changeProcessing terminates. The UNLOAD function fails.End of change

      User response

      Modify the JCL so that the conditional disposition of the UNLOAD data set is either UNCATLG, CATLG, KEEP, or PASS and run the job again.

      Module

      IQCUNLOD

      Parent topic: IMS Queue Control Facility messages
      End of change




      Update 1
      Date of change:
      May 21, 2012
      Topic:
      Chapter 3. Setting up IMS Queue Control Facility -> 10. Implementing SAF security for TSO users and batch jobs
      Change description:
      Documentation changes made by APAR PM40120. Added a new topic describing how to implement destination control security for TSO client and batch job users.


      APAR PM40120.pdfAPAR PM40120.pdf

Publication number

SC18-9875-06

Copyright date

2000, 2012

Original publication date

2011/4/22

Product Alias/Synonym

QCF
Queue Control Facility

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IMS Tools
IMS Queue Control Facility

Software version:

3.1.0

Operating system(s):

z/OS

Reference #:

7018215

Modified date:

2012-10-31

Translate my page

Machine Translation

Content navigation