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

ENDTCPPTP Command syntax diagram

 

Purpose

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 this iSeries 400 and establish a point-to-point TCP/IP session. Dial mode sessions (*DIAL) allow this iSeries 400 to contact a remote system that supports point-to-point TCP/IP.

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

 

Required Parameters

CFGPRF

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

*ALL: All currently active point-to-point TCP/IP sessions jobs operating in the mode specified by the OPRMODE parameter are ended.

generic*-configuration-profile-name: Specify the generic name of the point-to-point TCP/IP configuration profile. 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.

configuration-profile-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.

 

Optional Parameters

OPRMODE

Specifies the operating mode of the TCP/IP point-to-point session job to be ended. This value must match the value specified in the point-to-point configuration profile specified by CFGPRF.

*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 for ENDTCPPTP

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.

Error messages for ENDTCPPTP

*ESCAPE Messages

TCP1A1F

Cannot process request while &3/&2/&1 using &6.

TCP8205

Required object &2/&1 type *&3 not found.

TCP8209

ENDTCPPTP &1 &3 for &6/&5/&4 completed. &10 of &11 sessions ended.