VM/ESA
Open Systems Adapter / Support Facility
OAT Table discussion
- What is an OAT table anyhow?
- An OAT table is basically an Osa Address Table configuration file that tells the OSA2 card what devices are defined, what mode the devices will be operating in, and what port those devices will be using.
- How do I make changes to an OAT Table?
- You can makes changes to an OAT table by issuing an IOACMD command, and selecting the GET_OAT command. You can use either the Detailed OAT or the Summary OAT table as described below.
- OK, I made the changes to the OAT Table, now what?
- We have to inform the OSA2 card about the changes to the
OAT Table. We do this by 2 possible ways:
- It is recommended you use the IOACMD and select
the CONFIG_OSA command. This will prompt you
for any necessary files needed for input to the OSA2 card.
If any device will be used for SNA MODE, the CONFIG_OSA command will also place the SNA IMAGE configuration file out to the OSA2 card. - You can also use the IOACMD command, and select
the PUT_OAT command.
If any device will be used for SNA MODE, you will also need to execute the IOASNAVM EXEC to ensure an SNA IMAGE configuration file is placed out to the OSA2 card.
- It is recommended you use the IOACMD and select
the CONFIG_OSA command. This will prompt you
for any necessary files needed for input to the OSA2 card.
- We have to inform the OSA2 card about the changes to the
OAT Table. We do this by 2 possible ways:
- PUT_OAT worked fine, but I don't have my devices, what's up?
- For ANY OSA2 changes to take affect, you need to ACTIVATE
the configuration file(s) on the OSA2 card
(cmon now, this is high tech stuff and requires a bit more effort...almost done!).
- For ANY OSA2 changes to take affect, you need to ACTIVATE
the configuration file(s) on the OSA2 card
- How do I ACTIVATE an OAT TABLE or a change to my OSA2 card(s)?
- To activate changes on the OSA2 card, you will need to
vary off ALL devices (and paths) defined on
the chpid, and the chpid itself.
- VARY OFF device address
- VARY OFF PATH chpid FROM ALL
- VARY OFF chpid
If the chpid is shared with other systems (LPAR), then you will need to ensure it is offline to all systems/LPARs. - You should issue a QUERY CHPID command to verify the chpid and ALL devices and paths are offline before attempting to bring the chpid back online.
- To activate changes on the OSA2 card, you will need to
vary off ALL devices (and paths) defined on
the chpid, and the chpid itself.
- OK, the QUERY CHPID command said the chpid and all devices
and paths on this chpid are OFFLINE, Whats next?
- All you need to do now is issue
VARY ONLINE CHPID chpid command.
This will cause the CHPID and all of the devices
defined in the OAT TABLE to come online.
This can sometimes take a considerable amount of time, as OSA2 initialization and device initialization must all take place. - If you individually varied off the OSAD (FE) device, you may need to individually vary it back on, otherwise none of the other devices will come online.
- There will not be a PATH to a device until it is defined BOTH in the OAT table AND the IOCDS.
- All you need to do now is issue
VARY ONLINE CHPID chpid command.
This will cause the CHPID and all of the devices
defined in the OAT TABLE to come online.
- Your OSA2 card should now be ready to operate in the defined TCP/IP and/or SNA mode(s).Good Job!
Detailed OAT Sample
DETAILED OAT Sample:
/**********************************************************************/ /* OSA/SF Get OAT output created 01:06:09 on 01/01/2005 */ /* IOACMD APAR level OW33394 */ /**********************************************************************/ /*********************************************************************/ /* Start of OSA address table for CHPID 08 */ /*********************************************************************/ /* All entries below that are preceded by 's-' indicate that the */ /* field is settable during Put_OAT processing */ /*********************************************************************/ oathdr.1 = IOA_OAT_HDR /* Eyecatcher-Do not change */ oathdr.2 = 08 /* CHPID */ oathdr.3 = 03 /* s-Number of entries */ /*********************************************************************/ /* Start of OAT entry 1 */ /*********************************************************************/ oat.1.1 = IOA_OATENTRY /* Eyecatcher- Do not delete*/ oat.1.2 = OSA data valid /* Valid data indicator */ oat.1.3 = N/A /* Partition name */ oat.1.4 = 0 /* s-Partition number */ oat.1.5 = 00 /* s-Unit address */ oat.1.6 = 0800 /* Device number */ oat.1.7 = 08 /* CHPID */ oat.1.8 = 0800 /* Control unit number */ oat.1.9 = configured /* Channel state */ oat.1.10 = yes /* Device accessible */ oat.1.11 = 02 /* Group size */ oat.1.12 = passthru /* s-Entry type. One of: */ /* Passthru */ /* SNA */ /* Unassigned */ oat.1.13 = started /* Entry descriptor */ /*********************************************************************/ /* Start of Extended OAT entry */ /*********************************************************************/ passthru.1.1 = 0 /* s-Port number */ passthru.1.2 = no /* s-Default entry(no/pri/sec)*/ passthru.1.3 = 123.456.789.123 /* s-home IP address (w.x.y.z)*/ /*********************************************************************/ /* Start of OAT entry 2 */ /*********************************************************************/ oat.2.1 = IOA_OATENTRY /* Eyecatcher- Do not delete*/ oat.2.2 = OSA data valid /* Valid data indicator */ oat.2.3 = N/A /* Partition name */ oat.2.4 = 0 /* s-Partition number */ oat.2.5 = 01 /* s-Unit address */ oat.2.6 = 0801 /* Device number */ oat.2.7 = 08 /* CHPID */ oat.2.8 = 0800 /* Control unit number */ oat.2.9 = configured /* Channel state */ oat.2.10 = yes /* Device accessible */ oat.2.11 = 02 /* Group size */ oat.2.12 = passthru /* s-Entry type. One of: */ /* Passthru */ /* SNA */ /* Unassigned */ oat.2.13 = started /* Entry descriptor */ /*********************************************************************/ /* Start of Extended OAT entry */ /*********************************************************************/ passthru.2.1 = 0 /* s-Port number */ passthru.2.2 = no /* s-Default entry(no/pri/sec)*/ passthru.2.3 = 123.456.789.123 /* s-home IP address (w.x.y.z)*/ /*********************************************************************/ /* Start of OAT entry 3 */ /*********************************************************************/ oat.3.1 = IOA_OATENTRY /* Eyecatcher- Do not delete*/ oat.3.2 = OSA data valid /* Valid data indicator */ oat.3.3 = N/A /* Partition name */ oat.3.4 = 0 /* s-Partition number */ oat.3.5 = 0A /* s-Unit address */ oat.3.6 = 080A /* Device number */ oat.3.7 = 08 /* CHPID */ oat.3.8 = 0800 /* Control unit number */ oat.3.9 = configured /* Channel state */ oat.3.10 = yes /* Device accessible */ oat.3.11 = 01 /* Group size */ oat.3.12 = SNA /* s-Entry type. One of: */ /* Passthru */ /* SNA */ /* Unassigned */ oat.3.13 = started /* Entry descriptor */ /*********************************************************************/ /* Start of Extended OAT entry */ /*********************************************************************/ sna.3.1 = 0 /* s-Port number */ /********************************************************************** /******************* End of OAT entries ************************* /********************************************************************** /*===================================================================*/ /* Examples of Extended OAT entries start here */ /*===================================================================*/ /* Passthru extended entry example */ /* - Change IP addresses to match the host TCP/IP profile */ /* - Only 1 LP/UA per port can be the primary default entry */ /* - Only 1 LP/UA per port can be the secondary default entry. You */ /* cannot have a secondary default entry without a primary default*/ /* (A default entry value of 'yes' will be treated as 'primary') */ /* - All IP addresses must have an 'odd' index. */ /* For example, passthru.n.3 */ /* The even addresses are used for IP forwarding and are ignored */ /* for VM and VSE */ /* - To have up to eight IP addresses per OAT entry, repeat */ /* passthru.n.3 and change the 3 to 5, 7, 9, through 17 as needed,*/ /* for each additional IP address. */ /* Note: Even entries are ignored */ /* - Delete all IP address fields you are not assigning */ /*===================================================================*/ /* passthru.n.1 = PORT_NUMBER /* s-Port number (1 hex digit)*/ /* passthru.n.2 = NO, PRI or SEC /* s-Default entry(no/pri/sec)*/ /* passthru.n.3 = IP address 1 /* s-home IP address (w.x.y.z)*/ /* passthru.n.5 = IP address 2 /* s-home IP address (w.x.y.z)*/ /*===================================================================*/ /* SNA extended entry WITHOUT Network management example */ /*===================================================================*/ /* sna.n.1 = PORT_NUMBER /* s-Port number (1 hex digit)*/ /*===================================================================*/ /* SNA extended entry WITH Network management example */ /* - change VTAM IDNUM to match value on XCA node definition */ /*===================================================================*/ /* sna.n.1 = FF /* s-Port number (must be FF) */ /* sna.n.2 = VTAM IDNUM /* s-VTAM IDNUM (5 hex chars) */ /*===================================================================*/ /* End of Extended OAT entry examples */ /*===================================================================*/
Summary OAT Sample
SUMMARY OAT Sample:
************************************************************************ *** OSA/SF Get OAT output created 14:50:43 on 06/28/1999 *** *** IOACMD APAR level OW33394 *** ************************************************************************ *** Start of OSA address table for CHPID 08 *** ************************************************************************ * UA(Dev) Mode Port Entry specific information Entry Valid ************************************************************************ LP 0 (N/A) 00(0800) passthru 00 no 123.456.789.123 S OSA 01(0801) passthru 00 no 123.456.789.123 S OSA 0A(080A) sna 00 no 000.000.000.000 S OSA ************************************************************************ *** Legend for abbreviations *** ************************************************************************ * Entry column Valid column * ------------ ------------ * S - Started OSA - Does not exist in IOCDS, but is on OSA * NS - Not started CSS - Exists only in Channel Subsystem (IOCDS) * SIU - Started & in use ALL - Exists on the OSA and in IOCDS * N/A - Not Applicable * * Entry Specific Information * -------------------------- * Passthru entry - Default entry, Home IP address * SNA entry - VTAM IDNUM if port number is FF ************************************************************************ * Guidelines to updating this file for input ************************************************************************ * All comment lines must start with either '*' or '/*' * All comments and blank lines are ignored * Parameters are not column specific, but must be separated by * at least 1 blank space * A statement containing the LP number must precede any valid OAT lines * * There are 2 valid types of entry lines: * 1. Specify the LP which the following lines pertain to * * LP n (hostname) * LP is the keyword * n is the 1 hex digit partition number (0-F) * hostname is optional, and is ignored * * 2. The actual OAT entries for each LP, which must be one of: * * ua passthru port_number default_entry Home_IP * ua sna port_number VTAM_idnum * ua N/A or unassigned * where * -'ua' can be either a 1 or 2 digit unit address alone or with the * device address concatenated to it. e.g. - 0A(023A) or 0A * -'passthru', 'sna', 'N/A' or 'unassigned' which * indicates the type of entry this is. Specify unassigned * to eliminate an entry that already exists on the OSA * -port_number specifies the port number * * -default_entry is set to one of the following * - NO Not a default entry * - PRI Primary default entry * - SEC Secondary default entry (used when primary is not available) * * -Home_IP is the home IP address in standard w.x.y.z format with * values ranging from 0 to 255 in each position. It can be left * blank if you do not wish to have port sharing or an IP address * assigned to this entry. You CANNOT have a mixture of zero and * non-zero IP addresses in the same OAT. * * To specify more than 1 IP address for a passthru OAT entry, add a * line following the initial 'passthru line'. This line must start * with the home IP address. All other parameters are ignored. * * -VTAM_idnum is the 5 digit VTAM idnum used for network management. * Specify this parameter if the port number is FF. Otherwise you * can omit it, or if specified it is ignored. * You can only have 1 SNA network management entry per OAT. * ************************************************************************ *** End of OAT entries *** ************************************************************************