This topic describes how to perform the following tasks with oamcfg:
To create a record in the NMS OAM database for the object, enter:
oamcfg -c product [-l PCIbus:slot] [-n brdname] [-b brdno] [-@ host]
The following table explains each option:
Option |
Use this option to specify... |
---|---|
-c product |
Product string for the board type. Refer to Displaying board product types for information on retrieving a list of valid product name strings. If product is omitted, oamcfg chooses the first product name in this list. |
-l PCIbus:slot |
PCI bus and slot location of a board in the system. If this option is omitted, oamcfg assumes PCI bus 0, slot 0. |
-n brdname |
Name to give the board. If this option is omitted, a default name is generated. |
-b brdno |
Number to give the board (0 - 15). If this option is omitted, a default number is generated. |
-@ host |
Machine name or IP address of the resource host where the board is located. If not specified, oamcfg performs its operations on the host on which it is initialized. |
The -g and -m options cannot be used to identify the board in this operation. Refer to Command line options.
Note: The board must currently be physically installed in the system for its name to be added or deleted from the NMS OAM database.
For example, the following command adds a record for a CG 6000C board located in PCI bus 0, slot 20 on resource host MyHost1:
oamcfg -c CG_6000C_QUAD -l 0:20 -@ MyHost1
When a record is created for a board, the record includes a unique name and board number for the board. You can use either of these identifiers to refer to the board in future calls. To learn how to retrieve this information, refer to Reading and changing database information.
You can change the board name or number. Refer to Changing board ID information.
oamcfg can automatically detect boards in a resource host chassis. You can then use oamcfg to add records for detected boards to the NMS OAM database on that host.
To detect boards in a chassis, use the -x option. To detect boards in a resource host, also include the -@ option indicating the host:
oamcfg -x -@ MyHost1
oamcfg detects boards in the chassis and creates entries in the DetectedBoards[x] array keyword for each board. These keywords are displayed on the screen, as follows:
DetectedBoards[0].Name = AG_2000_0_16
DetectedBoards[0].Product = AG_2000
DetectedBoards[0].Location.PCI.Bus = 0
DetectedBoards[0].Location.PCI.Slot = 16
DetectedBoards[1].Name = AG_2000_BRI_0_17
DetectedBoards[1].Product = AG_2000_BRI
DetectedBoards[1].Location.PCI.Bus = 0
DetectedBoards[1].Location.PCI.Slot = 17
DetectedBoards[2].Name = AG_4000_E1_0_15
DetectedBoards[2].Product = AG_4000_E1
DetectedBoards[2].Location.PCI.Bus = 0
DetectedBoards[2].Location.PCI.Slot = 15
Note: If you have a chassis with an unusual PCI bus topology (for example, bus number 171 directly follows bus number 0), oamcfg searches functions more slowly. To speed up operation, create a text file specifying bus numbers to search. Refer to Specifying PCI bus numbers for board search functions for more information.
To add a detected board to the NMS OAM database, use the -a option. Also specify the -n option indicating the name of the board to add. For example, the following command line adds detected board AG_2000_0_16 to the database on resource host MyHost1:
oamcfg -a -n AG_2000_0_16 -@ MyHost1
To add all detected boards at once, omit any specific board name, as follows:
oamcfg -a -@ MyHost1
To delete a board from the NMS OAM database, use the -d option. The following command deletes the board named myboard:
oamcfg -d -n myboard
Note: This operation does not require that the board be physically removed from the system.
If no board is specified, oamcfg deletes all boards from the NMS OAM database.