Table of Contents (exploded view)
Note!
Abstract for Open Systems Adapter-Express Customer's Guide and Reference
How to send your comments to IBM
If you have a technical problem
Summary of changes
Summary of changes for SA22-7935-17
Summary of changes for SA22-7935-16
Summary of changes for SA22-7935-15
Summary of changes for SA22-7935-14
Summary of changes for SA22-7935-13
Summary of changes for SA22-7935-12
Summary of changes for SA22-7935-11
Summary of changes for SA22-7935-10
Summary of changes for SA22-7935-09
Summary of changes for SA22-7935-08
Summary of changes for SA22-7935-07
Summary of changes for SA22-7935-06
Summary of changes for SA22-7935-05
Summary of changes for SA22-7935-04
Summary of changes for SA22-7935-03
Summary of changes for SA22-7935-02
Summary of changes for SA22-7935-01
Part 1. OSA-Express guide
Part 2. OSA-Express reference
Messages
OSA-Express guide
Introducing OSA-Express2, OSA-Express3, OSA-Express4S, and OSA-Express5S
OSA-Express characteristics
Port sharing among images
Supported CHPID types
OSD CHPID type (QDIO mode)
OSE CHPID type (non-QDIO mode)
TCP/IP Passthru mode
SNA mode
OSM CHPID type (OSA intranode management network)
OSN CHPID type
OSX CHPID type (OSA zBX System z Blade Center Extension)
OSA-Express physical feature descriptions
The OSA-Express2, OSA-Express3, OSA-Express4S and OSA-Express5S 10 Gigabit Ethernet features
The OSA-Express2, OSA-Express3, OSA-Express4S and OSA-Express5S 1000BASE-T Ethernet features
OSA-Express 1000BASE-T Ethernet LAN speeds and duplex modes
OSA-Express supported functions
OSA-Express Layer 2 transport
Software requirements
Virtual LAN (VLAN) support
VLAN priority tagging
IPv6 on z/OS, Linux, z/VM, and z/VSE
Software requirements
IP Multicast support
IP Broadcast traffic
Port name relief
OSA-Express2, OSA-Express3, OSA-Express4S, and OSA-Express5S supported functions
Segmentation Offload (Large Send)
Hardware requirements
Software requirements
640 TCP/IP stacks
Hardware requirements
Software requirements
Multiple control unit support
Hardware requirements
Software requirements
Concurrent patch capability on z Systems
VLAN Management (GVRP) support
Hardware requirements
Software requirements
Layer 3 Virtual MAC for z/OS environments
Hardware requirements
Software requirements
OSA-Express Network Traffic Analyzer (OSAENTA)
Hardware requirements
Software requirements
Note
QDIO Diagnostic Synchronization (QDIOSYNC)
Hardware requirements
Software requirements
QDIO connection isolation
Hardware requirements
Software requirements
OSA support for Link Aggregation (IEEE 802.3ad)
Hardware requirements
Software requirements
OSA-Express for NCP
Hardware requirements
Software requirements
OSA-Express3, OSA-Express4S, and OSA-Express5S-only supported functions
OLM - Optimized Latency Mode
Hardware requirements
Software requirements
Inbound workload queueing
Hardware requirements
Software requirements
Multi-VSwitch Link Aggregation
Group Exclusive Mode
Port Group Controller Selection
Virtual Switch/OSA Network Connection Recovery
Hardware requirements
Software requirements
Enhanced network availability
ARP Takeover
Primary and secondary default routing
Virtual IP Addressing (VIPA)
Dynamic Virtual IP Addressing (DVIPA)
Enterprise Extender
Support for Simple Network Management Protocol (SNMP)
The Communications Server SNMP TCP/IP subagent
The OSA-Express Direct SNMP subagent
Open Systems Adapter/Support Facility (OSA/SF)
Deciding whether OSA/SF is required
OSA/SF management span
OSA/SF management of an OSA
OSA-Express hardware configuration
Defining and configuring an OSA using HCD
Preliminary information that you need
Device definitions - summary
Sample HCD input for OSA CHPID types
General HCD notes
Example 1: CHPID type OSD (QDIO); Layer 3 and Layer 2
HCD input
z/OS TRLE statement – single port
z/OS TCP/IP profile – single port
OSA/SF Query CHPID output – OAT (automatically built)
z/OS TRLE statement – multi-port
z/OS TCP/IP profile – multi-port
OSA/SF Query CHPID output – OAT (automatically built)
z/OS notes
Example 2: CHPID type OSX (OSA-Express for zBX IEDN)
HCD input
z/OS TCP/IP profile
Notes for OSX
Example 3: CHPID type OSM (OSA-Express for zManager and the INMN)
Notes for OSM
Example 4: CHPID type OSE (non-QDIO, for TCP/IP passthru and SNA/APPN/HPR traffic)
Notes for OSE
z/OS TCP/IP profile - single port
OSA/SF Query CHPID output - OAT (single port)
z/OS TCP/IP profile - multi-port
OSA/SF Query CHPID output - OAT (multi-port)
Example 5: OSN and 3745 devices (OSA-Express for NCP)
Define the OSAD device for OSA/SF
Tips for “Define OSA device” for OSA/SF in HCD
QDIO one control unit – 480 unit address support
OSA QDIO multiple control unit support – z890 and z990 or newer
640 TCP/IP stacks (1920 devices) support – OSA-Express2, OSA-Express3, OSA-Express4S, and OSA-Express5S
Stack and device maximums
Putting it all together: Examples for defining devices on one or multiple operating systems
Example 1: z/OS only
Example 2: z/OS and Linux on z Systems
Example 3: z/OS, z/VM, and Linux on z Systems
Assumptions and parameters
Results
Setting up OSA/SF on z/OS
Choosing the OSA modes
OSA/SF and the z/OS environment
Set up the Started Procedure task
Define the startup profile
Set up the configuration and master index files
Setting up z/OS to run as a guest of z/VM
Checklist for the OSA configuration and master file index
Set up APPC/MVS and VTAM for OSA/SF
Set up the Communications Server SNMP TCP/IP subagent
Controlling access to OSA/SF
OSA/SF tasks and commands
Some examples of RACF profile definitions
Some examples of RACF authorization assignments
Starting OSA/SF
Verifying that OSA/SF started
Deciding which OSA/SF interface to use
Stopping OSA/SF
Setting Up OSA/SF on z/VM
Choosing the OSA modes
OSA/SF and the z/VM environment
Install OSA/SF
Define OSA/SF to a z/VM guest environment
Set up APPC
Set up OSA/SF
Decide whether to specify RMCHINFO
Controlling access to OSA/SF for z/VM
Some examples of RACF profile definitions
Some examples of RACF authorization assignments
Notes on handling problems with OSA/SF
Deciding which OSA/SF interface to use
Setting Up OSA/SF on z/VSE
Determine the OSA modes
OSA/SF and the z/VSE environment
Define the partition for OSA/SF jobs
Create the working sublibrary (PRD2.OSASF) for OSA/SF
Copy the skeleton job for the master index (IOAINX)
Copy the skeleton job for IOAMAIN
Copy the skeleton job for IOACMD
Move the jobs into the power RDR queue
z/VSE running as a guest of z/VM
Stopping OSA/SF
Setting up and using the OSA/SF interfaces
Setting up the REXX command interface
Setting up the REXX command interface for z/OS
Setting up the REXX command interface for z/VM
Setting up the REXX command interface for z/VSE
Using the IOACMD EXEC interface
Full prompting
Command prompting by the IOACMD EXEC
Entering parameters without prompting
Starting the IOACMD EXEC and asking for help
For more on IOACMD
Setting up an OSA/SF GUI
Customize a TCP/IP connection
Customize a TCP/IP connection for z/OS
Customize a TCP/IP connection for z/VM
Setting Up TCP/IP
Customize a TCP/IP connection for z/VSE
Download and install the Java runtime and JavaHelptm files
Download the IOAJAVA GUI code and define the CLASSPATH environment variable
Creating a directory for ioajava.jar
Download the GUI code
Using FTP to download the GUI code
Defining the CLASSPATH environment variable
To define the CLASSPATH environment variable for Windows
Using DOS to define the CLASSPATH environment variable
To define the CLASSPATH environment variable for Linux
Starting the OSA/SF GUI
Using the OSA/SF GUI
OSA/SF Host Open window
OSA/SF commands
CHPID View window to display channel information
Using the OSA/SF GUI with different OSA/SF hosts
Problems starting the OSA/SF GUI
Debugging the OSA/SF GUI startup
Host program setup
Overview
z/OS
z/VM
z/VSE
Linux on z Systems
For more information
QDIO definitions on z/OS
Setting up a TRLE statement for QDIO
Updating the TCP/IP profile for QDIO
Setting up priority queuing
IP modes for CHPID type OSE (non-QDIO) on z/OS
TCP/IP definition requirements for CHPID type OSE IP modes
SNA modes for CHPID type OSE on z/OS
External Communication Adapter (XCA) major node for SNA
VBUILD Definition statement for SNA
PORT Definition statement for SNA
GROUP Definition statement for SNA
LINE and PU Definition statements for SNA
Switched Network (SWNET) major node for SNA
VBUILD Definition statement for SNA
PU Definition statement for SNA
PATH Definition statement for SNA
LU Definition statement for SNA
At the Physical Unit (PU)
Configuring OSA-Express modes
Using the REXX command interface to configure OSA-Express CHPIDs
REXX command interface instructions for configuring OSA-Express CHPIDs
1) Getting and modifying a configuration file
2) Getting an OAT template
Using samples
Using the Get OAT command
3) Modifying the OAT template
4) Activating the configuration
5) Verifying the configuration
Using the GUI to configure OSA-Express CHPIDs
Creating or modifying a CHPID configuration
1000BASE-T configuration data
The TCP/IP OAT entries
What next
The SNA OAT entries
What next
Activating the configuration
SNA configuration settings
OSA-Express reference
OSA port management
Enabling and disabling ports
Using the GUI
Using IOACMD
Using the HMC
MAC addresses
Maximum number of media access control (MAC) addresses
Local MAC address
Canonical versus noncanonical format
Group MAC address
Setting MAC addresses
Using the OSA/SF GUI
Using the REXX EXEC (IOACMD)
Using the Hardware Management Console
OSA-Express direct SNMP support
Query support
Trap and set support
Requirements
Setting up OSA-Express Direct SNMP support for z/OS
Additional resources
MIB
OSA-Express direct SNMP support for Linux on z Systems
Starting the OSA-Express direct SNMP subagent
How to stop the subagent
Additional resources
Problem determination aids
Using OSA/SF problem determination aids
OSA/SF message log
Using the GUI
Using the REXX command GET_DEBUG
OSA/SF trace table
Using the GUI
Using the REXX command GET_DEBUG
OSA/SF dump
IOACMD debug data sets
OSA/SF workstation debug settings
CHPID problems
Performance data
Resource Measurement Facility
Reporting OSA/SF problems to IBM
Servicing OSA-Express and OSA/SF
Service for an OSA hardware replacement
Installing a PTF for OSA/SF
Migrating to the OSA/SF Java–based GUI
Migrating to a new version or release of OSA/SF on z/OS
Removing data sets or files
Examples of removing data sets or files from the system
Configuration data sets and files created by the REXX IOACMD EXEC
Configuration data sets and files created by the OSA/SF GUI
Migrating to a new version or release of OSA/SF on z/VM
Migrating to a new version or release of OSA/SF on z/VSE
About the OSA Address Table (OAT)
OAT examples
Default OAT
OSA/SF commands for REXX
How to read syntax diagrams
Symbols
Syntax items
Syntax examples
CLEAR_DEBUG | CLR | CLR_DEBUG | CLEAR
CONFIG_OSA
CONVERTOAT
GET_CONFIG
GET_DEBUG
GET_OSA_ADDRESS_TABLE | GET_OAT | GET_OSA | GET_TABLE
INSTALL
QUERY
SET_PARAMETERS | SET_PARM | SET_PARMS
SHUTDOWN
START_MANAGING
STOP_MANAGING
OSA/SF messages and codes
OSA/SF messages
IOAx001E
IOAx002E
IOAx003E
IOAx004E
IOAx005E
IOAx006E
IOAx007E
IOAx008E
IOAx009E
IOAx010E
IOAx011E
IOAx015E
IOAx016E
IOAx018E
IOAx019E
IOAx020E
IOAx022E
IOAx023E
IOAx024E
IOAx025E
IOAx026E
IOAx027E
IOAx028E
IOAx03nE
IOAx051E
IOAx052E
IOAx053E
IOAx054E
IOAx055E
IOAx056E
IOAx057E
IOAx058E
IOAx059E
IOAx060E
IOAx061E
IOAX062E
IOAx063E
IOAx064E
IOAx065E
IOAx066I
IOAx068I
IOAx081E
IOAx084E
IOAx085E
IOAx086E
IOAx087I
IOAx088I
IOAx089I
IOAx090W
IOAx100I
IOAx101I
IOAx102I
IOAx103I
IOAx104E
IOAx105E
IOAx106E
IOAx107E
IOAx108E
IOAx109E
IOAx110I
IOAx111I
IOAx112W
IOAx113I
IOAx114I
IOAx115E
IOAx116E
IOAx118I
IOAx119E
IOAx120I
IOAx121E
IOAx123E
IOAx124I
IOAx125I
IOAx126I
IOAx127I
IOAx128W
IOAx130E
IOAx131E
IOAx132E
IOAx133E
IOAx134E
IOAx135E
IOAx136E
IOAx137E
IOAx138I
IOAx139E
IOAx140I
IOAx141I
IOAx142E
IOAx143I
IOAx144I
IOAx145W
IOAx146E
IOAx147E
IOAx149I
IOAx150I
IOAx151E
IOAx152I
IOAx153I
IOAx154E
IOAx155I
IOAx156E
IOAx157E
IOAx158E
IOAx159E
IOAx160E
IOAx161E
IOAx162E
IOAx163E
IOAx164E
IOAx165E
IOAx166E
IOAx167E
IOAx168E
IOAx169E
IOAx170E
IOAx171E
IOAx172I
IOAx173I
IOAx174I
IOAx175I
IOAx176I
IOAx177I
IOAx178I
IOAx179I
IOAx181E
IOAx182I
IOAx183E
IOAx184E
IOAx185I
IOAx186I
IOAx201I
IOAx202I
IOAx204I
IOAx205I
IOAx206I
IOAx207I
IOAx210I
IOAx211I
IOAx212E
IOAx213I
IOAx214I
IOAx215I
IOAx216I
IOAx217I
IOAx218I
IOAx219I
IOAx2yyI
IOAx233E
IOAx234E
IOAx235I
IOAx236E
IOAx237E
IOAx238A
IOAx239I
IOAx240I
IOAx241I
IOAx242I
IOAx250I
IOAx251I
IOAx252I
IOAx253I
IOAx254E
IOAx255I
IOAx256W
IOAx257I
IOAx258I
IOAx260I
IOAx261I
IOAx262I
IOAx263I
IOAx264I
IOAx265I
IOAx266I
IOAx276E
IOAx277E
IOAx278E
IOAx279E
IOAx280E
IOAx281E
IOAx282E
IOAx283W
IOAx284W
IOAx286E
IOAx289E
IOAx290E
IOAx292E
IOAx294E
IOAx295E
IOAx296W
IOAx298W
IOAx299I
IOAx301W
IOAx303E
IOAx304E
IOAx305E
IOAx306E
IOAx307W
IOAx308I
IOAx309I
IOAx310W
IOAx312I
IOAx313I
IOAx314E
IOAx315I
IOAx316I
IOAx317E
IOAx318E
IOAx319E
IOAx320E
IOAx321I
IOAx322I
IOAx323W
IOAx324W
IOAx325I
IOAx326I
IOAx327W
IOAx328W
IOAx329W
IOAx330E
IOAx333E
IOAx334E
IOAx335E
IOAx336E
IOAx340E
IOAx341W
IOAx342E
IOAx343E
IOAx345E
IOAx346E
IOAx347E
IOAx348E
IOAx349E
IOAx350E
IOAx351W
IOAx352E
IOAx353E
IOAx359E
IOAx360E
IOAx361E
IOAx362E
IOAx365E
IOAx366I
IOAx367E
IOAx372E
IOAx373E
IOAx376W
IOAx377E
IOAx378I
IOAx379I
IOAx381I
IOAx382E
IOAx383E
IOAx386E
IOAx387E
IOAx388E
IOAx389E
IOAx390E
IOAx391W
IOAx392W
IOAx393E
IOAx394E
IOAx396W
IOAx397W
IOAx398E
IOAx399I
IOAx401E
IOAx402E
IOAx403E
IOAx404E
IOAx405W
IOAx406W
IOAx409I
IOAx410E
IOAx411E
IOAx413E
IOAx414E
IOAx415E
IOAx416E
IOAx417E
IOAx418E
IOAx419E
IOAx420E
IOAx421E
IOAx422E
IOAx424E
IOAx425E
IOAx426E
IOAx428E
IOAx430I
IOAx431W
IOAx432I
IOAx433W
IOAx434I
IOAx435E
IOAx436E
IOAx439E
IOAx440E
IOAx441E
IOAx444E
IOAx446E
IOAx448E
IOAx449W
IOAx450E
IOAx451I
IOAx455E
IOAx456E
IOAx457E
IOAx459E
IOAx460E
IOAx464W
IOAx466E
IOAx467E
IOAx468E
IOAx469E
IOAx470E
IOAx472E
IOAx473E
IOAx474E
IOAx475I
IOAx476I
IOAx477I
IOAx478I
IOAx479I
IOAx480W
IOAx481E
IOAx482E
IOAx483E
IOAx484E
IOAx485I
IOAx486I
IOAx487E
IOAx488W
IOAx489W
IOAx490E
IOAx491E
IOAx492E
IOAx493E
IOAx494E
IOAx495E
IOAx496E
IOAx497E
IOAx498W
IOAx499E
IOAx500E
IOAx501E
IOAx503E
IOAx505E
IOAx506I
IOAx507I
IOAx508E
IOAx509E
IOAx510E
IOAx511W
IOAx512I
IOAx513I
IOAx514E
IOAx515E
IOAx516E
IOAx517E
IOAx518E
IOAx519E
IOAx520E
IOAx521E
IOAx522E
IOAx523E
IOAx524W
IOAx525E
IOAx526E
IOAx527E
IOAx529I
IOAx530E
IOAx601E
IOAx602E
IOAx620E
IOAx638E
IOAx639W
IOAx640E
IOAx641E
IOAx642E
IOAx643E
IOAx644E
IOAx645E
IOAx646I
IOAx647W
IOAx648I
IOAx649E
IOAx650E
IOAx652E
IOAx653E
IOAx654E
IOAx655E
IOAx656E
IOAx657E
IOAx658E
IOAx659E
IOAx660E
IOAx661E
IOAx662E
IOAx663E
IOAx664E
IOAx665W
IOAx666E
IOAx667E
IOAx668W
IOAx669W
IOAx670W
IOAx671W
IOAx672W
IOAx673W
IOAx674W
IOAx677E
IOAx678E
IOAx679E
IOAx680E
IOAx681W
IOAx682E
IOAx683E
IOAx684E
IOAx686W
IOAx687E
IOAx688E
IOAx689E
IOAx690E
IOAx691E
IOAx692E
IOAx693E
IOAx694I
IOAx695I
IOAx696E
IOAx697E
IOAx698E
IOAx699E
IOAx700E
IOAx701E
IOAx702I
IOAx751E
IOAx752W
IOAx756W
IOAx776E
IOAx801E
IOAx802E
IOAx803E
IOAx804I
IOAx805E
IOAx806E
IOAx807I
IOAx808I
IOAx809E
IOAx820I
IOAx821I
IOAx822E
IOAx823E
IOAx824E
IOAx861E
IOAx862E
IOAx863E
IOAx864E
IOAx866E
IOAx867E
IOAx868E
IOAx869E
IOAx870E
IOAx871E
IOAx873I
IOAx874W
IOAx875E
IOAx876E
IOAx877E
IOAx878E
IOAx879E
IOAx880E
IOAx881E
IOAx882I
IOAx883E
IOAx884E
IOAx885I
IOAx886I
IOAx887W
IOAx888I
IOAx889E
IOAx890E
IOAx891W
IOAx892W
IOAx893E
IOAK894E
IOAK895E
IOAx897E
IOAC898W
IOAx951W
IOAx952W
IOAx953E
IOAx954E
IOAC955W
IOAC956E
IOAx998I
IOAx999I
SNMP subagent messages
SNMP subagent messages
IOB000I
IOB001I
IOB002I
IOB003E
IOB004E
IOB005E
IOB006E
IOB007E
IOB008E
IOB009E
IOB010E
IOB011E
IOB012E
IOB013E
IOB014E
IOB015E
IOB016E
IOB017E
IOB018E
IOB019E
IOB020E
IOB021I
IOB022E
IOB023I
IOB024E
IOB025E
IOB026E
IOB027E
IOB028E
IOB029E
IOB030E
IOB031I
IOB032I
IOB033E
IOB034E
IOB035I
IOB036I
IOB037I
Technical Hints
OSA reject, error, and Network Analyzer (OSAENTA) codes
OSA reject codes
Internal errors
OSA Network Traffic Analyzer error codes
OSA Network Traffic Analyzer (OSAENTA) discard codes
OSA IDX failure return codes
OSA error codes
Physical connection information
Physical ports and status indicators
OSA-Express2
OSA-Express3
OSA-Express4S
OSA-Express5S
Fiber optic cabling
Cabling for 1000BASE-T Ethernet
OSA-Express functional limits and LAN transmission summary
OSA-Express speed/mode configuration information
Operating Modes and Frame Sizes Supported by OSA-Express Features
Notices
Programming Interface Information
Trademarks