3 EAGLE V-Flex Commands

This chapter describes the EAGLE commands used for the configuration of the Voice Mail Router (V-Flex) feature.

3.1 EAGLE Commands

This chapter describes the EAGLE commands used for the configuration of the Voice Mail Router (V-Flex) feature. Refer to Commands User's Guide for complete command descriptions including parameter names, valid parameter values, examples, and dependencies.

Table 3-1 Commands used for V-Flex

Type Commands
System Serial Number ent/rtrv-serial-num
Card ent/dlt/rtrv/alw/inh/init/rept-stat-card
Feature Control enable/chg/rtrv-ctrl-feat
STP Options chg/rtrv-stpopts
EAGLE STP Self Identification chg/rtrv-sid
Mated Application (MAP) chg/dlt/ent/rtrv-map
Subsystem Application chg/dlt/ent/rtrv-ss-appl
Service Selector chg/dlt/ent/rtrv-srvsel
HOMERN Entries ent/dlt/rtrv-homern
V-Flex Options

ent/chg/dlt/rtrv-vflx-cd

chg/rtrv-vflx-opts

ent/chg/dlt/rtrv-vflx-rn

ent/chg/dlt/rtrv-vflx-vmsid

Local Subsystem Activation alw/inh-map-ss

3.1.1 EAGLE Feature Control Commands

The GTT feature must be turned on in the system before the V-Flex feature can be enabled.

The chg-feat and rtrv-feat commands are used to turn on and display the on/off status of features, such as GTT, that are controlled with feature bits.
  • chg-feat - Change Feature
    • The chg-feat command is used to set the bit in the system to indicate the status of on for a feature that is controlled with a bit – to turn on the feature. After the feature is turned on, it cannot be turned off.
    • :gtt=on - Turns on the GTT feature.
  • rtrv-feat - Retrieve Feature
    • The rtrv-feat command is used to display the status (on or off) of features that are controlled with feature bits. This command has no parameters.

Note:

As of Release 46.3, the fak parameter is no longer required. This parameter is only used for backward compatibility.

When a feature is enabled using the enable-ctrl-feat command with the feature part number and feature access key, it is recognized by the system. Other actions might be needed to make the feature fully operational, such as turning the feature on, installing hardware, and database provisioning.

The V-Flex feature must be enabled using the V-Flex feature part number 893016701 and a feature access key. The feature access key is based on the V-Flex feature part number and the serial number of the system, making the feature access key site-specific.

Some features can be enabled with a temporary feature access key for a limited trial of the feature. The V-Flex feature cannot be enabled using a temporary feature access key.

After the feature is enabled, the feature must be turned on by using the chg-ctrl-feat command to set the feature status to on. The V-Flex feature is a Permanently On feature. The feature cannot be turned off after it is turned on.

The enable/chg/rtrv-ctrl-feat commands are used to enable, turn on, and display the status of features that are controlled by feature access keys.
  • enable-ctrl-feat – Enable Control Feature
    • The enable-ctrl-feat command uses the following parameters to permanently enable the V-Flex feature:
    • :partnum - The Oracle-issued part number for the V-Flex feature, 893016701.
    • :fak - The feature access key contains 13 alphanumeric characters and is not case sensitive.
  • chg-ctrl-feat – Change Control Feature
    • The chg-ctrl-feat command is used to turn on the V-Flex feature. After the V-Flex feature is turned on, it is permanently on; it cannot be turned off.
    • The chg-ctrl-feat command uses the following parameters to turn on the V-Flex feature:
    • :partnum - The Oracle-issued part number of the V-Flex feature, 893016701.
    • :status=on - Sets the status of the enabled V-Flex feature to on.
  • rtrv-ctrl-feat – Retrieve Control
    • The rtrv-ctrl-feat command displays the status (on or off) of the enabled features in the system. After the V-Flex feature is enabled, the VFLEX entry in the command output shows the status as off. After the V-Flex feature is turned on, the VFLEX entry in the command output shows the status as on.
    • The command can be entered with no parameters to list all enabled features, or with one of the following parameters:
    • :partnum - Specify the part number 893016701 to display the status only for the V-Flex feature.
    • :enable - Specify the value perm to display the status of all permanently enabled features in the system.

3.1.2 EAGLE Service Selector Commands

