Changes some of the attributes of a transient data queue.

Sintaxe:

SET TDQUEUE
 
>>-SET TDQUEUE(name)--+-------------------+--------------------->
                      +-ATIFACILITY(cvda)-+
                      +-NOTERMINAL--------+
                      '-TERMINAL----------'
 
>--+-----------------+--+-----------------+--------------------->
   '-ATITERMID(cvda)-'  '-ATITRANID(cvda)-'
 
>--+-----------------------+--+--------------------+------------>
   '-ATIUSERID(data-value)-'  +-ENABLESTATUS(cvda)-+
                              +-DISABLED-----------+
                              '-ENABLED------------'
 
>--+------------------+--+--------------------------+----------><
   +-OPENSTATUS(cvda)-+  '-TRIGGERLEVEL(data-value)-'
   +-CLOSED-----------+
   '-OPEN-------------'
 
 

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

Descrição:

SET TDQUEUE allows you to change some of the attributes that are in the runtime Transient Data Definitions (TDD) entry for a named transient data queue.
The queue must not be remote or indirect.

Opções:

ATIFACILITY(cvda)
• This option is for intrapartition queues only.
• Specifies whether a terminal (or session) is associated with the task that is to be started when this queue's trigger level is reached.
• This applies to tasks that are in an automatic transaction initiation (ATI) queue only.
• Valid CVDA values are TERMINAL and NOTERMINAL.

ATITERMID(data-value)
• This option is for intrapartition queues only.
• Specifies the name of the terminal or session that is to be associated with this queue when Automatic Transaction Initiation (ATI) occurs.
• The name must be four characters long and must represent a valid terminal.
• A valid terminal is any terminal that is autoinstalled, shipped, or defined in the Terminal Definitions (WD).

ATITRANID(data-value)
• This option is for intrapartition queues only.
• Specifies the name of the transaction that is to be started when this queue's trigger level is reached.
• The name can be up to four characters long, and must be defined in the Transaction Definitions (TD) as a local transaction.

ATIUSERID(data-value)
• This option is for intrapartition queues only.
• Specifies the user identifier that is associated with the queue, if any.
• The identifier is eight bytes long.
• TXSeries for Multiplatforms checks this value for validity only; otherwise, this value is ignored.

ENABLESTATUS(cvda)
• Specifies whether the queue is to be available for access by applications.
• Valid CVDA values are ENABLED and DISABLED.
• A DISABLED queue cannot be accessed by applications, although it still possibly can be OPEN.
• You cannot disable a queue whose name begins with the letter C, because this identifies CICS's own queues.
• For extrapartition queues, changing the value of the ENABLESTATUS option affects only the availability of the queue; CICS does not open or close the associated file.

OPENSTATUS(cvda)
• This option is for extrapartition queues only.
• Specifies whether the queue is to be open or closed.
• Valid CVDA values are OPEN and CLOSED.
• You cannot open or close a queue that is DISABLED.

TDQUEUE(name)
• Specifies the name of the transient data queue as defined in the TDD.
• The name can be up to four characters long.

TRIGGERLEVEL(data-value)
• This option is for intrapartition queues only.
• Specifies, as a 32-bit binary value, the number of output requests that are to be allowed to the queue before ATI occurs.
• The number must be in the range 0 through 32767.

Condições:

INVREQ
• Occurs for the following conditions, depending on the options that are specified on the SET TDQUEUE command:
  • TRIGGERLEVEL is specified for an extrapartition queue (RESP2=2).
  • TRIGGERLEVEL has an out-of-range value (RESP2=3).
  • ATITERMID is specified for an extrapartition queue (RESP2=4).
  • ATITRANID is specified for an extrapartition queue (RESP2=5).
  • ATIFACILITY is specified for an extrapartition queue (RESP2=6).
  • ATIFACILITY has an invalid CVDA value (RESP2=7).
  • OPENSTATUS has an invalid CVDA value (RESP2=8).
  • OPENSTATUS is specified for an intrapartition queue (RESP2=9).
  • ENABLESTATUS has an invalid CVDA value (RESP2=10).
  • DISABLED is specified for a queue name that begins with C (RESP2=11).
  • The named queue is remote (RESP2=12).
  • The named queue is indirect (RESP2=13).
  • OPEN or CLOSED is specified for a DISABLED queue (RESP2=15).
  • ATIUSERID was specified for an extrapartition queue (RESP2=19).
• Ação pré-definida: Terminates the task abnormally.

IOERR
• Occurs if an error occurs while opening or closing the queue (RESP2=14).
• See Processing the IOERR condition for information about handling the IOERR condition.
• Ação pré-definida: Terminates the task abnormally.

NOTAUTH
• Occurs if a resource security check has failed on TDQUEUE(name).
• Ação pré-definida: Terminates the task abnormally.

QIDERR
• Occurs if the named queue cannot be found in the TDD (RESP2=1).
• Ação pré-definida: Terminates the task abnormally.