STRTCPPTP (Start Point-to-Point TCP/IP)

STRTCPPTP Command syntax diagram

 

Purpose

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. 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) are used to have this iSeries 400 contact a remote system and establish a point-to-point TCP/IP session.

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

 

Required Parameters

CFGPRF

Specifies the name of the point-to-point configuration profile to use. The profile specifies all the attributes and values necessary to define this session. The mode specified in the profile determines whether this iSeries 400 will be contacting a remote system (*DIAL session), or if a remote system will be contacting this iSeries 400 (*ANS session). All other information about the characteristics of the session is also contained in the point-to-point configuration profile.

configuration-profile-name: Specify the name of a valid, inactive point-to-point configuration profile.

 

Optional Parameters

RESTART

Specifies whether to restart the point-to-point TCP/IP session job running the profile defined by the CFGPRF parameter. This parameter is only valid when used for a running point-to-point profile. If RESTART(*YES) is used with a point-to-point profile that is not running then an error will be posted.

*NO: Do not restart the TCP/IP point-to-point session job.

*YES: Restart the TCP/IP point-to-point session job. How the TCP/IP point-to-point session job is restarted depends on the type of point-to-point session that is running. By type, the session will be restarted as follows:

• Switched Line Dial (Dial remote systems)

  • Reset the session to start from Re-Dialing the remote system.

• Switched Line Answer (Answering incoming calls)

  • Reset the session to Ring Wait state (wait for remote system to dial)

• Leased Line (Initiator or Terminator) for PPP

  • Reset back to LCP Configure Request

• Leased Line (Initiator or Terminator) for SLIP

  • Reset back to an 'Active' state

• Dial-on-Demand

  • Reset the session to wait for the next Dial-on-Demand request

The OUTPUT, SNDINQMSG and AUTODLTCFG parameters will be ignored when RESTART(*YES) is specified.

OUTPUT

Specifies whether or not to print a copy of the script dialog between this iSeries 400 and the remote system. Use this dialog to diagnose problems that prevent a point-to-point TCP/IP session from being successfully established.

*ERROR: Only print the script dialog if one or more errors occur while establishing the TCP/IP point-to-point session job.

*NONE: Do not print the script dialog.

*PRINT: Print the script dialog with the spooled output of the job that issued the STRTCPPTP command, regardless of whether or not any errors occurred.

SNDINQMSG

Specifies whether or not to send an inquiry message after any initialization has been completed. The inquiry message will be sent to the QTCP message queue.

Until you respond to the inquiry message, the point-to-point session job is held. While the job is held, you can set up trace tools for diagnosing problems related to this TCP/IP point-to-point session job.

*NO: Do not send an inquiry message after initialization has been completed.

*YES: The point-to-point session job will send an inquiry message after it has completed its initialization. If the configuration profile has the attribute for automatic creation of the controller and device, the inquiry message will be sent after the controller description and device description have been created.

AUTODLTCFG

Specifies whether or not any controller description and device description configuration objects that were automatically created during STRTCTPTP initialization should be automatically deleted when the point-to-point session job ends.

*NO: Do not delete any controller description and device description configuration objects that were automatically created by STRTCPPTP. This allows the controller description and device description to be reused the next time a TCP/IP point-to-point session job is started using the specified configuration profile.

*YES: Delete any controller description and device description configuration objects that were automatically created during STRTCPPTP initialization.

Examples for STRTCPPTP

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 this iSeries 400 will be contacting a remote system (*DIAL session), or if a remote system will be contacting this iSeries 400 (*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 iSeries 400 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 example uses the SNDINQMSG parameter. This parameter 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 this iSeries 400.

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

Error messages for STRTCPPTP

*ESCAPE Messages

TCP1A1F

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

TCP8205

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

TCP8207

STRTCPPTP &1 not performed. Job &6/&5/&4 using &1.

TCP8208

STRTCPPTP &1 not performed. See previous messages.