# PPX support for NMS OAM

The PPX server can process the following NMS OAM events:

- HSWEVN_REMOVAL_REQUESTED

- OAMEVN_STOPBOARD_DONE

- CLKEVN_CONFIGURED

When the PPX server receives HSWEVN_REMOVAL_REQUESTED or OAMEVN_STOPBOARD_DONE for a board that is used in one of its initial connections (connections defined in ppx.cfg), it tears down the connection that is using the switch and marks the switch disabled within the fabric. Connections defined in ppx.cfg are the only connections that PPX acts on when it receives an NMS OAM event.

If the input on the connection (listener) is on an enabled switch, the default idle pattern is sent to the listening point. This same action is taken when a NULL talker is assigned to a connection object to which listeners have already been assigned.

When PPX receives CLKEVN_CONFIGURED, it determines whether the board's switch is being used by one of the initial connections defined in ppx.cfg. If it is, the connection is established. PPX also sets the state of the switch to ENABLED.

For more information on NMS OAM, refer to the NMS OAM System User's Manual.

This topic provides information on:

- Configuration for unpopulated CompactPCI slots

- Client connections

- Switch disabled error

- Switching service log support

## Configuration for unpopulated CompactPCI slots

Boards for unpopulated CompactPCI slots are defined in ppx.cfg. Similarly, the following PPX configuration is needed within the switch definition of boards that are planned to be inserted into currently unpopulated CompactPCI slots:

SwitchState [ENABLED | DISABLED]

When the field is set to DISABLED, the switch is added to the switching fabric but its state is set to DISABLED. Clients receive an error if they attempt to use the switch. If this field is missing from the definition of the switch, its value is assumed ENABLED.

## Client connections

Client applications are responsible for terminating connections that are effected by HSWEVN_REMOVAL_REQUESTED. PPX does not close the switch handle
until all clients have disconnected from the switch. Until the switch is closed, clients can continue to make connections using the switch.

## Switch disabled error

After a disabled switch is closed, users cannot make connections that reference that switch. The PPX error value PPXERR_DISABLED is returned from the following functions when a disabled switch is specified:

- ppxAddListeners

- ppxConnect

- ppxSetTalker

For more information, refer to Alphabetical error summary and PPX events.

## Switching service log support

If PPX's SWI command logging is configured, switch enable and disable information appear in the log file.

The following example shows the subsequent SWI log information that appears if each of the two boards (shown in the ppx.cfg excerpt) are removed and then reinserted.

ppx.cfg
[ppx]
Fabric
# ...
Switch 1
SwitchType = HMIC
DeviceName = "agsw"
DeviceNumber = 1
# ... etc...
Switch 4
SwitchType = HMIC
DeviceName = "agsw"
DeviceNumber = 4
# ... etc ...
# Initial Connections established by ppx server
Connect
1:local:0:0 to 1:local:17:0 QUAD
4:local:0:2 to 4:local:17:2 QUAD
End Connect
End Fabric

ppxswi.log
Setup of initial connections.
[Tue Jan 12 15:29:11 1999] Switch 1: Handle Opened 0x1
[Tue Jan 12 15:29:11 1999] swiMakeConnect: hd 0x1 LOCAL:0:0 TO LOCAL:17:0
[Tue Jan 12 15:29:11 1999] swiMakeConnect: hd 0x1 LOCAL:16:0 TO LOCAL:1:0
[Tue Jan 12 15:29:11 1999] swiMakeConnect: hd 0x1 LOCAL:2:0 TO LOCAL:19:0
[Tue Jan 12 15:29:11 1999] swiMakeConnect: hd 0x1 LOCAL:18:0 TO LOCAL:3:0
[Tue Jan 12 15:29:12 1999] Switch 4: Handle Opened 0x10002
[Tue Jan 12 15:29:12 1999] swiMakeConnect: hd 0x10002 LOCAL:0:2 TO LOCAL:17:2
[Tue Jan 12 15:29:12 1999] swiMakeConnect: hd 0x10002 LOCAL:16:2 TO LOCAL:1:2
[Tue Jan 12 15:29:12 1999] swiMakeConnect: hd 0x10002 LOCAL:2:2 TO LOCAL:19:2
[Tue Jan 12 15:29:12 1999] swiMakeConnect: hd 0x10002 LOCAL:18:2 TO LOCAL:3:2
Board removal
[Tue Jan 12 15:30:39 1999] Switch 4 Device 4 DISABLED
[Tue Jan 12 15:30:39 1999] Switch 4 Handle 0x10002 Closed
[Tue Jan 12 15:30:43 1999] Switch 1 Device 1 DISABLED
[Tue Jan 12 15:30:43 1999] Switch 1 Handle 0x1 Closed
Reinsert with auto reconnect
reinsert:
[Tue Jan 12 15:30:52 1999] Switch 1 Device 1 ENABLED
[Tue Jan 12 15:30:52 1999] Switch 1: Handle Opened 0x20001
reconnect:
[Tue Jan 12 15:30:52 1999] swiMakeConnect: hd 0x20001 LOCAL:0:0 TO LOCAL:17:0
[Tue Jan 12 15:30:52 1999] swiMakeConnect: hd 0x20001 LOCAL:16:0 TO LOCAL:1:0
[Tue Jan 12 15:30:52 1999] swiMakeConnect: hd 0x20001 LOCAL:2:0 TO LOCAL:19:0
[Tue Jan 12 15:30:52 1999] swiMakeConnect: hd 0x20001 LOCAL:18:0 TO LOCAL:3:0
reinsert:
[Tue Jan 12 15:30:57 1999] Switch 4 Device 4 ENABLED
[Tue Jan 12 15:30:57 1999] Switch 4: Handle Opened 0x30002
reconnect:
[Tue Jan 12 15:30:57 1999] swiMakeConnect: hd 0x30002 LOCAL:0:2 TO LOCAL:17:2
[Tue Jan 12 15:30:57 1999] swiMakeConnect: hd 0x30002 LOCAL:16:2 TO LOCAL:1:2
[Tue Jan 12 15:30:57 1999] swiMakeConnect: hd 0x30002 LOCAL:2:2 TO LOCAL:19:2
[Tue Jan 12 15:30:57 1999] swiMakeConnect: hd 0x30002 LOCAL:18:2 TO LOCAL:3:2