Displaying APPC/MVS information

Use the DISPLAY APPC command to display information about the APPC/MVS configuration.

D APPC

D APPC
D APPC,{TP[ ,SUMMARY\|SUM\|S][,{ASID\|A}=asid] } \|,LIST\|,L [,ASNAME=asname] \|,ALL\|,A [,DIR=IN\|OUT] [,IT=sssss[.ttt]] [,LLUN=lluname] [,LTPN=ltpname] [,PNET=pnetid] [,PLUN=pluname] [,PTPN=ptpname] [,SCHED={schedname}] {NONE } [,STPN=stpname] [,USERID=userid] {UR[ ,SUMMARY\|SUM\|S][,URID=urid] } \|,LIST\|,L [,LUWID=luwid] \|,ALL\|,A [,PNET=pnetid] [,PLUN=pluname] [,LLUN=lluname] {SERVER[ ,SUMMARY\|SUM\|S][,{ASID\|A}=asid] } \|,LIST\|,L [,ASNAME=asname] \|,ALL\|,A [,LLUN=lluname] [,STPN=stpname] {LU[ ,SUMMARY\|SUM\|S][,LLUN=lluname] } \|,LIST\|L [,PNET=pnetid] [,PLUN=pluname] \|,ALL\|A [,SCHED={schedname}] {NONE } [,L={a\|name\|name-a}]

 
D APPC,{TP[ ,SUMMARY|SUM|S][,{ASID|A}=asid]         }
           |,LIST|,L            [,ASNAME=asname]     
           |,ALL|,A        [,DIR=IN|OUT]             
                                [,IT=sssss[.ttt]]    
                           [,LLUN=lluname]           
                                [,LTPN=ltpname]      
                           [,PNET=pnetid]            
                           [,PLUN=pluname]           
                                [,PTPN=ptpname]      
                           [,SCHED={schedname}]      
                                   {*NONE*   }       
                                [,STPN=stpname]      
                           [,USERID=userid]          
                                                   
       {UR[ ,SUMMARY|SUM|S][,URID=urid]             }
           |,LIST|,L       [,LUWID=luwid]        
           |,ALL|,A        [,PNET=pnetid]        
                           [,PLUN=pluname]       
                           [,LLUN=lluname]           
       
       {SERVER[ ,SUMMARY|SUM|S][,{ASID|A}=asid]     }
               |,LIST|,L            [,ASNAME=asname] 
               |,ALL|,A        [,LLUN=lluname]       
                                    [,STPN=stpname]  
                                                  
       {LU[ ,SUMMARY|SUM|S][,LLUN=lluname]          }
           |,LIST|L            [,PNET=pnetid]       
                               [,PLUN=pluname]      
           |,ALL|A         [,SCHED={schedname}]      
                                   {*NONE*   }       
[,L={a|name|name-a}]

The parameters are:

TP

Indicates that the system is to display information (message ATB102I) about local transaction programs (TPs) and their conversations.

SUMMARY or SUM or S: Indicates that the system is to use the SUMMARY form of output. The resulting message contains the number of local transaction programs and the number of inbound and outbound conversations.
LIST or L: Indicates that the system is to use the LIST form of output. This output is the same as the SUMMARY display, followed by a list of the transaction programs that are running or that were selected through optional keyword filter parameters. Each entry in the list contains the name of a local transaction program, along with related information.
ALL or A: Indicates that the system is to use the ALL form of output. This output is the same as the LIST output, except that the system inserts a sublist after each entry in the list of transaction programs. The sublist contains information about each conversation associated with the particular local transaction program.
Note: For the output of the DISPLAY APPC,TP command, see the description of message ATB102I.

SERVER

Indicates that the system is to display information (message ATB103I) about APPC/MVS servers and the allocate queues they are serving.

SUMMARY or SUM or S: Indicates that the system is to use the SUMMARY form of output. The resulting display contains the number of servers, the number of allocate queues, and the total number of queued allocate requests in the system.
LIST or L: Indicates that the system is to use the LIST form of output. This output is the same as the SUMMARY display, followed by a list of allocate queues. Each entry in the list contains the name of the served transaction program associated with the allocate queue, along with related information.
ALL or A: Indicates that the system is to use the ALL form of output. This output is the same as the LIST output, except that the system inserts a sublist after each entry in the list. The sublist contains information about each server for a particular allocate queue.
Note: For the output of the DISPLAY APPC,SERVER command, see the description of message ATB103I.

