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