WRKAPPNSTS (Work with APPN Status)

WRKAPPNSTS Command syntax diagram

 

Purpose

Use the Work with APPN Status (WRKAPPNSTS) command to get information about the status of APPN and HPR network sessions, and RTP connections on your local system. The controller (CTL) parameter, the remote network identifier (RMTNETID) parameter, one of either the RMTLOCNAME parameter or the RMTCPNAME parameter, and the TCID parameter when OPTION(*RTP) are used to select the information to display. Note that RMTLOCNAME and RMTCPNAME cannot both be specified.

 

Optional Parameters

OPTION

Specifies one of the options below.

*SELECT: A list of options is shown that allows a user to select the information with which to work.

*LOC: Display the Work with APPN Locations panel.

*RTP: Display the Work with RTP Connections panel.

CTL

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

*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.

RMTNETID

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

*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 RMTNETID value specified in the system network attributes is used.

remote-network-identifier: Specify the remote network identifier.

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.

*ALL: For the remote network identifier specified, 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.

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.

*ALL: For the specified network identifier, 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.

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 only valid with OPTION(*RTP).

*ALL: All TCIDs with active sessions are shown.

transport-connection-identifier: Specify the TCID to show. When the TCID parameter is not equal to *ALL, both the CTL and RMTCPNAME parameters must be *ALL.

MODE

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

*ALL: For the specified network identifier, all APPN sessions (regardless of which mode they are using) with active APPN sessions are shown.

*NETATR: The mode name defined in the network attributes is used.

generic*-mode-name: Specify the generic name of a mode.

mode-name: Specify the name of a mode.

Examples for WRKAPPNSTS

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.

Error messages for WRKAPPNSTS

*ESCAPE Messages

None.