LU

Indicates that the system is to display information (message ATB101I) about logical units (LUs).

SUMMARY or SUM or S: Indicates that the system is to use the SUMMARY format of output. The resulting display contains the number of active, outbound, pending, and terminating logical units.
LIST or L: Indicates that the system is to use the LIST form of output. This output is the same as the SUMMARY display, followed by a list of logical units. Each entry in the list contains the name of a local logical unit, and related information.
ALL or A: Indicates that the system is to use the ALL form of output. This output is the same as the LIST output, except that the system inserts a sublist after each entry in the list. The sublist contains the names of the partner logical units that have sessions established with the local logical unit.
Note: For the output of the DISPLAY APPC,LU command, see the description of message ATB101I.

The following is a list of keywords that filter the displays. When you specify a filter keyword, the system displays only the data that meet the keyword's criteria.

Note:

The same keyword cannot be used twice with a single command.
A command line cannot exceed 126 characters in length.

ASID or A=asid

The address space identifier of the transaction program (with DISPLAY APPC,TP) or server (with DISPLAY APPC,SERVER). Specify a one- to four-digit hexadecimal value.

ASNAME=asname

The address space name of the transaction program (with DISPLAY APPC,TP) or server (with DISPLAY APPC,SERVER). The address space name is one to eight alphanumeric (a-z, 0-9) or special (@, #, $) characters, but the first character cannot be numeric (0-9).

DIR=IN or OUT

The direction of the conversation. DIR can have the values: IN (for INBOUND), or OUT (for OUTBOUND). These values specify INBOUND conversations, which the partner transaction program allocated, and OUTBOUND conversations, which the local transaction program allocated.

IT=sssss[.ttt]

The idle time for a conversation. Idle time is the amount of time that the local transaction program waits for data or for a confirmation from the partner transaction program. sssss specifies the number of seconds, from 0 - 99999; ttt specifies the number of thousandths of a second, from .0 - .999. When you specify this keyword, the system displays only conversations with an idle time greater than or equal to the value you specify.

LLUN=lluname

The local logical unit name. This name is one to eight alphanumeric (a-z, 0-9) or special (@, #, $) characters, but the first character cannot be numeric (0-9).

LTPN=ltpname

The local transaction program name. This name is one to 64 alphanumeric (a-z, 0-9) or special (@, #, $) characters. The name may also contain the characters in character set 00640, except for the following:

comma(,) - used as a parameter delimiter and means that the preceding character is interpreted as the end of the transaction program name
blank( ) - used as a parameter delimiter and means that the preceding character is interpreted as the end of the transaction program name
asterisk(*) - used to filter the name of the transaction program. It can only be used as the last character of the name. An asterisk causes the LTPN keyword filter to match every transaction program name that begins with the characters preceding the asterisk.

You abbreviate the name of the local transaction program by entering the first part of the name, followed by an asterisk. For example, PROCESS* matches every local transaction program name that begins with the letters PROCESS.

To list all the local, non-served TPs on the system (and filter out served TPs), enter LTPN=*.

You can also specify the asterisk as the last character of the displayable format of a SNA service transaction program name.

The displayable format of the SNA service transaction program name is in the form:

¬X'hh'ccc

Where hh is the hexadecimal value for the first non-displayable character and ccc is a character string (one to three characters) from character set Type A. You can abbreviate the name of the SNA transaction program by entering the first part of the name, followed by an asterisk.

Character sets 00640 and Type A are listed in z/OS MVS Planning: APPC/MVS Management.

PNET=pnetid

The network ID where the partner LU resides. This ID is one to eight alphanumeric (a-z, 0-9) or special (@, #, $) characters, and is equivalent to the network-ID portion of a network-qualified LU name. Together with the PLUN parameter, PNET filters the information to be displayed.

PLUN=pluname

The partner logical unit name. This name is one to eight alphanumeric (a-z, 0-9) or special (@, #, $) characters, and is equivalent to the network-LU-name portion of a network-qualified LU name. The first character cannotbe numeric (0-9).

Together with the PNET parameter, PLUN filters the partner LU information to be displayed, as follows:

PNET=pnetid, without a value for PLUN, results in a display of all partner LUs in only the specified network.
PLUN=pluname, without a value for PNET, results in a display of all the partner LUs that share the same specified network LU name in all the networks in the installation.
PNET=pnetid with PLUN=pluname results in a display of only the partner LU that has a network-qualified name that matches the specified network ID and network LU name.
A DISPLAY command without specified values for PNET and PLUN results in a display of information for all partner LUs in all networks.

PTPN=ptpname

The partner transaction program name. This name is one to 64 alphanumeric (a-z, 0-9) or special (@, #, $) characters. The name may also contain the characters in character set 00640, except for the following:

comma(,) - used as a keyword delimiter and means that the preceding character is interpreted as the end of the transaction program name
blank( ) - interpreted as the end of the command and means that the preceding character is interpreted as the end of the transaction program name
asterisk(*) - used to filter the partner transaction program name, it can only be used as the last character of the name. It causes the PTPN keyword filter to match every transaction program name which begins with the characters preceding the asterisk.

You can abbreviate the name of the partner transaction program by entering the first part of the name, followed by an asterisk. For example, PROCESS* matches every partner transaction program name that begins with the letters PROCESS.

You can also specify the asterisk as the last character of the displayable format of a SNA service transaction program name.

The displayable format of the SNA service transaction program name is in the form:

¬X'hh'ccc

Character sets 00640 and Type A are listed in z/OS MVS Planning: APPC/MVS Management.

SCHED=schedname or *NONE*

The transaction scheduler name or *NONE*. The scheduler name is one to eight alphanumeric (a-z, 0-9) characters. Special characters (@, #, $) are not permitted.

For the DISPLAY APPC,TP command, the system displays only the transaction programs scheduled for the transaction scheduler you specify. If you specify *NONE* instead of the name of a transaction scheduler, the system displays only those transaction programs that are not associated with a transaction scheduler (such as transaction programs engaged in an outbound conversation, or transaction programs that are served by an APPC/MVS server).

For the DISPLAY APPC,LU command, the system displays only the logical units controlled by the transaction scheduler you specify. If you specify *NONE* instead of the name of a transaction scheduler, the system displays only those logical units that are not associated with a transaction scheduler. These logical units are known as NOSCHED logical units.

Note: The installation defines the names of the transaction schedulers on the SCHED keyword in the APPCPMxx parmlib member. Although lower-case alphabetic characters are not permitted for scheduler names specified in parmlib, you can use lower-case on the SCHED keyword name. The system translates lower-case characters to their upper-case equivalent before it processes the DISPLAY APPC command.

STPN=stpname

The name of the served transaction program (TP). For DISPLAY APPC,TP, this is the name of a TP that was served by an APPC/MVS server on this system. For DISPLAY APPC,SERVER, this is the TP name for which the server registered.

The name of the served transaction program is one to 64 alphanumeric (a-z, 0-9) or special (@, #, $) characters. This name may also contain the characters in character set 00640, except for the following:

comma(,) - used as a keyword delimiter and means that the preceding character is interpreted as the end of the transaction program name
blank( ) - interpreted as the end of the command and means that the preceding character is interpreted as the end of the transaction program name
asterisk(*) - used to filter the served transaction program name, it can only be used as the last character of the name. It causes the STPN keyword filter to match every transaction program name that begins with the characters preceding the asterisk.

You abbreviate the name of the served transaction program by entering the first part of the name, followed by an asterisk. For example, SERV* matches every served transaction program name that begins with the letters SERV.

To list all the served TPs on the system (and filter out non-served TPs), enter STPN=*.

You can also specify the asterisk as the last character of the displayable format of a SNA service transaction program name.

The displayable format of the SNA service transaction program name is in the form:

¬X'hh'ccc

Character sets 00640 and Type A are listed in z/OS MVS Planning: APPC/MVS Management.

USERID=userid

The userid of the transaction program that is running because of an allocate request. For an inbound conversation, this is the userid of the local MVS™ transaction program. For an outbound conversation, this is the userid of the partner transaction program. If you specify this keyword with the TP parameter, the system only displays conversations in which the userid of the allocated transaction program matches the userid you specify. The userid is one to ten alphanumeric (a-z,0-9) or special (@, #, $) characters.

L=a, name, or name-a

Specifies the display area (a), console name (name), or both (name-a) where the display is to appear.

If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.