The ent/chg/dlt/rtrv-srvsel service selector commands are used to provision, remove, change, and display the applicable service selectors required for a service entry for DSM services. These commands provide some flexibility when provisioning the type of messages that require V-Flex processing.

  • The ent-srvsel command specifies the applicable service selectors to define a V-Flex DSM service entry.

    The ssn=* parameter is supported for the V-Flex subsystem. The snp and snai parameters are not needed in V-Flex service selectors.

    The gti/gtii/gtin value can be either 2 or 4.

    If the gti/gtii/gtin value is 2, the np, nai, npv, or naiv parameters cannot be specified with the ent-srvsel command.

    If either the npv or naiv parameters are specified in the ent-srvsel command, then both parameters must be specified and neither the np and nai parameters can be specified.

  • The chg-srvsel command specifies the applicable selectors to change an existing V-Flex service entry.
  • The dlt-srvsel command specifies the applicable selectors to delete an existing service entry.

    Either the np and nai, or npv and naiv parameters can be specified with the dlt-srvsel command only if the gti/gtii/gtin value for the service selector being removed is 4. If the gti/gtii/gtin value of service selector being removed is 2, only the gti/gtii/gtin, tt, and ssn parameters can be specified with the dlt-srvsel command.

    If either the np or nai parameters are specified with the dlt-srvsel command, then both parameters must be specified with the dlt-srvsel command and neither the npv and naiv parameters can be specified with the dlt-srvsel command.

    Note:

    If the service selector being removed does not show values for the np and nai parameters, or the npv and naiv parameters, and you want to use these parameters with the dlt-srvsel command, refer to the command description in Commands User's Guide for the np and nai values that correspond to the npv and naiv values for the service selector being removed.

    Note:

    If the service selector being removed does not show values for the npv and naiv parameters, and you want to use these parameters with the dlt-srvsel command, refer to the command description in Commands User's Guide for the npv and naiv values that correspond to the np and naiv values shown for the service selector being removed.
  • The rtrv-srvsel command displays a list of provisioned service selector combinations. All output is sorted first by service, then by global title domain (ANSI first, followed by ITU), GTI, translation type, numbering plan, and the nature of address indicator. The output can be filtered by specifying various optional parameters.

    Because of the large number of service selectors that can be in the database, the rtrv-srvsel command can be entered with the num and force parameters. The num parameter specifies the maximum number of entries to display. The force parameter must be specified to display more than 50 entries. This prevents trying to display extremely large numbers of entries, which could take hours.

3.1.3 EAGLE V-Flex Options Commands

The chg-vflx-opts and rtrv-vflx-opts commands define and display V-Flex options in the system. The options are used to condition the DN in an incoming MSU.

  • chg-vflx-opts - Change V-Flex Options
    • The chg-vflx-opts command uses the following parameter to provision the data in the VFLXOPTS table:

Table 3-2 chg-vflx-opts Parameters - Class = DATABASE

Parameter Optional/ Mandatory Range Description
dra Optional rn, rndn, ccrndn Destination Routing Address (DRA)
dranai Optional sub, unknown, natl, intl, ntwk Nature Of Address Indicator for DRA
dranaiv Optional 0-127 Nature Of Address Indicator Value for DRA
dranp Optional e164, x121, f69 Numbering Plan for DRA
dranpv Optional 0-7 Numbering Plan Value for DRA
nequeryonly Optional off, on Search Call Decision table after RTDB lookup
netype Optional vmsid, sprn, grn Network Entity Type used for RTDB lookup
  • rtrv-vflx-opts - Retrieve V-Flex Options
    • The rtrv-vflx-opts command displays the V-Flex options setting that are provisioned in the VFLXOPTS table.

3.1.4 EAGLE HOMERN Prefix Commands

The ent/dlt/rtrv-homern commands define, delete, and display home routing number prefixes in the HOMERN table.

  • ent-homern - Enter Home Routing Number Prefix
    • The ent-homern command is used to enter up to 100 home routing number prefixes for the operating network into the HOMERN table.
    • :rn - Home routing number prefix (1-15 digits)
  • dlt-homern - Delete Home Routing Number Prefix
    • The dlt-homern command removes a home routing number prefix from the HOMERN table.
    • :rn – Home routing number prefix (1-15 digits)
  • rtrv-homern - Retrieve Home Routing Number Prefix
    • The rtrv-homern command displays the list of home routing number prefixes that belong to the operation network. The command has no parameters.

3.1.5 EAGLE Voice Mail Prefix Commands

