call_list

Manage a call list

Format

• [-v] [-V] -c -d --list --delay-seizure-list-number
• [-v] [-V] -c -d [--list] --position
• [--busy-position] [--dest-number] [--dnd-position]
• [--one-call] [--origin] [--ringing-time] [--sms-support]
• [--delay-seizure-list-number] [--ird-bypass]
• [--instant-messaging-support] [--call-list-cdiv]
• [-v] [-V] -d --list
• [-v] [-V] -e -d s [--list] [--position]
• [-v] [-V] -i -d [--busy-position] --dest-number [--dnd-position] [--delay-seizure-list-number] [--list]
• [--one-call] [--origin] --position [--ringing-time] [--sms-support] [--ird-bypass] [--instant-messaging-support]
• [--call-list-cdiv]
• [-v] [-V] -p [-d M] [--list] [-f]

Function

The command is used to change, erase, initiate, and print a call list. It is also used to set the active call list.

The call list is a distribution list for individual extensions, using the deflect service to forward the call to up to 10 different destinations in series. The distribution can be interrupted by various conditions, for example encountering a busy user or a user with DND active. Different call origins can optionally be treated differently. The ringing time and other options can also be configured.

Parameters

• --busy-position
  Busy Position. States to which position the call shall be distributed in case the --dest-number is busy, OR if the calling party shall receive busy and be offered busy services (call back, and so on).

  Value:
  0	No busy position. The distribution process is finished, and the calling party has received a busy tone).
  2...10	Selected position to distribute the call to in case of busy (must be a higher number than --position).
  11	Distribution process is finished in case of busy, and the call is rerouted if rerouting is defined.

  Example: '--busy-position 5', the call shall be distributed to the 5th position in the list.

  The switch requires an argument. The argument is single-valued.

• --call-list-cdiv

  Repeated distribution call diversion category. Pad to length is enabled for this switch.

  The digits have the following meaning:

  D1	External follow-me is allowed to be executed on the destination.
  	0	No
  	1	Yes
  D2	Follow-me is allowed to be executed on the destination.
  	0	No
  	1	Yes
  D3	Diversion Immediate (direct diversion) is allowed to be executed on the destination.
  	0	No
  	1	Yes
  D4	Diversion on no reply is allowed to be executed on the destination.
  	0	No
  	1	Yes
  D5	Diversion on busy is allowed to be executed on the destination.
  	0	No
  	1	Yes

  If the parameter is omitted, default value is 0000. The switch requires an argument. The argument is single-valued.

  Note: IRD service/list and diversion must be located in the same system. Otherwise, the call is distributed to the following position in the IRD list.

• -c, --change

  Change some settings, that is, reconfigure an item (or several items).

  The switch takes no arguments.

• --delay-seizure-list-number

  Delay seizure list number.

  Value
  0	No active delay seizure list number (can only be set via call_list and parallel_ringing, use --delay-seizure-list-number 0 to deactivate sequential ringing).
  1..999	Valid numbers

  The switch requires an argument. The argument is single-valued.

• --dest-number

  Destination to a number in the call list. The destination number may be any of the following numbers:

  • Analog extensions (Primary and Secondary)
  • Digital extensions (ODN and ADN)
  • Digital POTS extensions
  • ISDN extensions
  • CAS extensions
  • Integrated cordless extensions
  • Remote extensions
  • IP extensions
  • A destination in the private network
  • A destination in the public network (including LCR codes)
  • A group hunting group
  • A common bell group
  • An ACD group
  • A CTI group
  • Individual PBX operators or PBX operator group
  • A voice mail system
  • An Interception Computer System
  • Virtual extensions

  If public number, then the external destination code must be included.

  Example: --dest-number 007195555, where 00 is the external destination code.

  The switch requires an argument. The argument is single-valued.

• -d, --dir

  Directory number for an extension. The number must belong to a number series for extensions. Accepted argument length is 2 to 20 digits.

  The switch requires an argument.

• --dnd-position
  DND Position. States to which position the call shall be distributed in case the --dest-number has do not disturb values.

  Value
  0	The distribution process is finished, and the calling party shall receive a no progress tone.
  1..10	Selected position to distribute the call to in case of DND. The value must be either equal or higher than --position. DND is bypassed if the value is equal to the --position.

  Example: '--dnd-position 5', the call shall be distributed to the 5th position in the list.

  The switch requires an argument. The argument is single-valued.

