z/OS MVS System Messages, Vol 3 (ASB-BPX)
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


ATB102I

z/OS MVS System Messages, Vol 3 (ASB-BPX)
SA38-0670-00

ATB102I
hh.mm.ss APPC DISPLAY [id]

Explanation

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.

System action

The system continues processing.

Module

ATBCODP

Source

APPC/MVS

Routing Code

2

Descriptor Code

5M

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014