Nortel DMS-100 Introduction to Query Commands


Introduction

Query commands consist of a command name followed by a series of parameters.  Operating companies use query commands to display the characteristics of telephone lines.  Query commands allow users with access to a DMS I/O Device (IOD) to determine the status (working or unassigned) of Directory Numbers (DN) or Line Equipment Numbers (LEN) associated with lines.

The information received through query commands simplifies service order preparation.  Entering the query command QDN (Query Directory Number) and a DN gives a user information about the hardware and software associated with the DN of a particular line.

Query Commands

The Line Data Base (LDB) query commands are used to:

The commands can be executed at any level of the Man-Machine Interface (MMI) system.  A command is not needed to enter or leave the query mode.  A user logged on at a MMI position can enter a query command.

Either the prompt or no-prompt mode of entry can be used.  Entering a $ (dollar sign) character indicates that the user is either finished entering data for a parameter or has accepted the default parameter.  The user can confirm, reject, or edit the input the same way as for Service Order (SERVORD) commands.

Note:  The format for the query commands output, with the exception of QDN, has been altered when the summary option is used.  The drawer totals for each peripheral are written on two lines when the peripheral has more than 17 drawers.  Two lines are required if the total number of drawers chosen is greater than 17.  No change is made to the type of information that is displayed.

Entering Query Commands in No-Prompt Mode

In no-prompt mode, query commands are entered by the user along with the required correct parameters.  In case of an error, the DMS switch reverts to the prompt mode of entry, beginning at the point where the invalid parameter was entered.

Entering Query Commands in Prompt Mode

To enter query commands in prompt mode, perform the following actions:

  1. Log on.
  2. Enter one of the commands shown in the following "Query Commands" table.
  3. Refer to the "Query Command Prompts" table in this article for an explanation of the query command prompts and the data to be entered.  If an incorrect parameter is entered, the system prompts for the correct information.
  4. On entry of a valid parameter, the DMS switch displays the next prompt.  The DMS switch continues to prompt until all necessary parameters have been entered.

When all parameters have been entered, the DMS switch displays or prints the order as entered.  The user must enter a Y (to accept the command), a N (reject), or a E (edit).

-----------------------------------------------------------------------------------------
Query Commands

Command      Description
-----------------------------------------------------------------------------------------
MQDN         Query Mobile DN (DMS-100 Wireless Switch Only) 
QBERT        Query Bit Error Rate Testers 
QCM          Query Call Memory 
QCOUNTS      Query Counts 
QCPUGNO      Query the CPU Group Number
QCUST        Query Customer Information 
QDN          Query Individual Line Data 
QDNA         Query Data Network Address 
QDNSU        Obtain a Summary of Unassigned DNs 
QDNWRK       Obtain a Summary of Assigned DNs 
QGRP         Query a Call Pickup or Long Speed Call User Group 
QHA          Obtain a Detailed Listing of Assigned Hardware 
QHASU        Obtain a Summary of LEN Hardware Assigned and Software Unassigned 
QHLR         Query Home Location Register (DMS-100 Wireless Switch Only) 
QHU          Obtain a Summary of LEN Hardware Unassigned 
QLEN         Query Line Data Related to a Given LEN 
QLENWRK      Obtain a Summary of Working (Hardware Assigned and Software Assigned) LENs 
QLOAD        Obtain a Summary of LEN Assignments by Line Class Code 
QLRN         Query Location Routing Number 
QMADN        Query Multiple Access Directory Mumber 
QMODEL       Query Model 
QMSB         Query Make Set Busy 
QNCOS        Query Network Class of Service 
QPHF         Query Packet Handler 
QPRIO        Query Guaranteed Background Class of Process
QSCUGNO      Query Speed Call User Group Number 
QSIMR        Query Simultaneous Ringing (SimRing) Group
QSL          Query Screening List
QTOPSPOS     Query TOPS Positions 
QWUCR        Query Wake-Up Call Requests
-----------------------------------------------------------------------------------------
-End-

Query Commands Line Class and Agent Class Code Compatibility

The following table lists query commands and each type of line class or agent class with which they are compatible.  The line types are General Services Framework Enhanced Residential (GSF), International Business Networks (IBN), and Meridian Digital Centrex (MDC), which functions within IBN.







-----------------------------------------------------------------------------------------
Query Commands Line Class and Agent Class Compatibility

