8950 VAM (8950 Voice Activation Manager) Task Execution ...

8950 VAM (8950 Voice Activation Manager)Task Execution GuideRelease 16.0

365-370-370R16.0Issue 1

July 2010

Copyright © 2010 Alcatel-Lucent. All Rights Reserved.

This material is protected by the copyright laws of the United States and other countries. It may not be reproduced, distributed, or altered in any fashion by any entity (either internal or external to Alcatel-Lucent), except in accordance with applicable agreements, contracts, or licensing, without the express written consent of Alcatel-Lucent and the business management owner of the material.

For permission to reproduce or distribute, please contact:

Product Development Manager: +1 317 322 6847 1 800 645 6759 (continental U.S.)

Notice

Every effort was made to ensure that this information product was complete and accurate at the time of printing. However, information is subject to change.

Mandatory customer information

This information product does not contain any mandatory customer information.

Interference information: Part 15 of FCC rules

NOTE: This equipment has been tested and found to comply within the limits.

Trademarks

Alcatel-Lucent, Lucent, and http://www.alcatel-lucent.com are registered trademarks of Alcatel-Lucent.

HP is a registered U.S. trademark of the Hewlett-Packard Company.

Microsoft is a registered trademark and Windows and Windows NT are trademarks of Microsoft Corporation in the United States and in other countries.

Pentium is a registered trademark of Intel Corporation.

Sun is a registered trademark of Sun Microsystems, Inc licensed to Sunsoft, Inc; and Java is a trademark of Sun Microsystems, Inc.

Ordering information

The ordering number for this information product is 365-370-370R16.0.

Support

Information product support

Alcatel-Lucent provides a referral telephone number for support. Use this number to report errors or to ask questions about the information product. This is a non-technical number. The referral telephone number is +1 317 322 6847 or 1 800 645 6759 (continental U.S.).

Technical support

Technical assistance can be obtained by calling the Global Welcome Center at:

Toll Free: 1 (866) 582-3688

International or Direct Dial: 1-613-784-6100

Developed by Alcatel-Lucent Customer Training and Information Products.

C O N T E N T Si i i

365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................................................................................................

Contents

............................................................................................................................................................................................................................................................

1 Introduction to Task ToolkitOverview 1-1

8950 VAM Task Toolkit 1-2

............................................................................................................................................................................................................................................................

2 Task Execution OverviewOverview 2-1

Hardware Specifications 2-2

Software Specifications 2-5

............................................................................................................................................................................................................................................................

3 Task Execution InterfaceOverview 3-1

Browser Set-up 3-4

Starting 8950 VAM 3-5

Navigation Buttons in the 8950 VAM Launch -8

Changing the Password 3-9

Common Area Buttons 3-10

Starting Task Execution 3-12

Selecting a Switch 3-16

Selecting Multiple Switches 3-17

The Task Order Summary Screen 3-19

Customizing the Task Order Summary Screen 3-21

Creating a User Profile 3-22

Querying on Start-Up 3-24

Setting Default Query Task Order 3-25

Setting Default Task Order Summary Display 3-28

...........................................................................................................................................................................................................................................................

C O N T E N T Si v

365-370-370R16.0Issue 1, July 2010

Displaying the Screen After Modification 3-30

Multiple Language Support 3-31

Using the Task Execution Commands 3-32

Task Execution Commands 3-33

The Task Execution Toolbar 3-36

The Keyboard Shortcuts 3-37

The Task Order Screen 3-40

Pasting Data from an External Application 3-47

Using the Insert Command in a Repeat table 3-48

Using the Modify Command in a Repeat table 3-50

Creating a New Task Order 3-52

Displaying Task Order Information by Query 3-55

Displaying a list of orders in an existing Task Order Summary screen 3-56

Displaying a list of orders in a new Task Order Summary screen 3-57

Querying by Timestamp 3-62

Filtering the Displayed Orders on a Task Order Summary Screen 3-65

Modifying a Task Order 3-68

Modifying an Existing Task Order 3-69

Canceling a Task Order 3-72

Copying a Task Order 3-75

Copying Data Between Dissimilar Orders 3-77

Displaying the Details of an Order 3-78

Retrieving the Recent Changes of a Task Order 3-83

Forcing an Order to Completion Status 3-87

Refreshing the Task Order Summary Screen 3-88

Printing Task Order Information 3-89

Requesting Help from Within Task Execution 3-91

Closing a Task Order Summary Screen 3-93

Terminating Task Execution 3-94

Multiple Order Processing from the Task Order Summary Screen 3-95

Canceling a Batch of Orders 3-96

Modifying a Batch of Orders 3-97

Copying a Batch of Orders 3-98

...........................................................................................................................................................................................................................................................

C O N T E N T Sv

365-370-370R16.0Issue 1, July 2010

Force Completing a Batch of Orders 3-99

............................................................................................................................................................................................................................................................

4 Upstream Batch Processing InterfaceOverview 4-1

Background 4-3

Data Interface Agreement 4-5

Creation of Spreadsheet Files 4-9

Processing Spreadsheet Files 4-11

Constraints and Assumptions 4-15

Configuration 4-16

............................................................................................................................................................................................................................................................

5 Sample Starter PackagesOverview 5-1

Sample Starter Package 5-2

............................................................................................................................................................................................................................................................

GL Glossary............................................................................................................................................................................................................................................................

IN Index

...........................................................................................................................................................................................................................................................

C O N T E N T Sv i

365-370-370R16.0Issue 1, July 2010

F I G U R E Sv i i

365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................................................................................................

List of figures

............................................................................................................................................................................................................................................................

1 Introduction to Task Toolkit

............................................................................................................................................................................................................................................................

2 Task Execution Overview

2-1 8950 VAM Topology 2-3

2-2 International Configuration 2-4

............................................................................................................................................................................................................................................................

3 Task Execution Interface

3-1 8950 VAM Login Page 3-6

3-2 8950 VAM Launch Page 3-7

3-3 Central Select 3-12

3-4 Task Execution Desktop Screen 3-13

3-5 Notification screen 3-14

3-6 Screen Control Buttons 3-17

3-7 Task Execution Desktop Screen with Icons 3-18

3-8 Default Task Order Summary Screen 3-22

3-9 Desktop screen, View Menu 3-23

3-10 Task Order Summary (User Profile Mode) Screen 3-28

3-11 Sample Customized Task Order Summary Screen 3-30

3-12 Task Execution Toolbar 3-36

3-13 Example Task Order Screen 3-40

3-14 Sample Task Showing a Repeat Table 3-46

3-15 Insert Row Window 3-49

3-16 Modify Row Window 3-50

3-17 Task Order Screen with Scroll Arrows 3-51

...........................................................................................................................................................................................................................................................

F I G U R E Sv i i i

365-370-370R16.0Issue 1, July 2010

3-18 New Task Order Screen 3-52

3-19 New Task Order Screen with Multi-Switch Support 3-53

3-20 Multi-Switch Sample Order 3-54

3-21 Query Task Order Screen 3-58

3-22 Query Task Order Screen - Text Boxes and Status 3-59

3-23 Query Task Order Screen - Text Boxes 3-59

3-24 Query Task Order Screen - Timestamps 3-61

3-25 Calendar window 3-63

3-26 Query Task Order Screen - Bottom 3-64

3-27 Query Control Buttons 3-64

3-28 Filter Task Order Screen 3-65

3-29 Modify Task Order Screen 3-70

3-30 Canceling Orders on the Task Order Summary Screen 3-73

3-31 Cancel Order Confirmation Window 3-73

3-32 Copy Task Order screen 3-75

3-33 Example Task to be Copied 3-76

3-34 Task Order Details Screen for Order Status REJ 3-79

3-35 Task Orders Details Screen for Order Status ERR 3-80

3-36 Task Orders Details Screen for Order Status CPD 3-81

3-37 Retrieve Command - Item Summary Screen 3-83

3-38 Retrieve Command - Task Order Details Screen 3-85

3-39 Force Complete Confirmation Window 3-87

3-40 Refresh Command 3-88

3-41 Print Column Selection Screen 3-90

3-42 Example Output From the Print Command 3-90

3-43 Help Message from the Task Order Summary Screen 3-91

3-44 Help Message from the Query Task Order Screen 3-92

3-45 Exit Confirmation Screen 3-94

............................................................................................................................................................................................................................................................

4 Upstream Batch Processing Interface

4-1 UBIC Data Flow 4-4

...........................................................................................................................................................................................................................................................

F I G U R E Si x

365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

5 Sample Starter Packages

5-1 Sample Control Tab 5-3

5-2 Add Dedicated Access Trunk Service - Main Tab 5-4

5-3 Add POTS - Main Tab 5-5

5-4 Add POTS - Line Info Tab 5-5

5-5 Change MLHG 5-6

5-6 Change POTS - Main Tab 5-7

5-7 Change POTS - Line Info Tab 5-8

5-8 Delete POTS - Main Tab 5-9

5-9 Verify POTS - Main Tab 5-10

5-10 Add CENTREX Group - 5ESS 5-10

5-11 Add CENTREX Lines - 5ESS - View 1 5-11

5-12 Add CENTREX Lines - 5ESS - View 2 5-12

5-13 Add CENTREX Lines - DMS 5-13

5-14 ADD POTS (DMS) - Main Tab - View 1 5-14

5-15 ADD POTS (DMS) - Main Tab - View 2 5-15

5-16 Change POTS (DMS) - Main Tab - View 1 5-16

5-17 Change POTS (DMS) - Main Tab - View 2 5-17

5-18 Delete POTS (DMS) - Main Tab 5-18

5-19 DaRoute - DA ROUTE Details Tab 5-19

5-20 MGCF Trunk Group - Details 1 Tab 5-20




5-24 Route Digits Screen 5-23

5-25 Route Digits Key Set Screen 5-23

5-26 Route Digits Key Set - Reports page Screen 5-24

5-27 MGCF Intelligent Routing - Input Data Tab 5-25

5-28 MGCF Intelligent Routing - Data Tab 5-25

5-29 MGCF CAS Trunk - Details Tab 5-26

5-30 MGCF SS7 Trunk - Details Tab 5-26

...........................................................................................................................................................................................................................................................

F I G U R E Sx

365-370-370R16.0Issue 1, July 2010

T A B L E Sx i

365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................................................................................................

List of tables

............................................................................................................................................................................................................................................................


............................................................................................................................................................................................................................................................


2-1 Client Software Requirements 2-5

............................................................................................................................................................................................................................................................


3-1 Icons and their Definitions 3-10

3-2 Task Order Summary Screen Columns 3-19

3-3 Field Names and Values 3-26

3-4 Desktop Screen Menus and Commands 3-33

3-5 Task Order Summary Screen Menus and Commands 3-34

3-6 Item Summary Screen Menus and Commands 3-35

3-7 Keyboard Shortcuts 3-37

3-8 List of Widgets 3-44

3-9 Item Summary Screen Menus and Commands 3-84

............................................................................................................................................................................................................................................................


............................................................................................................................................................................................................................................................


...........................................................................................................................................................................................................................................................

T A B L E Sx i i

365-370-370R16.0Issue 1, July 2010

1 - 1365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................


............................................................................................................................................................................................................................................................

Overview

Purpose This chapter describes the three components of 8950 VAM (Voice Activation Manager) Task Toolkit, namely, Task Execution, Task Builder, and Task Administration.

Important! The product name “VitalSuite Voice Activation Manager” has been changed to “8950 VAM”. Starting with release 14.0, this name change has been done in the software and is reflected in the documentation. Hence in this release the names “VitalSuite Voice Activation Manager” is replaced with the new name “8950 VAM”.

Objectives This chapter provides information to perform the following:

• List the benefits of using 8950 VAM Task Toolkit.

• Identify the components of Task Toolkit.

• Specify the differences between Task Execution, Task Builder, and Task Administration.

The following topic(s) is/are included in this chapter.

8950 VAM Task Toolkit 1-3

...........................................................................................................................................................................................................................................................

1 - 2 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

8950 VAM Task Toolkit

Task Toolkit 8950 VAM Task Toolkit is a set of applications and software tools that enables a user to perform switch provisioning. It consists of three components, namely:

• 8950 VAM Task Execution

• 8950 VAM Task Builder

• 8950 VAM Task Administration

Task Execution 8950 VAM Task Execution is an application that allows you to create and send an order of Recent Changes (RCs) to a switch, using a pre-built form called a task. Task Execution is menu-driven and contains a set of commands that are used for managing existing orders. A user of Task Execution is referred to as a Task Executor. The DB partitioning feature is based on adding a new resource to the Application Administration Permissions. This resource will apply to the Task Order Summary and restrict users from a partitioned company so that they can only see records for tasks from themselves or other users from their company. Each user can only be in one work group and that work group is a task group to which resource groups are assigned. Users for partitioned companies are assigned to a work group that contains the resource group with the new resource.

Task Builder 8950 VAM Task Builder is an application that provides the ability to define tasks. It can be used by a Task Executor to create an order of RCs. A task is a complex tool that consists of many components. The user of this application, called a Task Builder or Task Definer, must design the task, create each component individually, and unite all components within a task definition structure. The task is thoroughly tested and saved to a database, which is accessible to the Task Executors.

Task Administration 8950 VAM Task Administration is a set of tools that allows a Task Administrator to manage the resources that support the Task Toolkit applications and its users. The primary users of the 8950 VAM Task Toolkit are the task executors and task builders. The resources are items that are needed by the executors and builders to perform their jobs. For example, switches, printers, and tasks.

2 - 1365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................


............................................................................................................................................................................................................................................................

Overview

Purpose The 8950 VAM Task Execution system enables users to enter orders of recent changes as high level tasks. Such tasks can be specified by replacing parameters that change for each order. The system then creates an order which consists of the complete set of properly sequenced Recent Changes (RCs) that are required to accomplish the designated task.

To perform task entries, users of the Task Execution system do not need detailed knowledge of the switch.


• Identify the 8950 VAM hardware specifications

• Identify the 8950 VAM software specifications

The following topics are included in this chapter.

Hardware Specifications 2-2

Software Specifications 2-4

...........................................................................................................................................................................................................................................................

2 - 2 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Hardware Specifications

Introduction This section lists the hardware specifications that are required to support the 8950 VAM. The topology is shown in Figure 2-1 and Figure 2-2.

Client Configurations The client platform may use any of the following operating systems:

• Solaris

• Windows

The browser always runs on the client. In the future, platforms such as Network Computers (NCs) are likely to emerge which are specifically designed to run Java. Until such time, only client configurations are anticipated in our customer environments.

Combined Client/ServerConfiguration

8950 VAM allows entry-level configurations that minimize the use of equipment. Such configurations require all Task Toolkit components to be installed on a single host, such as an HP-UX platform.

...........................................................................................................................................................................................................................................................

2 - 3365-370-370R16.0Issue 1, July 2010

Figure 2-1 8950 VAM Topology

...........................................................................................................................................................................................................................................................

2 - 4 365-370-370R16.0Issue 1, July 2010

Figure 2-2 International Configuration

...........................................................................................................................................................................................................................................................

2 - 5365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Software Specifications

The Server To install the Task Toolkit on a server, the following upgraded or additional third-party packages are required:

1. HP-UX

2. INFORMIX Dynamic Server

3. BaseWorX

4. Apache Web Server

5. Iona Orbix MT C++

6. JAVA RunTime Environment (JRE)

Reference: See 8950 VAM Release Notes for details on applicable versions of third-party software.

The Client The following table lists software that must be installed on the client:

Table 2-1 Client Software Requirements

Other applicable requirements include the following:

1. At least 256 MB random access memory (RAM) for a PC and at least 512 MB RAM for a workstation.

2. Monitor with screen size at least equal to 17 inches.

3. Monitor with screen resolution as follows:

• SUN Solaris - 1152X900.

• PC - 1024x768, true color.

________________________________SOFTWARE _________________PC _______________________SUN WORKSTATION

OPERATING SYSTEM Microsoft Windows 2000

Microsoft Vista

Solaris

BROWSER Microsoft Internet Explorer

Netscape

JAVA PLUG-IN TASK EXECUTION

TASK BUILDER

TRANSLATIONS INTERFACE

OAM Applets

The latest version that is specified in the 8950 VAM Release Notes.

The latest version that is specified in the 8950 VAM Release Notes.

3 - 1365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................


............................................................................................................................................................................................................................................................

Overview

Purpose This chapter describes the Task Execution user interface. It contains information on how to start the application and navigate through the interface screens to perform user activities.


1. Prepare the browser to access Task Execution.

2. Start and log in to the Task Execution application.

3. Create a new task order.

4. Query for specific task orders.

5. Customize the displayed list of task orders.

6. Modify an existing task order.

7. Cancel a task order.

8. Create a task order by copying an existing one.

9. View detailed information for a task order.

10. List the recent changes of an existing order.

11. Force an order to completion status to prevent its removal.

12. Refresh the list of task orders.

13. Print a task order.

14. Perform certain operations on multiple orders at the same time.

...........................................................................................................................................................................................................................................................

3 - 2365-370-370R16.0Issue 1, July 2010

15. Monitor switch access.

The following topics are included in this chapter:

Browser Set-up 3-3

Starting 8950 VAM 3-5

Navigation Buttons in the 8950 VAM Launch Page 3-8

Changing the Password 3-9

Common Area Buttons 3-10

Starting Task Execution 3-15

The Task Order Summary Screen 3-19

Customizing the Task Order Summary Screen 3-21

Multiple Language Support 3-27

Using the Task Execution Commands 3-28

Task Execution Commands 3-29

The Task Execution Toolbar 3-32

