CL Command Reference - STRTCPPTP

CL Command List > STRTCPPTP Reference

Description:

The Start Point-to-Point TCP/IP (STRTCPPTP) command is used to start a point-to-point TCP/IP session job. A session job operates in one of two possible modes:
1. Answer mode (*ANS) sessions allow a remote system to contact the local system and establish a point-to-point TCP/IP session.
2. Dial mode (*DIAL) sessions are used to have the local system contact a remote system and establish a point-to-point TCP/IP session.

Note: You can start any profiles of linetype *PPP with this command. You must use iSeries Navigator to configure *PPP profiles.


Examples:

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

STRTCPPTP CFGPRF(DIALPRF)

This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile ¡åDIALPRF¡å contains the information that will determine whether the local system will be contacting a remote system (*DIAL session), or if a remote system will be contacting the local system (*ANS session).



Example 2: Start a Session and Capture the Script Dialog.

STRTCPPTP CFGPRF(DIALPRF) OUTPUT(*PRINT)

This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile ¡åDIALPRF¡å contains the information that the local system will use to contact the remote system and establish a point-to-point TCP/IP session with it. A copy of the dialog exchanged between the two systems prior to establishing a point-to-point TCP/IP session is written to the default output queue for the job that issued the STRTCPPTP command.



Example 3: Send an Inquiry Message After Initializing the TCP/IP Session Job.

STRTCPPTP CFGPRF(ANSWERPRF) SNDINQMSG(*YES)

This command uses the SNDINQMSG parameter, which is normally used only if it is necessary to collect detailed internal trace information when the controller and device description used by the point-to-point session job are automatically created.

This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile ¡åANSWERPRF¡å contains the information that will be used to establish a point-to-point TCP/IP session when a remote system contacts the local system.

After automatically creating the controller and device description it will use, the point-to-point session job will send an inquiry message to the QTCP message queue. Depending on the response, the job will either continue running or will be cancelled.



Example 4: Restarting a Running Point-To-Point Profile.

STRTCPPTP CFGPRF(ANSWERPRF) RESTART(*YES)

This command will restart the running point-to-point profile ANSWERPRF. How the session is reset (restarted) depends on the connection type of the line (switched or unswitched) and the mode (dial or answer). For more information on how the session would be reset, see the details for RESTART(*YES) above.