Command     GSF  IBN  MDC
-----------------------------------------------------------------------------------------
MQDN        N    Y    Y
QBERT       Y    Y    Y
QCM         N    Y    Y 
QCOUNTS     N    Y    N 
QCPUGNO     N    Y    Y 
QCUST       N    Y    Y 
QDN         Y    Y    Y 
QDNA        N    Y    N 
QDNSU       N    Y    Y 
QDNWRK      Y    Y    Y 
QGRP        N    Y    Y 
QHA         N    Y    Y 
QHASU       N    Y    Y 
QHLR        N    Y    Y 
QHU         N    Y    Y
QLEN        Y    Y    Y 
QLENWRK     Y    Y    Y 
QLOAD       N    Y    Y 
QLRN        N    Y    Y 
QMADN       N    Y    Y 
QMODEL      N    N    N 
QMSB        N    Y    Y 
QNCOS       N    Y    Y 
QPHF        N    N    N 
QPRIO       N    Y    Y 
QSCUGNO     N    Y    Y 
QSIMR       N    Y    Y 
QSL         N    Y    Y 
QTOPSPOS    N    N    N 
QWUCR       N    Y    Y
-----------------------------------------------------------------------------------------
-End-

Query Command Prompts

The following table lists the query command prompts and the correct data to be entered for each prompt.

-----------------------------------------------------------------------------------------
Query Command Prompts

Prompt           Valid input                    Explanation
-----------------------------------------------------------------------------------------
CARD_CODE        6X17AA, 6X18AA, 6X18AB,        The type of line card to be queried.
                 6X21AA, 6X58AA, or NIL_CTN     Defaults to all card types.
-----------------------------------------------------------------------------------------
CUSTGRP          Alphanumeric                   The customer group is a group of lines
                                                identified by a common language name.
-----------------------------------------------------------------------------------------
CUSTNAME         1 to 16 characters             The customer name is the character name
                                                assigned to the customer group.
-----------------------------------------------------------------------------------------
DIRECTORY_       Digits                         The DN to be queried.
NUMBER
-----------------------------------------------------------------------------------------
-continued-

-----------------------------------------------------------------------------------------
Query Command Prompts (continued)

Prompt           Valid input                    Explanation
-----------------------------------------------------------------------------------------
DIRECTORY_       R, ALL or R nnnnnnn nnnnnnn    The range of DNs to be queried.
NUMBER_
RANGE                                             * R prompts you to set a range.

                                                  * ALL queries every DN. 

                                                  * R and the two series of digits
					            represent the starting and final DNs
						    of the set to be queried.
-----------------------------------------------------------------------------------------
DN_OR_LEN        DN =                           Directory Number (DN) associated
                 7 or 10 digits                 with the service that is to be
                 entered with no                established, modified, or deleted.
                 spaces or hyphens.
                                                7-digit DN ambiguity exists if
                                                the DMS-100 switch serves more
                                                than one NPA and the same 7-digit 
                                                DN is used in multiple NPAs.

                                                To resolve this, you will be 
                                                prompted to enter the full
                                                10-digit DN.

                 LEN =                          The Line Equipment Number (LEN)
                 An entry in the format:        associated with a service to be
					        established, modified, or deleted.
                 <site> ff u dd cc

                 Where:
														                  
                   * <site> = Site Name
                     Defaults to HOST
		     (4 alphanumeric characters)

                   * ff = Frame Number
		     (0 to 511)

                   * u = Unit
                     (0 to 19)

                   * dd = Drawer Number
		     Drawer number of the line 
		     spread group.
		     (0 to 19)

                   * cc = Line Circuit Number 
		     (0 to 31)
-----------------------------------------------------------------------------------------
-continued-








-----------------------------------------------------------------------------------------
Query Command Prompts (continued)

Prompt           Valid input                    Explanation
-----------------------------------------------------------------------------------------
FORMATTED_OR     H or F                         Applies to QCM command only.
_HEX_(F|H)                                      The hexadecimal (H) option provides the
                                                same information as the formatted (F) option,
					        and includes:

						  * Display of what is now in system memory 
						    (the "physical view").

                                                  * The information that the DMS switch needs 
						    for table control (the "logical view").
-----------------------------------------------------------------------------------------

FORMAT           S (summary) or                 Specifies if the printout is to be a summary
                 D (detailed)                   or a detailed view of the information.
-----------------------------------------------------------------------------------------
FROM_DN          Digits                         The first DN in a range (R) of DNs queried.
-----------------------------------------------------------------------------------------
FROM_LM          Digits                         The first LM in a range (R) of LMs queried.
-----------------------------------------------------------------------------------------
GND              Y or N                         Applies to QHA and QHASU commands only. 
                                                Specifies if ground start only or both loop
					        and ground start lines are to be queried.

					        If "Y" is entered, the data on ground start 
					        lines is printed.  If "N" is entered, the data 
					        on loop and ground start lines (N) is printed.
-----------------------------------------------------------------------------------------
GRP_TYPE         CPU or SCU                     Applies to QGRP command only. 
                                                Specifies the type of group to be queried.
-----------------------------------------------------------------------------------------
LEN              Refer to DN_OR_LEN             The LEN associated with a service to be
                 above.                         established, modified, or deleted.