The Keyboard Shortcuts 3-33

The Task Order Screen 3-36

Creating a New Task Order 3-46

Displaying Task Order Information by Query 3-49

Filtering the Displayed Orders on a Task Order Summary Screen

3-58

Modifying a Task Order 3-60

Canceling a Task Order 3-63

Copying a Task Order 3-66

Displaying the Details of an Order 3-78

Retrieving the Recent Changes of a Task Order 3-73

Forcing an Order to Completion Status 3-77

Refreshing the Task Order Summary Screen 3-78

...........................................................................................................................................................................................................................................................

3 - 3 365-370-370R16.0Issue 1, July 2010

Printing Task Order Information 3-79

Requesting Help from Within Task Execution 3-81

Multiple Order Processing from the Task Order Summary Screen

3-95

...........................................................................................................................................................................................................................................................

3 - 4365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Browser Set-up

Introduction Using a browser, you can access the 8950 VAM Task Execution application. Supported browsers include Netscape and Microsoft Internet Explorer. You must setup the browser to access the 8950 VAM Task Execution application. To setup the browser, complete the following procedures:

• Remove unnecessary warning messages that appear in some Task Execution windows.

• Install Java plug-ins that allow you to use a special tool called the Java Console.

The following sections describe these procedures.

...........................................................................................................................................................................................................................................................

3 - 5 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Starting 8950 VAM

Steps to Login To start the Task Execution application, you must access the 8950 VAM Launch page by performing the following procedure:

...........................................................................................................................................................................

1 Start the browser and enter the correct uniform resource locator (URL) for your 8950 VAM system.

Important! The browser must be compatible with 8950 VAM as described in Chapter 2, Software Specifications. The URL may be obtained from your system or task administrator.

...........................................................................................................................................................................

2 Enter your username and password at the 8950 VAM Login Page as shown in Figure 3-1, “8950 VAM Login Page” (3-6) and choose Login.

Important! Ten unsuccessful logins will disable the login page. Contact your system administrator to re-enable your login.

...........................................................................................................................................................................................................................................................

3 - 6365-370-370R16.0Issue 1, July 2010

Figure 3-1 8950 VAM Login Page

...........................................................................................................................................................................

3 Click Login to get the 8950 VAM Launch page.

Result: After successful login, the 8950 VAM Launch Page is displayed, as shown in Figure 3-2, “8950 VAM Launch Page” (3-7). You can notice the display of information regarding the last successful login, that appears above the icons on the screen.

Important! Some items on the screens may not be available for all customers.

...........................................................................................................................................................................................................................................................

3 - 7 365-370-370R16.0Issue 1, July 2010

Figure 3-2 8950 VAM Launch Page

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 8365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Navigation Buttons in the 8950 VAM Launch Page

Background You can use the four blue navigation buttons on the left-side of the launch page as follows:

8950 VAM – Return to the launch page.

System Administration Central – Login to the central as the system administrator.

TELNET – Open a telnet window in order to login to a remote system.

Important! The Telnet protocol handler is no longer supported in Internet Explorer (IE) 7.0. Hence this button will not work in IE 7.0.

User Options – Change your password.

...........................................................................................................................................................................................................................................................

3 - 9 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Changing the Password

Procedure Follow these steps to change the password:

...........................................................................................................................................................................

1 Select Change Password.

...........................................................................................................................................................................

2 Enter the username.

...........................................................................................................................................................................

3 Enter the current password.

...........................................................................................................................................................................

4 Enter the new password.

...........................................................................................................................................................................

5 Re-enter the new password.

...........................................................................................................................................................................

6 Press the Accept action button.

...........................................................................................................................................................................................................................................................

3 - 1 0365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Common Area Buttons

Introduction You may use the gray common area buttons as follows:

Help – Display a help screen.

Documentation – Link to available online documentation.

Support – Display information about how to get 8950 VAM support.

About – Display the current release of 8950 VAM.

Customer icon The customer name appears within an icon underneath the common area on the 8950 VAM Launch Page.

8950 VAM Interfaces Table 3-1, “Icons and their Definitions”(3-10) describes the icons on the 8950 VAM launch page. Each icon accesses a different application of the system.

Important! Some items may not be available for all customers.

Table 3-1 Icons and their Definitions

Icon Definition

Application Administration Task and Network Element Manager (NEM) administration

System Administration User, Switch, and Workgroup Administration

Firewall Administration Firewall Application such as feature locking

Translation Interface Translation Interface Application for the shadow database

Task Building 8950 VAM Task Builder Application

Task Execution 8950 VAM Task Execution Application

...........................................................................................................................................................................................................................................................

3 - 1 1 365-370-370R16.0Issue 1, July 2010

Message of the Day The Message of the Day may be configured at the UNIX level by the system administrator or anyone with root user privileges. The existing data in /etc/motd cannot be removed, but the privileged user can append to the existing text. During subsequent revisions, you can remove or modify the appended text, but ensure that you retain the original text. To display the Message of the Day to the user, the privileged user must link the /etc/motd file to the /etc/customer.warning file. This will completely overwrite the contents of the customer.warning file with the contents of the motd file. The Message of the Day is displayed on the 8950 VAM Launch Page underneath the chip bar.

...........................................................................................................................................................................................................................................................

3 - 1 2365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Starting Task Execution

Procedure To start Task Execution, click the Task Execution icon that appears on the 8950 VAM Launch page that is shown in Figure 3-2, “8950 VAM Launch Page” (3-7). This displays the Task Execution Desktop screen.

Important! You can start Task Execution by using Central Select screen option or without using Central Select. The Central Select allows you to select the switch you want to access from a central. This feature is enabled using the ATP feature lock. This is applicable for customers with multiple centrals.

Figure 3-3 Central Select

...........................................................................................................................................................................................................................................................

3 - 1 3 365-370-370R16.0Issue 1, July 2010

Task Execution DesktopScreen

The Task Execution Desktop screen is the first screen to be displayed following the launch of task execution. It is launched within the browser window and resides there for all screens in the Task Execution application. It contains a menu bar with three menus, namely, File, View, and Help. The Task Execution Desktop screen is shown in Figure 3-4, “Task Execution Desktop Screen” (3-13). It contains two windows, the Task Order Summary screen and the Asynchronous Notification screen. You can resize the Task Execution window if the tunable parameter "RESIZABLE_TASK_GUI" has value "YES".

Figure 3-4 Task Execution Desktop Screen

Task Order SummaryScreen

The Task Order Summary screen is the main screen for the Task execution application. It typically displays a list that contains task order data. This screen has a menu bar and a toolbar that are used for executing commands. The commands use additional screens where actual activities are performed. A user must have permissions to display this screen. To display more than one Task Order Summary screen, click the File menu of the Task Execution Desktop screen followed by the New Task Order Summary command.

...........................................................................................................................................................................................................................................................

3 - 1 4365-370-370R16.0Issue 1, July 2010

Important! If DB partitioning is enabled and the logged in user belongs to a workgroup that has GroupPermissionOnly resource, then the users can only see the records or tasks from the logged in username or other users of their company.

Asynchronous Notificationscreen

The Asynchronous Notification screen shows the user the number of orders on selected switch queues and provides notification of order status changes to a terminal state such as CPD, ERR, or REJ. The Asynchronous Notification screen appears at the bottom of the Desktop screen. To activate the screen, click the View menu and then click the Enable Async Window command. You can close the screen by clicking the Disable Async Window command under the View menu. The screen can be minimized by clicking its minimize button that appears in its top right-hand corner. The size of this screen is fixed to display five lines of text.

Important! If DB partitioning is enabled and the logged in user belongs to a workgroup that has GroupPermissionOnly resource, then the users can only see the switches from the logged in username or other users of their company.

Figure 3-5 Notification screen

Asynchronous Notificationscreen layout

The screen is evenly divided into two sections that are separately scrollable. The left section is a rolling display of task order status changes tagged by order id and timestamp. The right section is called the Switch Queue Asynchronous window. It contains a list of all switches on the central and the number of items that are currently in the queue for each switch. These items are non-terminated, that is, they are still in a state of transmission. The non-terminated items are for orders in the XMT state for every switch on the central. The criteria for this list covers every successful task order submission using the Send release method, as well as every successful resubmit from the Details screen. Switches that have no outstanding items are reported with a queue length of zero items. The data is retrieved at five minute intervals and is posted at the Task execution GUI, when the GUI requests the information. A timestamp of when the poll occurred appears in the right section of the screen.

...........................................................................................................................................................................................................................................................

3 - 1 5 365-370-370R16.0Issue 1, July 2010

Switch is not connected If the switch status is in any other mode other than the connect mode, it can be viewed where the number of items is normally displayed. This indicates to the user whether the link between 8950 VAM and EMM or the link between EMM and the switch is down.

...........................................................................................................................................................................................................................................................

3 - 1 6365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Selecting a Switch

Introduction Included within the Asynchronous Notification screen is a multi-list Switch Name selection box. The user can choose the required switches that bubble up to the top for easy viewing.

Procedure To select a switch:

...........................................................................................................................................................................

1 Click on the drop-down menu.

...........................................................................................................................................................................

2 Select a switch.

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 1 7 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Selecting Multiple Switches

Procedure To select multiple switches:

...........................................................................................................................................................................

1 Select the first switch as described above.

Important! If no switches are selected then all switches are displayed; otherwise, only selected switches are displayed.

...........................................................................................................................................................................

2 From the keyboard, depress Shift + | (vertical bar).

...........................................................................................................................................................................

3 Select the required switch from the list that appears.

...........................................................................................................................................................................

4 Continue from step 2 as needed.

........................................................................................................................................................E N D O F S T E P S

Navigating the threescreens

In the top right-hand corner of the Task Order Summary screen is a set of three buttons: the minimize button, the maximize button, and the close button. They are shown in Figure 3-6, “Screen Control Buttons” (3-17).

Figure 3-6 Screen Control Buttons

The Asynchronous Notification screen contains a minimize button. Clicking the minimize button converts the screen to an icon within the Desktop screen. You can restore its size by clicking the icon itself. Figure 3-7, “Task Execution Desktop Screen with Icons” (3-18) shows the Desktop screen with both the Task Order Summary screen and the Asynchronous Notification screen minimized.

MaximizeMinimize Close

...........................................................................................................................................................................................................................................................

3 - 1 8365-370-370R16.0Issue 1, July 2010

Figure 3-7 Task Execution Desktop Screen with Icons

...........................................................................................................................................................................................................................................................

3 - 1 9 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

The Task Order Summary Screen

Description of Columns The list of order information that appears on the Task Order Summary screen is arranged in columns. You cannot change the data within the columns but you can use commands such as modify and query to affect the displayed information. The columns can be repositioned as desired. The column headings and descriptions are listed in Table 3-2 as follows:

Table 3-2 Task Order Summary Screen Columns

Column Name Description

OrderID Unique identifier of the order (up to 19 characters)

Status Current order status—one of the following: CAN, CPD, ERR, OPN, RDY, REJ, XMT

Task Name Long task name that is used to create the order (up to 255 characters)

Item Number of items in the order (up to four digits ranging from 1 through 5000)

Switch Number of switches to which the order was sent (up to three digits ranging from 0 through 999)

Switch Name Name of the switch to which this order was sent

For multi-switch orders:

If the status is CAN, CPD, OPN, RDY, or XMT, then this field contains the name of the first switch to which this order was sent.

If the status is ERR or REJ, then this field contains the name of the first switch to fail in this order.

Release Date/Time Time when the order is scheduled to be sent to the switch or current time if not scheduled

For multi-switch orders, this is the release date/time associated with the first switch.

Created By UserID of the executor who created the order (up to eight characters)

More Info Additional information from the database about this order

Executed Date/Time Time when the recent change was sent to the switch interface

Comment Text message created by the executor who is associated with the order (up to 80 characters)

Modified Date/Time Time when the order was last modified

Modified by UserID of the executor who last modified the order (up to eight characters)

...........................................................................................................................................................................................................................................................

3 - 2 0365-370-370R16.0Issue 1, July 2010

Sorting by column data If you click any of the column names, a small black icon appears. Click this icon to display the orders in ascending or descending order.

Screen Behavior The following information describes the contents of the screen and how to use the screen:

• When Task Execution is started, a Task Order Summary screen lists orders that have been either rejected by a switch or found to contain errors, within the last 72 hours. They are sorted according to release date and time, with the most recent order listed first. If no such orders exist, the screen is empty.

• This screen is not dynamically updated. The Refresh button is used to update the screen. The Refresh button also deselects any highlighted task orders.

• This screen is also used to display task orders in response to executing the Query Task Orders function.

• Any option under the selected menu, such as Details, Modify, and Force Complete, are enabled when a task order has been selected (highlighted).

Important! Force Complete requires special permission.

• The information displayed on this screen can be sorted and filtered to customize the data shown.

• You can resize the width of any column by dragging the separator that is between column headings.

• When you have more than one Task Order Summary screen and you minimize one of them, the icon for the minimized screen disappears behind the maximized screen. The icon is not visible until you minimize, resize, or cancel the other Task Order Summary screens.

• The query criteria section that appears above the Task Order Summary screen can be a multi-line display that shows the entire query request that resulted in the listed orders.

Family The family to which the particular task belongs to.

Column Name Description

...........................................................................................................................................................................................................................................................

3 - 2 1 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Customizing the Task Order Summary Screen

Task Execution User Profile User profile is a feature that enables the user to customize the Task Order Summary (TOS) screen so that desired information is readily available. The customized screen appears as specified in the user profile each time the user logs in. It is not reset between sessions.

The Task Order Summary screen is the first screen presented to the task execution user, provided the user has permission to view the summary. Users or executors have a need to display customized screens to match their local provisioning environment or to better accommodate their own personal use of Task Execution. This feature allows the user to establish a profile for the Task Order Summary screen which is remembered between sessions.

...........................................................................................................................................................................................................................................................

3 - 2 2365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Creating a User Profile

Introduction The default Task Order Summary screen is based on a query to display up to 100 orders that have the status REJ or ERR, created in the last 72 hours by the logged in user. This screen appears as follows:

Figure 3-8 Default Task Order Summary Screen

Procedure To create a user profile, execute the following steps:

...........................................................................................................................................................................

1 From the desktop screen, click the View menu as shown.

...........................................................................................................................................................................................................................................................

3 - 2 3 365-370-370R16.0Issue 1, July 2010

Figure 3-9 Desktop screen, View Menu

...........................................................................................................................................................................

2 Select User Profile.

The User Profile screen allows you to customize the Task Order Summary screen in three ways:

1. Query on Start-Up

2. Set Default Query Task Order

3. Set Default Task Order Summary Display

Important! Depending on your selection, follow the steps as mentioned in the sections “Querying on Start-Up” (3-24), “Setting Default Query Task Order” (3-25), or “Setting Default Task Order Summary Display” (3-28).

...........................................................................................................................................................................................................................................................

3 - 2 4365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Querying on Start-Up

Introduction This feature is used to enable or disable the processing of a default query. It is applicable only when the Task Execution user with TOS permissions first enters Task Execution.

Procedure To query on start-up, execute the following steps:

...........................................................................................................................................................................

1 To enable the default query, click the Query on Start-Up checkbox until a check mark appears. By default, the Query on Start-Up checkbox is checked.

Result: The check mark is followed by the word Yes.

...........................................................................................................................................................................

2 To disable the default query, click the Query on Start-Up checkbox until the box is empty.

Result: The checkbox is followed by the word No.

...........................................................................................................................................................................

3 Click OK button to save the Query on Start-up status. Click CANCEL button to retain the previously saved Query on Start-up status.

Important! If query on start-up is disabled, then the desktop window only is displayed and not the Task Order Summary screen.

...........................................................................................................................................................................................................................................................

3 - 2 5 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Setting Default Query Task Order

Introduction If Query on Start-Up is enabled, as described above, then this feature allows you to customize the default query that will be processed whenever the user first enters Task Execution. There are two limits set on this feature:

1. The default query is restricted to the past 72 hours relative to the current time.

2. A maximum of 1000 matches is displayed.

Procedure To define the default query, perform the following steps:

1. From the User Profile screen, click the Query Screen button.

Result: The Query Task Orders screen appears.

2. Enter desired values into the fields on the Query Task Orders screen to define the default query.

...........................................................................................................................................................................................................................................................

3 - 2 6365-370-370R16.0Issue 1, July 2010

Table 3-3 Field Names and Values

Fields Values

Order ID unique identifier for an order

Task Tag short name of the task being queried

Task Name long name of the task being queried

Switch Name switch where the order was delivered

Task Family family name of the tasks to be queried

Created By the user id of the person who created the order

Modified By the user id of the person who modified the order last

USFN Parameter the USFN (Universal Switch Feature Name) Parameter field represents the name of a feature

USFN Value the value associated with the feature

Comment any comment that may have been added to the order

Status current order status - one of the following:

ALL - Lists all orders regardless of status

CAN - List orders that have been canceled

CPD - Lists orders that have received successful status from the switch, indicating that they have completed

ERR - Lists orders that were sent to the switch but encountered an error condition before getting to the switch

OPN - Lists orders that have been placed into a hold state until they are released for execution

RDY - Lists orders that have been scheduled to be sent to the switch

REJ - Lists orders that were rejected by the switch

XMT - Lists orders that are being processed

...........................................................................................................................................................................................................................................................

3 - 2 7 365-370-370R16.0Issue 1, July 2010

3. Click OK button to save the defined query. Click CANCEL button to retain the previously saved query. Click RESET button if you want the screen to go back to the state when the screen was opened.

