Technical Deep Dive: SPoM Link Creation 1. Overview SPoM (Single Point of Maintenance) Link creation is a critical operation within network inventory and service activation systems. It establishes a logical or physical binding between two network resources (ports, circuits, or equipment) to ensure end-to-end service continuity, facilitate fault management, and enable automated provisioning. The spom link create command/function is used to instantiate a new adjacency or cross-connect in the SPoM database or controller. 2. Pre-Creation Checklist Before executing spom link create , validate the following to avoid orphaned or inconsistent links: | Check | Description | |-------|-------------| | Resource Availability | Both endpoints (A-side and Z-side) exist in the inventory and are not already fully allocated. | | Capacity & Compatibility | Bandwidth, media type (fiber, copper, virtual), protocol, and signal format match. | | Link Type | Determine if it is a physical patch , logical trunk , or protection group link . | | State Management | Ensure the intended endpoints are in an “In-Service” or “Maintenance” state, not “Decommissioned.” | 3. Syntax & Parameters (Example – NMS/CLI Style) A typical spom link create command follows this structure: spom link create \ --link-id <unique_identifier> \ --a-end <device>:<port/subinterface> \ --z-end <device>:<port/subinterface> \ --link-type <physical|logical|protection> \ --bandwidth <value_in_mbps_or_gbps> \ --owner <ops_team|planning|customer> \ --description "<purpose_of_link>" \ --auto-commit <true|false>
Key Parameter Details
link-id : Must be unique in the SPoM repository. Suggested format: LNK-{REGION}-{DATE}-{SEQ} a-end / z-end : Exact inventory paths. Use show resource tree to confirm syntax. auto-commit : If false , the link is staged for validation and requires spom link commit .
4. Operational Workflow When spom link create is executed, the SPoM engine performs these steps in order: spom link create
Validation
Endpoint existence, administrative state, and compatibility checks. Prevents creation of loops or duplicate links between same endpoints.
Resource Reservation
Marks the port/subinterface capacity as “allocated” (if bandwidth-aware).
Link Record Generation
Inserts new row into spom_links table with status PROVISIONING . Technical Deep Dive: SPoM Link Creation 1
Dependency Update
Refreshes any parent circuit or service that relies on this link.