-----------------------------------------------------------------------------------------
LINE_CLASS_      Refer to the "Line Class       The Line Class Code (LCC) of the service
CODE             Code Table" in Issue #11.      to be queried.

                                                Defaults to all line class codes (NLCC).
-----------------------------------------------------------------------------------------
LINE_DRAWER_     Valid input format:            The line drawers in each line module to be
RANGE            R n1 n2 n3 ... $ALL            queried.

						Where: 
						  
						  n1, n2, ..., nn, are the designated numbers
	                                          (0 to 19) of the line drawers to be queried 
						  and $ is the list delimiter. 

					        Defaults to all drawers (ALL).
-----------------------------------------------------------------------------------------
-continued-








-----------------------------------------------------------------------------------------
Query Command Prompts (continued)

Prompt           Valid input                    Explanation
-----------------------------------------------------------------------------------------
LINE_MODULE_     Valid input format:            A range of Line Modules (LM) or Line
RANGE            lm_ident fn1 un1               Concentrating Modules (LCM) to be queried. 
		 lm_ident fn2 un2
                                                Where: 

		                                  lm_ident = is the Site Name
							     Defaults to HOST
						             (4 alphanumeric characters)

	                                          fn1 = First Frame number 
						        (0 to 99) 

					          un1 = First Unit Number 
						        (0 to 9) 

					          fn2 = End Frame Number 
						        (0 to 99) 

					          un2 = End Unit Number 
						        (0 to 9) 
					     
					        Defaults to all LM or LCM.
-----------------------------------------------------------------------------------------
NUMBERING_       3 digits                       The Numbering Plan Area (NPA) of the DN
PLAN_AREA                                       to be queried. 
                                                
						DMS-100 Wireless QHLR and MQDN commands only.
-----------------------------------------------------------------------------------------
NXX              3 digits                       The central office code of the DN to be
                                                queried.

					        DMS-100 Wireless QHLR command only.
-----------------------------------------------------------------------------------------
OPTION                                          Applicable to QDNWRK and QLENWRK commands
                                                only.

                                                Refer to the "Line Service Options" table in
					        Issue #11 for a list of valid inputs.

					        If one option is entered, only data on lines
					        with the specified option is printed out.

                                                If a "$" character is entered, the printout 
					        includes all options.  When the option is
					        entered in no-prompt mode, the option must
					        be delimited by the "$" character.
-----------------------------------------------------------------------------------------
RANGE            R (range) or N (no)            Allows a group of DNs or LENs to be queried.
-----------------------------------------------------------------------------------------
STATION          4 digits                       The station of the DN to be queried. 
                                                
						DMS-100 Wireless QHLR command only.
-----------------------------------------------------------------------------------------
-continued-




-----------------------------------------------------------------------------------------
Query Command Prompts (continued)

Prompt           Valid input                    Explanation
-----------------------------------------------------------------------------------------
SUMMARY_OR_      S or D                         The type of printout required.  "S"
DETAILS                                         specifies a summary printout.  Produces a
                                                count of the DNs or LENs being queried.  
						"D" specifies a detailed printout.  Provides
					        the same information as "S", but includes 
					        other information that varies according
					        to the query command selected. 
					     
					        Defaults to Summary (S).
-----------------------------------------------------------------------------------------
TO_DN            Digits                         The last DN in a range (R) being queried.
-----------------------------------------------------------------------------------------
TO_LM            Digits                         The last LM in a range (R) being queried.
-----------------------------------------------------------------------------------------
TREATMENT        ANCT, BLDN, OPRT,              The type of treatment to be queried. 
		 TRBL or UNDT                   
                                                  ANCT = Machine Intercept Announcement 
	                                          BLDN = Blank DN
			   		          OPRT = Operator Intercept 
					          TRBL = Trouble Intercept 
					          UNDT = All Treatments 
					     
					        Defaults to UNDT. 
					     
					        Treatments are defined in the data schema
                                                section of the Translations Guide.
-----------------------------------------------------------------------------------------
-End-

Examle Output of the QDN Command

Example output message of the Query Directory Number (QDN) command in prompt mode with an unique 7-digit directory number.

>QDN 6210100
--------------------------------------------------------
DN: 6210100
TYPE: SINGLE PARTY LINE
SNPA: 416  SIG: DT  LNATTIDX: 0
LINE EQUIPMENT NUMBER: HOST 02 0 01 00
LINE CLASS CODE: 1FR
IBN TYPE: STATION
CUSTGRP: RESG000  SUBGRP: 0  NCOS: 0
CARDCODE: 6X17AC  GND: H  PADGRP: STDLN  BNV: NL  MNO: N
PM NODE NUMBER: 26
PM TERMINAL NUMBER: 33
OPTIONS:
CWT DGT
RES OPTIONS:
SCF NOAMA INACT SCRJ NOAMA ACT $
--------------------------------------------------------