DISPLAY CONVID command


>>-DISPLAY-- --NET--,--CONVID--,--ID--=--appl_name-------------->

   .-,--ETIME--=--0-----------------.   
>--+--------------------------------+--------------------------->
   '-,--ETIME--=--number_of_minutes-'   

>--+-------------------------------------------------------------+-->
   |                      .-,--BTIME--=--0---------------------. |   
   '-,--DIAG--=--BLOCKED--+------------------------------------+-'   
                          '-,--BTIME--=----number_of_minutes---'     

>--+--------------------------------+--------------------------->
   '-,--LOGMODE--=--logon_mode_name-'   

>--+-----------------------+-----------------------------------><
   '-,--LUNAME--=--lu_name-'

Abbreviations

Operand	Abbreviation
DISPLAY	D
LOGMODE	LOG
LUNAME	LU

Purpose

The DISPLAY CONVID (conversation ID) command provides information about active conversations with the specified application program. You can limit display of information to conversations that have had no activity for a specified period of time.

Note: This command causes VTAM® to check every conversation and could have an adverse effect on VTAM performance.

You can use this command during problem determination to view a record of conversation information between logical unit (LU) partners.

Conversations that are in the process of allocating and deallocating are temporarily suspended while this command is being processed. Conversations that are sending or receiving continue to operate while this command is running.

Operands

BTIME=number _of_minutes

Specifies the minimum amount of time in minutes that a conversation can be in a blocked pacing state before VTAM displays its record of conversations between the LU partners.

For example, if you specify BTIME=5, VTAM displays only information about conversations that have been in a blocked pacing state for at least 5 minutes.

The BTIME operand must be specified with the DIAG=BLOCKED operand. The command is not accepted otherwise.

You can specify a value in the range 0 - 999 minutes as a value for the BTIME operand. If you specify 0 (the default), VTAM displays a record of all conversations that are in blocked pacing state.

If you specify both the BTIME and ETIME operands, then only those conversations that meet both criteria will be displayed.

Tip: VTAM rounds up the elapsed time for a blocked conversation. If a given conversation has been blocked for only 2 seconds, the time will be rounded up to 1 minute for a display.

DIAG=BLOCKED

Specifies that only those conversations that are unable to send because of pacing constraints be displayed. The reason for the constraint can include session-level pacing, a blocked virtual route, or HPR backpressure.

ETIME=number_of_minutes

Specifies the minimum amount of time that can elapse with no API activity before VTAM displays its record of conversations between the LU partners.

For example, if you specify ETIME=5, VTAM displays only information about conversations that have had no activity for at least 5 minutes.

You can specify 0–999 minutes as a value for ETIME. If you use 0 (the default), VTAM displays a record of all conversations.

ID=appl_name

Identifies the name of the LU 6.2 application to which the requested conversation information applies. This value cannot be a network-qualified name.

LOGMODE=logon_mode_name

Specifies the logon mode name to which the requested conversation information applies. Active conversations that use the specified logon mode name are displayed.

LUNAME=lu_name

Specifies the name of the partner LU to which the requested conversation information applies. Active conversations with the specified partner LU are displayed. The name can be a network-qualified name in the form of netid.luname.

If PARMS=(NQNAMES=NO) is coded on the ACB macro of the resource named on the ID operand, and a network-qualified name is specified, the network identifier is ignored.

If PARMS=(NQNAMES=YES) is coded on the ACB macro, luname can be either a non-network-qualified name or a network-qualified name. If luname is a non-network-qualified name, the command is processed against all LUs with that non-network-qualified name across all networks. If luname is a network-qualified name, the command is processed against the LU in the specified network.

Resulting display

The resulting VTAM display shows:

The names of the partner LUs in the conversations
Each partner LU's logon mode name
Each conversation's identifier
Each conversation's session identifier
The availability of HPDT services at the time the session was established
Each conversation's status including whether the conversation is blocked for sending because of pacing constraints
Each conversation's elapsed time in a blocked for pacing state
Each conversation's elapsed time with no new API activity

Examples

Displaying active conversations with a specific partner LU:

d net,convid,id=appcap05,luname=appcap06
IST097I DISPLAY ACCEPTED
IST1040I CONVERSATION(S) FOUND FOR APPCAP05
IST1007I PARTNER = NETA.APPCAP06, LOGMODE = BATCH
IST1008I CONVID = 01000003, STATUS = F_SR, ETIME = 2
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = D5376DF41F2EDFF2, HPDT = NO
IST924I -------------------------------------------------------------
IST314I END

Displaying all active conversations for a specific LU:

