Retrieves information about a temporary storage queue.

Sintaxe:

INQUIRE TSQUEUE
 
                                .---------------------------.
                                V                           |
>>-INQUIRE TSQUEUE(data-value)----+-----------------------+-+--><
                                  +-NUMITEMS(data-area)---+
                                  +-FLENGTH(data-area)----+
                                  +-LOCATION(cvda)--------+
                                  +-MAXITEMLEN(data-area)-+
                                  '-MINITEMLEN(data-area)-'
 
 

For more information about the use of CICS-value data areas (CVDAs), see Appendix F, CVDAs recognized by the translator.

Descrição:

The INQUIRE TSQUEUE command returns information about a particular temporary storage queue.

Comentários:

In a browse, CICS returns all queues, and you can see queues that are created by CICS for internal use in addition to those that are created by user applications.
In particular, queues with names that start with these characters are CICS queues: '**', '$$', X'FA' through X'FF', 'CEBR' and 'DF'.

In releases of TXSeries for Multiplatforms before 5.1, an EXEC CICS INQUIRE TSQ API always reset the TSQ read index to point to the last record in that TSQ.
Therefore, if an EXEC CICS READQ TS followed the INQUIRE TSQ API, and the READQ TS tried to read the next record, the READQ TS could not read that record, because it did not exist. In release 5.1, EXEC CICS INQUIRE TSQ no longer resets the read index.

See Using the CICS API commands for general information about browsing, syntax, exception conditions, and examples.

Opções:

NUMITEMS(data-area)
• Returns a 16-bit binary field that gives the number of items that are in the temporary storage queue.

FLENGTH(data-area)
• Returns a 32-bit binary field that gives the total length in bytes all the items that are in the temporary storage queue.
• Note:
  • An fixed length overhead of 11 bytes is automatically added to the LENGTH value when you execute a INQUIRE TSQUEUE command.
  • Therefore, if the value of LENGTH is 50, the value that is returned for the FLENGTH attribute is 61.
  • In this example, LENGTH is the total length in bytes of all the items that are in the temporary storage queue.

LOCATION(cvda)
• Returns a CVDA value that indicates where the temporary storage queue resides.
• The CVDA values are:
  • AUXILIARY
    • The temporary storage queue is held in the CICS temporary storage file.
  • MAIN
    • The temporary storage queue is held in main storage.

MAXITEMLEN(data-area)
• Returns a 16-bit binary field that gives the length, in bytes, of the largest item that is in the temporary storage queue.
• The length of a queue item is the sum of the length of the user data plus 24 bytes for header information.

MINITEMLEN(data-area)
• Returns a 16-bit binary field that gives the length, in bytes, of the smallest item that is in the temporary storage queue.

TSQUEUE(data-value)
• Specifies the eight-character name of the temporary storage queue about which you are inquiring.

Condições:

END
• RESP2 values:
  • No more resource definitions of this type (RESP2=2) exist.

ILLOGIC
• RESP2 values:
  • You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress (RESP2=1).

QIDERR
• RESP2 values:
  • The temporary storage queue cannot be found (RESP2=1).