Display APPN Information (DSPAPPNINF)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Display APPN Information (DSPAPPNINF) command provides the user with Advanced Peer-to-Peer Networking (APPN) network information which is used to assist in problem analysis. The user specifies one basic type of network information being shown, printed, or stored in an output file: information about the network topology, the local directory, or session information. More information on APPN functions is in found in the APPN information in the Networking category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ book.

Top

Parameters

Keyword	Description	Choices	Notes
INFTYPE	Type of information	TOPOLOGY, LCLNODE, *SSN	Optional, Positional 1
NODES	Nodes	ALL, ACTIVE, *INACTIVE	Optional, Positional 2
SSNTYPE	Session type	ENDPNT, INMSSN	Optional, Positional 3
JOB	Job name	Qualified job name	Optional
	Qualifier 1: Job name	Name
	Qualifier 2: User	Name
	Qualifier 3: Number	000000-999999
CTL	Controller description	Name, *ALL	Optional
OUTPUT	Output	, PRINT, *OUTFILE	Optional
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD

Top

Type of information (INFTYPE)

Specifies the type of information given.

The possible values are:

*TOPOLOGY: The contents of the topology database is shown or printed. The local topology database contains the set of all nodes and their characteristics and, for each node, the set of link destination nodes along with the characteristics of the connecting links.
*LCLNODE: The contents of the local directory is shown or printed. The local directory contains the local node and the names of all remote control points and their locations.
*SSN: The information about intermediate sessions or sessions that have the local node as a session endpoint is shown or printed.

Top

Nodes (NODES)

Specifies the set of nodes that is requested. This parameter is valid only if *TOPOLOGY is specified on the Type of information prompt (INFTYPE parameter).

The possible values are:

*ALL: All nodes in the topology database are shown or printed.
*ACTIVE: Only the active nodes are shown or printed.
*INACTIVE: Only the inactive nodes are shown or printed.

Top

Session type (SSNTYPE)

Specifies which type of session information is shown. This parameter is valid only when *SSN is specified on the Type of information prompt (INFTYPE parameter).

The possible values are:

*ENDPNT: Information about sessions for which the local node is a session endpoint is shown or printed.
*INMSSN: Information about intermediate sessions being routed through the local node is shown or printed.

Top

Job name (JOB)

Specifies the name of the job for which session information is shown or printed. If * is specified on the Output prompt (OUTPUT parameter) and no job name is specified, a list of APPN job names run since the most recent initial program load (IPL) of the system is displayed. You can select a job name from that list. If *PRINT or *OUTFILE is specified on the Output prompt (OUTPUT parameter) and no job name is specified, the session information for all APPN jobs is printed or stored in a specified output file.

This parameter is valid only if *ENDPNT is specified on the Session type prompt (SSNTYPE parameter).

job-name: Specify the job name for which session information is shown or printed.

Top

Controller description (CTL)

Specifies the controller for which intermediate sessions are requested. This parameter is valid only if *INMSSN is specified on the Session type prompt (SSNTYPE parameter).

The possible values are:

*ALL: The intermediate sessions for all controllers are shown or printed.
controller-description-name: Specify the name of the controller for which intermediate sessions are shown or printed.

Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

The possible values are:

*: The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).

*PRINT: The output is printed with the job's spooled output.

*OUTFILE: The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

Top

File to receive output (OUTFILE)

Specifies the name and library of the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library.

Note: If a new file is created, the system uses file QAxxxxx in library QSYS with a format name of QLzzzz as a model, depending on the value specified on the Type of information prompt (INFTYPE parameter). The following table lists the possible values for that parameter and the output file and model that correspond to the values.

Parameter Values             Output File Created
                             OUTFILE  FORMAT
*TOPOLOGY                    QALSTDB  QLSTDB
*LCLNODE                     QALSDIR  QLSDIR
*SSN - endpoint session      QALSEND  QLSEND
*SSN - intermediate session  QALSINM  QLSINM

The possible library values are:

*LIBL: The library list is used to locate the file. If the file is not found, one is created in the current library.
*CURLIB: The current library for the job is used to locate the file. If no library is specified as the current library list for the job, QGPL is used.
library-name: Specify the name of the library where the file is located.

Top

Output member options (OUTMBR)

Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the Output (OUTPUT) parameter.

The possible values for output member options are:

*FIRST: The requested APPN information is stored in the first member. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified in the OUTFILE parameter.
member-name: Specify the name of the member used to store the requested APPN information. If a member name is specified and the member does not exist, the system creates it. Valid values range from 1 through 10 characters.

The optional values are:

*REPLACE: The system clears the existing member and adds the new records.

*ADD: The system adds the new records to the end of the existing records.

Top

Examples

Example 1: Printing a List

DSPAPPNINF   INFTYPE(*TOPOLOGY)  NODES(*ALL)  OUTPUT(*PRINT)

This command prints the list of all nodes currently existing in the APPN network, the set of links destination nodes associated with each node, and the link characteristics for each link.

Example 2: Showing a List of PCIDs

DSPAPPNINF   INFTYPE(*SSN)  SSNTYPE(*ENDPNT)
             JOB(APPNJOB/USERPROF/000001)  OUTPUT(*)

This command shows a list of procedure correlation session identifiers (PCIDs) associated with the job name APPNJOB/USERPROF/000001. From this list, the user can specify an option to show additional information about a session.

Example 3: Storing Contents of a Directory

DSPAPPNINF   INFTYPE(*LCLNODE)  OUTPUT(*OUTFILE)
             OUTFILE(USERLIB/APPNFILE)  OUTMBR(*FIRST, *REPLACE)

This command stores the contents of the local directory in the first member of an output file named USERLIB/APPNFILE. If information already exists in this member, the new information replaces the existing information.

Top

Error messages

None

Top