d net,convid,id=appcap05
IST097I DISPLAY ACCEPTED
IST1040I CONVERSATION(S) FOUND FOR APPCAP05
IST1007I PARTNER = NETB.APPCAP07, LOGMODE = BATCH
IST1008I CONVID = 01000009, STATUS = SEND, ETIME = 2
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = E7F33883005B53C7, HPDT = YES
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETB.APPCAP06, LOGMODE = BATCH
IST1008I CONVID = 01000008, STATUS = SEND, ETIME = 2
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = E7F33883005B53C6, HPDT = YES
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETA.APPCAP06, LOGMODE = BATCH
IST1008I CONVID = 01000006, STATUS = SEND, ETIME = 4
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = E7F33883005B53C5, HPDT = YES
IST924I -------------------------------------------------------------
IST314I END

Displaying active conversations for a specific logmode:

d net,convid,id=appcap05,logmode=interact
IST097I DISPLAY ACCEPTED
IST1040I CONVERSATION(S) FOUND FOR APPCAP05
IST1007I PARTNER = NETB.APPCAP06, LOGMODE = INTERACT
IST1008I CONVID = 01000011, STATUS = SEND, ETIME = 10
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A3E, HPDT = NO
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETA.APPCAP06, LOGMODE = INTERACT
IST1008I CONVID = 0100000C, STATUS = SEND, ETIME = 14
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A3B, HPDT = NO
IST924I -------------------------------------------------------------
IST314I END

Displaying active conversations for a specific logmode and partner LU:

d net,convid,id=appcap05,luname=appcap06,logmode=batch
IST097I DISPLAY ACCEPTED
IST1040I CONVERSATION(S) FOUND FOR APPCAP05
IST1007I PARTNER = NETB.APPCAP06, LOGMODE = BATCH
IST1008I CONVID = 01000008, STATUS = SEND, ETIME = 18
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A39, HPDT = YES
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETA.APPCAP06, LOGMODE = BATCH
IST1008I CONVID = 01000006, STATUS = SEND, ETIME = 20
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A38, HPDT = YES
IST924I -------------------------------------------------------------
IST314I END

Displaying active conversations with no API activity for more than 2 minutes and the partner LU is found in more than one network:

d net,convid,id=appcap05,luname=appcap06,etime=2
IST097I DISPLAY ACCEPTED
IST1040I CONVERSATION(S) FOUND FOR APPCAP05
IST1007I PARTNER = NETB.APPCAP06, LOGMODE = INTERACT
IST1008I CONVID = 01000011, STATUS = SEND, ETIME = 11
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A3E, HPDT = YES
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETB.APPCAP06, LOGMODE = HOLLY
IST1008I CONVID = 0100000F, STATUS = SEND, ETIME = 13
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A3D, HPDT = YES
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETA.APPCAP06, LOGMODE = INTERACT
IST1008I CONVID = 0100000C, STATUS = SEND, ETIME = 15
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A3B, HPDT = YES
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETB.APPCAP06, LOGMODE = BATCH
IST1008I CONVID = 01000008, STATUS = SEND, ETIME = 18
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A39, HPDT = YES
IST924I -------------------------------------------------------------
IST1007I PARTNER = NETA.APPCAP06, LOGMODE = BATCH
IST1008I CONVID = 01000006, STATUS = SEND, ETIME = 20
IST2161I COCDC BLOCKED TIME = 0
IST1009I SID = EAABEEC32CD34A38, HPDT = YES
IST924I -------------------------------------------------------------
IST314I END

Displaying active conversations for a specific LU that are blocked for sending because of pacing constraints:

d net,convid,id=appcap05,diag=blocked
IST097I DISPLAY ACCEPTED                         
IST1040I CONVERSATION(S) FOUND FOR APPCAP05       
IST1007I PARTNER = NETB.APPCAP07, LOGMODE = BATCH         
IST1008I CONVID = 01000008, STATUS = SEND /B, ETIME = 2   
IST2161I BLOCKED TIME = 2
IST1009I SID = E7F33883005B53C7, HPDT = YES               
IST924I ------------------------------------------------------------
IST314I END

Displaying active conversations for a specific LU that have been blocked for sending because of pacing constraints for at least 2 minutes:

d net,convid,id=appcap05,diag=blocked,btime=2
IST097I DISPLAY ACCEPTED                         
IST1040I CONVERSATION(S) FOUND FOR APPCAP05       
IST1007I PARTNER = NETB.APPCAP07, LOGMODE = BATCH         
IST1008I CONVID = 01000008, STATUS = SEND /B, ETIME = 2
IST2161I BLOCKED TIME = 2
IST1009I SID = E7F33883005B53C7, HPDT = YES               
IST924I ------------------------------------------------------------
IST314I END