# LOCATE ALL FREE

## Qualifiers:

DN <dnmin> TO <dnmax>

PLID <card type> <unit>

PLID <card type> <unit> <shelf>

PLID <card type> <unit> <shelf> <slot>

PLID <card type> <unit> <shelf> <slot> <circuit>

PLID <card type> <unitmin> TO <unitmax>

## Purpose:

Identifies all directory numbers (DN) or location IDs that have not been assigned.

## Details:

The qualifiers <dnmin> and <dnmax> represent the directory numbers at the lower and upper bounds of the search. The qualifiers must be the same length (i.e. 1000 to 2000, not 500 to 1500).

The qualifiers <unitmin> and <unitmax> represent the location IDs at the lower and upper bounds of the search. Each qualifier consists of up to four numbers: unit, shelf, slot, and circuit. The unit number must be input only for unitmin. If shelf, slot, and circuit are left blank for unitmin, the lowest available values will be selected by default. If unit, shelf, slot, and circuit are left blank for unitmax, the highest available values will be selected by default.

The <card type> qualifier can be 4_PORT_LS, 8_PORT_ONS, 16_PORT_ONS, AC15, CEPT, COVLINE, DATASTATION, DID2, DID3, DIGITALLINE, DNILINE, DS1, E_AND_M, HYBRID_LS_ONS, LOOPDID, LS/GS, ONSLINE, OPSLINE, SCDCTRUNK, UNIVERSAL_E1, UNIVERSAL_T1, ANYCARDTYPE.

A directory number is considered to be free if it satisfies all of the following conditions:

- The DN is within the specified range inclusive.

- The DN is NOT within the configured Automatic DN Selection Range.

- The DN is the same length as the <dnmin> and <dnmax> numbers.

- The DN does not map to the existing telephone, group pilot number, ARS destination, feature access code, special service number, or remote directory number.

- The DN will not conflict with an ARS digit string.

- The DN will not cause a conflict with an existing feature access code, including the Set Registration Auto DN Selection - Prefix.

- The DN is not already assigned to a peripheral, route, or hunt group.

- The DN is not a sub-string of a longer provisioned DN.

A PLID is considered to be free if there is no programmed card type for the PLID, there is no device associated with a PLID, or there is no directory number associated with a device programmed for the PLID (except for PLIDs programmed for system ports or modem pools).

## Example:

### Entry: LOCATE ALL FREE DN 3000 TO 3500

System Response:

LOCATE: Warning! file *.LOCATE.FREE.DN will be overwritten.
3001
3004
3400

Quantity of free DNs in the given range: 3.

If the system returns the following response:

The free DNs within the given range can be found in *.LOCATE.FREE_DN.

Enter the following command and then click OK to list the results:

TYPE *.LOCATE.FREE_DN