STRTCP (Start TCP/IP)

STRTCP Command syntax diagram

 

Purpose

The Start TCP/IP (STRTCP) command initializes and activates TCP/IP processing, starts the TCP/IP interfaces, and starts the TCP/IP server jobs. A STRTCP command must be issued before any TCP/IP processing can be performed on the iSeries. This includes Simple Network Management Protocol (SNMP) agent processing.

The TCP/IP interfaces that are started are those that have set the AUTOSTART parameter to a value of *YES using the Add TCP/IP Interface (ADDTCPIFC) command, the Change TCP/IP Interface (CHGTCPIFC) commands, or the iSeries Navigator.

Note:

If TCP/IP is started when no subsystems are active (i.e. the system is in restricted state), no application server jobs or TCP/IP interfaces are started.

>

Jobs can be started for these TCP/IP application servers:

• Simple Network Management Protocol (SNMP) agent
  
  
• Router Daemon (ROUTED)
  
  
• Bootstrap Protocol (BOOTP)
  
  
• Trivial File Transfer Protocol (TFTP)
  
  
• Domain Name Server (DNS)
  
  
• Dynamic Host Configuration Protocol (DHCP)
  
  
• Distributed Data Management (DDM)
  
  
• Virtual terminal support (TELNET)
  
  
• File Transfer Protocol (FTP)
  
  
• Simple Mail Transfer Protocol (SMTP)
  
  
• Line Printer Daemon (LPD)
  
  
• Hypertext Transfer Protocol (HTTP)
  
  
• Post Office Protocol (POP)
  
  
• Remote Execution (REXEC)
  
  
• Network Station Manager Inventory (NSMI)
  
  
• Distributed Computing Environment (DCE)
  
  
• Directory Services (DIRSRV)
  
  
• Ultimedia System Facilities (USF)
  
  
• Network Station Login Daemon (NSLD)
  
  
• Internet Daemon (INETD)
  
  
• Management Central (MGTC)
  
  
• On Demand (ONDMD)
  
  
• NetServer (NETSVR)
  
  
• DataLink File Manager (DLFM)
  
  
• Virtual Private Network (VPN)
  
  
• Extended Dynamic Remote SQL (EDRSQL)
  
  
• IBM Host On-Demand (HOD)
  
  
• On-Demand Platform Authentication (ODPA)
  
  
• Simple Network Time Protocol (NTP)
  
  
• Quality of Service (QoS)
  
  
• Triggered Cache Manager (TCM)
  
  
• Domino
  
  
• Lotus QuickPlace (LQP)
  
  
• 5250 WebFacing (WEBFACING)

The Start TCP/IP command only starts a TCP/IP application job if the AUTOSTART attribute in the application's configuration is set to *YES when the command is issued. No TCP/IP application jobs are started in the QSYSWRK subsystem if any of the following is true:

• The TCP/IP licensed program product is not installed.
• All of the TCP/IP applications have an AUTOSTART configuration attribute value of *NO.
• STRSVR(*NO) is specified for the STRTCP command. See the description of the STRSVR parameter below.

Use the commands listed below to change the configuration for an application so that it will be automatically started when the Start TCP/IP command is issued.

• For the SNMP agent use the Change SNMP Attributes (CHGSNMPA) command: CHGSNMPA AUTOSTART(*YES)
• For the RouteD server use the Change RouteD Attributes (CHGRTDA) command: CHGRTDA AUTOSTART(*YES)
• For the SMTP application use the Change SMTP Attributes (CHGSMTPA) command: CHGSMTPA AUTOSTART(*YES)
• For the Post Office Protocol (POP) version 3 mail servers use the Change POP Mail Server Attributes (CHGPOPA) command: CHGPOPA AUTOSTART(*YES)
• For the FTP application use the Change FTP Attributes (CHGFTPA) command: CHGFTPA AUTOSTART(*YES)
• For the TELNET application use the Change TELNET Attributes (CHGTELNA) command: CHGTELNA AUTOSTART(*YES)
• For the LPD application use the Change LPD Attributes (CHGLPDA) command: CHGLPDA AUTOSTART(*YES)
• For the World Wide Web HyperText Transfer Protocol (HTTP) server use the Change HTTP Attributes (CHGHTTPA) command: CHGHTTPA AUTOSTART(*YES)
• For the NTP application use the Change NTP Attributes (CHGNTPA) command: CHGNTPA AUTOSTART(*YES)
• For the Distributed Computing Environment (DCE) use the iSeries Operations Navigator to configure DCE and select to autostart upon TCP/IP startup.
• For Directory Services (DIRSRV) use the iSeries Navigator to configure DIRSRV and select to autostart upon TCP/IP startup.

When the STRTCP command is issued and the iSeries is not in restricted state, >the QTCPIP job in the QSYSWRK subsystem is started. The QTCPIP job is used for activating and deactivating TCP/IP interfaces.

Note:

The STRTCP command does not need to be issued to use socket applications that run over an SNA network.

Attention:

Before attempting to start an X.25 interface, ensure that the remote system information (RSI) for non-DDN X.25 interfaces that use a permanent virtual circuit (PVC) is configured. Use the Add TCP/IP Remote System Information (ADDTCPRSI) command to do this. Incoming data from a remote system on the X.25 network is not processed unless an RSI entry for the PVC is configured on the X.25 interface before the interface is started.

 

Optional Parameters

STRSVR

Specifies whether or not TCP/IP application servers are started by the Start TCP/IP (STRTCP) command.

*YES: The STRTCP command also starts all TCP/IP application servers with a configuration attribute of AUTOSTART(*YES) when TCP/IP is activated.

*NO: The STRTCP command does not start any of the TCP/IP application servers when TCP/IP is activated. The AUTOSTART attribute in the application configuration is ignored.

STRIFC

Specifies whether or not to activate all TCP/IP interfaces that specify AUTOSTART(*YES) when TCP/IP is activated.

*YES: When the QTCPIP job is started by the STRTCP command, the job will attempt to activate all TCP/IP interfaces for which AUTOSTART(*YES) is specified.

*NO: The AUTOSTART(*YES) interface parameter will be ignored. No TCP/IP interfaces will be automatically started.

Examples for STRTCP

Example 1: Starting TCP/IP

STRTCP

This command initializes and activates TCP/IP processing, starts the TCP/IP interfaces, and starts the TCP/IP server jobs.

Example 2: Starting TCP/IP and TCP/IP Servers

STRTCP   STRSVR(*YES)

Because *YES is the default value for the STRSVR parameter, the result of issuing this command is identical to the Example 1.

Example 3: Starting TCP/IP But Not the TCP/IP Servers

STRTCP   STRSVR(*NO)

This will start TCP/IP processing without starting any of the TCP/IP application server jobs.

Example 4: Starting TCP/IP in Restricted State

STRTCP   STRSVR(*NO)  STRIFC(*NO)

This will start TCP/IP processing, even if the system is in restricted state. TCP/IP application servers and IP interfaces will not be started.>

Error messages for STRTCP

*ESCAPE Messages

CPF9848

Cannot open file &1 in library &2 member &3.

CPF9849

Error while processing file &1 in library &2 member &3.

TCP1A04

&1 currently active.

TCP1A12

Error occurred submitting interface job.

TCP1A14

Error occurred starting TCP/IP servers.

TCP1A77

&1 completed successfully; however errors occurred.

TCP1D03

&1 member record length not correct.

TCP1D04

Error occurred processing member &1 of &2/&3.

TCP9999

Internal system error in program &1.