Use of relative time In User profile mode, Query Task Orders behave differently when compared to a regular query. If the query uses the Release date/time, Execution date/time, or Modified date/time fields, then relative time values are stored internally. This means that even though you set an absolute time value to define the query, the window of time defined by that time value and the current time is used each time that you enter Task Execution and re-execute the query.

An example using Releasedata/time

For example, if the time now is 11:00A.M and you set the Release date/time to list all orders that were released since 8:00A.M, then each time you enter Task Execution, the query will list orders that have been released within the last three hours; it does not continue to list orders that were released since 8:00A.M. This provides an efficient use of resources because orders can multiply at a very fast rate and the resulting list may quickly exceed the maximum for display.

...........................................................................................................................................................................

1 Click OK to save the default query.

Result: The user returns to the User Profile screen.

...........................................................................................................................................................................................................................................................

3 - 2 8365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Setting Default Task Order Summary Display

Introduction This feature allows you to select the columns that appear on the Task Order Summary screen.

Procedure To set the Default Task Order Summary, execute the following steps:

...........................................................................................................................................................................

1 From the User Profile screen, click the TOS Screen button.

Result: The Task Order Summary (User Profile Mode) screen appears. A partial view is shown as follows:

Figure 3-10 Task Order Summary (User Profile Mode) Screen

...........................................................................................................................................................................

2 Select the Task Order Summary screen columns to display by clicking each checkbox that corresponds to a desired column. Make sure that the check mark only appears beneath the desired column names.

Important! The Family column is not displayed on the standard default TOS screen, but can be selected as part of a customized TOS screen.

...........................................................................................................................................................................

3 To rearrange columns, position the mouse pointer on the column name to be moved and drag the column name to the desired location.

Important! To drag the column name, continue holding the left mouse button while moving the mouse.

...........................................................................................................................................................................

4 To select a default sort column, click the desired column header. Click it a second time to set the default order in reverse.

...........................................................................................................................................................................................................................................................

3 - 2 9 365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................

5 Click OK button to save the customized Task Order Summary presentation definition. Click CANCEL button to retain the previously saved Task Order Summary presentation definition.

Result: The user returns to the User Profile screen.

...........................................................................................................................................................................

6 Click RESET button if you want the screen to go back to the state when the screen was opened. The user remains on the Task Order Summary presentation definition page.

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 3 0365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Displaying the Screen After Modification

Procedure To display the customized screen, restart Task Execution as follows:

...........................................................................................................................................................................

1 Select the File menu on the Task Execution desktop menu bar.

...........................................................................................................................................................................

2 Select the Exit command.

Result: The user returns to the 8950 VAM Launch Page.

...........................................................................................................................................................................

3 Select the Task Execution icon.

Result: Task Execution restarts with the customized interface.

The following is a partial illustration of the Task Execution user interface with a customized Task Order Summary screen:

Figure 3-11 Sample Customized Task Order Summary Screen

...........................................................................................................................................................................................................................................................

3 - 3 1 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Multiple Language Support

Using Task Execution withMultiple Languages

You can select the language that is used for displaying 8950 VAM Task Execution. The selected language is used for all buttons, screen titles, and data within the screens that originate from the task definition database. Languages must be customized. You must select the language from your desktop environment before selecting the Task Execution icon from the 8950 VAM launch page. Only one language is active at a time. Languages using non-ASCII characters are supported.

...........................................................................................................................................................................................................................................................

3 - 3 2365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Using the Task Execution Commands

Invoking a command In general, Task Execution commands are invoked in one of three ways:

• From any of the menu bars

• From the toolbar

• By using a keyboard shortcut

Not every screen has all three capabilities.

Using the menus Menu bars appear at the top of the Desktop screen, the Task Order Summary screen, and the Item Summary screen. Each menu contains a list of commands that is executed by mouse-click. If a command is followed by an arrow, then a sub-menu will appear after the command is clicked. In this case, the user is required to choose an item from the sub-menu in order to proceed.

Using the toolbar The toolbar contains buttons that correspond to some of the menu commands. Click the appropriate button to execute the command.

Using the keyboardshortcuts

A keyboard shortcut is a set of two keys that, when depressed together, invoke a Task Execution command or other action that is associated with any of the screens. For example, there are keyboard shortcuts for each of the cut, copy, and paste commands that appear on a Task Order screen that has a Repeat Table. Keyboard shortcuts allow you to bypass using the mouse in some cases, although not completely.

...........................................................................................................................................................................................................................................................

3 - 3 3 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Task Execution Commands

Menus on the DesktopScreen

The following tables describe the menus that appear on the desktop screen menu bar, namely, the file menu and the help menu. Each table contains a brief description of each command and names the screen that appears when it is invoked.

Table 3-4 Desktop Screen Menus and Commands

Menus on the Task OrderSummary Screen

The following tables describe the commands for each menu on the Task Order Summary screen, including a brief description of each command and a screen that appears after selecting the menu item, if any.

Menu Command Action Screen

File New Displays a sub-menu containing the following two options:

Task Order: Click this option to create a new task order

Task Order Summary: Click this option to create a new instance of a Task Order Summary screen that contains a list of desired orders

New Task Order screen

Query Task Orders screen- Use this screen to query existing orders. The resulting list of orders appears in a new instance of a Task Order Summary screen that appears in a new browser window

Exit Terminates the application Exit confirmation pop-up

View Enable Async Window

Display the Asynchronous Notification Screen

Asynchronous Notification Screen

Disable async Window

Close the Asynchronous Notification Screen

Asynchronous Notification Screen

Help About Displays the Task Toolkit release number

Help pop-up

Help Topics

Displays a help message that discusses Task Execution

...........................................................................................................................................................................................................................................................

3 - 3 4365-370-370R16.0Issue 1, July 2010

Table 3-5 Task Order Summary Screen Menus and Commands

Menus on the ItemSummary Screen

The following tables show the commands for each menu on the Item Summary screen, including a brief description of each command and a screen that appears after selecting the menu item, if any.


File Print Prints task orders Print Column Selection screen

Close Removes the Task Order Summary screen from display

(no associated screen)

Selected Modify Modifies rejected (REJ), failed (ERR), scheduled (RDY) or held (OPN) orders

Task Order screen of the selected task

Cancel Sets the status of an REJ, ERR, RDY, or OPN order to cancel (CAN)

Cancel Order confirmation pop-up

Copy Creates a task order from an existing order Task Order screen that contains data from the selected order with a different Order ID

Details Displays information for an ERR, REJ, or CPD order including the message returned from the switch for a successful VERIFY order

Task Order Details screen

Force Complete

Sets the status of the selected order to CPD

Retrieve Displays the components of the selected order with their respective status

Item Summary screen

View Filter Displays orders from the current Task Order Summary screen that meet a specific criteria

Filter Task Orders screen

Query Modifies the Task Order Summary screen to display a list of orders that meet a defined query of the database

Query Task Orders screen

Refresh Updates the screen by performing another query (No associated screen)

Help About Displays a description of the Task Order Summary screen

Help pop-up

...........................................................................................................................................................................................................................................................

3 - 3 5 365-370-370R16.0Issue 1, July 2010

Table 3-6 Item Summary Screen Menus and Commands


File Print Prints Item Summary screen data Print Column Selection screen

Close Removes the Item Summary screen from display


Selected Details Displays specific information about the selected recent change, allowing the user to modify the apptext and resubmit the recent change to the switch


Retrieve Displays the Task Order screen that was used to create the order, allowing modification and re- submission

Task Order screen

Help About Displays the Item Summary screen description

Help pop-up

...........................................................................................................................................................................................................................................................

3 - 3 6365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

The Task Execution Toolbar

The Toolbar An alternate means to execute a command is to click its corresponding button on the toolbar. Remember that all commands are not represented on the toolbar.

Figure 3-12 Task Execution Toolbar

The buttons of the toolbar depicted in Figure 3-12, “Task Execution Toolbar” (3-36) correspond to the following commands:

1. Print

2. Modify

3. Cancel

4. Force Complete

5. Copy

6. Details

7. Retrieve

8. Query

9. Refresh

10. Filter

11. About

1 2 3 4 5 6 7 8 9 10 11

...........................................................................................................................................................................................................................................................

3 - 3 7 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

The Keyboard Shortcuts

Invoking Commands usingShortcuts

An alternative to using the menu bars and toolbar is to use the keyboard shortcuts. A keyboard shortcut is the use of a combination of keys to produce a desired action. There are two types of keyboard shortcuts:

• Hot key—makes the corresponding menu selection or button active. Depressing a hot key that corresponds to a menu forces the list of commands to appear. Additional hot keys that correspond to the command itself must be depressed to execute the command. If the hot key corresponds to a button, the action is carried out immediately

• Accelerator—directly performs the corresponding action

Key Combinations Hot keys use the <ALT> key as a prefix and accelerators use the <CTRL> key as a prefix. An underline on a menu label indicates the shortcut key to the user. For example, CANCEL indicates that <ALT>L is the shortcut key for the CANCEL button. On menus, the hot key is displayed explicitly next to the command.

In Task Execution, all dialog boxes have been modified in such a way that “Enter/Return” key activates the focused button.

The following table lists the keyboard shortcuts that are available:

Table 3-7 Keyboard Shortcuts

Menus/Buttons Hot Keys Accelerators

From the Desktop screen

File <ALT>F

File --> New <ALT>F --> <ALT>N

File --> New --> Task Order <ALT>F --> <ALT>N --> <ALT>K <CTRL>K

File --> New --> Task Order Summary <ALT>F --> <ALT>N --> <ALT>M <CTRL>M

File --> Exit <ALT>F --> <ALT>X <CTRL>X

View <ALT>V

View --> Enable Async Window <ALT>V --> <ALT>B <CTRL>B

View --> Disable Async Window <ALT>V --> <ALT>B <CTRL>B

Help <ALT>H

Help --> About <ALT>H --> <ALT>A <CTRL>A

...........................................................................................................................................................................................................................................................

3 - 3 8365-370-370R16.0Issue 1, July 2010

Help --> Help Topics <ALT>H --> <ALT>T <CTRL>T

From the Task Order Summary Screen

File <ALT>F

File --> Print <ALT>F --> <ALT>P <CTRL>P

File --> Close <ALT>F --> <ALT>C <CTRL>C

Selected i <ALT>S

Selected --> Modify <ALT>S --> <ALT>M <CTRL>M

Selected --> Cancel <ALT>S --> <ALT>L <CTRL>L

Selected --> Copy <ALT>S --> <ALT>Y <CTRL>Y

Selected --> Details <ALT>S --> <ALT>D <CTRL>D

Selected --> Force Completed ii <ALT>S --> <ALT>E <CTRL>E

Selected --> Retrieve <ALT>S --> <ALT>G <CTRL>G

View <ALT>V

View --> Query Task Orders <ALT>V --> <ALT>Q <CTRL>Q

View --> Refresh <ALT>V --> <ALT>R <CTRL>R

View --> Filter <ALT>V --> <ALT>I <CTRL>I

Help <ALT>H


From the Item Summary Screen

File <ALT>F

File --> Print <ALT>F --> <ALT>P <CTRL>P

File --> Close <ALT>F --> <ALT>C <CTRL>C

Selected iii <ALT>S

Selected --> Details <ALT>S --> <ALT>D <CTRL>D

Selected --> Retrieve <ALT>S --> <ALT>G <CTRL>G

Help <ALT>H



...........................................................................................................................................................................................................................................................

3 - 3 9 365-370-370R16.0Issue 1, July 2010

i At least one order needs to be selected (highlighted) before using the option.

ii A user with the appropriate permissions only can exercise it.

iii At least one order needs to be selected (highlighted) before using the option.

iv Once the option is selected (normally using the <Tab> key), use the <SPACE> bar to activate the option. Please note that the <Return> key will not work if there are both "Yes" and "No" options.

v It does not apply to the Warning pop-up message.

vi If it is executed in the Task screen and any value violates the level 1 check, a level 1 check failure message is displayed. The second time it is executed, it will be reset.

______________________________________________________________Buttons

Yes iv

No v

OK vi <ALT>O

APPLY <ALT>A

CANCEL <ALT>L

RESET vii <ALT>R

HELP <ALT>H

CUT <ALT>U

COPY <ALT>Y

PASTE <ALT>E

INSERT <ALT>I

MODIFY <ALT>M

NEXT <ALT>N

PREVIOUS <ALT>V

RESUBMIT <ALT>S

PRINT <ALT>P


...........................................................................................................................................................................................................................................................

3 - 4 0365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

The Task Order Screen

Introduction Using the Task Execution application, a request can be sent to a switch for provisioning purposes. To create such a request, you must display a pre-built form called a Task Order screen. The task builder defines the content of the Task Order screen. It collects the data needed to make the request. An example of a Task Order screen is shown in Figure 3-13, “Example Task Order Screen” (3-40).

Figure 3-13 Example Task Order Screen

After you enter data into the Task Order screen, click OK or APPLY to submit the request to the switch. The request is called an order.

Displaying the Task The task order screen is the interface we use to create an order to be sent to a switch. Each screen is comprised of components that together present a clear and concise means of collecting information necessary to execute the order. Those components include the following items which are described below:

• Tabs

• Groups

• Fields

...........................................................................................................................................................................................................................................................

3 - 4 1 365-370-370R16.0Issue 1, July 2010

Tabs A task order screen may contain one or more tabs. Each tab is labeled on its handle. The tab label identifies the general purpose for the fields that appear on the tab. To view the fields under each tab, click the tab label.

Groups A tab may be divided into rectangular areas called groups. Each group is labeled at the top. Groups help to organize the various fields that are associated with the task. By default, each task has an initial group called the control group, as shown in Figure 3-13, “Example Task Order Screen” (3-40). This group contains six fields that identify the specific order that will be sent to the switch. Those fields include the following:

1. Order ID

The unique identifier for an order. This is required. The Order ID is automatically assigned a default value on an incremental basis. To modify this value, double-click the field and overwrite the value. To increment the numeric part of the default value, click the Next button.

2. Switch Name

The switch where the order will be delivered. This is a read-only field.

3. Release Method

Determines how the order will be sent to the switch. This is a required field. Release methods include the following:

– Send - The order is sent to the bottom of the switch’s order queue.

– Send Immediate - The order is sent to the top of the switch’s order queue.

– Scheduled - The order is sent at a specified time.

– Hold - The order is not sent. To send the order, use the modify command to change the release method so that the order can be dispatched.

– Default - The order is sent at the system default time (1 AM). This time is superseded by the time specified for a switch.

Important! Some release methods may not be available for some customers.

...........................................................................................................................................................................................................................................................

3 - 4 2365-370-370R16.0Issue 1, July 2010

4. Release Date/Time

Determines when the order will be released. This is required only if the release method is scheduled. Click the calendar button to display the Date and Time screen so you can set the desired time of release.

5. Status

The current status of the order. This is a read-only field. Field values and their meanings are as follows:

– CAN - The order was cancelled.

– CPD - All recent changes in the order have been successfully completed at the switch.

– ERR - An error was detected in the native recent change language before sending the order to the switch. Another reason for this status is if an inventory update failed, such as a failure to update office equipment inventory.

– OPN - The order is not sent to the switch until the release method is changed from Hold.

– RDY - This is the initial state for all task orders once the order has been successfully submitted to the server.

– REJ - The order encountered a failure at the switch and is rejected.

– XMT - The order is being processed.

Important! TST is a valid status but task orders with this status are not displayed on the Task Execution interface. This status is given to an order that is being tested by the task builder.

6. Comment

An optional field that allows you to enter information related to an order.

More information about thestatus of an order

The task order is in the RDY state or XMT state while it is being successfully processed. If all recent changes or items that belong to the order are processed successfully, then the overall status for the task order is CPD. When one or more of the items within a task order fails, then the overall status of the order is inherited from the status of the first item failure. The status of the order changes to ERR or REJ as soon as one item in the order fails. As an example, if the first item failure is REJ due to a failure at the switch, then the task order status is REJ.

...........................................................................................................................................................................................................................................................

3 - 4 3 365-370-370R16.0Issue 1, July 2010

If the first item failure is ERR due to an internal 8950 VAM processing error, such as attempting to add an object that already exists in the shadow database or a connectivity problem with EMM, then the task order status is ERR. 8950 VAM stops processing the task order on the first failure unless the task builder creates the task with functionality that allows processing to continue.

Reference: See the 8950 Voice Activation Manager Task Builder Guide for details about this functionality.

Task Order Data To create an order, the task executor enters data within the various fields that appear on the task order screen. Each field has a field label. If the field label is italic, then a value for the field is required.

Widgets The fields appear in a variety of ways depending upon widgets that are supported during the development of the task. A widget is a means of expressing a field on the task order screen. The task builder, the developer of the task, selects the best widget to represent each field. This is based on the type of data that the task executor must enter. For example, a Text Field widget is used if a text string is to be entered as field data, whereas, an Integer widget is used to allow a numeric value. Table 3-8 lists the available widgets with a description and directions.

...........................................................................................................................................................................................................................................................

3 - 4 4365-370-370R16.0Issue 1, July 2010

Table 3-8 List of Widgets

Important! Tasks can be developed so that they accept the following special characters “( ) ! @ # $ % ^ & * _ + ¿ - = { } : ¿ ; ` < > ? , . / | \” in the text field.

Field Level Men When you right-click any field label that is on a Task Order screen, the field level menu appears. It contains three commands related to that particular field. They are described as follows:

• Reset - Retrieves the original value of the field. More specifically, this means:

– The default value if one exists and if the New Task Order command is currently being processed.

– The value that was sent to the switch if the Modify or Copy command is currently being processed.

