Work with APPN Status (WRKAPPNSTS)

The Work with APPN Status (WRKAPPNSTS) command allows you to display and work with information about the status of APPN and HPR network sessions, and RTP connections on your local system. The controller (CTL) parameter and either the RMTLOCNAME parameter or the RMTCPNAME parameter (if specified), are used to select the information to display. Note that RMTLOCNAME and RMTCPNAME cannot both be specified.

Parameters

Keyword	Description	Choices	Notes
OPTION	Option	SELECT, LOC, *RTP	Optional, Positional 1
CTL	Attached controller	Generic name, name, *ALL	Optional
RMTNETID	Remote network identifier	Communications name, ALL, NETATR	Optional
RMTLOCNAME	Remote location	Generic name, name, *ALL	Optional
RMTCPNAME	Remote control point	Generic name, name, *ALL	Optional
MODE	Mode	Generic name, name, ALL, NETATR	Optional
TCID	Transport connection ID	Character value, *ALL	Optional

Top

Option (OPTION)

Specifies the type of information that you can work with.

The possible values are:

*SELECT: A list of options is shown that allows a user to select the information with which to work.
*LOC: The Work with APPN Locations panel is displayed.
*RTP: The Work with RTP Connections panel is displayed.

Attached controller (CTL)

Specifies the controller name for which status is shown. Only sessions using the specified controller are listed on the Work with APPN Status display.

The possible values are:

*ALL: All controllers with active APPN sessions are shown.
generic*-controller-name: Specify the generic name of the controller.
controller-name: Specify the name of the controller.

Remote network identifier (RMTNETID)

Specifies the name of the remote network in which the remote control point or remote location reside.

The possible values are:

*ALL: All remote locations and all remote control points with active APPN sessions are shown. If *ALL is specified for RMTNETID, then RMTCPNAME and RMTLOCNAME must be *ALL.
*NETATR: The LCLNETID value specified in the system network attributes is used.
remote-network-identifier: Specify the remote network identifier.

Remote control point (RMTLOCNAME)

Specifies the remote location name of active APPN sessions for which status is shown. Only sessions with the specified remote location name are listed on the Work with APPN Status display.

The possible values are:

*ALL: All remote locations with active APPN sessions are shown.
generic*-remote-location-name: Specify the generic name of the remote location.
remote-location-name: Specify the full name of a remote location.

Remote control point (RMTCPNAME)

Specifies the remote control point name of active APPN sessions for which status is shown. Only sessions with the specified remote control point name are listed on the Work with APPN Status display.

For the OPTION(*RTP) view, RMTCPNAME is used to specify the control point name for the RTP connection partner. For the OPTION(*LOC) view, RMTCPNAME is used to specify the control point name for the attached controller.

The possible values are:

*ALL: All remote control points with active APPN sessions are shown.
generic*-remote-control-point-name: Specify the generic name of the remote control point.
remote-control-point-name: Specify the full name of a remote control point.

Mode (MODE)

Specifies the name of the mode by which to subset all list entries.

The possible values are:

*ALL: All active sessions are shown.
*NETATR: The DFTMODE value specified in the system network attributes is used.
generic*-mode-point-name: Specify the generic name of the mode.
mode-name: Specify the full name of a mode.

Transport connection ID (TCID)

Specifies the transport connection identifier (TCID) of an RTP connection. Only sessions running over an RTP connection with the specified TCID are listed on the Work with Sessions for RTP Connections panel. This parameter is valid only when OPTION(*RTP) is specified.

The possible values are:

*ALL: All TCIDs with active sessions are shown.
transport-connection-identifier: Specify the TCID to be shown. When the TCID parameter is not equal to *ALL, both the CTL and RMTCPNAME parameters must be *ALL

Examples

Example 1: Working with RTP Connections

WRKAPPNSTS   OPTION(*RTP)  TCID(*ALL)

This command enables the user to display all active RTP connections.

Example 2: Working with APPN Locations

WRKAPPNSTS   OPTION(*LOC)  RMTNETID(ROCV)  RMTCPNAME(ROCAS*)

For the specified remote control point name, this command allows the user to display all APPN location pairs that have active APPN sessions.