gtpc1m02Transmission Control Protocol/Internet Protocol

Transmission Control Protocol/Internet Protocol


Contents

  • Figures

  • Tables

  • Notices
  • Trademarks
  • About This Book
  • Before You Begin
  • Who Should Read This Book
  • How This Book Is Organized
  • Conventions Used in the TPF Library
  • Related Information
  • How to Send Your Comments

  • TCP/IP Support Overview

  • Networking Protocols Introduction
  • TPF System Support of Transmission Control Protocol/Internet Protocol
  • TCP/IP Native Stack Support
  • TCP/IP Network Overview
  • Network Requirements
  • Industry-Standard Transport Application Programming Interface (API)
  • Open Network Connectivity
  • Client/Server Environment
  • Enhanced Role in the Internet
  • Porting Socket Applications

  • TCP/IP Offload Support

  • TCP/IP Internals
  • IBM 3172 Model 3 Interconnect Controller Overview
  • Configuration Characteristics of TCP/IP Offload Devices
  • Data Flow between the Offload Device and the TPF System
  • Sample Transmission Control Protocol/Internet Protocol Network
  • Components of TCP/IP Support
  • Outbound Message Flow through the Socket/CLAW Interfaces
  • Inbound Message Flow through the Socket/CLAW Interfaces
  • Nonsocket User Exits
  • Nonsocket Activation
  • Nonsocket Connect
  • Nonsocket Deactivation
  • Nonsocket Message
  • TPF Control Block Structures
  • CLAW Device Table (CDT) and Related Control Block Structures
  • Contents of the CLAW Device Table
  • Related Control Block Structures
  • Determining the Value for the CLAWADP Parameter
  • File Descriptor Table and Related Control Block Structures
  • Contents of the File Descriptor Table
  • Related Control Block Structures
  • Determining the Value for the CLAWFD Parameter
  • Internet Protocol Address Table
  • Contents of the Internet Protocol Address Table
  • Related Control Block Structures
  • Determining the Value for the CLAWIP Parameter
  • Maximum Value for the IP Parameter
  • Storage Considerations
  • SNAKEY Parameters
  • Miscellaneous Control Block Structures
  • Socket Thread Control Blocks
  • Calculating the Approximate Total Number of TCP/IP Bytes
  • Example Calculating the Approximate Total Number of TCP/IP Bytes
  • Tuning and Performance
  • Operator Procedures for TCP/IP Offload Support
  • Configuring a TCP/IP System
  • Defining the CLAW Host Name
  • Considerations for IBM 3172 Model 3 Interconnect Controllers
  • Defining CLAW Workstations for a TPF Host Processor
  • Considerations for IBM 3172 Model 3 Interconnect Controllers
  • Activating and Deactivating CLAW Workstations
  • Displaying Information about TCP/IP Support
  • Deleting a CLAW Workstation
  • Moving a CLAW Workstation from One TPF Host Processor to Another
  • Performing a Hardware Switchover
  • Using the CLAW Data Trace Function
  • Starting the CLAW Data Trace Function
  • Stopping the CLAW Data Trace Function
  • Using the CLAW Process Trace Function
  • Starting the CLAW Process Trace Function
  • Stopping the CLAW Process Trace Function
  • Resetting the ZCLAW Command Lock

  • TCP/IP Native Stack Support

  • TCP/IP Native Stack Support Internals
  • TCP/IP Layers
  • Using CDLC IP Routers
  • Configuration Characteristics of CDLC IP Routers
  • Data Flow between the CDLC IP Router and the TPF System
  • Sample TCP/IP Networks
  • Using OSA-Express Support
  • Configuration Characteristics of the OSA-Express Card
  • Data Flow between the OSA-Express Card and the TPF System
  • Components of TCP/IP Native Stack Support
  • Policy Agent
  • Outbound Message Flow
  • Outbound Message Flow for CDLC
  • Outbound Message Flow for OSA-Express
  • Inbound Message Flow
  • TPF Control Block Structures
  • Socket Block Table Structure
  • Defining the Socket Block Table
  • CDLC IP Configuration Record
  • Defining the CDLC IP Network Configuration
  • CDLC IP CCW Area Table
  • Defining CDLC IP CCW Area Table Resources
  • OSA Configuration Record
  • OSA Control Block Table
  • OSA Shared IP Address Table
  • OSA Read Buffers
  • Defining OSA Read Buffers
  • IP Message Table
  • Defining the IP Message Table
  • IP Routing Table
  • Defining the IP Routing Table
  • Tuning TCP/IP Native Stack Support
  • Tuning Major Control Block Structures
  • Tuning the IP over CDLC Link Layer
  • Tuning the IP Network
  • Performance
  • TCP/IP Network Configurations
  • Selecting the Local IP Address
  • Defining Gateways
  • Operator Procedures for TCP/IP Native Stack Support
  • Configuring a TPF System
  • Enabling TCP/IP Native Stack Support
  • Local IP Addresses
  • Default Local IP Address
  • Maximum Packet Size
  • Types of TPF Local IP Addresses
  • CDLC Addresses
  • Real OSA IP Addresses
  • Virtual IP Addresses (VIPAs)
  • CDLC IP Connections
  • Defining CDLC IP Connections
  • Activating and Deactivating CDLC IP Routers
  • Deleting CDLC IP Routers
  • OSA-Express Connections
  • Defining OSA-Express Cards to the Processor
  • Defining OSA-Express Connections to TPF
  • Activating and Deactivating OSA-Express Connections
  • Displaying OSA-Express Connections
  • Deleting OSA-Express Connections
  • Gateways
  • Routing Information Protocol
  • How Network and Processor Failures Affect VIPAs
  • Swinging VIPAs to an Alternate OSA-Express Connection
  • Moving VIPAs from One Processor to Another
  • Workload Balancing Using Movable VIPAs
  • Configuration Examples
  • Managing IP Routing Table Entries
  • Displaying TCP/IP Native Stack Support
  • Starting and Stopping the IP Trace Function
  • Displaying IP Trace Information
  • Using the Individual IP Trace Function
  • Displaying Individual IP Trace Tables
  • Deactivating Sockets
  • Displaying Socket Control Block Information
  • Socket Application Design Considerations
  • Sharing Sockets
  • Using Existing Socket Applications
  • New Socket Options Supported
  • Send Buffer and Receive Buffer Sizes
  • Timeouts
  • Low-Water Marks
  • activate_on_accept API
  • Local Sockets
  • Simple Network Management Protocol Agent Support
  • SNMP Overview
  • SNMP Manager
  • SNMP Agent
  • Management Information Base (MIB)
  • Interaction between SNMP Components
  • Protocol Data Units (PDUs)
  • Structure and Fields of SNMP PDUs
  • TPF SNMP Agent Support
  • Implementing Management Information Base-II (MIB-II)
  • Processing SNMP Requests
  • Message Processing
  • User MIB Variables
  • SNMP Traps
  • Installing TPF SNMP Agent Support
  • Installing and Defining TPF TCP/IP Native Stack Support
  • Installing the SNMP Agent
  • Creating the SNMP Configuration File
  • Coding the UCOM and UMIB User Exits
  • Defining and Starting the SNMP Agent Server
  • Defining IP Routing Table Entries
  • Defining the TPF System to the SNMP Manager
  • Domain Name System Support
  • DNS Server
  • TPF Host Name Table
  • IP Address Selection
  • DNS Client
  • Internet Security
  • Denial-of-Service Attacks
  • Packet Filtering
  • Packet Filtering Rules File Syntax
  • Considerations for Packet Filtering Rules
  • Examples of Packet Filtering Rules
  • Problem Diagnosis
  • TCP/IP Network Services Database Support
  • Quality of Service
  • Data Collection and Reduction
  • Message Counts by Application
  • TCP/IP Network Services Database File
  • TCP/IP Network Services Database File Syntax
  • TCP/IP Network Services Database File Example

  • Socket Application Programming Interface Overview

  • Socket Overview
  • Sockets
  • Types of Sockets Supported by TCP/IP
  • Socket Address for the Internet Domain
  • Port Numbers
  • Standard Dotted Decimal Formats
  • Mapping Address Parts
  • Integer Byte Order Conversion
  • Blocking and Nonblocking
  • Out-Of-Band Data
  • TPF Socket Application Programming Interface (API) Support
  • Socket API Functions Using TCP/IP Offload Support
  • Socket API Functions Using TCP/IP Native Stack Support
  • Socket User Exits
  • Socket Accept for TCP/IP Offload Support
  • Socket Activation
  • Socket Connect
  • Socket Cycle-Up When Using TCP/IP Offload Support
  • Socket Deactivation
  • Socket System Error
  • TCP/IP Native Stack Support Accept Connection
  • Select TCP/IP Support
  • Socket Cycle-Up When Using TCP/IP Native Stack Support
  • Full-Duplex Socket Support
  • Using activate_on_receipt
  • Socket Sweeper Support to Close Inactive Sockets
  • Sample Socket Sessions
  • Function Calls Used in a Sample TCP Session
  • Using the activate_on_receipt Function Call
  • Function Calls Used in a Sample UDP Session
  • Main Socket Function Calls
  • Socket Application Programming Interface Functions Reference
  • General Function Information
  • accept -- Accept a Connection Request
  • activate_on_accept -- Activate a Program When the Client Connects
  • activate_on_receipt -- Activate a Program after Data Received
  • activate_on_receipt_with_length -- Activate a Program after Data of Specified Length Received
  • bind -- Bind a Local Name to the Socket
  • close -- Shut Down a Socket
  • connect -- Request a Connection to a Remote Host
  • gethostbyaddr -- Get Host Information for IP Address
  • gethostbyname -- Get IP Address Information by Host Name
  • gethostid -- Return Identifier of Current Host
  • gethostname -- Return Host Name
  • getpeername -- Return the Name of the Peer
  • getservbyname -- Get Server Port by Name
  • getservbyport -- Get Server Name by Port
  • getsockname -- Return the Name of the Local Socket
  • getsockopt -- Return Socket Options
  • htonl -- Translate a Long Integer
  • htons -- Translate a Short Integer
  • inet_addr -- Construct Internet Address from Character String
  • inet_ntoa -- Return Pointer to a String in Dotted Decimal Notation
  • ioctl -- Perform Special Operations on Socket
  • listen -- Complete Binding, Create Connection Request Queue
  • ntohl -- Translate a Long Integer
  • ntohs -- Translate a Short Integer
  • read -- Read Data on a Socket
  • recv -- Receive Data on a Connected Socket
  • recvfrom -- Receive Data on Connected/Unconnected Socket
  • recvmsg -- Receive Message on Connected/Unconnected Socket
  • select -- Monitor Read, Write, and Exception Status
  • send -- Send Data on a Connected Socket
  • sendmsg -- Send Message on a Socket
  • sendto -- Send Data on an Unconnected Socket
  • setsockopt -- Set Options Associated with a Socket
  • shutdown -- Shut Down All or Part of a Duplex Connection
  • sock_errno -- Return the Error Code Set by a Socket Call
  • socket -- Create an Endpoint for Communication
  • write -- Write Data on a Connected Socket
  • writev -- Write Data on a Connected Socket

  • Operator Procedures for Internet Server Applications

  • Operator Procedures for the Internet Daemon
  • Internet Daemon
  • Internet Daemon Configuration File
  • Internet Daemon Control
  • Internet Server Application
  • Internet Server Application Control
  • Trivial File Transfer Protocol (TFTP) Server
  • Adding the Trivial File Transfer Protocol (TFTP) Server
  • Directives for the TFTP Configuration File
  • Creating the TFTP Configuration File
  • Transferring and Maintaining the TFTP Configuration File
  • File Transfer Protocol (FTP) Server
  • FTP Server LOG File
  • Adding the File Transfer Protocol (FTP) Server
  • Syslog Daemon
  • Files
  • Syslog Daemon Configuration File
  • Modifying the Syslog Daemon Configuration File
  • Adding the Syslog Daemon Server
  • Operating the Syslog Daemon
  • Starting the Syslog Daemon
  • Stopping the Syslog Daemon
  • Offloading Log Files
  • Diagnosing Syslog Daemon Configuration Problems
  • Application Considerations
  • TPF Internet Mail Server Support
  • TPF Internet Mail Server Overview
  • Mail Database Layout
  • Recoup Considerations for the Mail Database
  • TPF Internet Mail Server Configuration Files
  • SMTP Configuration File Parameters
  • IMAP/POP Configuration File Parameters
  • TPF Configuration File Parameters
  • Access List Configuration Parameters
  • TPF Internet Mail Server Administrator or Operator Tasks
  • Configuring the TPF System for TPF Internet Mail Server Support
  • Adding a Domain to an Existing TPF Internet Mail Server Configuration
  • Adding New Users to an Existing TPF Internet Mail Server Configuration
  • Controlling the TPF Internet Mail Servers
  • Managing Client Mailboxes
  • TPF Internet Mail Server Client Tasks

  • Secure Sockets Layer (SSL) Support

  • Secure Sockets Layer (SSL) Support
  • SSL_accept
  • SSL_aor
  • SSL_check_private_key
  • SSL_connect
  • SSL_CTX_check_private_key
  • SSL_CTX_free
  • SSL_CTX_load_and_set_client_CA_list
  • SSL_CTX_load_verify_locations
  • SSL_CTX_new
  • SSL_CTX_new_shared
  • SSL_CTX_set_cipher_list
  • SSL_CTX_set_client_CA_list
  • SSL_CTX_set_default_passwd_cb_userdata
  • SSL_CTX_set_verify
  • SSL_CTX_use_certificate_chain_file
  • SSL_CTX_use_certificate_file
  • SSL_CTX_use_PrivateKey_file
  • SSL_CTX_use_RSAPrivateKey_file
  • SSL_free
  • SSL_get_cipher
  • SSL_get_error
  • SSL_get_peer_certificate
  • SSL_get_session
  • SSL_get_verify_result
  • SSL_get_version
  • SSL_library_init
  • SSL_load_and_set_client_CA_list
  • SSL_load_client_CA_file
  • SSL_new
  • SSL_pending
  • SSL_read
  • SSL_renegotiate
  • SSL_set_cipher_list
  • SSL_set_client_CA_list
  • SSL_set_fd
  • SSL_set_session
  • SSL_set_verify
  • SSL_shutdown
  • SSL_use_certificate_file
  • SSL_use_PrivateKey_file
  • SSL_use_RSAPrivateKey_file
  • SSL_write
  • SSLv2_client_method
  • SSLv2_server_method
  • SSLv23_client_method
  • SSLv23_server_method
  • SSLv3_client_method
  • SSLv3_server_method
  • TLSv1_client_method
  • TLSv1_server_method

  • Appendixes

  • Appendix A. CLAW Trace Postprocessor
  • Sample JCL for the CLAW Data Trace Postprocessor
  • CLAW Data Trace Postprocessor
  • Sample JCL for the CLAW Process Trace Postprocessor
  • CLAW Process Trace Postprocessor
  • Appendix B. ISO-C Structures Called by Socket API Functions
  • Structures Defined in the socket.h Header File
  • Additional Structures
  • Appendix C. Socket Error Return Codes

  • Appendix D. Sample Application Driver Code
  • activate_on_receipt Transmission Control Protocol (TCP) Server
  • activate_on_receipt Transmission Control Protocol (TCP) Child Server
  • Transmission Control Protocol (TCP) Server
  • Transmission Control Protocol (TCP) Client
  • User Datagram Protocol (UDP) Server
  • User Datagram Protocol (UDP) Client
  • Appendix E. TCP/IP Restricted CLAW C Functions: Reference
  • claw_accept -- Accept a CONNECT Request from the Workstation
  • claw_closeadapter -- Terminate CLAW Activity on Subchannel Pair
  • claw_connect -- Initiate a Request to Open a Logical Link
  • claw_disconnect -- Remove a Logical Link from an Adapter
  • claw_end -- Terminate All CLAW Activity
  • claw_initialization -- Prepare for CLAW Activity
  • claw_openadapter -- Initialize an Adapter
  • claw_query -- Get the Status of CLAW Adapter or Logical Links
  • claw_send -- Send a Message on an Active Logical Link
  • CLAW Return Codes
  • Appendix F. Using the Internet Protocol Trace Facility
  • About the IP Trace Table
  • Starting the IP Trace Facility and Specifying Which Data to Trace
  • Stopping the IP Trace Facility
  • Defining How Much Data to Store in the IP Trace Table
  • Writing the IP Trace Table to a Real-Time Tape
  • Displaying Information about the IP Trace Facility
  • Displaying the IP Trace Table Online
  • Creating a Compacted Display of the IP Trace Table
  • Creating a Formatted Display of the IP Trace Table
  • Using the Offline IPTPRT Utility to Create an IPTPRT Report
  • Sample JCL for the IPTPRT Utility
  • Defining the IPTPRT Report
  • IPTPRT Messages
  • Including the IP Trace Table in System Error Dumps
  • Appendix G. Management Information Base Variables
  • MIB Variable Types
  • Index