• -e, --erase

  Erase some settings, that is, deconfigure an item (or several items).

  The switch takes no arguments.

• -f, --format

  Select a format for the printout.

  Possible values are: 'ACTIVE', 'LIST', 'REGEN', 'active', 'list', 'regen'.

  The switch requires an argument. The argument is single-valued.

  'list' means that data associated with a list is printed, normally the data printed is associated with a position.

  'active' and 'regen' will both print the active list number if it is in the following range:

  'active' 1 - 10.

  'regen' 2 - 10.

• -i, --initiate

  Initiate some settings, that is, make initial configuration of an item (or several items).

  The switch takes no arguments.

• --instant-messaging-support

  States whether instant messaging between end-points is supported for the --position (and the related --dest-number).

  The switch is only valid if the --dir is a generic extension. Default: true.

  Allowed values are: '1', 't', 'true', 'y', 'yes', '0', 'f',

  'false', 'n', 'no'.

  The switch requires an argument. The argument is single-valued.

• --ird-bypass

  States whether ird-bypass is supported for the --position (and the related --dest-number). Default: false.

  Allowed values are: '1', 't', 'true', 'y', 'yes', '0', 'f', 'false', 'n', 'no'.

  The switch requires an argument. The argument is single valued.

• --list
  Answering position list. The number corresponds to the Personal Number Profile number. One list contains one deflection list.

  Value
  0	No active list (can only be set via call_list --dir x --list 0 to inactivate personal number).
  1..50	list 1 to 50.

  The switch requires an argument. The argument is single-valued.

• --one-call

  States that the entered answering position can only be called once while the call is being distributed.

  When the parameter is set to false, the selected answering position can be called as many times as the Personal Number is called.

  When the parameter is set to true, once the selected answering position has received a call, it will not be called again by another incoming call to the service while the deflection to that answering position is ongoing. New incoming calls deflected to that answering position will be directly distributed to the next answering position in the active list, regardless of the value for parameter --busy-position.

  The recommended value for --one-call, when --dest-number belongs to the public network, is true.

  Note: Switch --one-call and switch --instant-messaging-support cannot both be set to true.

  Allowed values are: '1', 't', 'true', 'y', 'yes', '0', 'f', 'false', 'n', 'no'.

  The switch requires an argument. The argument is single-valued.

• --origin
  Origin selection. The --position (and the related --dest-number) can be selected depending on the calling party type. Pad to length is enabled for this switch.

  Value
  D1	Internal/Private origin: 0 - Not allowed, 1 - Allowed
  D2	PBX operator origin: 0 - Not allowed, 1 - Allowed
  D3	Public/unknown origin: 0 - Not allowed, 1 - Allowed
  Default value: 111

  The switch requires an argument. The argument is single-valued.

• --position

  Position order. The answer position place in the --list. There can be up to ten positions in each list. Value: 1..10

  The switch requires an argument. The argument is single-valued.

• -p, --print

  Print all or some settings, that is, print the configuration of an item, several items, or all items.

  The switch takes no arguments.

• --ringing-time

  States the ringing time when calling to an answering position (--position) before deflecting the call to the next position in the list or, if it is the last one, the call shall be terminated.

  Value: 2..60 seconds.

  Example: '--ringing-time 20', the --dest-number will be called for 20s before the call is deflected to the next position.

  The switch requires an argument. The argument is single-valued.

• --sms-support

  States whether SMS is supported for the --position (and the related --dest-number). Default: false.

  Allowed values are: '1', 't', 'true', 'y', 'yes', '0', 'f', 'false', 'n', 'no'.

  The switch requires an argument. The argument is single-valued.

• -v, --verbose

  Turn on verbose output (that is, progress information) to standard error.

  The switch takes no arguments.

• -V, --verbose-to-syslog

  Turn on verbose logging to syslog (usually to /var/log/messages).

  The switch takes no arguments.

Examples

• The call list for directory number 1000 is already initiated and its new changed data will be: For the list number 2 and position 3, the call will be distributed to position 4 in case the third one is busy.

  call_list -c --dir 1000 --list 2 --position 3 --busy-position 4

• The call list for directory number 2000 is already initiated. It will change the following data for the list number 2 and position 3: A destination number of 024823535. A ringing supervision time of 14 seconds. The new destination number specified above can only be called once while the call is being distributed. It will not be called again by another incoming call until the terminal is free.

  call_list -c --dir 2000 --list 2 --position 3 --dest-number 024823535 --ringing-time 14 --one-call 1 --instant-messaging-support no