Widget Description How to use it

Calendar Timestamp followed by a button

Click the button to display a calendar screen that you use to modify the timestamp

CheckBox Small box that is either empty or contains a check mark

Click the box to enable or disable the associated feature

Choice Rectangle followed by a down-arrow button

Click the down-arrow to display a list of choices from which you make a selection

Integer Rectangle followed by an up-arrow and down-arrow pair

Click the up-arrow to increment the numeric value and the down-arrow to decrement it

Radio List of entries each preceded by a small “radio button”

Click the radio button that precedes your selection

Only one entry may be selected

TextArea Rectangular area that has multiple rows of whitespace

Click within the field and enter text data

TextField Rectangular area that has a single row of whitespace

Click within the field and enter text data.

...........................................................................................................................................................................................................................................................

3 - 4 5 365-370-370R16.0Issue 1, July 2010

• Deselect - Removes the highlight from the field indicating that this field is not sent to the server and blanks the value of the field. For the New Task Order, Modify, and Copy commands, if the field has a default value, deselect sets it to the default value and keeps the field highlighted.

• Help - Displays a pop-up screen containing a message called field help defined by the task builder. This pop-up never overlays the field that it describes.

The Task Buttons The following buttons appear at the bottom of every Task Order screen:

• OK - Sends the order to the switch according to the selected release method and closes the Task Order screen. Before submitting the task order to the server, 8950 VAM verifies the following:

– All required fields are present

– Level 1 validations are passed

– Level 2 validations are passed

Reference: Please see the 8950 Voice Activation Manager Task Builder Guide for a discussion of Level 1 and 2 validations.

– A repeat table within the task order contains no more than 5000 rows.

– If the Release Method is scheduled, then the Release Date/Time is greater than the current date and time.

If all checks are successfully passed and the task order was successfully submitted to the server, then a pop-up message screen appears indicating success. You must dismiss the pop-up message screen by clicking the OK button that it contains.

• Apply - Performs the same behavior as the OK button except the task order screen remains open.

• Reset - Clears any data that has been entered by the task executor, except the order ID, and returns to the same task order screen with the default information displayed. No task order is created.

• Cancel - Removes the Task Order screen from display without submitting the order.

• Help - Displays a pop-up screen that contains a help message called long help defined by the task builder. The task executor must dismiss the pop-up screen by clicking OK.

...........................................................................................................................................................................................................................................................

3 - 4 6365-370-370R16.0Issue 1, July 2010

Repeat table The task order screen may contain a repeat table. This is a special field that allows the executor to enter multiple values of the same type. For example, a Delete POTS 5ESS task may contain a repeat table to allow the removal of a range of telephone numbers instead of only one telephone number.

Figure 3-14 Sample Task Showing a Repeat Table

Repeat table: Cut, Copy,and Paste commands

In Figure 3-14, “Sample Task Showing a Repeat Table” (3-46) the “Equipment” group contains a repeat table. Note that this special field is accompanied by five buttons that allow you to enter and manipulate data within the box. The Cut and Copy buttons require that you select an entry. The Cut button removes the selected entry from the list and copies it to the memory. The Copy button copies the selected entry to memory without removing it from the list. After using either Cut or Copy, you may click Paste to retrieve the entry, placing it back into the table at the same or a different location.

...........................................................................................................................................................................................................................................................

3 - 4 7 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Pasting Data from an External Application

Introduction If you use a spreadsheet or a text editor to collect or organize data for an order, you can easily transfer the data from the spreadsheet or text file into the repeat table.

Procedure To paste data from an external application, follow this procedure:

...........................................................................................................................................................................

1 Within the external file that contains the data, select or highlight the desired data.

Important! In a text file, the delimiter can be the SPACE key or TAB key.

...........................................................................................................................................................................

2 Use the application’s cut or copy operation to transfer the data to memory.

Important! On some systems, this memory area is called the clipboard.

...........................................................................................................................................................................

3 Within the task order, place your mouse cursor into the target location in the repeat table.

...........................................................................................................................................................................

4 Click the repeat table paste button.

Result: The data from the external file is copied into the repeat table.

Important! When pasting, Level 1 Checks are performed on the pasted data.

...........................................................................................................................................................................................................................................................

3 - 4 8365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Using the Insert Command in a Repeat table

Background After clicking the Insert button, an Insert Row window appears, as shown in Figure 3-15, “Insert Row Window” (3-49), that allows the executor to enter one entry or a list of entries within the repeat table. To create one entry, enter values for the fields that are listed on the left side of the Insert Row window and then click OK or APPLY.

Procedure To create a list of entries, follow this procedure:

...........................................................................................................................................................................

1 Enter starting values for the fields that are listed on the left side of the Insert Row window. Note that some of these fields may not be numeric and will remain constant within the resulting list. In Figure 3-15, “Insert Row Window” (3-49), the field Type of Line Equip is non-numeric and will remain constant.

...........................................................................................................................................................................

2 On the right side of the Insert Row window, within the Range area, enter the desired number of rows to be created in the resulting list.

...........................................................................................................................................................................

3 In the Range Fields area, select (highlight) one or more fields to be incremented throughout the resulting list. Only fields that are strictly numeric are listed here. In Figure 3-15, “Insert Row Window” (3-49), you may select EXTN or Line Equip or you may select both. Any range field that you select will increment throughout the list. Any unselected range field will remain constant throughout the list.

...........................................................................................................................................................................

4 Click OK or APPLY.

Result: The Insert Row window is displayed.

...........................................................................................................................................................................................................................................................

3 - 4 9 365-370-370R16.0Issue 1, July 2010

Figure 3-15 Insert Row Window

...........................................................................................................................................................................................................................................................

3 - 5 0365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Using the Modify Command in a Repeat table

Procedure To change an existing repeat table entry, follow this procedure:

...........................................................................................................................................................................

1 Select the repeat table entry.

...........................................................................................................................................................................

2 Click the Modify button.

Result: The Modify Row window is displayed.

Figure 3-16 Modify Row Window

........................................................................................................................................................E N D O F S T E P S

Scroll arrows Arrows may be present at the tab level of a Task Order Screen if they are needed for scrolling through the tabs. Arrows are present if the screen width is less than the display space needed to show all of the tabs and their labels. An example is shown in the following figure:

...........................................................................................................................................................................................................................................................

3 - 5 1 365-370-370R16.0Issue 1, July 2010

Figure 3-17 Task Order Screen with Scroll Arrows

...........................................................................................................................................................................................................................................................

3 - 5 2365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Creating a New Task Order

Introduction To create a new task order, the user must locate and display a new Task Order screen by executing the New Task Order command.

Procedure To create a new task order, follow these procedures:

...........................................................................................................................................................................

1 Click the File menu.

...........................................................................................................................................................................

2 Click the New sub-menu.

...........................................................................................................................................................................

3 Click Task Order.

Result: The New Task Order screen appears, as shown in Figure 3-18, “New Task Order Screen” (3-52).

Important! You can also use the keyboard shortcuts.

Figure 3-18 New Task Order Screen

...........................................................................................................................................................................

4 Use the following fields on the New Task Order screen to retrieve the appropriate task:

• Task Family - the name associated with the group of tasks from which you want to select. This field defaults to your previous selection or the first family in the list, if you are using this screen for the first time.

...........................................................................................................................................................................................................................................................

3 - 5 3 365-370-370R16.0Issue 1, July 2010

• Task Name - the long name of the task. If there are more than eight task names to display, the first eight names are displayed with a vertical scroll bar.

• Switch Name - the name of the switch or switches to receive this order. If the task supports multi-switch selection, then this field will be a multi-switch selection box displaying all available switches, as shown in Figure 3-20, “Multi-Switch Sample Order” (3-54).

Figure 3-19 New Task Order Screen with Multi-Switch Support

• You may select more than one switch by holding the <CTRL> key as you click the switch name. You may deselect in the same way. If the task is an auto-select task, the switch name widget is disabled.

Important! All switches listed within a multi-switch selection box must be the same generic.

...........................................................................................................................................................................

5 After entering the necessary data, click OK or APPLY to display the task order screen.

Result: Figure 3-20, “Multi-Switch Sample Order” (3-54) shows a multi-switch task order screen with two selected switches.

...........................................................................................................................................................................................................................................................

3 - 5 4365-370-370R16.0Issue 1, July 2010

Figure 3-20 Multi-Switch Sample Order

........................................................................................................................................................E N D O F S T E P S

Multiple New Task Orders Multiple new task order screens may be open at the same time, including new task orders requesting the same task family - task name - switch name combination. Permission settings are checked and only valid switches and task names are displayed to the user. Task definition differences are most prominent among switches of different types that overload the task name.

Important! Upstream systems send the short task tag over the interface.

...........................................................................................................................................................................................................................................................

3 - 5 5 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Displaying Task Order Information by Query

Introduction Information about existing task orders may be listed on a Task Order Summary screen, as shown in Figure 3-4, “Task Execution Desktop Screen” (3-13). To display this list, you must query the database. This is done by using the Query Task Order screen in one of two ways:

1. Displaying a list of orders in an existing Task Order Summary screen

2. Displaying a list of orders in a new Task Order Summary screen

...........................................................................................................................................................................................................................................................

3 - 5 6365-370-370R16.0Issue 1, July 2010

Displaying a list of orders in an existing

............................................................................................................................................................................................................................................................

Task Order Summary screen

Procedure To display a list of orders in an existing Task Order Summary screen, follow these procedures:

...........................................................................................................................................................................

1 From the Task Order Summary screen, click the View menu.

...........................................................................................................................................................................

2 Click the Query command.

Important! You may also use the Query Task Orders button on the toolbar or the keyboard shortcut.

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 5 7 365-370-370R16.0Issue 1, July 2010

Displaying a list of orders in a new

............................................................................................................................................................................................................................................................

Task Order Summary screen

Procedure To display a list of orders in a new Task Order Summary screen, execute the New Task Order Summary command by following this procedure:

...........................................................................................................................................................................

1 From the Task Execution Desktop screen, click the File menu.

...........................................................................................................................................................................

2 Click the New sub-menu.

...........................................................................................................................................................................

3 Click Task Order Summary.

Important! You may also use the keyboard shortcut.

........................................................................................................................................................E N D O F S T E P S

Maximum number ofqueries allowed

The application administrator may set a maximum value on the number of queries that can be made during a Task Execution session. The maximum can be a number from 1 through 4.

Important! This is controlled by a tunable parameter. By default, an unlimited number of queries are allowed.

On reaching the maximum, the user cannot make another query request and cannot execute the following commands, including hot keys and accelerators:

• Refresh (View menu)

• Query (View menu)

• Task Order Summary (File-->New submenu)

• OK

• Apply

Important! The maximum number of queries allowed includes any query request that was canceled. After the canceled request has been processed by the server, the query count is decremented, allowing another query request to be executed.

...........................................................................................................................................................................................................................................................

3 - 5 8365-370-370R16.0Issue 1, July 2010

Query Task Order screen A Query Task Order screen appears on the Desktop, as shown in the following figure:

Figure 3-21 Query Task Order Screen

The Query Task Order screen allows you to enter search criteria to locate orders that you want to display on the Task Order Summary screen. You may want to use the Query Task Order screen to search for an order to be copied or modified.

Important! Whenever you request a query, the query criteria that you supply should be as specific as possible. It is recommended that you use at least one of the three timestamp items to focus the search of the database. This will greatly enhance the speed of the search for matching orders.

If the Query Task Order screen is larger than the display area on the Desktop, then scroll bars appear to enable you to read the entire window.

...........................................................................................................................................................................................................................................................

3 - 5 9 365-370-370R16.0Issue 1, July 2010

Figure 3-22 Query Task Order Screen - Text Boxes and Status

Figure 3-23 Query Task Order Screen - Text Boxes

To Query by Entering TextInformation

To perform a query, you may enter search criteria into the textfields and intelligent combo boxes of the Query Task Order screen, both shown in the preceding figures. Intelligent combo boxes provide a drop-down list of values that you can select for the field or you may enter text, up to 200 characters. The drop-down list always displays the most recent values. You may enter mixed uppercase and lowercase characters as long as the case exactly matches the item that you are querying. The search criteria is used to locate the orders. Information about each matching order is listed on a Task Order Summary screen. The following is a list of text fields and intelligent combo boxes that appear on the Query Task Order screen.

• Order ID - unique identifier for an order.

• Task Tag - short name of the task being queried.

• Task Name - long name of the task being queried.

• Switch Name - switch where the order was delivered.

• Task Family - family name of the tasks to be queried.

...........................................................................................................................................................................................................................................................

3 - 6 0365-370-370R16.0Issue 1, July 2010

• Created By - the user id of the person who created the order.

• Modified By - the user id of the person who modified the order last.

• USFN Parameter - the USFN (Universal Switch Feature Name) Parameter field represents the name of a feature.

• USFN Value - the value associated with the feature.

• Comment - any comment that may have been added to the order.

Important! Do not use a single quote character (’) when querying on comment.

Important Guidelines Observe the following guidelines when you enter information in the Query Task Order screen:

– White space signifies text fields.

Important! After entering data within a text field, leading and trailing white space is ignored when the query is processed.

– Wild cards (*) can be used as any part of the search value for text fields.

– Alternation (|) can be used as the OR condition for text fields only.

– The selection widgets must be selected as needed.

– The widget fields display pop-up windows with calendar and time.

– All fields are case sensitive.

Important! A combination of all the fields for which you provide data or activate is used for the query.

To Query by Order Status Query orders based on their current status by clicking one or more status checkboxes. The following list describes each status item:

• ALL - Lists all orders regardless of status

• CAN - Lists orders that have been canceled

• CPD - Lists orders that have received successful status from the switch, indicating that they have completed

• ERR- Lists orders that were sent to the switch but encountered an error condition before getting to the switch

• OPN - Lists orders that have been placed into a hold state until they are released for execution

...........................................................................................................................................................................................................................................................

3 - 6 1 365-370-370R16.0Issue 1, July 2010

• RDY - Lists orders that have been scheduled to be sent to the switch

• REJ - Lists orders that were rejected by the switch

• XMT - Lists orders that are being processed

To Query by Using aTimestamp

You can query the database by using three different milestones (as shown in Figure 3-24, “Query Task Order Screen - Timestamps” (3-61)), namely:

• Release Date/Time - the date and time that the order was sent to a switch.

This is the default for the query as shown by the checkmarks in the following figure. The following figure also shows the default From date being twenty-four hours prior to the current date and time and the default To date being twenty-four hours following the current date and time.

• Execution Date/Time - the date and time that the order was processed by the switch.

The default From date is twenty-four hours prior to the current date and time and the default To date is the current date and time.

Important! The execution timestamp is used to determine when canceled orders are purged from the database.

• Modified Date/Time - the date and time that the order was last modified.

The default timestamps are the same as with the execution date/time above.

Figure 3-24 Query Task Order Screen - Timestamps

...........................................................................................................................................................................................................................................................

3 - 6 2365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Querying by Timestamp

Introduction To query by a timestamp, enter a range for the Release Date/Time, Execution Date/Time, and/or the Modified Date/Time.

Procedure To query by a timestamp, follow these procedures:

...........................................................................................................................................................................

1 Select the From checkbox.

Result: This action enables the calendar button at the right of the timestamp.

...........................................................................................................................................................................

2 Click the calendar button.

Result: The Calendar window is displayed as shown in Figure 3-25, “Calendar window” (3-63).

...........................................................................................................................................................................................................................................................

3 - 6 3 365-370-370R16.0Issue 1, July 2010

Figure 3-25 Calendar window

...........................................................................................................................................................................

3 Select the desired month, day, year, and time and click OK.

...........................................................................................................................................................................

4 To specify the end of the range, select the To checkbox and repeat steps two and three; otherwise, the range of time will end with the current date and time.

Important! It is not required that you specify a timestamp range. The From/To boxes can be separately checked so that only the checked field’s corresponding value in the Date/Time entry is used to query.

If you use Release Date/Time to query and you only specify the From timestamp, the range of time will surpass the current date and time.

...........................................................................................................................................................................................................................................................

3 - 6 4365-370-370R16.0Issue 1, July 2010

Figure 3-26 Query Task Order Screen - Bottom

........................................................................................................................................................E N D O F S T E P S

More Information The Tunable Parameters feature of 8950 VAM Task Toolkit allows you to specify up to ten Universal Switch Feature Names (USFNs) to display for each order that uses them. To display them on the Task Order Summary screen, click the More Information checkbox, shown above. After executing the query, the parameters and values appear in the More Information column of the screen.

Maximum Number ofMatches

The Maximum of Matches field is an integer widget that accepts the number of query matches to display. You can insert a number from 1 through 4,000. If you insert zero, it will automatically be set to one. This field is shown in the preceding figure.

Figure 3-27 Query Control Buttons

To Submit the Query To accept the query, click the OK button or the Apply button. The following buttons are available on the Query Task Order screen:

• OK - Executes the function and terminates the window

• Apply - Executes the function and keeps the window displayed

• Reset - Changes the values of the fields on the window to their original state

• Cancel - Terminates the Query Task Orders request and removes the window

• Help - Provides a help message

Result of the Query After the query is submitted and processed, the Task Order Summary screen is displayed on the Desktop. Multiple Task Order Summary screens may reside on the desktop.

...........................................................................................................................................................................................................................................................

3 - 6 5 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Filtering the Displayed Orders on a Task Order Summary Screen

Introduction You can customize the list of orders displayed on the Task Order Summary screen by using the Filter command. Filtering allows you to specify a set of criteria that determine the order display on your screen. Once the filter is activated, it will remain turned on until it is turned off.

