Menu principal                 [Fechar]
Introdução
Divisões
Identification Division
Environment Division
Data Division
Procedure Division
Comandos CICS
VSAM - File Status
Quadros importantes
SQL - Structured Query Language
Outros programas
Rotinas prontas
Palavras reservadas
Introdução ao Oracle
Sites de busca
Sites interessantes
Meu e-mail

CICS Manual do Usuário - ISSUE ERROR


Volta a página anterior

Volta ao Menu Principal


Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

ISSUE ERROR

Informs an advanced program-to-program communications (APPC) mapped conversation partner of an error.
An APPC conversation allows a program to send data to, and receive data from, a program that is running in a remote system.
Programming that uses APPC conversations is called Distributed Transaction Programming (DTP).
For guidance information about DTP, refer to the TXSeries for Multiplatforms Intercommunication Guide.

Sintaxe

Descrição:

ISSUE ERROR allows an application program to inform a process in a connected APPC system that some program-detected error has occurred.
For example, a remote CICS application is notified by having EIBERR set, with EIBERRCD=0889.
The actions that are required in order to recover from the error are the responsibility of logic that is contained in both application programs.
The application program can use this command to respond negatively when the CONFIRM option has been specified on a SEND command that is executed by a partner transaction.

If an ISSUE ERROR command is issued by a transaction that is in the receive state, the send/receive states of the two transactions are reversed.
This enables the issuing transaction to send additional information about the error.

After an ISSUE ERROR command, the program should test EIBRECV to find the state of the conversation.
If EIBRECV is not set, EIBERR and EIBFREE should also be tested.

Opções:

    CONVID(name)
  • Identifies the conversation to which the command relates.
  • The four-byte name identifies either the token that is returned by a previously executed ALLOCATE command in the EIBRSRCE field of the EXEC Interface Block (EIB), or the token that represents the principal facility (that was returned by a previously executed ASSIGN command).
  • If this option is omitted, the principal facility is assumed.
    STATE(cvda)
  • Gets the state of the current conversation.
  • See STATE.

Condições:

    INVREQ
  • Occurs for the following conditions, depending on the options that are specified on the ISSUE ERROR command:
    • The CONVID option is omitted and the principal facility is not an APPC conversation.
    • An attempt was made to use a distributed transaction processing (DTP) command on a valid non-DTP CONVID.
    • A remotely linked-to program attempted to execute an ISSUE ERROR command that refers to the principal facility.
  • Ação pré-definida: Terminates the task abnormally.
    NOTALLOC
  • Occurs if the specified CONVID value does not relate to a conversation that is owned by the application.
  • Ação pré-definida: Terminates the task abnormally.
    TERMERR
  • Occurs if a session-related error occurs.
  • Any subsequent action on that conversation other than a FREE command causes an ATCV abend.
  • Ação pré-definida: Terminates the task abnormally (with abend code ATNI).

Informações relacionadas:

© Copyright IBM Corp.