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


ATB104I

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

ATB104I
hh.mm.ss APPC DISPLAY [id]

Explanation

In the message, the following appears:
APPC UR’S EXPRESSIONS OF INTEREST  LOGSTREAM NAME
  ttttt            eeeee           logstreamname 
[URID=urid
EXPRESSION OF INTEREST COUNT=cnt    SYNC POINT IN PROG=sss
LUWID=luwid]
[LTPN=tpname|X'hh'ccc
PTPN=tpname|X'hh'ccc
CONV CORRELATOR=ccid
LLUN=luname    PLUN=pluname    DIRECTION=dir
RESYNC REQUIRED=rrr    IMPLIED FORGET=fff]

When the operator enters the DISPLAY APPC,UR command, this message displays information that APPC/MVS has about local units of recovery (URs) and APPC/MVS expressions of interest in these URs. The information is displayed with conversation information, such as local and partner LU names, protected LUWIDs, conversation correlators, and local and remote TP names.

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 DISPLAY command was processed.
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.
APPC UR'S ttttt
The number of URs that have at least one expression of recoverable interest from APPC/MVS that meets all the specified optional selection parameters. ttttt is displayed as a decimal integer.
EXPRESSIONS OF INTEREST eeeee
The number of expressions of recoverable interest from APPC/MVS that meet all the specified optional selection parameters. eeeee is displayed as a decimal integer.
LOGSTREAM NAME logstream_name
The log stream name APPC uses to store information related to partner LUs that APPC has established sync-level syncpoint conversations with. If LOGGING=RRSGNAME was specified in the APPC started procedure, and if RRS is not active, then a value of *UNKNOWN* will be displayed. See z/OS MVS Planning: APPC/MVS Management for further information regarding the naming of APPC log streams.

If the command includes the LIST parameter, lines 4 through 6 appear for each UR included in the summary.

In lines 4 through 6 of the message text:
URID=urid
The URID is the RRS unit of recovery identifier (in hexadecimal)

You can use this URID with the LUWID also displayed by this message to correlate information when using the RRS ISPF panels. For more information on the RRS ISPF panel interface, see z/OS MVS Programming: Resource Recovery.

EXPRESSION OF INTEREST COUNT=num
The number of APPC/MVS expressions of recoverable interest in this unit of recovery that meet all the specified optional selection parameters. num is displayed as a decimal integer.
SYNC POINT IN PROG=sss
sss is one of the following:
YES
A syncpoint verb (Commit or Backout) is in progress for the unit of recovery.
NO
There is no syncpoint verb in progress for the unit of recovery.
LUWID=luwid
The protected logical unit of work ID (LUWID) for this unit of recovery. You can use this LUWID with the URID also displayed by this message to correlate information when using the RRS ISPF panels. For more information on the RRS ISPF panel interface, see z/OS MVS Programming: Resource Recovery.
If the DISPLAY APPC,UR command includes the ALL parameter, the following lines appear in the message text:
  • One occurrence of lines 4 through 6, for each unit of recovery for which APPC/MVS has at least one expression of recoverable interest that meets all the specified optional selection parameters.
  • One occurrence of lines 7 through 10, for each APPC/MVS expression of recoverable interest that meets all the specified optional selection parameters.
The expressions of interest are grouped together by unit of recovery.
In lines 7 through 11 of the message text:
LTPN=tpname|X'hh'ccc
In the message text:
tpname
The local TP name. It is 1 to 64 characters long. If there is no inbound conversation or the TP name cannot be determined, *UNKNOWN* appears in this field.
¬X'hh'ccc
The 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 in non-hexadecimal form.
ccc
A character string, with a maximum length of 3.

If there is no inbound conversation to the TP, *UNKNOWN* appears in this field.

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 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 in non-hexadecimal form.
ccc
A character string, with a maximum length of 3.
*UNKNOWN* appears in this field when either:
  • The conversation is inbound, or
  • The TP name cannot be determined
CONV CORRELATOR=ccid
The conversation correlator of the conversation for which APPC expressed interest. ccid is displayed in character representation of hexadecimal digits.
Note: A conversation correlator is unique among all the conversation correlators created by a particular LU. All conversation correlators are created by the LU that initiates the conversation allocation.
LLUN=luname
The 8-byte network LU name of the local LU. luname is displayed as character data.
PLUN=pluname
The network-qualified name of the partner LU, if its network ID is known. pluname is displayed as character data.
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.
*UNKNOWN*
The conversation direction is either not applicable or not available.
RESYNC REQUIRED=rrr
rrr is one of the following:
YES
Resynchronization is required for the unit of recovery because of a protected conversation failure. Resynchronization is required to achieve a state of consistency.
NO
Resynchronization is not required for the unit of recovery.
IMPLIED FORGET=fff
fff is one of the following:
YES
Indicates an implied-forget condition. Before it can complete, the unit of recovery requires the receipt of a network flow as notification that the syncpoint initiator has received the last message about the expression of interest.
NO
Indicates there is no implied-forget condition.

System action

The system continues processing.

Module

ATBCODP

Source

APPC/MVS

Routing Code

2

Descriptor Code

5

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014