CONVID keyword
Use the CONVID keyword to select or reject conversational messages. You can specify keywords or a list of conversation numbers for the CONVID keyword value. You can use CONVERSATIONS or CONV as an alias for CONVID.
Parameter | Description |
|---|---|
ALL ANY | selects or rejects both conversational and non-conversational messages |
CONVxxxx | the number that identifies the conversation that you want to select or reject for processing |
ONLY | selects or rejects both conversational and held conversational messages Non-conversational messages are not selected. |
NONE | selects or rejects only non-conversational messages |
- You can combine multiple keywords. For example, CONVID=(NONE, ONLY) is equivalent to CONVID=ALL.
- Message Advisor ignores duplicate keywords.
- You can combine keywords with conversation numbers. The conversation numbers will restrict which conversational messages are processed as shown in the following examples:
- CONVID=(0002) or CONVID=(ONLY, 0002) selects or rejects only conversations with an ID of 0002. Both active and held conversations are selected or rejected. You must specify DESTYPE=HELD to restrict processing to held conversations only.
- CONVID=(NONE, 0001) selects or rejects all non-conversational messages and all conversations with an ID of 0001.
- CONVID=(ALL, 0001) selects or rejects all non-conversational messages and all conversations with an ID of 0001.
- For shared queues systems, Message Advisor processes all conversational filtering at the message level. Message Advisor searches all destinations. A message that contains a conversation prefix and SPA is considered conversational. A message that does not contain a conversation prefix and SPA is considered non-conversational.
For non-shared queues systems, the ONLY and NONE keywords provide additional filtering at the destination level. ONLY processes only conversational SMBs and CNTs which are in conversation. NONE processes non-conversational SMBs, but processes all CNTs because CNTs in conversation may also have non-conversational messages queued.
A message is considered conversational if it meets all the following requirements:
- contains a conversation prefix and SPA
- is queued to a conversational transaction or an LTERM in conversation
A message is considered non-conversational if it meets any of the following requirements:
- is queued to a non-conversational transaction or an LTERM not in conversation (even if the message contains a SPA)
- does not contain a SPA (even if the conversation is still active)
- is queued to a non-conversational transaction or an LTERM not in conversation (even if the message contains a SPA)
- does not contain a SPA (even if the conversation is still active)
- For the DISplay command set, the default CONVID parameter is All for SELECT statements.
- For the DEQueue and UNLoad command sets, the default CONVID parameter for SELECT statements is the value specified for CONV on the command.
- For all command sets, the default CONVID parameter is All for REJECT statements.
- CONVID=A is not an abbreviation for CONVID=ALL. CONVID=A is interpreted as CONVID=000A and processes only held conversations with an ID of 000A.
- Most CONVID values will not be allowed with the SORT=QCT keyword on the DISPLAY TYPE=DQ command because the QCT keyword indicates that messages are not to be examined or counted (the displayed counts are taken from CNT or SMB).
Related topic