Deletes a temporary storage queue.

Sintaxe

Descrição:

DELETEQ TS deletes all the temporary data that is associated with a temporary storage queue in either main or auxiliary storage.
If in auxiliary storage, the queue can reside on a remote system.
All storage that is associated with the queue is freed.

Delete temporary data as soon as possible to avoid using excessive amounts of storage.

Opções:

QUEUE(name)
• Specifies the symbolic name of the queue that is to be deleted.
• For a description of how queue names are defined, see the TXSeries for Multiplatforms Administration Reference.
• For applications that are written in COBOL, the name can be up to eight characters long, each of which can contain any bit pattern; and it must be unique within the CICS system. Do not use X'FA' through X'FF' as the first character of the name; these characters are reserved for CICS use.
• The same rules apply when using the C or C++ programming language, except that the name must be a full eight characters long.

SYSID(name)
• Specifies on which CICS region the DELETEQ is to run.
• The SYSID name has one through four characters.
• For a full description of the SYSID option, refer to SYSID.
• If the SYSID option is not specified, it defaults to the value that is in the RemoteSysId attribute of the TSD entry that is matched with the queue name that is requested in the QUEUE option.

Condições:

INVREQ
• Occurs for the following conditions, depending on the options that are specified on the DELETEQ TS command:
  • The specified queue is in doubt (that is, locked upon restart and awaiting transaction resolution).
  • The queue is remote and has been created by CICS internal code.
• Ação pré-definida: Terminates the task abnormally.

IOERR
• Occurs if an I/O error occurs during the temporary storage operation.
• See Processing the IOERR condition for information about handling the IOERR condition.
• IOERR can occur for recoverable auxiliary intrapartition TS queues if the file server is restarted while CICS is still running.
• Ação pré-definida: Terminates the task abnormally.

ISCINVREQ
• Occurs if the remote system indicates a failure that does not correspond to a known condition.
• Ação pré-definida: Terminates the task abnormally.

NOTAUTH
• Occurs for the following conditions:
  • A resource security check is unsuccessful on QUEUE(name).
  • SYSID is specified by a transaction that is defined with the RSLCheck attribute set to either internal or external.
• Ação pré-definida: Terminates the task abnormally.

QIDERR
• Occurs if the specified queue cannot be found in either main or auxiliary storage.
• Ação pré-definida: Terminates the task abnormally.

SYSIDERR
• Occurs if a problem with the communications configuration prevents the DELETEQ from proceeding. For example:
  • The connection that is named in the SYSID option is not the name of a Communications Definition (CD) entry.
  • The SYSID option references a CD entry that is incorrectly configured.
  • The SYSID option references a CD entry that is marked as out of service.

• It can also occur if the connection to the remote system is closed.
• This can be because the remote system is not available.
• Ação pré-definida: Terminates the task abnormally.

  Informações relacionadas:

  • Processing the IOERR condition
  • TXSeries for Multiplatforms Administration Reference
  • TXSeries for Multiplatforms Intercommunication Guide
  
  

  ---

  © Copyright IBM Corp.

  ---