CLOSE CONVERSATION

 

operand1

CLOSE CONVERSATION *CONVID
  ALL

This document covers the following topics:

For an explanation of the symbols used in the syntax diagram, see Syntax Symbols.

Related Statements: DEFINE DATA CONTEXT | OPEN CONVERSATION

Belongs to Function Group: Natural Remote Procedure Call


Function

The statement CLOSE CONVERSATION is used in conjunction with the Natural RPC (Remote Procedure Call). It allows the client to close conversations. You can close the current conversation, another open conversation, or all open conversations.

Note:
A logon to another library does not automatically close conversations.

Syntax Description

Operand Definition Table:

Operand Possible Structure Possible Formats Referencing Permitted Dynamic Definition
operand1   S A           I                 yes no

Syntax Element Description:

Syntax Element Description
operand1
Identifier of Conversation to be Closed:

To close a specific open conversation, specify its ID as operand1.

operand1 must be a variable of format/length I4.

*CONVID
Closing the Current Conversation:

To close the current conversation, specify *CONVID.

The ID of the current conversation is determined by the value of the system variable *CONVID.

ALL
Closing All Open Conversations:

To close all open conversations, specify ALL.

Further Information and Examples

See the following sections in the Natural RPC (Remote Procedure Call) documentation:

  • Natural RPC Operation in Conversational Mode

  • Using a Conversational RPC