• The call list for directory number 1500 will change the switch --origin in its position 1 of its list number 2: The call shall be answered only when calling from a PBX operator.

  call_list -c --dir 1500 --list 2 --position 1 --origin 010

• The already initiated call list for directory number 2500 will change the following data for the list number 2 and position 3: A destination number of 2255. The new destination number specified above is allowed to receive SMS messages.

  call_list -c --dir 2500 --list 2 --position 3 --dest-number 2255 --sms-support 1

• The already initiated call list for directory number 2500 will change the following data for list number 2 and position 3: A destination number of 2255. The destination number of 2255 is allowed to execute ird-bypass.

  call_list -c --dir 2500 --list 2 --position 3 --dest-number 2255 --ird-bypass 1

• The already initiated call list for directory number 2500 will change the following data for the list number 2: Delay seizure list number 5.

  call_list -c --dir 2500 --list 2 --delay-seizure-list-number 5

• The already initiated call list for directory number 2500 will change the following data for the list number 2 and position 3: Delay seizure list number 10.

  call_list -c --dir 2500 --list 2 --position 3 --delay-seizure-list-number 10

• Delete all the lists associated to the call list for directory number 2000.

  call_list -e --dir 2000

• Delete the second list associated to the call list for directory number 2000.

  call_list -e --dir 2000 --list 2

• Delete the third position in the second list associated to the call list for directory number 1000.

  call_list -e --dir 1000 --list 2 --position 3

• Delete the third position in the first list associated to the call list for directory number 1000.

  call_list -e --dir 1000 --position 3

• Initiate a list for the call list for dir 2000. No list has been initiated before for this call list, so the initiated list will be list number 1.
  The initiated list contains answering positions with the following data:

  • For list position 3 the destination number is 8322 with a ringing supervision time of 10 seconds. Calls from the public network will not be answered from this position.
  • For list position 1 the destination number is 03413227. In case this destination number is busy, position 4 will answer the call. This destination number can only be called once and it does not depend on the origin.
  • For list position 5 the destination number is 3000 with a ringing supervision of 5 seconds. Calls from the operator will not be sent to this position.
  • For list position 2 the destination number is 8325 with a ringing supervision time of 10 seconds.
  • For list position 4 the destination number is 5255, which is allowed to receive SMS messages.
  • For list position 6 the destination number is 5256, which is allowed to do IRD bypass when calling from 5256 to Personal Number list directory number 2000.
  • For list position 7 the internal destination number is 5238. In case this destination number has do not disturb active, position 9 will answer the call.

  call_list -i --dir 2000 --position 3 --dest-number 8322 --ringing-time 10 --origin 110

  call_list -i --dir 2000 --position 1 --dest-number 03413227 --busy-position 4 --one-call 1 --instant-messaging-support no

  call_list -i --dir 2000 --position 5 --dest-number 3000 --ringing-time 5 --origin 101

  call_list -i --dir 2000 --position 2 --dest-number 8325 --ringing-time 10

  call_list -i --dir 2000 --position 4 --dest-number 5255 --sms-support 1

  call_list -i --dir 2000 --position 6 --dest-number 5256 --ird-bypass 1

  call_list -i --dir 2000 --position 7--dest-number 5238 --dnd-position 9

• Initiate the second position in list number 3 associated to the call list for dir 1500, with the destination number 8776. It will only answer calls from the PBX operator. In case the dest number is busy, the distribution process is stopped.

  call_list -i --dir 1500 --list 3 --position 2 --dest-number 8776 --origin 010 --busy-position 11

• Initiate a first position in a call list 1 for extension 2000 that supports instant messaging calls. Several calls must be allowed, and the destination number shall be 5256.

  call_list -i -dir 2000 --list 1 --position 1 --dest-number 5256 --one-call no --instant-messaging-support yes

• Initiate a first position in a call list 1 for extension 2001, with the destination number 3256 and Follow-me is allowed to be executed on the destination.

  call_list -i -dir 2001 --list 1 --position 1 --dest-number 3256 --call-list-cdiv 01000

• Print all call lists in the ‘normal’ format.

  call_list -p

• Print all call lists that have the ‘list’ format.

  call_list -p -f list

• Change the active call list to 3 for dir 2000.

  call_list -d 2000 --list 3