gtps2m02ACF/SNA Data Communications Reference

ACF/SNA Data Communications Reference


Contents

Figures

Tables

Notices

  • Trademarks
  • About This Book

  • Before You Begin
  • Who Should Read This Book
  • Conventions Used in the TPF Library
  • How to Read the Syntax Diagrams
  • Related Information
  • How to Send Your Comments
  • Introduction to TPF SNA Support

  • TPF SNA Overview
  • Basic SNA Terms and Concepts
  • TPF Message Processing Flow Overview

  • TPF Inbound Message Flow
  • Protocol Handling
  • Presentation Handling
  • TPF Outbound Message Flow
  • TPF SNA

  • SNA Data Transfer
  • Common Characteristics of NCP and CTC Data Transfer
  • NCP Data Transfer
  • Unique Characteristics of CTC Data Transfer
  • Multiple-Domain Networks
  • Subarea (PU_5) Environment
  • Cross-Domain Links
  • Cross-Domain Resource Manager (CDRM)
  • Cross-Domain Sessions
  • Low-Entry Networking (PUT 2.1) Environment
  • Control Points
  • Control LUs
  • 3174 APPN Considerations
  • Advanced Peer-to-Peer Networking (APPN) Environment
  • Control Points
  • Message Routing
  • TPF Applications

  • Considerations for Developing Applications That Access NCB Records
  • TPF as Host Node SLU
  • Activating LU-LU Sessions with TPF
  • TPF Application Programming Considerations

  • Function Management Header (FMH)
  • Programming Considerations for Session Initiation
  • Synchronizing Messages with Sequence Numbers
  • 3600 Application Considerations
  • Data Transmission from 3600 to a TPF Application
  • Data Transmission from a TPF Application to a 3600
  • 3270 Application Considerations
  • Non-SNA 3270 Application Considerations
  • SNA 3270 Application Considerations
  • Host Node Application Considerations
  • IMS Relay Application Considerations
  • CICS Relay Application Considerations
  • X.25 NPSI Support
  • NPSI Message Length Considerations
  • Request Unit Chaining
  • RU Sizes
  • NPSI GATE/Fast Transaction Processing Interface (GATE/FTPI)
  • Message Traffic Multiplexing
  • Input Processing
  • Multiplexing Output Traffic
  • Application Program Interface
  • Network Definition
  • Operations
  • Activating the TPF CTCP
  • Activating Multi-Channel Links
  • Traces
  • TPF Mapping Support
  • Airlines Line Control (ALC) Support through SNA

  • TPF Host Interfaces
  • Session Control via VTAM SSCP
  • Command Support
  • Addressing an ALC Device
  • TPF/NEF SNA Multiple Host Support
  • X.25 ALC Interface for Switched or Permanent Virtual Circuits (XALCI)
  • User-Replaceable PSV Routine
  • Network Definition
  • XALCI Configuration
  • TPF Advanced Program-to-Program Communications

  • TPF/APPC Components
  • TPF/APPC Installation Checklist
  • General Installation Tasks
  • Installation Tasks for Low-Entry Networking (LEN)
  • Defining TPF/APPC LUs to the Network
  • Defining TPF/APPC LUs to a VTAM Subsystem
  • Defining a TPF/APPC LU to a PS/2 Workstation (Using a Generic Name)
  • TPF/APPC Control Blocks
  • TPF/APPC Conversation Control Block
  • TPF/APPC Session Control Block
  • TPF/APPC Work Blocks
  • TPF/APPC Work Block
  • TPF/APPC Change Number of Sessions Work Block
  • TPF/APPC Partner Work Block
  • TPF/APPC Half-Session to Presentation Services Record
  • Presentation Services
  • TPF Transaction Program ATTACH Interface
  • Conversation Verbs
  • Change Number of Sessions
  • Finite State Machine
  • Generating the Side Information Table for Mapped Conversations
  • Creating the Input File
  • Running CHQI
  • Side Information Table Offline Program Output
  • Loading the Side Information Data Set to TPF
  • Resource Manager
  • Session Manager
  • Initiating a Session
  • Session Termination
  • Message Flow
  • Inbound Message Queuing
  • System Restart
  • Session Considerations
  • Conversation Considerations
  • Subsystem Considerations
  • Considerations for a Tightly Coupled Environment
  • Considerations for a Loosely Coupled Environment
  • Loosely Coupled Complex Example
  • Loosely Coupled Installation Checklist
  • User Exits
  • Transaction Program Design Considerations
  • Traditional LU 6.2 Conversations
  • Pipeline LU 6.2 Conversations
  • Shared LU 6.2 Conversations
  • Sample Transaction Programs
  • Sample Transaction Program Functions
  • Requesting TPF Transaction Program
  • Requested TPF Transaction Program
  • Sample Requesting TPF Transaction Program
  • Sample Requested TPF Transaction Program
  • High-Performance Routing (HPR) Support

  • Benefits of Using HPR Support
  • HPR Node Types
  • ANR Labels
  • Activating Links
  • RTP Connections
  • TCIDs
  • Starting RTP Connections
  • Deactivating RTP Connections
  • Displaying RTP Connections
  • Starting LU-LU Sessions
  • ROUTE_SETUP Process
  • LU-LU Session Activation Flows
  • Session Addresses
  • Path Switches
  • Path Switch Process
  • Path Switch Timer
  • Detecting Network Failures
  • Short Request Timer
  • Alive Timer
  • NLPs
  • NHDRs
  • THDRs
  • Data
  • HPR Control Messages
  • Network Considerations for NLPs
  • HPR Control Blocks
  • RTPCB Table
  • HPRSAT
  • HPRMT
  • Relationship with Other SNA Control Blocks
  • Host IPL Considerations
  • RTP Connection Resynchronization Process
  • CP-CP Session Failures
  • Flow Control
  • ARB Pacing
  • RTP Output Queue
  • HPR Output Messages
  • Selective Retransmission
  • Retransmitting Output Messages
  • Requesting That Input Messages Be Retransmitted
  • Segmentation and Reassembly
  • Segmenting Output Messages
  • Reassembling Input Messages
  • Installation and Tuning
  • Diagnostic Information
  • Sense Codes Unique to the TPF System
  • TPF/SNA Control Block Structures

  • Resource Vector Table (RVT) and Related Control Block Structures
  • How the RVT Is Organized
  • RVT-Related Control Block Structures
  • Node Control Block (NCB) Records and Related Structures
  • Types of NCB Records
  • NCB-Related Control Block Structures
  • Displaying Information about NCB Records and Related Structures
  • Initializing NCB Records
  • Reclaiming NCB Directory Records and NCB Records
  • Increasing the Number of NCB Directory Records in the TPF System
  • Performance Considerations for Accessing NCB Records
  • Developing Applications That Retrieve NCB Records
  • Allocating or Retrieving a Scratch Pad Area (SPA) for a Dynamic LU
  • Defining SNA Resources to the TPF System

  • Using the OSTG Program to Define SNA Resources
  • Important Considerations
  • Loading Resource Definitions by Performing a Fresh Load
  • Forcing a Fresh Load during the Next IPL
  • Loading Resource Definitions by Performing a Dynamic Load
  • Falling Back to the Old Resource Definitions
  • Displaying Status Information about the Load Functions
  • Using the ZNDYN ADD Command to Define SNA Resources
  • Restrictions
  • Important Considerations
  • Using the ZNDYN CHANGE Command to Change SNA Resource Definitions
  • Using Dynamic LU Support to Define SNA Resources
  • Defining Remote LU Resources
  • Defining Remote ALS Resources
  • Activating and Deactivating Resources

  • Activating and Deactivating a Shared NCP
  • Starting and Stopping Application Programs
  • Activating and Deactivating Cross-Domain Resource Managers
  • Activating and Deactivating Control LU-Logon Manager Sessions
  • Activating and Deactivating APPN CP-CP Sessions
  • CP-CP Session Considerations When Running Loosely Coupled
  • Activating LU-LU Sessions
  • Activating LU-LU Sessions Other Than LU 6.2
  • Activating LU 6.2 Sessions
  • PU 5 Environment
  • PU 2.1 LEN Environment
  • PU 2.1 APPN Environment
  • Mixed PU 5 and PU 2.1 Environment
  • LU-LU Sessions in an APPN Network

  • Predefining TPF LUs to the APPN Network
  • APPN LU Registration Process
  • Remote Initiated LU-LU Sessions
  • Network Services Application Interfaces

  • ISHLL Macro
  • Session Management Request Services
  • Starting Session Management Request Services
  • Requesting Session Resynchronization
  • Requesting Session Termination Interface
  • Session Status Awareness Services
  • Activating Session Status Awareness Services
  • Starting Session Started Notification
  • Starting Session Ended Notification
  • PU 5 FID4 Considerations

  • NCP Support
  • Channel Contact
  • NCP Considerations
  • CTC Support
  • Pre-Channel Contact/Priming
  • Channel Contact
  • Loosely Coupled Considerations
  • Session Initiation
  • VTAM Considerations
  • Class of Service, Virtual Routes, and Transmission Priority
  • Other VTAM Considerations
  • VTAM Considerations for NCP 5.3
  • LU-LU Session VR Assignment for CTC
  • Virtual Route (VR) Activation
  • Virtual Route Deactivation
  • Network Flow Control
  • Software IPL Considerations
  • Hardware IPL Considerations
  • Extended Network Addressing
  • Network Definition
  • SNA Network Interconnection (SNI) Considerations
  • PU 2.1 Considerations

  • General Information
  • Session Control
  • Session Identifiers
  • Extended BIND
  • SNA Restart and ALS Discovery
  • 37x5 Considerations
  • 37x5 and APPN Considerations
  • 37x5 and LEN Considerations
  • Non-37x5 Considerations
  • Non-37x5 and APPN Considerations
  • Non-37x5 and LEN Considerations
  • 3174 Considerations
  • SNA Message Protocol

  • Response Protocol
  • Recoverable and Non-Recoverable Messages
  • Single-Segment Messages
  • Chained and Segmented Messages
  • Multithread Processing
  • Bracket Support
  • Unsolicited Messages
  • Unsolicited Messages Destined for a LNIATA/LEID
  • Unsolicited Messages Destined for a RID
  • 3614/3624 Message Processing
  • 3614/3624 Session Initiation and Application Considerations
  • User Routines

  • Process Selection Vector (PSV)
  • Input Message PSV Processing
  • Output Message PSV Processing
  • PSV Interface
  • PSV Output Message Queueing
  • Defining PSV Routines
  • Logical End-Point Identifiers, Terminals, and PSV Routines
  • Data Flow Control (DFC) Considerations
  • User DFC Interface
  • Outbound Message Interface
  • Pacing Considerations
  • Undeliverable Message Considerations
  • Response Protocols/Error Handling
  • Input Message Router Exit
  • Queue Manager

  • Queue Manager Interface
  • Input Interface
  • Output Interface
  • General Return Codes
  • Detailed Return Codes
  • Diagnostic Aids

  • Trace Functions
  • Operating System Traces
  • Path Information Unit (PIU) Trace Facility
  • SNA I/O Trace Facility
  • Reliability and Serviceability
  • Error Detection and Feedback
  • Hardware Error Recovery
  • NCP Slowdown
  • CTC Slowdown
  • Data Collection/Reduction and Test Tools

    Appendix A. Logical Unit Status (LUSTAT)

    Appendix B. General Format of the SNA BIND Command

  • BIND Images for TPF Supported Secondary Logical Units
  • Acceptable BIND Image For a Local Host Node SLU
  • Appendix C. Interface Requirements for System Utility Programs

  • RID and RVT Conversions
  • Retrieving NCB and SPA Data Records (CSNB)
  • Select A Thread Utility Routine (SELEC)
  • Select A Thread Utility Program (CSF0)
  • Appendix D. Using the Path Information Unit (PIU) Trace Facility

  • About the PIU Trace Table
  • Starting the PIU Trace Facility and Specifying Which Data to Trace
  • Stopping the PIU Trace Facility
  • Defining How Much of the RU to Store in the PIU Trace Table
  • Writing the PIU Trace Table to a Real-Time Tape
  • Displaying Information about the PIU Trace Facility
  • Examples
  • Displaying the PIU Trace Table Online
  • Creating a Compacted Display of the PIU Trace Table
  • Creating a Formatted Display of the PIU Trace Table
  • Using the Offline PIU Print (PIUPRT) Utility to Create a PIUPRT Report
  • Sample JCL for the PIUPRT Utility
  • Defining the PIUPRT Report
  • PIUPRT Utility Return Codes
  • RH Indicators
  • Including the PIU Trace Table in System Error Dumps
  • Appendix E. VTAM Mode Table Entries

    Appendix F. TPF Message Processing Flow User Extensions

  • TPF Inbound Message Flow Extensions
  • TPF Outbound Message Flow Extensions
  • ROUTC Exit
  • Appendix G. Sample TPF CTCP Implementation Using PSVs

  • Introduction to CTCP Functions
  • Generalized Access to X.25 Transport Extension (GATE)
  • User CTCP Control Blocks
  • X.25 Network Control Block
  • X.25 Link Control Block (XLCB)
  • Virtual Circuit Control Block (VCCB)
  • User Terminal Control Blocks
  • End Point Control Block (EPCB)
  • Contact Point Control Block (CPCB)
  • Control Block Residence
  • TPF SNA Session Awareness
  • Session Start
  • Session End
  • TPF X.25 Command Message Flows
  • PSV Processing of NPSI/GATE Commands
  • TPF X.25 Data Message Flows
  • CTCP Input Data Message Processing
  • CTCP Output Data Message Processing
  • Appendix H. SNA Command Flow

  • PU 5 and PU 2.1 LEN Session Activation
  • CDRM-CDRM Session Activation
  • PU 5 and PU 2.1 Session Deactivation
  • APPN Session Activation
  • APPN LU-LU Session Deactivation
  • APPN-Subarea Migration Flows
  • More on SNA Command Flow
  • Appendix I. TPF Sense Code Processing

  • SNA Timeout Processing
  • Index