# AG board locate: blocate

#### Name

blocate

#### Purpose

For UNIX systems, associates the PCI bus assignment to a physical board by flashing an LED on the board.

#### Usage

blocate [ options ]

where options are:

Option | Description
--- | ---
pci_bus pci_slot | Specifies the PCI bus and slot location of the AG board on which to flash an LED.

#### Description

If no options are specified, blocate displays the PCI bus and PCI slot number for all AG boards installed in a UNIX system. If a PCI bus and slot number is specified on the command line, blocate flashes an LED on the specified board. To learn which LED flashes on your board model, refer to the board documentation.

Example: Flashing all AG board LEDs

To display the PCI bus and slot numbers for all AG boards in the UNIX system, enter:

blocate

The output resembles the following:

Thu Jul 10 15:51:22 There was 1 NMS AG PCI card(s) detected
BUS SLOT INTERRUPT
00 14 0xf

The board configuration is also logged to an ASCII text file, pci_cfg.txt, with the current date and time. The file is created in the current working directory.

Example: Flashing a specific board LED

To flash an LED on a specific AG board in a UNIX system, enter:

blocate pci_bus pci_slot

where pci_bus and pci_slot are the PCI bus and PCI slot locations of the board. For example:

blocate 0 14

The following message displays:

Flashing LED for NMS PCI board on bus 0 slot 14

The LED on the specified board flashes briefly.