The ent/chg/dlt/rtrv-csl commands are used to enter, change, delete, and display Voice Mail prefix entries for V-Flex. The common screening list entries tailor certain types of common screening information to specific features.

  • ent-csl - Enter Common Screening List
    • The ent-homern command is used to enter up to 100 home routing number prefixes for the operating network into the HOMERN table.
    • The ent-csl command is used to enter a Voice Mail prefix digit string; the string is specified in the following parameter:
    • :ds - Specify 1-15 hexadecimal digits for the prefix
    • The V-Flex feature is identified in the command by one of the following parameters:
    • :feature - Specify the feature name as it appears in the rtrv-ctrl-feat command output when the feature is enabled (:feature=”VFLEX”).
    • :pn - Specify the V-Flex feature part number 893016701
    • The Common Screening List must be specified when the feature uses more than one screeening list. V-Flex uses only the vmpfx list.
    • :list - Specify the name of the Common Screening List associated with the feature (:list=vmpfx).
  • chg-csl - Change Common Screening List
    • The chg-csl command is used to change a Voice Mail prefix digit string; the new string is specified in the following parameter:
    • :ds - Specify 1-15 hexadecimal digits for the prefix
    • The V-Flex feature is identified in the command by one of the following parameters:
    • :feature - Specify the feature name as it appears in the rtrv-ctrl-feat command output when the feature is enabled (:feature=”VFLEX”)
    • :pn - Specify the V-Flex feature part number 893016701
    • The Common Screening List must be specified when the feature uses more than one screeening list. V-Flex uses only the vmpfx list.
    • :list - Specify the name of the Common Screening List associated with the feature (:list=vmpfx).
  • dlt-csl - Delete Common Screening List
    • The dlt-csl command is used to delete a Voice Mail prefix digit string; the string is specified in the following parameter:
    • :ds – Specify 1-15 hexadecimal digits for the prefix
    • The V-Flex feature is identified in the command by one of the following parameters:
    • :feature - Specify the feature name as it appears in the rtrv-ctrl-feat command output when the feature is enabled (:feature=”VFLEX”)
    • :pn - Specify the V-Flex feature part number 893016701
    • The Common Screening List must be specified when the feature uses more than one screeening list. V-Flex uses only the vmpfx list.
    • :list - Specify the name of the Common Screening List associated with the feature (:list=vmpfx).
  • rtrv-csl - Retrieve Common Screening List
    • The rtrv-csl command is used to display the provisioned Voice Mail prefix entries. The V-Flex feature is identified in the command by one of the following parameters:
    • :feature - Specify the feature name as it appears in the rtrv-ctrl-feat command output when the feature is enabled (:feature=”VFLEX”)
    • :pn - Specify the V-Flex feature part number 893016701

3.1.6 EAGLE Voice Mail Routing Number Commands

The chg/dlt/ent/rtrv-vflx-rn commands are used to define and display voice mail routing numbers and routing number names, and to view the associated reference count.

  • chg-vflx-rn - Change Voice Mail Routing Number
    • The chg-vflx-rn command uses the following parameters:
    • :rnname - Routing number name associated with a voice mail routing number
    • :nrn - New Voice Mail Routing Number associated with a routing number name
    • :nrnname - New Routing Number Name
  • dlt-vflx-rn - Delete Voice Mail Routing Number
    • A routing number (name) cannot be deleted if its associated reference count is greater than zero. (Use the rtrv-vflx-rn command to display the reference count.)
    • The dlt-vflx-rn command uses the following parameter:
    • :rnname - Routing number name associated with a voice mail routing number
  • ent-vflx-rn - Enter Voice Mail Routing Number
    • The ent-vflx-rn command uses the following parameters to associate voice mail routing numbers with routing number names.
    • :rn - Voice Mail Routing Number
    • :rnname - Voice Mail Routing Number Name
  • rtrv-vflx-rn - Retrieve Voice Mail Routing Number
    • The rtrv-vflx-rn command displays voice mail routing numbers and routing number names, and the associated reference count.
    • When the command is entered with no parameters, all provisioned voice mail routing number information is displayed.
    • The following parameters can be used to display information for a specific routing number or routing number name, with or without the reference count:
    • :refcnt - Display (yes) or do not display (no) the reference count
    • :rn - Voice Mail Routing Number
    • :rnname - Voice Mail Routing Number Name

3.1.7 EAGLE Voice Mail Server ID Commands

