In the message, the following appears:
LOCAL TP'S INBOUND CONVERSATIONS OUTBOUND CONVERSATIONS
ttttt ccccc ooooo
[LTPN=tpname|X'hh'ccc | STPN=tpname|¬X'hh'ccc
LLUN=luname WUID=workid CONVERSATIONS=mmmmm ASID=asid
SCHED=schdname ASNAME=adspname TPID=tpid]
[PTPN=tpname|X'hh'ccc
PLUN=luname USERID=userid DIRECTION=dir
VERBS=verbs IT=nnnnnnnn LCID=lcid
MODE=mode VTAMCID=cid]
The
operator entered the DISPLAY APPC,TP command to display information
about local transaction programs (TPs) and their conversations.
The
first three lines of the message always appear.
In the first
three lines of the message text:
- hh.mm.ss
- The hour, minute, and second at which the system processed the
DISPLAY command. 00.00.00 appears in this field if the time
of day (TOD) clock is not working.
- id
- A decimal identifier used with the CONTROL C,D command to cancel
status displays that are written on typewriter or printer consoles
or displayed inline on a display console. This identifier does not
appear when the display appears in a display area on a display console.
- LOCAL TP'S nnnnn
- The number of APPC/MVS TPs that the system is currently processing,
or that were selected by optional keyword parameters. This value includes
the number of TPs that are being processed by APPC/MVS servers (served
TPs) and TPs that have been scheduled by APPC/MVS transaction schedulers.
This later group of TPs is called scheduled TPs.
- INBOUND CONVERSATIONS nnnnn
- The number of inbound conversations that are currently allocated,
or that were selected by optional keyword parameters.
- OUTBOUND CONVERSATIONS nnnnn
- The number of outbound conversations currently allocated, or that
are selected by optional keyword parameters.
Note: If the partner TP is another local APPC/MVS
TP, the conversation is considered local. Unless one or both ends
of a local conversation are suppressed from the display by keyword
filter parameters, the system displays all local conversations twice,
as follows:
- The TP that did the allocate is shown as the local TP. The allocated
TP is shown as the partner.
- The allocated TP is shown as the local TP. The TP that did the
allocate is shown as the partner.
If the command includes the LIST parameter, lines 4 through
6 appear for each local TP that is currently active, or a subset of
these TPs, depending on whether the operator specified one or more
optional filter keyword parameters on the command.
The TPs
are grouped by address space, with lines 4 through 6 repeated for
each local TP running in an address space. Information about TPs processed
by APPC/MVS servers (served TPs) is separate from information about
TPs scheduled by an APPC/MVS transaction scheduler.
Lines 4-6
appear first for a local scheduled TP, if one is running in the address
space. The LTPN= variable indicates local scheduled TPs. Lines 4
through 6 appear for each served TP running in an address space, if
any. The STPN= variable indicates local served TPs.
An address
space can contain, at most, one local inbound scheduled TP, together
with TP. An address space can, however, contain any number of served
local TPs.
In lines 4 through 6 of the message text:
- LTPN=tpname|X'hh'ccc or
STPN=tpname|X'hh'ccc
- In the message text:
- tpname
- The local TP name. If the TP is scheduled by a transaction scheduler,
LTPN= precedes the name. If the TP is served by an APPC/MVS server,
STPN= precedes the name. The TP name is 1 to 64 characters long.
- ¬X'hh'ccc
- The systems network architecture (SNA) service TP name. In the
variable text:
- hh
- The first character of the SNA service TP name, in hexadecimal.
This character is non-displayable.
- ccc
- A character string, with a maximum length of 3.
For outbound conversations, *UNKNOWN* appears
in this field.
- LLUN=luname
- The logical unit (LU) name.
- WUID=workid
- The work unit identifier, which the transaction scheduler assigns
to a program instance using the Unit_of_Work_ID. The value in this
field is *UNKNOWN* if:
- The transaction scheduler does not use the associate service
- The transaction scheduler does not use the Unit_of_Work_ID parameter
on the associate service
- The TP is not scheduled by a transaction scheduler
- CONVERSATIONS=nnnnn
- The number of conversations in which the TP is involved. The
maximum value is 99999.
- ASID=asid
- The address space identifier (ASID) to which the TP is associated.
- SCHED=schdname
- The name of the transaction scheduler that scheduled the TP. It
is the value of a SCHED keyword in the APPCPMxx parmlib
member. If the TP is a batch job, started task, or TSO/E user, or
if the TP is running under an LU that is not associated with a transaction
scheduler (NOSCHED LU), *NONE* appears in this field.
- ASNAME=adspname
- The name of the address space with which the TP is currently associated.
If the local TP is running as a batch job, the job name appears in
this field. If the local TP is running under TSO/E, the TSO/E userid
appears in this field. If the local TP is running in a transaction
initiator, a value from the TP profile appears in this field.
- TPID=tpid
- The TP identifier. It is a 16-digit hexadecimal value. The field
(including TPID=) does not appear for served TPs.
If the DISPLAY APPC,TP command includes the
ALL parameter, the following lines appear in the message text:
- Lines 4 through 6
- One occurrence of lines 7 through 10 for each conversation in
which the local transaction program is involved.
In lines 7 through 10 of the message text:
- PTPN=tpname|X'hh'ccc
- In the message text:
- tpname
- The partner TP name. It is 1 to 64 characters long. For inbound
conversations, *UNKNOWN* appears in this
field.
- ¬X'hh'ccc
- The systems network architecture (SNA) service TP name. In the
variable text:
- hh
- The first character of the SNA service TP name, in hexadecimal.
This character is non-displayable.
- ccc
- A character string, with a maximum length of 3.
For inbound conversations, *UNKNOWN* appears
in this field.
- PLUN=unitname
- The partner LU name.
- USERID=userid
- The userid that flowed into or out of APPC/MVS on an ALLOCATE
request for this conversation. For an inbound conversation, it is
the userid of the local system TP. For an outbound conversation, it
is the userid of the partner TP. If a userid was not specified, *NONE* appears
in this field.
- DIRECTION=dir
- The direction of the conversation, which is one of the following:
- INBOUND
- The conversation is inbound. It was allocated by the partner
TP.
- OUTBOUND
- The conversation is outbound. It was allocated by the local TP.
- VERBS=nnnnnnnn
- The number of APPC callable services issued by the local TP on
this conversation. The maximum value is 99999999.
- IT=nnnnnnnn
- The amount of time that the local TP has been waiting for data
or a confirmation from the partner TP. Depending on the amount of
time, nnnnnnnn has one of the following formats:
- sss.ttt S
- The time is less than 1000 seconds.
- hh.mm.ss
- The time is at least 1000 seconds, but less than 100 hours.
- hhhhh.mm
- The time is at least 100 hours.
- ********
- The time is greater than 99999 hours.
- NOTAVAIL
- The time-of-day (TOD) clock is not working
- *NONE*
- The local TP is not waiting for data or a confirmation.
In the variable text:
- ttt
- The number of milliseconds.
- sss or ss
- The number of seconds.
- mm
- The number of minutes.
- hh or hhhhh
- The number of hours.
- LCID=lcid
- The local conversation identifier. It is an 8-digit hexadecimal
value. For a Virtual Telecommunications Access Method (VTAM®) conversation, *NONE* appears in
this field.
- MODE=modename
- The mode used by the conversation.
- VTAMCID=cid
- The VTAM conversation identifier.
For a VTAM conversation, this
provides the link between APPC and VTAM.
For a local conversation, *NONE* appears in this field. It
is an 8-digit hexadecimal value.