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.

  • 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!).

  • 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.

  • 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.

  • 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                          ***
************************************************************************