Procedure To filter the contents of a Task Order Summary screen, use the Filter command in the following way:

...........................................................................................................................................................................

1 Click the View menu on the menu bar of the Task Order Summary screen.

...........................................................................................................................................................................

2 Click Filter.

Result: The Filter Task Order screen appears as shown in Figure 3-28, “Filter Task Order Screen” (3-65).

Figure 3-28 Filter Task Order Screen

...........................................................................................................................................................................................................................................................

3 - 6 6365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................

3 It contains a multi-list box for each column in the summary table, pre-populated with values from the current Task Order Summary screen. The values are sorted in either descending alphabetical order or chronologically.

...........................................................................................................................................................................

4 Click any of the data elements to use as filter criteria. You may also type data in the text field above each multi-list box.

Important! The wildcard (*) and or (|) symbols should not be used.

All selected and typed data is used to produce the filter results. The filter criteria includes the following options: OrderID, Status, Task Name, Item Switch, Switch Name, Release Date/Time, Created By, More Info, Executed Date/Time, Comment, Modified Date/Time, and Modified By.

...........................................................................................................................................................................

5 Click OK or APPLY to submit the filter request. The resulting list that appears within the Task Order Summary screen is the result of all selected and typed data.

...........................................................................................................................................................................

6 The filter button on the Task Order Summary toolbar indicates whether a filter is enabled or disabled. If the filter button is half-shaded, then the filter is enabled; otherwise, it is disabled. The numbers to the right of the button indicate the amount of orders matching the filtering criteria, which are displayed currently and the total amount of orders matching the filtering criteria.

...........................................................................................................................................................................

7 The filter remains enabled until it is turned off. To do this, perform the same procedure as above; however do not enter any filter criteria. Click the RESET button to deselect all entered and selected data.

...........................................................................................................................................................................

8 Clicking OK or APPLY.

Result: The original Task Order Summary screen contents are restored.

...........................................................................................................................................................................................................................................................

3 - 6 7 365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................

9 The Filter screen displays all switches applicable for a multi-switch order, including those that are not currently displayed to the user in the Switch Name column. The switch names that are displayed on the Task Order Summary screen for multi-switch orders shall match at least one of the switches that are specified in the Filter screen.

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 6 8365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Modifying a Task Order

Introduction You can modify an existing task order that is in the OPN, RDY, ERR, or REJ state. This allows the task executor to correct fallout by directly modifying data on the Task Order screen. Data that has already successfully been sent to the switch is grayed out on the screen and is unavailable for edit.

The Modify Task OrdersScreen

After executing the procedure for modifying a task order, the Modify Task Orders screen is displayed. It is a replica of the original Task Order screen that was used for initiating the request, but not all fields can be modified.

Fields that Cannot beModified

The Order ID, Status, and Switch fields are protected and cannot be edited. If the task order contains a repeat group, only the row affected by the failure is displayed on the Modify Task Order screen; other rows cannot be changed. All the buttons of a repeat table are disabled except the modify button. If the task order contains multiple recent changes, then you can only change data for the one recent change that actually failed.

...........................................................................................................................................................................................................................................................

3 - 6 9 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Modifying an Existing Task Order

Procedure To modify an existing task order, follow this procedure:

...........................................................................................................................................................................

1 After deciding which order is to be modified, display the order information within a new Task Summary screen, by using the New Task Summary screen command, or within an existing Task Summary screen, by using the Query Task Orders command.

...........................................................................................................................................................................

2 Select or highlight the order to be modified from the Task Summary screen.

...........................................................................................................................................................................

3 Click the Selected menu.

...........................................................................................................................................................................

4 Click the Modify command.

Important! As an alternative to steps 3 and 4, click the Modify button on the toolbar or use the appropriate Keyboard Shortcut.

...........................................................................................................................................................................

5 Make the necessary changes to the Modify Task Order screen, shown in Figure 3-29, “Modify Task Order Screen” (3-70).

...........................................................................................................................................................................

6 Click OK to resubmit the order to the switch(es).

...........................................................................................................................................................................................................................................................

3 - 7 0365-370-370R16.0Issue 1, July 2010

Figure 3-29 Modify Task Order Screen

........................................................................................................................................................E N D O F S T E P S

Modifying Multiple TaskOrders Simultaneously

Using the procedure shown above, you can modify multiple task orders simultaneously, as long as they were not created from the same Task Order screen. This is especially useful for visually comparing the field values of two or more task orders.

Multiple Updates to theSame Task Order

Two executors cannot modify the same task order concurrently. This is prevented by internal verification of the modification timestamp whenever an update to an order is attempted. With each successful modification the modification timestamp is updated. If the modification is not based on the most recent version of the task order, it is rejected. The executor is then notified that the modify request failed but can try again using the newest version of the task order.

...........................................................................................................................................................................................................................................................

3 - 7 1 365-370-370R16.0Issue 1, July 2010

Modifying Orders from theItem Summary Screen

If Modify is called from the Item Summary screen, the modification is done for the selected item.This is different from modifying an order from the Task Order Summary screen; it always modifies the first failed item in ERR or REJ state.

Modifying multi-switchorders

If you modify a multi-switch order, the Modify Task Order screen displays the switch information as follows:

• If the order has RDY or OPN status, then all switches are displayed with the first switch highlighted

• If the order has REJ or ERR status, then all the switches are displayed with the first failing switch highlighted.

After you modify the data and resubmit the order, it is sent only to the highlighted switch.

Important! Submitting changes to one of the switches on a multi-switch order may update information for the other switches.

...........................................................................................................................................................................................................................................................

3 - 7 2365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Canceling a Task Order

Introduction A task executor can cancel an existing order. This means that you can change the status of a task order from ERR, OPN, RDY, or REJ state to CAN state. Canceled orders are typically removed from the database. An order that is currently active cannot be canceled.

Steps to Cancel an ExistingTask Order

To cancel an existing task order, follow this procedure:

...........................................................................................................................................................................

1 After deciding which order is to be canceled, display the order information within a new Task Summary screen, by using the New Task Summary screen command, or within an existing Task Summary screen, by using the Query Task Orders command.

...........................................................................................................................................................................

2 Select or highlight the order to be canceled from the Task Summary screen.

...........................................................................................................................................................................


...........................................................................................................................................................................

4 Click the Cancel command as shown in Figure 3-30, “Canceling Orders on the Task Order Summary Screen” (3-73).

Important! You can also click the Cancel button on the toolbar or use the appropriate Keyboard Shortcut.

...........................................................................................................................................................................................................................................................

3 - 7 3 365-370-370R16.0Issue 1, July 2010

Figure 3-30 Canceling Orders on the Task Order Summary Screen

...........................................................................................................................................................................

5 In the cancel order confirmation window, Figure 3-31, “Cancel Order Confirmation Window” (3-73), click Yes to cancel the order; otherwise, click No.

Figure 3-31 Cancel Order Confirmation Window

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 7 4365-370-370R16.0Issue 1, July 2010

After the Order is Canceled After clicking yes, the order entry may be removed from the Task Order Summary screen depending on the current screen query. In this case, you can re-display it after the order is actually cancelled, by performing a query that includes canceled orders. Its new status will be CAN.

...........................................................................................................................................................................................................................................................

3 - 7 5 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Copying a Task Order

Introduction To create a new task order, you can choose to copy an existing order. In creating a new order, copying allows you to reuse data or modify data from the copied order. After executing the Copy command, a Copy Task Order screen appears. Click OK or APPLY to display the Task Order screen of the copied task. It has a unique Order ID since the new order is different from the copied order; otherwise, the fields of the two Task Order screens are identical.

Procedure To copy an existing task order, follow this procedure:

...........................................................................................................................................................................

1 After deciding which order is to be copied, display the order information within a new Task Summary screen, by using the New Task Summary screen command, or within an existing Task Summary screen, by using the Query Task Orders command.

...........................................................................................................................................................................

2 Select or highlight the order to be copied from the Task Summary screen.

...........................................................................................................................................................................


...........................................................................................................................................................................

4 Click the Copy command.

Result: The Copy Task Order screen appears as shown in Figure 3-33, “Example Task to be Copied” (3-76).

Figure 3-32 Copy Task Order screen

...........................................................................................................................................................................................................................................................

3 - 7 6365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................

5 Click OK or APPLY.

Result: The Task Order screen for the copied order is displayed as shown in Figure 3-33, “Example Task to be Copied” (3-76).

Figure 3-33 Example Task to be Copied

...........................................................................................................................................................................

6 Make the desired changes to the fields of the newly copied order.

...........................................................................................................................................................................

7 Click OK or APPLY to submit the new order to the switch(es).

...........................................................................................................................................................................................................................................................

3 - 7 7 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Copying Data Between Dissimilar Orders

Introduction You may copy data from one order to a different order that uses one or more of the same USFNs.

To copy data between dissimilar orders, follow this procedure:

...........................................................................................................................................................................

1 Within the Task Order Summary screen, select the order to be copied.

...........................................................................................................................................................................

2 Use the Selected menu, Copy button or keyboard shortcut to execute the Copy command.

...........................................................................................................................................................................

3 Choose the task family, task, and switch that will be used to create the new order.

...........................................................................................................................................................................

4 After clicking OK or APPLY, the Task Order screen will appear containing values that were copied from the original order.

...........................................................................................................................................................................

5 Modify the fields of the new order as desired.

...........................................................................................................................................................................

6 Click OK or APPLY to submit the new order.

Important! If either of the two tasks was copied using the Single Task Copy procedure and scripts then the USFNs may be renamed. In that case, this copy procedure does not apply.

...........................................................................................................................................................................................................................................................

3 - 7 8365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Displaying the Details of an Order

Introduction You can view detailed information about task orders in the ERR, REJ, or CPD state. Viewing details for ERR or REJ orders is helpful in debugging a problem or directing you to the source of the problem. Viewing details for CPD orders allows you to see the verified results of an order, if a verify command was issued. To view an order’s details, access the Task Order Details screen.

Procedure To display detailed information for a task order, follow this procedure:

...........................................................................................................................................................................

1 In the Task Order Summary screen, select a task order for which you need to display the details.

...........................................................................................................................................................................

2 Do one of the following:

• Click the Selected menu and choose the Details command.

• Click the Details button on the toolbar.

• Press <CTRL>D.

Result: The Task Order Details screen appears as shown in Figure 3-34, “Task Order Details Screen for Order Status REJ” (3-79), Figure 3-35, “Task Orders Details Screen for Order Status ERR” (3-80), and Figure 3-36, “Task Orders Details Screen for Order Status CPD” (3-81) for Orders with REJ, ERR, and CPD status respectively.

...........................................................................................................................................................................................................................................................

3 - 7 9 365-370-370R16.0Issue 1, July 2010

Figure 3-34 Task Order Details Screen for Order Status REJ

...........................................................................................................................................................................................................................................................

3 - 8 0365-370-370R16.0Issue 1, July 2010

Figure 3-35 Task Orders Details Screen for Order Status ERR

Important! If errors are encountered at the switch, the task orders are rejected. You can view the switch error details along with the error message in the Task Order Details screen.

...........................................................................................................................................................................................................................................................

3 - 8 1 365-370-370R16.0Issue 1, July 2010

Figure 3-36 Task Orders Details Screen for Order Status CPD

........................................................................................................................................................E N D O F S T E P S

Screen Description The Task Order Details screen displays the following information:

• Order Status

Displays the current status of the order.

• Error Message

Displays the switch reject message once the Recent Change failed (REJ) at the switch, or the appropriate error message for orders with ERR status.

...........................................................................................................................................................................................................................................................

3 - 8 2365-370-370R16.0Issue 1, July 2010

• Recent Change Text

Displays the APPTEXT, Table Editor, SERVORD, or SONUS string formed by the task engine for submission to the switch. This is shown in Figure 3-34, “Task Order Details Screen for Order Status REJ” (3-79) and Figure 3-35, “Task Orders Details Screen for Order Status ERR” (3-80). Privileged users can modify the APPTEXT, Table Editor, SERVORD, or SONUS string directly from this window.

Important! If you modify the recent change text, the data within the task itself is not updated.

• Switch Verify Results

Displays the results of a successful verify task order or displays a verify message upon switch rejection, if the task builder programmed the verify into the task.

Using the Task OrderDetails screen

Review the information listed within the Task Order Details screen and select any of the following options:

• Edit the recent change text by clicking within the white text box. You may modify the apptext and click the RESUBMIT button to send the modified order to the switch.

• Print the details by clicking the PRINT button on the toolbar. When the printer window appears, select the printer that should receive the output.

• Terminate the details command by clicking the CANCEL button.

Displaying details of amulti-switch order

If you run the details command on a multi-switch order, then the following is displayed:

• If the order has CPD status, then information associated with the first switch is displayed

• If the order has REJ or ERR status, then information associated with the first failed switch is displayed.

If you modify the recent change text and resubmit the order, only the transaction that belongs to the displayed switch or item is resubmitted to the server.

...........................................................................................................................................................................................................................................................

3 - 8 3 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Retrieving the Recent Changes of a Task Order

Introduction You can use this command to retrieve a task order and display its individual components as a list of items on the screen. You can then make changes to the order by modifying any of its items.

Important! If a repeat table was used to create the order, each entry in the repeat table determines a separate item belonging to the order and is listed as such.

Procedure To retrieve the recent changes of a task order, follow this procedure:

...........................................................................................................................................................................

1 Ensure that the order to be retrieved is displayed on the Task Order Summary screen, and is in an acceptable state.

...........................................................................................................................................................................

2 Highlight the order, and select the Retrieve command from the Selected menu.

Result: The Item Summary screen is displayed.

Figure 3-37 Retrieve Command - Item Summary Screen

...........................................................................................................................................................................................................................................................

3 - 8 4365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................

3 Each entry within the Item Summary screen displays information about a recent change belonging to the selected order. The information consists of the following parts:

• Item Number—sequence number indicating when the recent change was sent to the switch within the scope of this order. It is a four-digit number [0-5000].

• USFN—key Universal Switch Feature Names used by this RC and their values when it was sent to the switch. They are listed in the following format:<USFN> = <USFN value>, <USFN> = <USFN value>,...

If the column is blank, there are no key USFNs.

Important! The task builder can designate task fields as key, in which case they will appear in the USFN column.

• Status—recent change status as determined by the switch

• Switch—switch to which this recent change was sent

........................................................................................................................................................E N D O F S T E P S

Commands from the ItemSummary Screen

A description of the commands of the Item Summary screen is found in Table 3-9.

Table 3-9 Item Summary Screen Menus and Commands

____________Menu Command ________________________________Action Screen

____________File Print Prints Item Summary screen data Print Column Selection screen

____________ Close Removes the Item Summary screen from display


____________Selected Details Displays specific information about the selected recent change, allowing the user to modify the apptext and resubmit the recent change to the switch


____________ Retrieve Displays the Task Order screen that was used to create the order, allowing modification and re- submission

Task Order screen

____________Help About Displays the Task Toolkit release number Help pop-up

...........................................................................................................................................................................................................................................................

3 - 8 5 365-370-370R16.0Issue 1, July 2010

More About the SelectedMenu

The current status of the item that you select in the Item Summary screen determines whether or not you can examine details, modify, and resubmit the request to the switch. The following provides further information about the two commands found in the Selected menu.

Details The Task Order Details screen, as shown in Figure 3-38, “Retrieve Command - Task Order Details Screen” (3-85), is used for this operation even though its information applies only to the selected recent change. Next and Previous buttons appear on this screen so you can show details about each recent change easily.

Figure 3-38 Retrieve Command - Task Order Details Screen

The Resubmit button allows you to send the order to the switch again. The following list shows how the order or item status affects the action that you can take. Editing the native RC text on the Details screen reflects the actual user ID and not the “TGUI” in the Modified By User field of the Task Order Summary. :

Order or Item Status Able to resubmit?Order CPD No

Item CPD No

Item ERR or REJ Yes

Item RDY No - An error is displayed with no details available

...........................................................................................................................................................................................................................................................

3 - 8 6365-370-370R16.0Issue 1, July 2010

Retrieve This Retrieve command automatically displays the Task Order screen allowing you to modify fields and resubmit the order to the switch, depending upon the order / recent change status. For each type of order status, the following list shows the action you can take based on the order or item status:

Using Query and Retrieveto Identify an Item within an

Order

When you perform a query on the Query Task Order screen, the task orders that match the query are presented on the Task Order Summary screen. You can then select one of the matching task orders and execute the Retrieve command to display the Item Summary screen. Within this screen, the items that match the query appear at the top of the list. You can then select an item and modify it, either at the Details level (using the Details command) or at the Task Order level (using the Modify command). If no item matches the query criteria then all items will appear sorted by item number.

Multi-switch orders and theretrieve command

The following is true when you execute the retrieve command on a multi-switch order:

• The Item Summary screen displays each switch on a multi-switch order as a separate item.

• The retrieve command from the Item Summary screen displays the Task Order screen that is associated with the selected item. The Task Order screen displays only the associated switch. If you modify the data and then click OK or APPLY, the transaction that is associated with this item is sent only to the designated switch.

• The details command from the Item Summary screen displays information about the selected switch for items with CPD status and displays information about the failed switch for items with REJ or ERR status. If you modify the switch text and resubmit the item, only that transaction is sent to the associated switch.

Important! Submitting changes to one of the switches on a multi-switch order may update information for the other switches.

_________________Order or Item Status ____________________View or Modify order?

_________________Order CAN, CPD, or XMT ____________________View only

_________________Item CPD ____________________View only

