End Point-to-Point TCP/IP (ENDTCPPTP)

The End Point-to-Point TCP/IP (ENDTCPPTP) command is used to end a point-to-point TCP/IP session job. A session job operates in one of two possible modes:

Answer mode sessions (*ANS) allow a remote system to contact the local system and establish a point-to-point TCP/IP session.
Dial mode sessions (*DIAL) allow the local system to contact a remote system that supports point-to-point TCP/IP.

Note: Profiles of linetype *PPP can ended with this command but any configuration of *PPP profiles must be done using the iSeries Navigator graphical user interface.

The TCP/IP point-to-point session jobs run in the QSYSWRK subsystem.

Keyword	Description	Choices	Notes
CFGPRF	Configuration profile	Character value, *ALL	Required, Positional 1
OPRMODE	Operating mode	ANY, ANS, *DIAL	Optional, Positional 2

Configuration profile (CFGPRF)

Specifies which point-to-point TCP/IP sessions job or jobs should be ended.

This is a required parameter.

*ALL: All currently active point-to-point TCP/IP sessions jobs operating in the mode specified by the OPRMODE parameter are ended.
generic-name: Specify the generic name of the point-to-point TCP/IP configuration profile to be ended. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all profiles with names that begin with the generic name are ended. If an asterisk is not included, the name is assumed to be a complete point-to-point TCP/IP configuration profile name. All currently active point-to-point TCP/IP session jobs using the profiles indicated and operating in the mode specified by the OPRMODE parameter are ended.
name: Specify the name of a TCP/IP point-to-point configuration profile. The active point-to-point session job using this profile is ended.

Operating mode (OPRMODE)

Specifies the operating mode of the TCP/IP point-to-point session job to be ended.

*ANY: Any point-to-point TCP/IP session job that matches the configuration profile name specified on the CFGPRF parameter is ended, regardless of operating mode.
*ANS: The operating mode of the session to be ended is *ANS. All *ANS point-to-point TCP/IP session jobs that are currently active that match the specified CFGPRF parameter will be ended.
*DIAL: The operating mode of the session to be ended is *DIAL. All *DIAL point-to-point TCP/IP session jobs that are currently active that match the specified CFGPRF parameter will be ended.

Examples

Example 1: End a TCP/IP Point-To-Point Session Job

ENDTCPPTP   CFGPRF(DIALPRF)

This command ends the point-to-point TCP/IP session job that is using configuration profile DIALPRF. The operating mode (OPRMODE) value will default to *ANY so the operating mode is not used in deciding whether to end the session job.

Example 2: End All Answer (*ANS) Mode TCP/IP Point-To-Point Session Jobs

ENDTCPPTP   CFGPRF(*ALL)  OPRMODE(*ANS)

This command ends all active or activating point-to-point answer mode (*ANS) TCP/IP session jobs.

Example 3: End All TCP/IP Point-To-Point Session Jobs

ENDTCPPTP   CFGPRF(*ALL)

This command ends all active or activating point-to-point TCP/IP session jobs.

Example 4: End All TCP/IP Point-To-Point Session Jobs Starting with XYZ.

ENDTCPPTP   CFGPRF(XYZ*)

This command ends all active or activating point-to-point TCP/IP session jobs that have profiles that begin with XYZ.

Example 5: End an Answer Mode TCP/IP Point-To-Point Session Job using a Specific Profile Name

ENDTCPPTP   CFGPRF(DIALPRF)  OPRMODE(*ANS)

This command will end the point-to-point TCP/IP session job using profile DIALPRF if this profile is defined to run in answer mode. If the profile is defined to run in dial mode then no action will be taken.