The ent/chg/dlt/rtrv-vflx-vmsid commands are used to enter, change, delete, and display Voice Mail Server IDs for V-Flex.

  • ent-vflx-vmsid - Enter Voice Mail Server ID
    • The ent-vflx-vmsid command is used to define a Voice Mail Server ID and associate up to 10 voice mail routing number names with that VMSID. The default VMSID comprises a special default set of routing numbers used when a query is received with either an invalid MSISDN or with a MSISDN that is not found in the RTDB.
    • The following command parameters specify the new VMSID and the routing number name associated with each specified voice mail routing number index:
    • :id - Specify 1-15 hexadecimal digits for the ID, or dflt to specify the default VMSID
    • :idx0 through :idx9 - Specify the new routing number name for the specified voice mail routing number index.
  • chg-vflx-vmsid - Change Voice Mail Server ID
    • The chg-vflx-vmsid command is used to change one or more voice mail routing numbers that are associated with a VMSID.
    • The following command parameters specify the VMSID and the new routing number name associated with each voice mail routing number index:
    • :id - Specify 1-15 hexadecimal digits for the ID, or dflt to specify the default VMSID
    • :idx0 through :idx9 - Specify the routing number name for the specified voice mail routing number index.
  • dlt-vflx-vmsid - Delete Voice Mail Server ID
    • The dlt-vflx-vmsid command with the following parameter is used to delete a Voice Mail Server ID from the VMSID table:
    • :id - Specify 1-15 hexadecimal digits for the ID
  • rtrv-vflx-vmsid - Retrieve Voice Mail Server ID
    • The rtrv-vflx-vmsid command is used to display the provisioned V-Flex VMSIDs and the routing number name associated with each voice mail routing number index.
    • When the command is entered with no parameters, all VMSIDs are displayed. The following parameters are used to display one VMSID, or all entries referring to the specified routing number name:
    • :id - Specify 1-15 hexadecimal digits for the ID, or dflt to specify the default VMSID
    • :rnname - Specify a routing number name that is associated with the specified VMSID

3.1.8 EAGLE Call Decision Entry Commands

The ent/chg/dlt/rtrv-vflx-cd commands are used to enter, change, delete, and display call decision entries for the V-Flex feature.

  • ent-vflx-cd - Change V-Flex Call Decision Entry
    • The ent-vflx-cd command is used to define the call decision criteria that are used to create a voice mail routing number.
    • The command uses the following parameters to define the call decision entry:
    • :bcap - INAP/CAP bearer capabilities; numerical values that are used to indicate the type of mail that is used by the call, such as voice, video, or multimedia. The user assigns meanings to the numbers; V-Flex does not place any interpretation on the values. The value none can be specified to indicate that there is no BCAP information in the entry.
    • :cdn - The call decision name for the new call decision entry
    • :dnstat - Dialed number status, to indicate whether the MSISDN is found in the EPAP RTDB, is not found in the RTDB, or does not matter.
    • :rnidx - The routing number index to be associated with the generated voice mail routing number.
    • :rdi - Call redirection indicator (redirected or not redirected)
    • :vmdig - The voice mail number or voice mail prefix digits to associate with the specified call decision entry name. If the call is redirected (the rdi=redir parameter is specified), then the value specified for the vmidg parameter represents a voice mail number. If the call is not redirected (the rdi=dir parameter is specified), then the value specified for the vmidg parameter represents a set of voice mail digits.
  • chg-vflx-cd - Change V-Flex Call Decision Entry
    • The chg-vflx-cd command is used to change an existing V-Flex call decision entry. The command uses the following parameters to change the call decision entry name, a routing number index associated with the call decision entry, or a voice mail number or voice mail prefix digits that are associated with a call decision entry:
    • :cdn - An existing call decision entry name
    • :ncdn - The new name for the specified call decision entry
    • :nrnidx - The new routing number index to be associated with the specified call decision entry name
    • :nvmdig - The new voice mail number or voice mail prefix digits to associate with the specified call decision entry name
  • dlt-vflx-cd - Delete V-Flex Call Decision Entry
    • The dlt-vflx-cd command with the cdn parameter is used to remove an existing V-Flex call decision entry from the Call Decision table.
    • :cdn – An existing call decision entry name
  • rtrv-vflx-cd - Retrieve V-Flex Call Decision Entry
    • The rtrv-vflx-cd command is used to display the provisioned V-Flex call decision entries.
    • When the command is entered with no parameters, all call decision entries are displayed. The following parameters are used to display one call decision entry, or all call decision entries that are associated with the specified voice mail number or voice mail prefix digits.
    • :cdn - Call decision name; name of a call decision entry
    • :vmdig - Voice mail number or voice mail prefix digits