_________________Item ERR or REJ ____________________View or Modify

...........................................................................................................................................................................................................................................................

3 - 8 7 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Forcing an Order to Completion Status

Force Complete If an order is listed with ERR or REJ status, the Force Complete command allows you to change the status to CPD (completed). You would use this command if it is determined that the order has been resolved at the switch level.

Important! You need permission to be able to execute this command. See your System Administrator or Task Administrator.

This command does not affect the status of the individual items of the order. Use the Retrieve command to view the original status of each individual item.

Procedure To execute the force complete command, follow this procedure:

...........................................................................................................................................................................

1 Ensure that the order to be forced to CPD is displayed on the Task Order Summary screen, and is in ERR or REJ state.

...........................................................................................................................................................................

2 Highlight the order, and select the Force Complete command from the Selected menu.

Result: A confirmation window appears as shown.

Figure 3-39 Force Complete Confirmation Window

Important! You must have permission to execute this command.

...........................................................................................................................................................................................................................................................

3 - 8 8365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Refreshing the Task Order Summary Screen

Refresh Command To update the screen with general order information that is current in the database, click the Refresh button or click the View menu followed by the Refresh command. A refresh message appears to indicate the operation is in progress, as shown in Figure 3-40, “Refresh Command” (3-88).

Figure 3-40 Refresh Command

...........................................................................................................................................................................................................................................................

3 - 8 9 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Printing Task Order Information

Task Order SummaryScreen

The Print command allows you to print information displayed within the Task Order Summary screen. The Print command is available on the File menu or you can click the Print button. After doing so, the Print Column Selection screen appears. You may customize the output by clicking any of the other checkboxes, as shown in Figure 3-41, “Print Column Selection Screen” (3-90). The printed output is shown in Figure 3-42, “Example Output From the Print Command” (3-90).

...........................................................................................................................................................................................................................................................

3 - 9 0365-370-370R16.0Issue 1, July 2010

Figure 3-41 Print Column Selection Screen

Figure 3-42 Example Output From the Print Command

Item Summary Screen You may print information that appears on the Item Summary screen. To execute the print command, click the File menu and then click Print.

...........................................................................................................................................................................................................................................................

3 - 9 1 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Requesting Help from Within Task Execution

Introduction Help information may be available about the screen you are viewing. Two sample help messages are shown below. From the Task Order Summary screen, click the Help menu and then About. You may also click the Help button. This message provides help about the Task Order Summary screen as shown in Figure 3-43, “Help Message from the Task Order Summary Screen” (3-91). The help message in Figure 3-44, “Help Message from the Query Task Order Screen” (3-92) is displayed by clicking the Help button on the Query Task Order screen.

Figure 3-43 Help Message from the Task Order Summary Screen

...........................................................................................................................................................................................................................................................

3 - 9 2365-370-370R16.0Issue 1, July 2010

Figure 3-44 Help Message from the Query Task Order Screen

...........................................................................................................................................................................................................................................................

3 - 9 3 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Closing a Task Order Summary Screen

Procedure To close the Task Order Summary screen, follow this procedure:

...........................................................................................................................................................................

1 Click the File menu.

...........................................................................................................................................................................

2 Click the Close command.

OR

...........................................................................................................................................................................

3 Click the Close screen control button that is in the top right-hand corner of the Task Order Summary screen.

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 9 4365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Terminating Task Execution

Procedure To terminate Task Execution, follow this procedure:

...........................................................................................................................................................................

1 Click the File menu on the Desktop.

...........................................................................................................................................................................

2 Click Exit.

Result: A confirmation is displayed as shown.

Figure 3-45 Exit Confirmation Screen

...........................................................................................................................................................................

3 Click Yes to terminate Task Execution.

...........................................................................................................................................................................................................................................................

3 - 9 5 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Multiple Order Processing from the Task Order Summary Screen

Operations on MultipleOrders at the Same Time

You can select multiple orders, also known as a batch of orders, from the task order summary screen and perform the following operations on those orders:

• Cancel

• Modify

• Copy

• Print

Mouse and KeyboardOperations

Use any of the following methods to select or deselect a batch of orders from the Task Order Summary screen:

• To select disjoint orders using the mouse

1. Click one order in the table.

2. Press <CTRL> and mouse click another order.

• To deselect disjoint orders using the mouse

1. Press <CTRL> and click the order to be deselected.

• To select a range of orders using the mouse

1. Click one order in the table.

2. Press <SHIFT> and mouse click the order that is at the end of the desired range.

• To deselect a range of orders using the mouse

1. Press <CTRL> and click each order that is to be deselected.

• To select a range of orders using the keyboard

1. Select an order in the table using the up-arrow or down-arrow key.

2. Press <SHIFT> and continue to press the arrow key until you reach the end of the range.

• To deselect a range of orders using the keyboard

1. Move any arrow key.

Important! You cannot use the keyboard to select/deselect disjoint items.

...........................................................................................................................................................................................................................................................

3 - 9 6365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Canceling a Batch of Orders

Procedure To cancel a batch of orders, follow this procedure:

...........................................................................................................................................................................

1 Select the batch of orders.

...........................................................................................................................................................................

2 Execute the Cancel command by clicking Cancel from the Selected menu or the Cancel button on the toolbar.

...........................................................................................................................................................................

3 Click Yes to confirm the cancellation, in the pop-up window.

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 9 7 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Modifying a Batch of Orders

Procedure To modify a batch of orders, follow this procedure:

...........................................................................................................................................................................

1 Select the batch of orders. Only orders in the REJ, ERR, RDY, and OPN states may be modified. If an order in a batch is not in one of the above states, it will not be modified. An error message will appear after the operation is completed indicating the orders that were not modified.

...........................................................................................................................................................................

2 Execute the Modify command by clicking Modify from the Selected menu or the Modify button on the toolbar. The “Control Field Batch Modify” screen appears.

...........................................................................................................................................................................

3 On the “Control Field Batch Modify” screen, use any of the following options to modify the orders:

• Choose any release method—This will take place only for orders in the RDY or OPN state

• Change the release date/time if scheduling the orders

...........................................................................................................................................................................

4 When you modify the release method or release date/time for a batch of orders, you are executing a batch submit request.

...........................................................................................................................................................................

5 When you change the status of a batch of orders to CPD, you are executing a batch force request.

...........................................................................................................................................................................................................................................................

3 - 9 8365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Copying a Batch of Orders

Procedure To copy a batch of orders to a single task order definition, follow this procedure:

...........................................................................................................................................................................


...........................................................................................................................................................................

2 Execute the Copy command by clicking Copy from the Selected menu or the Copy button on the toolbar.

Result: The New Task Order screen appears.

...........................................................................................................................................................................

3 On the New Task Order screen, choose a Task Family, Task Name, and Switch Name to provide the target task definition.

...........................................................................................................................................................................

4 Click OK or APPLY. New orders are immediately created in the database. If an error occurs on any order, an error message will appear.

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

3 - 9 9 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Force Completing a Batch of Orders

Introduction The Force Complete command changes the status of one or more orders to CPD. You may only execute this for orders that are in the REJ or ERR state.

Procedure To force complete a batch of orders, follow this procedure:

...........................................................................................................................................................................


...........................................................................................................................................................................

2 Execute the Force Complete command by clicking Force Complete from the Selected menu or the Force Complete button on the toolbar.

• Change the status of the batch to CPD—This will take place only for orders in the REJ or ERR state.

........................................................................................................................................................E N D O F S T E P S

4 - 1365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................


............................................................................................................................................................................................................................................................

Overview

Purpose This chapter describes the Upstream Batch Processing Interface (UBIC) for using the 8950 VAM Task Toolkit services. UBIC facilitates the flow of orders from an upstream system to the Task Toolkit application on 8950 VAM.

Orders must be created in an MS-Excel spreadsheet format. You can create orders either manually or by using an upstream system. The resulting .xls or .xlsx file is sent and stored in a specific directory on the 8950 VAM system. Each row in the .xls or .xlsx file contains information about the task control and data parameters for a single task order. The Upstream Batch Processing Interface enables 8950 VAM to attempt to convert the data in each row into a task order. Unsuccessful task order attempts are recorded.


1. Creation of Data Interface Agreements.

2. Creation of spreadsheet files

3. Processing spreadsheet file

........................................................................................................................................................E N D O F S T E P S

...........................................................................................................................................................................................................................................................

4 - 2 365-370-370R16.0Issue 1, July 2010

The following topics are included in this chapter

Background 4-3

Data Interface Agreement 4-5

Creation of Spreadsheet Files 4-9

Processing Spreadsheet Files 4-11

Constraints and Assumptions 4-15

...........................................................................................................................................................................................................................................................

4 - 3365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Background

Introduction UBIC involves a simple, robust, quickly deployable and easy to use interface to speed up provisioning by eliminating unnecessary manual steps. It is used in combination with other 8950 VAM benefits for flow-through interfaces such as:

• Controlled data entry (validation at several levels)

• High availability as provided by the duplex configuration

• Fall-out handling in a controlled and facilitated manner

• Data logging - historical data is available for later reference or re-use.

The main advantage of this interface is that you do not have to enter data manually into the 8950 VAM Task Execution GUI once it is present in a spreadsheet in your local hard disc.

As depicted in figure 1, the data flow through UBIC consists of three steps:

1. The customer or the upstream system prepares the spreadsheet files from local information and sends the files to a specific directory in 8950 VAM.

2. 8950 VAM converts this information into one or more 8950 VAM CORBA IDL messages based on the task definitions present in a Data Interface Agreement created by the customer.

3. 8950 VAM executes the successfully converted orders in the spreadsheet files.

...........................................................................................................................................................................................................................................................

4 - 4 365-370-370R16.0Issue 1, July 2010

Figure 4-1 UBIC Data Flow

8950 VAM Server

...........................................................................................................................................................................................................................................................

4 - 5365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Data Interface Agreement

Purpose This section covers the details of the Data Interface Agreement and the procedure for creating it.

Data Interface AgreementDetails

The Data Interface Agreement is the file containing the definition of tasks. This file is located in /tgui/ubic/dia and is named <customer name>.dia where customer name refers to the name of the 8950 VAM customer. This file is used by 8950 VAM to decide how to process the task orders in the spreadsheet file. The link between the .dia file and the spreadsheet file is the TaskName column.

Important! <customer name> refers to the name that is internally used by 8950 VAM to identify a customer and this may not be how the customers refer to themselves. Therefore, if you wish to manually create the .dia file, contact Alcatel-Lucent Support to get this information. A .dia file with a different name will not be recognized by 8950 VAM. Alternatively, you can use the utility provided by 8950 VAM to generate the .dia file (as explained in the next section) and manually edit the file as needed.

The .dia file has one row per task. The columns in each row are separated by a comma (,). For each and all tasks, the first nine columns contain the task control parameters which are as follows:

Column Number

Column Description Column Value

1 Order ID OrderId (Fixed, Case-sensitive String)

2 Task Order Status Status (Fixed, Case-sensitive String)

3 Name of the switch to which the order is to be sent

SwitchName (Fixed, Case-sensitive String)

4 Task Name The actual name of the task e.g. APOTS5ESS, CPOTS5ESS etc.

5 Task Order Release Method

ReleaseMethod (Fixed, Case-sensitive String)

6 Date and Time of Release ReleaseDateTime (Fixed, Case-sensitive String)

...........................................................................................................................................................................................................................................................

4 - 6 365-370-370R16.0Issue 1, July 2010

Of the nine fields tabulated above, Switch Type for the task is used in conjunction with the task name to determine which of the “overloaded” task definitions must be used for processing a specific task order. An overloaded task is a task that has the same name but different task definitions that cater to different switch types.

Example: A task named APOTS can be overloaded for both 5ESS and DMS instead of creating two different tasks with names like APOTS5ESS and APOTSDMS.

For each task, task data parameters (required and optional USFNs) are defined beginning with the comma separated tenth column to match the task definition in the Task Execution database. From an interface point of view, task data parameters are optional. However, from the task point of view, the required USFNs must be present for each task in order to successfully create and submit a task order. The optional USFNs may or may not be present depending on whether they are used when the actual task orders are created.

For tasks having repeat table items, repeat table USFNs are represented by adding the suffix &| to the USFN.

Example: TN&|.

All required task fields are identified by adding the prefix * to the USFN.

Example: *LCC.

Creating a Data InterfaceAgreement

You can manually create the .dia file for any required task(s) by providing the information for each task in the format described in the previous section.

7 Originating User for the task order

originatingUser (Fixed, Case-sensitive String)

8 Comment Comment (Fixed, Case-sensitive String)

9 Switch Type for the task The actual switch type for the task. For example 5ESS, DMS and so on.

Column Number

Column Description Column Value

...........................................................................................................................................................................................................................................................

4 - 7365-370-370R16.0Issue 1, July 2010

Additionally, 8950 VAM also provides a utility named DiaFileGenerator to create the .dia file from the Task Execution database. If required, the .dia file generated by DiaFileGenerator can be edited. Instances of when you need to edit a .dia file are as follows:

• To remove some unused optional USFNs

• To remove unused task definitions.

Important! Repeated runs of the DiaFileGenerator will result in the existing .dia file being overwritten with every run.

The following section details the procedure for creating the .dia file using DiaFileGenerator:

Important! DiaFileGenerator can be used only if the UBIC feature is enabled. Contact Alcatel-Lucent Support to get the feature enabled.

Procedure To create a .dia file for all the tasks in the Task Execution database, do the following:

1. Login to the 8950 VAM HP Server machine as ubic .

2. At the command prompt, enter DiaFileGenerator and press [ENTER].

Result: As every task is processed, status messages are displayed on the screen similar to those shown below:

DiaFileGenerator : Generating .dia entry for task : ABLS5ESS

DiaFileGenerator : Generating .dia entry for task : ABLSDMS

The .dia file is generated with the name <customer name>.dia in the /tgui/ubic/dia directory. This contains the definitions of all the tasks in the Task Execution database.

If any errors are encountered during the processing of any task, error messages are displayed on the screen. A log file is also created by DiaFileGenerator named DiaFileGenerator.log in the /tmp directory. Errors and trace messages are appended to the log file with every run of DiaFileGenerator script.

Creating .dia file forspecific tasks in the Task

Execution database

You can choose to generate the .dia file only for a list of selected tasks and not for all the defined tasks. To select a list of tasks, create a task list file with the desired tasks listed one task per line.

...........................................................................................................................................................................................................................................................

4 - 8 365-370-370R16.0Issue 1, July 2010

The task names listed in this file are the short name of the task i.e., the name displayed in the Task Tag option list of the Query Task Order dialog box on Task Execution GUI. This is also the name that is displayed within [ ] in the Task Name option box of the New Task Order dialog box or the title of the task order dialog box.

Example: For the task ‘HFC Add POTS (5ESS) Add Plain Old Telephone Service [HFCADDPOTS5E]’, the task name to be used in the task list file is HFCADDPOTS5E.

Given below is a sample task list file that lists three tasks:

• HFCADDPOTS5E• ABLS5ESS• ACXLN5ESS

After creating the task list file, follow the procedure given below:

1. Login to the 8950 VAM HP Server machine as ubic .

2. At the command prompt, enter DiaFileGenerator <Task Lis t f i le name> and press [ENTER].

Important! If the Task List file name is not specified with a fully qualified path, the file is expected in the current directory.

Result: As every task is processed, status/error messages are displayed on the screen. The DiaFileGenerator.log file is created in the /tmp directory. The .dia file is generated with the name <customer name>.dia in the /tgui/ubic/dia directory. This contains the definitions of all the tasks listed in the task list file.

Contents of the .dia file This section details the contents of the sample .dia file generated for the task ACXLN5ESS.

OrderId,Status,SwitchName,ACXLN5ESS,ReleaseMethod,ReleaseDateTime,originatingUser,Comment,5ESS,CFB1,CFD1,CFINT_1,CFNB,CFND,CFV,CIDIAL,CPUOG,CWC,*DPAT,*EXTN&|,*IDP_NAME,*LCC,MSSGP1,*NPA,*NXX,*OE2&|,*OETYP_1&|,PIC,PTC,*RATE_1,SC1D,SC1L,SERDN,*TGF,*TGID

Important! Notice that for each task, the USFNs appear in a comma separated single row.

...........................................................................................................................................................................................................................................................

4 - 9365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Creation of Spreadsheet Files

This section covers details pertaining to the creation of spreadsheets (.xls or .xlsx files).

Task Control Parameters inthe Spreadsheet files

Given below is a list of task control parameters and their corresponding values. These parameters must be specified in the spreadsheet (.xls) file in order to create each task order.

* Irrespective of whether the incoming file has a value or not 8950 VAM defaults it to RDY.

Column Number

Task Control Parameter Domain Value Required?

1 Order ID Unique across 8950 VAM, up to 30 characters. For further information see Constraints and Assumptions 4-15

Y

2 Status RDY (Fixed value)* N

3 Switch Name 11 Characters Y

4 Task Name The actual name of the task, up to 33 characters

Y

5 Release Method N (Send), I (Immediate), S (Scheduled), D (Default), H (Held)

Y

6 Release Date and Time YYYYMMDDHHMMSS.0+/-HHMM (GMT offset)

For example: 20070414134055.0+/-0530

Y

7 Originating User User ID of the 8950 VAM user submitting the task order, up to 8 characters – can be UBIC

Y

8 Comment Blank or optional comment up to 80 characters

N

9 Switch Type Leave this field blank (internally populated by 8950 VAM based on the Switch Name)

N

...........................................................................................................................................................................................................................................................

4 - 1 0 365-370-370R16.0Issue 1, July 2010

** Release Date and Time is mandatory if Release Method is S. Otherwise the field can be left blank. If the specified Date and Time is less than the system time, Release Method is changed by 8950 VAM automatically to N.

Task Data Parameters inSpreadsheet files

The data parameter values are specified in the .xls or .xlsx files starting from the tenth column. For every task, the order in which the parameter values are specified must match the order in which the task USFNs appear in the .dia file.

If a parameter has a null value, the particular column in the .xls or .xlsx field must be left blank. Except for repeat table fields, you must ensure that only one value is present in every cell.

To specify multiple repeat table items in a single cell, separate the items with a |

Example: To specify multiple TN values in a single cell, enter the data as 7325551212|7325551213|7325551214|7325551215.

...........................................................................................................................................................................................................................................................

4 - 1 1365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Processing Spreadsheet Files

This section details the procedure for processing spreadsheet (.xls) files.

Transmitting the files to the8950 VAM Server

You can use the ubic User ID for transmitting the .xls or .xlsx files to the 8950 VAM server. However, before transmitting the .xls or .xlsx files you must create a .csv equivalent for each .xls or .xlsx file to be transmitted. This becomes necessary since the .csv is a text format file. Then the .xls or .xlsx format is not readable on the HP server. Subsequently, you can transmit the .xls or .xlsx and .csv files using the binary mode of transfer to the /tgui/ubic/data directory on the 8950 VAM server.

Immediately after transmitting a pair of .xls or .xlsx and .csv files, a corresponding .done file needs to be transmitted to the 8950 VAM server. This indicates that the transmission of .xls and .xlsx and .csv files is complete. This also ensures that partially transferred files are not taken up by 8950 VAM for processing.

Example: Transmission of abc.xls or abc.xlsx and abc.csv should be immediately followed by the transmission of abc.done. The .done file is a blank file.

Important! In the absence of a .csv or .done file, .xls or .xlsx files will not be processed by 8950 VAM.

We suggest that you avoid overwriting an existing .xls/.csv file since this may result in lost data and/or processing errors. The overwrite permissions can be blocked for the ubic user by following the FTP Configuration details given in the section “Configuration” (4-16).

Processing Spreadsheetfiles

Before the transmitted files can be processed, the .dia file needs to be generated. Refer to the section on Data Interface Agreement for details on the generation of .dia file.

The spreadsheet files can be processed either manually by starting the appropriate process or automatically by the cron job. For details on setting up the cron job, refer to the 8950 VAM System Administration Guide.

...........................................................................................................................................................................................................................................................

4 - 1 2 365-370-370R16.0Issue 1, July 2010

When multiple .xls or .xlsx files are processed, the files are processed in the order of their timestamp, with the earliest dated file attempted first. With manual processing, it is possible to process either any single specified file or all the .xls and .xlsx files.

Procedure The procedure for manual processing is as follows:

1. Login to the 8950 VAM HP Server machine as int .

2. Ensure that all the 8950 VAM processes are up and running – the 8950 VAM command line ‘menu’ can be used to check the status of all the processes (option 2 > 4) and start the processes (option 2 > 2).

3. At the command prompt, enter start_ubic and press [ENTER].

Important! To process a specific file, enter s tar t_ubic <.xls f i le name> or s tart_ubic <.xlsx f i le name>

Example: start_ubic abc.xls and press [ENTER].

Result: Status messages similar to the following are displayed:

start_ubic: Thu Mar 31 17:32:15 MST 2005 starting UBIC processstart_ubic: Checking for feature enablestart_ubic: starting process: (PID=6119) ...start_ubic: ... (10 second pause to verify process launch) ...start_ubic: UBIC process is started successfully. Please see the log file /tmp/UBIC.log for more details.

After the above messages are displayed, you will be returned to the command prompt. The process continues to run in the background. If for some reason, the started process is not able to process the .xls or .xlsx files, details are logged in the /tmp/UBIC.log file.

If the process proceeds successfully, the following actions take place:

• The .xls or .xlsx files are processed one at a time starting at the first row.

• For each row in a .xls or .xlsx file, definition of the task is obtained from the .dia file (.dia file contents are loaded into memory at the start of the process) and the USFN/value pairs are generated.

• On successful generation of the USFN/value pairs, the task order is submitted for creation and further processing. The task order is created in 8950 VAM only if the entered task order parameter values pass the level1 and level2 validations defined for the task.

...........................................................................................................................................................................................................................................................

4 - 1 3365-370-370R16.0Issue 1, July 2010

• If an error occurs while submitting the order, an appropriate error message is logged into a corresponding .err file in the /tgui/ubic/logs directory. The first two columns of the .err file contain the Order Id and the status ‘FAIL’ and the detailed error message is given in the third column. For a row that resulted in the successful submit of a task order, the .err file contains the status ‘SUCCESS’ with the third column being blank. Any error encountered during the processing of one row in a .xls or .xlsx file will not affect the processing of subsequent rows.

Example: For a file named abc.xls, the error file will be named abc.err.

• After all the task orders in a .xls or .xlsx file are processed, an email containing the .err file is sent to the ubic user. If task orders were successfully created and submitted for each row in the .xls or .xlsx file without any errors, the text area of the email message will be blank. If there are failed orders, the text area of the email message contains the Order Id of the failed orders and their line numbers in the .xls or .xlsx file.

• After a .xls or .xlsx file are completely processed, the .xls or .xlsx, and .done files are deleted and the .csv file is renamed as .old file. This ensures that processed files are not processed again.

Example: abc.old

Process-related trace and error messages are logged in files named Ubic.trace.* and Ubic.errors.* respectively in the /tgui/ubic/logs directory. Every time s tar t_ubic is invoked, new trace and errors files are created. The latest files can only be identified based on their timestamps.

If there is a read error while attempting to process an .xls or .xlsx file, for instance if the .xls or .xlsx file was transferred in ASCII mode instead of binary mode, an error is logged in the Ubic.errors.* file and the .xls or .xlsx, .csv and .done files are deleted so that they can be transferred again to the 8950 VAM server.

Important! If a backup and restore was carried out on a 8950 VAM server, the .xls or .xlsx files that were processed between the days the backup was done and the system was restored will have to be cleaned manually.

...........................................................................................................................................................................................................................................................

4 - 1 4 365-370-370R16.0Issue 1, July 2010

If for any reason you choose to abort the processing (either the manually started process or the cron job) of .xls or .xlsx files, you can enter stop_ubic and press [ENTER] at the int command prompt. This stops the processing of the .xls or .xlsx file being currently processed after processing the current row.

When the process is started again (manually or automatically), the processing resumes from where it stopped.

Example: If the processing was aborted after processing the tenth row in the .xls or .xlsx file, it will resume from the 11th row in the same .xls or .xlsx file.

If the UBIC process is active when the stop_ubic command is issued, the following status messages are displayed:

stop_ubic: Thu Mar 31 17:32:31 MST 2005 Stopping UBIC processstop_ubic: UBIC process for PID=${PID} successfully stopped.

If the UBIC process is not active when the stop_ubic command is issued, the following status messages are displayed:

stop_ubic: Thu Mar 31 17:32:35 MST 2005 Stopping UBIC processstop_ubic: No UBIC process (no pid file found).

Types of Task Order ErrorMessages

The following types of error messages can result when there is an error in the processing of a task order:

• DatabaseFailure – results when there is any issue in accessing the 8950 VAM database.

• LogicalFailure – results when there is invalid data for one or more task order parameters.

• DuplicateOrderIdFailure – results when the Order Id of a task order in an .xls or .xlsx file already exists in the 8950 VAM database.

• NotAuthorizedFailure – results when the User Id used in the originatingUser column does not have the required permission to submit the particular task order. This can be due to the lack of permission for that particular task or that particular switch.

...........................................................................................................................................................................................................................................................

4 - 1 5365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Constraints and Assumptions

The constraints and the assumptions related to the usage of this interface are listed in the following section.

Assumptions The interface makes the following assumptions:

1. The 8950 VAM server has enough memory to run the processes related to this interface.

2. The 8950 VAM server has enough disk space to accommodate the .xls, .csv, .err and the other trace and error log files related to this interface.

3. MS-Excel 2000 is used by the upstream system and is also the MS-Excel version used in development and testing.

Constraints The interface has the following constraints:

1. MS Excel supports a maximum of 256 columns and 65536 rows. This limits the volume and kind of task orders that can be submitted through this interface.

2. Data sent over the FTP interface is unencrypted (this includes the ubic user password).

3. Unless some task order naming convention and/or originating user ID is used for the task orders submitted through this interface, there is no way of distinguishing such orders within 8950 VAM. Additionally, in the absence of a specific starting sequence of characters for the Order IDs flowing from UBIC, there is no way of getting the order status data for such task orders over the Asynchronous Update IDL.

4. Fall-out handling cannot be performed through this interface. This means failed orders have to be worked using the Task Execution GUI.

5. Multi-sheet workbooks only have one sheet (the first sheet) processed – the rest of the workbook is ignored.

6. Switch queries can be supported in a one-way downstream direction, where the query information does not flow back upstream, but can be consulted in Task Execution GUI.

7. A row in the .xls or .xlsx file that failed to become a task order can be resent in a new .xls or .xlsx file, since editing of .xls/.csv file is not allowed.

8. Task orders can be sent only to the switches supported by the specific 8950 VAM server. No cross-server actions will be performed.

...........................................................................................................................................................................................................................................................

4 - 1 6 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Configuration

FTP Configuration for UBIC To prevent a UBIC user from overwriting an existing file or to allow read-only FTP access, you will need to change the FTP configuration by setting the overwrite permission status to No.

By default, guests and anonymous users are not given overwrite access. In order to restrict overwrite access to UBIC users you must add another entry called 'real' to the Overwrite No variable in the ftpaccess file.

Procedure Follow these steps to change the FTP file configuration status:

1. Login to the 8950 VAM HP Server machine as super user (root).

2. Access the ftpaccess file from the /etc/ftpd/ directory.

Result: The contents of the ftpaccess file are displayed. You can add or modify the entries for variables present in this file.

Important! By default, the ftpaccess file is not present in the /etc/ftpd/ directory. You can copy this file from the /usr/newconfig/etc/ftpd/examples directory.

3. Add another entry called real in the overwrite no variable row.

Example: overwrite no guest , anonymous, real # overwrite permission.

4. To restart the FTP deamon, change the following entry in /etc/inetd.conf file.

ftp stream tcp nowait root /usr/lbin/ftpd ftpd -ltoftp stream tcp nowait root /usr/lbin/ftpd ftpd -al

5. Next, restart the inetd by using 'inetd -c command.

Result: Overwrite permissions are restricted to all users.

Other Configuration For information on Tunable Parameters, refer to the 8950 VAM System Administration Guide.

5 - 1365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................


............................................................................................................................................................................................................................................................

Overview

Purpose This chapter contains the sample starter package of Task Orders that are provided.


• Identify the tasks of the starter package and the task order screen for each task.

The following topics are included in this chapter.

Sample Starter Package 4-2

...........................................................................................................................................................................................................................................................

5 - 2 365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Sample Starter Package

Task Orders Included inScreen Samples

The following pages contain screen samples from a starter package that may have been delivered with the 8950 VAM Task Execution product. The following Task Order screens are included:

• Sample Control Tab

• Add Dedicated Access Trunk Service - Main Tab

• Add POTS - Main Tab

• Add POTS - Line Info Tab

• Change MLHG

• Change POTS - Main Tab

• Change POTS - Line Info Tab

• Delete POTS - Main Tab

• Verify POTS - Main Tab

• Add CENTREX Group - 5ESS

• Add CENTREX Lines - 5ESS - View 1

• Add CENTREX Lines - 5ESS - View 2

• Add CENTREX Lines - DMS

• ADD POTS (DMS) - Main Tab - View 1

• ADD POTS (DMS) - Main Tab - View 2

• Change POTS (DMS) - Main Tab - View 1

• Change POTS (DMS) - Main Tab - View 2

• Delete POTS (DMS) - Main Tab

• DaRoute - DA ROUTE Details Tab

• MGCF Trunk Group - Details 1 Tab




• Route Digits Screen

• Route Digits Key Set Screen

• Route Digits Key Set - Reports page Screen

• MGCF Intelligent Routing - Input Data Tab

• MGCF Intelligent Routing - Data Tab

• MGCF CAS Trunk - Details Tab

...........................................................................................................................................................................................................................................................

5 - 3365-370-370R16.0Issue 1, July 2010

• MGCF SS7 Trunk - Details Tab

Important! Unless DMS is specified, the task is used for creating orders for a 5ESS switch only.

Control tab The fields in the control tab are same in all the screens. The following is an example of the Control tab screen.

Figure 5-1 Sample Control Tab

Add Dedicated AccessTrunk Service

To send an order using this task, you must provide the following:

• trunk service type

• trunk group number

• trunk group characteristic

• starting trunk member number

• number of trunk member

• trunk equipment type

• trunk equipment number

• transmission class

• far end NPA

See Figure 5-2, “Add Dedicated Access Trunk Service - Main Tab” (5-4).

...........................................................................................................................................................................................................................................................

5 - 4 365-370-370R16.0Issue 1, July 2010

Important! If a service order adds a new trunk circuit, the circuit will be added in the switch. However, the 8950 Voice Activation Manager Trunk Originating Equipment interface will still see the trunk circuit as reserved. To update the status of the circuit to working, refer to Task 103 in the 8950 Voice Activation Manager Trunk Originating Equipment Guide.

Figure 5-2 Add Dedicated Access Trunk Service - Main Tab

Add Plain Old TelephoneService

For the 5ESS switch, orders created from this task require a telephone number, line equipment number, line class code, and rate center. See Figure 5-3, “Add POTS - Main Tab” (5-5) and Figure 5-4, “Add POTS - Line Info Tab” (5-5). For DMS, the required fields are telephone number, line equipment number, line class code, local access and transport.

...........................................................................................................................................................................................................................................................

5 - 5365-370-370R16.0Issue 1, July 2010

Figure 5-3 Add POTS - Main Tab

Figure 5-4 Add POTS - Line Info Tab

...........................................................................................................................................................................................................................................................

5 - 6 365-370-370R16.0Issue 1, July 2010

Change Multiline HuntGroup

Orders using this task require hunt type and leading telephone number (TN). See Figure 5-5, “Change MLHG” (5-6).

Figure 5-5 Change MLHG

Change Plain OldTelephone Service

Orders using this task require the telephone number to be changed. See Figure 5-6, “Change POTS - Main Tab” (5-7) and Figure 5-7, “Change POTS - Line Info Tab” (5-8).

Delete Plain Old TelephoneService and Verify Plain

Old Telephone Service

Orders created from these tasks require the telephone number. DeletePOTS is shown in Figure 5-18, “Delete POTS (DMS) - Main Tab” (5-18) and VerifyPOTS is shown in Figure 5-9, “Verify POTS - Main Tab” (5-10).

...........................................................................................................................................................................................................................................................

5 - 7365-370-370R16.0Issue 1, July 2010

Figure 5-6 Change POTS - Main Tab

...........................................................................................................................................................................................................................................................

5 - 8 365-370-370R16.0Issue 1, July 2010

Figure 5-7 Change POTS - Line Info Tab

...........................................................................................................................................................................................................................................................

5 - 9365-370-370R16.0Issue 1, July 2010

Figure 5-8 Delete POTS - Main Tab

...........................................................................................................................................................................................................................................................

5 - 1 0 365-370-370R16.0Issue 1, July 2010

Figure 5-9 Verify POTS - Main Tab

Figure 5-10 Add CENTREX Group - 5ESS

...........................................................................................................................................................................................................................................................

5 - 1 1365-370-370R16.0Issue 1, July 2010

Figure 5-11 Add CENTREX Lines - 5ESS - View 1

...........................................................................................................................................................................................................................................................

5 - 1 2 365-370-370R16.0Issue 1, July 2010

Figure 5-12 Add CENTREX Lines - 5ESS - View 2

...........................................................................................................................................................................................................................................................

5 - 1 3365-370-370R16.0Issue 1, July 2010

Figure 5-13 Add CENTREX Lines - DMS

...........................................................................................................................................................................................................................................................

5 - 1 4 365-370-370R16.0Issue 1, July 2010

Figure 5-14 ADD POTS (DMS) - Main Tab - View 1

...........................................................................................................................................................................................................................................................

5 - 1 5365-370-370R16.0Issue 1, July 2010

Figure 5-15 ADD POTS (DMS) - Main Tab - View 2

...........................................................................................................................................................................................................................................................

5 - 1 6 365-370-370R16.0Issue 1, July 2010

Figure 5-16 Change POTS (DMS) - Main Tab - View 1

...........................................................................................................................................................................................................................................................

5 - 1 7365-370-370R16.0Issue 1, July 2010

Figure 5-17 Change POTS (DMS) - Main Tab - View 2

...........................................................................................................................................................................................................................................................

5 - 1 8 365-370-370R16.0Issue 1, July 2010

Figure 5-18 Delete POTS (DMS) - Main Tab

IMS task related screensamples

The following pages contain IMS task related screen samples from a starter package that is delivered with the 8950 VAM Task Execution product.

You can access these screens using the New Task Order screen. For information on how to access the New Task Order screen, refer to Table 3-4, “Desktop Screen Menus and Commands”(3-33) in the “Task Execution Commands” (3-33) section.

From the New Task order screen, select a Task Family and a Task Name from the drop-down menus and click OK to see the required task information. For more information on New Task order screen, refer to “Creating a New Task Order” (3-52).

DaRoute screen The following screen, Figure 5-19, “DaRoute - DA ROUTE Details Tab” (5-19) is used to manage the digit analysis routing tables.

...........................................................................................................................................................................................................................................................

5 - 1 9365-370-370R16.0Issue 1, July 2010

Figure 5-19 DaRoute - DA ROUTE Details Tab

MGCF Trunk Groupscreens

The following screens, Figure 5-20, “MGCF Trunk Group - Details 1 Tab” (5-20), Figure 5-21, “MGCF Trunk Group - Details 2 Tab” (5-20), Figure 5-22, “MGCF Trunk Group - Details 3 Tab” (5-21), and Figure 5-23, “MGCF Trunk Group - Details 4 Tab” (5-21) are used to manage trunk groups in the OMCP or MGCF switches.

...........................................................................................................................................................................................................................................................

5 - 2 0 365-370-370R16.0Issue 1, July 2010

Figure 5-20 MGCF Trunk Group - Details 1 Tab


...........................................................................................................................................................................................................................................................

5 - 2 1365-370-370R16.0Issue 1, July 2010



...........................................................................................................................................................................................................................................................

5 - 2 2 365-370-370R16.0Issue 1, July 2010

MGCF Intelligent RoutingTask

MGCF Intelligent Routing task is delivered with the sample Demo Tasks. This task is used to activate a new NPA-NXX code.

The MGCF Intelligent Routing task accepts two NPA-NXX codes as input. The first is the New Code to be activated. The second is the Route Like Code to be used to determine the routing parameters for the code being activated.

The existence of the NPA-NXX code in the inventory database or in the switch determines the action to be taken.

If the NPA-NXX of the New Code is not translated in the Route Digits table, MGCF Intelligent Routing task will initiate a command to insert the NPA-NXX code that is being activated.

MGCF Intelligent Routing task works with two inventory tables, the Route Digits table and the Route Digits Key Set table. The Route Digits inventory table is a copy of the Route Digits table on the MGCF switch.

The Route Digits Key Set inventory table functions as an office profile table, listing the key set combinations that define the various calling areas and dial plans that have to be translated for each NPA-NXX combination.

Important! The user is responsible for initializing and maintaining the data in the Route Digits Key Set inventory table, manually, through the Translation Interface GUI.

The following screens, Figure 5-24, “Route Digits Screen” (5-23), Figure 5-25, “Route Digits Key Set Screen” (5-23), and Figure 5-26, “Route Digits Key Set - Reports page Screen” (5-24) show example inventory table records in the Route Digits and Route Digits Key Set tables and an example reports screen.

...........................................................................................................................................................................................................................................................

5 - 2 3365-370-370R16.0Issue 1, July 2010

Figure 5-24 Route Digits Screen

Figure 5-25 Route Digits Key Set Screen

...........................................................................................................................................................................................................................................................

5 - 2 4 365-370-370R16.0Issue 1, July 2010

Figure 5-26 Route Digits Key Set - Reports page Screen

The Route Digits Key Set table in the switch has four records. Only one of these key sets has a record for the NPA-NXX of the Route Like Code. The New Code has records for two of the key sets. Hence, the task will create two recent changes.

One of the recent changes will change the New Code NPANXX for the key set that has a record for both codes. The other one deletes the New Code record for the key set that does not exist for the Route Like Code.

For an existing record the Intelligent routing task sends a change RC (Recent Change) and sends a delete RC for other record.

The following screens show the task order screens for an existing or New Code and Route Like Code in the Route Digits inventory table.

Enter the following in Figure 5-27, “MGCF Intelligent Routing - Input Data Tab” (5-25) screen:

• New Code - to be activated

• Route Like Code - to be used as a template for the translations

Important! When this task is executed, the MGCF Intelligent Routing - Data Tab screen shows the records that will be created. The user cannot change the data in Figure 5-28, “MGCF Intelligent Routing - Data Tab” (5-25) screen.

...........................................................................................................................................................................................................................................................

5 - 2 5365-370-370R16.0Issue 1, July 2010

Figure 5-27 MGCF Intelligent Routing - Input Data Tab

Figure 5-28 MGCF Intelligent Routing - Data Tab

...........................................................................................................................................................................................................................................................

5 - 2 6 365-370-370R16.0Issue 1, July 2010

MGCF CAS Trunk screen The following screen, Figure 5-29, “MGCF CAS Trunk - Details Tab” (5-26) is used to manage the MGCF CAS Trunks.

Figure 5-29 MGCF CAS Trunk - Details Tab

MGCF SS7 Trunk screen The following screen, Figure 5-30, “MGCF SS7 Trunk - Details Tab” (5-26) is used to manage the MGCF SS7 Trunks.

Figure 5-30 MGCF SS7 Trunk - Details Tab

G L O S S A R YG L - 1

365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................................................................................................

Glossary

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

# 8950 VAM8950 Voice Activation Manager

A ANCMAccess Node Configuration Management

APIApplication Process Interface

APPLICATIONA collection of executable and configuration files that, when operated upon, provide a defined set of functionality.

ASCIIAmerican Standard Code for Information Interchange.

B BASEWORXBaseWorx application (BWX). This application is an integrated suite of tools used to develop and operate UNIX-based distributed applications in multivendor environment.

C CCPCustomer Care Platform

CORBACommon Object Request Broker Architecture. This is a platform-independent protocol for interprocess communication. This is for communication at the API and application level and lower.

...........................................................................................................................................................................................................................................................


365-370-370R16.0Issue 1, July 2010

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

CPUCentral Processing Unit

CSLCommunication Software Launcher

CSRCustomer Service Representative

CSVComma separated value.

D DNSDomain Name Server

E EMMElement Mediation Module

F FILE SYSTEMAn operating system structure imposed on a media device, such as a disk drive, used for manipulating data.

FTPFile Transfer Protocol

G GUIGraphical User Interface

H

I ICMSIntegrated Customer Management System

ISDNIntegrated Services Digital Network

IDLInterface Definition Language.

...........................................................................................................................................................................................................................................................


365-370-370R16.0Issue 1, July 2010

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

J JDBCJAVA Database Component

JDKJAVA Development Kit

K

L LDSLocal Digital Switch

M MSIEMicrosoft Internet Explorer

N NPA/NXXNumbering Plan Area/Office Code

O OA&MOperations, Administration, and Maintenance

OA&M PLATFORMsee XDP.

OEOriginating Equipment

ORACLEOracle Database application used by 8950 VAM. It includes facilities for schemas, SQL, data backup, and recovery.

ORBIXOrbix software provides and supports CORBA service for 8950 VAM.

OSOperating System

P PARTITIONA bounded file system.

...........................................................................................................................................................................................................................................................


365-370-370R16.0Issue 1, July 2010

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

PLATFORMAn integrated set of software components that form a base on which applications can be developed.

PROCESSA program from disk combined with the OS overhead necessary to support its execution.

Q

R RAMRandom Access Memory

RCRecent Change

RCATRecent Change Action Table

S SAMSystem Administration Manager

SECMSwitch Element Configuration Management

SERVERThe UNIX host machine that contains 8950 VAM and supporting software.

SQLStructured Query Language

SOService Orders

T TCP/IPTransmission Control Protocol/Internet Protocol. A transport protocol commonly used over a network. The 8950 VAM application currently supports TCP/IP only.

TNTelephone Number

...........................................................................................................................................................................................................................................................


365-370-370R16.0Issue 1, July 2010

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

......................................................................................................................................................................................................

TNS LISTENERThe TNS Listener is a persistent daemon process, run by Oracle that “listens” to the 8950 VAM application for database commands and updates.

TASKService Provisioning tool that converts unique service order items into appropriate recent change language.

U UIUser Interface application. This application is responsible for providing each 8950 VAM user with a graphic interface to communicate with 8950 VAM.

UNIXThis is the OS application that provides an environment to govern how resources are used on the machine. Such resources include CPU, RAM memory, and secondary storage. The UNIX application also supports the execution of user-level programs. HP-UX is the UNIX OS developed by Hewlett Packard. 8950 VAM currently runs on HP-UX.

USFNUniversal Switch Feature Name

V

W

X XDPCross Domain Platform, also referred to as the OA&M Platform. This application is responsible for OA&M of the 8950 VAM application. It provides a communications facility that allows the 8950 VAM administrator to start and stop applications, dynamically trace the activity of a process, and provide interprocess communication between processes over well-known port numbers.

Y

Z

...........................................................................................................................................................................................................................................................


365-370-370R16.0Issue 1, July 2010

I n d e xI N - 1

365-370-370R16.0Issue 1, July 2010

............................................................................................................................................................................................................................................................

Index

.............................................................................

.............................................................................

.............................................................................

8950 VAMinterfaces on, 3-10

8950 VAM Login Page, 3-5

A about, 3-10

About command, 3-34, 3-35, 3-84

Accelerator, 3-37

Add CENTREX Group - 5ESS, 5-2

Add CENTREX Lines - 5ESS, 5-2

Add CENTREX Lines - 5ESS - View 2, 5-2

Add Dedicated Access Trunk Service, 5-4

Add POTS, 5-5

Add POTS - Line Info Tab, 5-2

ADD POTS (DMS) - Main Tab - View 2, 5-2

Alternation symbol, 3-60

Application Administration icon, 3-10

Apply button, 3-45

Asynchronous Notification screen, 3-14

C Calendar widget, 3-44

Calendar window, 3-63

CAN, 3-42

Cancelbutton on a Task Order

screen, 3-45

command on the selected menu, 3-34

procedure to cancel a task order, 3-72

Change MLHG, 5-6

change password procedure, 3-8

Change POTS, 5-7Sample Starter Package

, 5-7

Change POTS - Line Info Tab, 5-2

Change POTS (DMS) - Main Tab - View 1, 5-2

Change POTS (DMS) - Main Tab - View 2, 5-2

CheckBox widget, 3-44

Choice widget, 3-44

clear button, 3-6

client requirements, 2-5

clipboard, 3-47

Close button, 3-17

Close command, 3-34, 3-35, 3-84

Comment, 3-19, 3-42, 3-60

common area buttons, 3-10

.............................................................................

Copybutton on a repeat table,

3-46

command on the selected menu, 3-34

copying data between dissimilar orders, 3-77

procedure to copy a task order, 3-75

CPD, 3-42

Created By, 3-19, 3-60

Creating a New Task Order, 3-52

customer name, 3-10

Customizing the Task Order Summary Screen, 3-21

Cut, 3-46

D Dataentering on screens, 3-59

Data Interface Agreement, 4-11

i n d e xI N - 2

365-370-370R16.0Issue 1, July 2010

.........................................................................................................................................................................................................................................................

.............................................................................

.............................................................................

Default Query Task Order, 3-25

Comment, 3-26

Created By, 3-26

Modified By, 3-26

Order ID, 3-26

Status, 3-26

Switch Name, 3-26

Task Family, 3-26

Task Name, 3-26

Task Tag, 3-26

USFN Parameter, 3-26

USFN Value, 3-26

Default release method, 3-41

Default Task Order Summary, 3-28

Delete POTS, 5-9

Deselect command, 3-45

desktop screen, 3-13menus and commands,

3-33

Details command, 3-34, 3-35, 3-84

Details Icon, 3-13

disable async window command, 3-14

Displaying order detailsmulti-switch order, 3-82

procedure, 3-78

documentation button, 3-10

E enable async window command, 3-14

ERR, 3-42

Executed Date/Time, 3-19, 3-20

F Family, 3-52

field, 3-40

.............................................................................

.............................................................................

.............................................................................

Field Level Menu, 3-44

File menu, 3-33, 3-34, 3-35

Filtercommand, 3-34

Filtering displayed orders, 3-65

Firewall Administration icon, 3-10

Force Complete, 3-34, 3-87

G group, 3-40

H Hardware Specifications, 2-2

Helpbutton on Task Order

screen, 3-45

command, 3-45

common area button, 3-10

menu on the Desktop screen, 3-33

menu on the Item Summary screen, 3-35, 3-84

menu on the Task Order Summary screen, 3-34

pop-up, 3-35

help message, 3-33

Hold release method, 3-41

Hot key, 3-37

I IconsDetails, 3-13

Help, 3-13

Modify, 3-13

New, 3-13

Query Task Orders, 3-13

Refresh, 3-13

Insert Row window, 3-48

.............................................................................

.............................................................................

.............................................................................

Integer widget, 3-44

Invoking a command, 3-32

Item, 3-19

Item Number, 3-84

K key, 3-37

keyboard shortcut, 3-32, 3-37

keyboard shortcuts, 3-37

L Level 1 validations, 3-45

Level 2 validations, 3-45

Logging in, 3-12

M Maximize, 3-17

Maximum Number of Matches, 3-64

Menu bars, 3-32

Menusaccessing, 3-33

on Task Order Summary Screen, 3-33, 3-34

Message of the Day, 3-11

Minimize, 3-17

Modified by, 3-19, 3-60

Modified Date/Time, 3-19, 3-20

Modifyprocedure to modify a

multi-switch order, 3-71

procedure to modify a task order, 3-68

Modify commanddescription, 3-34

Modify Icon, 3-13

Modify Row window, 3-50

Modifying orders from the Item Summary screen, 3-71

I n d e xI N - 3

365-370-370R16.0Issue 1, July 2010

...........................................................................................................................................................................................................................................................

.............................................................................

.............................................................................

.............................................................................

.............................................................................

Modifying Task Ordersprocedure for, 3-69, 3-72

More Info, 3-19

Multiple Language Support, 3-31

multi-switch selection box, 3-53

Multi-Switch Support, 3-53

N navigation buttons, 3-17

Network Element Manager (NEM), 3-10

New Icon, 3-13

New Task Order command, 3-52

O OK, 3-45

OPN, 3-42

Order ID, 3-19, 3-41, 3-59

Ordersmodifying

procedure for, 3-69, 3-72

P Paste, 3-46

Pasting data from an external application, 3-47

Print Column Selection screen, 3-35

Print command, 3-34, 3-35, 3-84

Printing Task Order Information, 3-89

Q Query by Entering Text Information, 3-59

Query by Order Status, 3-60

Query by Timestamp, 3-62

Query command, 3-34

.............................................................................

.............................................................................

Query on Start-Up, 3-24

Query Task Order guidelines, 3-60

Query Task Order screen, 3-58

Query Task Orders Icon, 3-13

R Radio widget, 3-44

RDY, 3-42

Refresh command, 3-34, 3-88

Refresh Icon, 3-13

Refreshing the Task Order Summary Screen, 3-88

REJ, 3-42

Release Date/Time, 3-19, 3-20, 3-42

Release Method, 3-41

release number, 3-33

Repeat table, 3-46, 3-50

Insert Command, 3-48

Pasting data, 3-47

repeat table, 3-45

Reset button, 3-45

Reset command, 3-44

Resubmit button, 3-85

Retrieve command, 3-34, 3-35, 3-86

Retrieving multi-switch orders, 3-86

S Sample Starter Package, 5-13

, 5-4, 5-5, 5-6, 5-9, 5-10, 5-13

Scheduled release method, 3-41

.............................................................................

Screensentering data on, 3-59

starter package for, 5-2

Task Order Summary, 3-13

Select multiple switches procedure, 3-17

Selected menu, 3-34, 3-35

Send Immediate release method, 3-41

Send release method, 3-41

server requirements, 2-5

Software Specifications, 2-5

Sorting by column data, 3-20

Specificationshardware, 2-2

software, 2-5

Spreadsheet Files, 4-11

start procedure, 3-12

Starter Package, 5-2

Status, 3-19, 3-42, 3-84

Submitting a query, 3-64

summary screen, 3-13

support button, 3-10

Switch, 3-19, 3-84

Switch Name, 3-19, 3-41, 3-53, 3-59

switch name selection box, 3-16

switch queue asynchronous window, 3-14

System Administration Central, 3-8

System Administration icon, 3-10

T tab, 3-40

Task Building icon, 3-10

Task Execution Commands, 3-32

i n d e xI N - 4

365-370-370R16.0Issue 1, July 2010

.........................................................................................................................................................................................................................................................

.............................................................................

Task Execution icon, 3-10

Task Execution Interfacelogging in, 3-12

Task Execution Toolbar, 3-36

Task Family, 3-52, 3-59

Task Name, 3-19, 3-53, 3-59

Task Order, 3-33

Task Order Details screen, 3-35, 3-81

Task Order screen, 3-35, 3-40

Task Order screen buttons, 3-45

Task Order Summary, 3-33

Task Order Summary (TOS), 3-21

Task Order Summary Screenaccessing menus on, 3-33

example of, 3-13

information on, 3-20

menus on, 3-33, 3-34

Task Ordersmodifying

procedure for, 3-69, 3-72

Task Tag, 3-59

TELNET, 3-8

Terminating the application, 3-33

TextArea widget, 3-44

TextField widget, 3-44

toolbar, 3-32

Translation Interface icon, 3-10

TST, 3-42

U Upstream Batch Processing Interface, 4-1

Upstream systems, 3-54

.............................................................................

.............................................................................

.............................................................................

User Interfaces, 3-10

User Options, 3-8

USFN, 3-84

USFN Parameter, 3-60

USFN Value, 3-60

Using the keyboard shortcuts, 3-32

Using the menus, 3-32

Using the toolbar, 3-32

V Verify POTS, 5-10, 5-13

View menu, 3-33, 3-34

W widgets, 3-43

wildcards, 3-60

X XMT, 3-42

8950 VAM (8950 Voice Activation Manager) Task Execution ...

Documents

Transcript of 8950 VAM (8950 Voice Activation Manager) Task Execution ...