Lucent Technologies AP-5 User manual

APS (Application Plus Server) 4.1

Users Guide

101-1830-001

Issue 1.0

June 1999

Copyright  1999, Lucent Technologies

Notice

Every effort was made to ensure that the information in this book was

complete and accurate at the time of printing. However, information is

subject to change.

Your Responsibility for Your System’s Security

Toll fraud is the unauthorized use of your telecommunications system by

an unauthorized party, for example, persons other than your company’s

employees, agents, subcontractors, or persons working on your com-

pany’s behalf. Note that there may be a risk of toll fraud associated with

your telecommunications system and, if toll fraud occurs, it can result in

substantial additional charges for your telecommunications services.

You and your system manager are responsible for the security of your sys-

tem, such as programming and configuring your equipment to prevent

unauthorized use. The system manager is also responsible for reading all

installation, instruction, and system administration documents provided

with this product in order to fully understand the features that can intro-

duce risk of toll fraud and the steps that can be taken to reduce that risk.

Lucent Technologies does not warrant that this product is immune from or

will prevent unauthorized use of common-carrier telecommunication ser-

vices or facilities accessed through or connected to it. Lucent Technolo-

gies will not be responsible for any charges that result from such

unauthorized use.

Lucent Technologies Fraud Intervention

If you suspect you are being victimized by toll fraud and you need techni-

cal support or assistance, call the appropriate BCS National Customer

Care Center telephone number. Users of the MERLIN®, PARTNER®,

and System 25 products should call 1 800 628 2888. Users of the System

75, System 85, DEFINITY® Generic 1, 2 and 3, and DEFINITY® ECS

products should call 1 800 643 2353. Customers outside the continental

United States should contact their local Lucent representative, or call one

of the above numbers in the following manner:

• Dial the International Access Code; for example, 011.

• Dial the country code for the U.S., that is, 01.

• Lastly, dial either of the telephone numbers provided above.

Lucent Technologies Web Page

The world wide web home page for Lucent Technologies is:

http://www.lucent.com

Federal Communications Commission Statement

Part 15: Class A Statement. This equipment has been tested and found

to comply with the limits for a Class A digital device, pursuant to Part 15

of the FCC Rules. These limits are designed to provide reasonable protec-

tion against harmful interference when the equipment is operated in a

commercial environment. This equipment generates, uses, and can radiate

radio-frequency energy and, if not installed and used in accordance with

the instructions, may cause harmful interference to radio communications.

Operation of this equipment in a residential area is likely to cause harmful

interference, in which case the user will be required to correct the interfer-

ence at his own expense.

Industry Canada (IC) Interference Information

This digital apparatus does not exceed the Class A limits for radio noise

emissions set out in the radio interference regulations of Industry Canada.

Le Présent Appareil Nom

érique n’é

met pas de bruits radio

é

lectriques

d

é

passant les limites applicables aux appareils num

é

riques de la class A

pr

é

scrites dans le reglement sur le brouillage radio

é

lectrique

é

dict

é

par le

Industrie Canada.

Trademarks

See the preface of this document.

Ordering Information

Call: Lucent Technologies BCS Publications Center

Voice 1 800 457-1235 International Voice 317 322-6791

Fax 1 800 457-1764 International Fax 317 322-6699

Write: Lucent Technologies BCS Publications Center

2855 N. Franklin Road

Indianapolis, IN 46219

Order: Document No. 101-1830-001

Issue 1, June 1999

For additional documents, refer to the section in “About This Document”

entitled “Related Resources.”

You can be placed on a standing order list for this and other documents

you may need. For more information on standing orders, or to be put on a

list to receive future issues of this document, contact the Lucent Technol-

ogies Publications Center.

Obtaining Products

To learn more about Lucent Technologies products and to order products,

contact Lucent Direct, the direct-market organization of Lucent Technolo-

gies Business Communications Systems. Access their web site at

www.lucentdirect.com. Or call the following numbers: customers 1 800

451 2100, account executives 1 888 778 1880 (voice) or 1 888 778 1881

(fax).

Warranty

Lucent Technologies provides a limited warranty on this product. Refer to

the “Limited Use Software License Agreement” card provided with your

package.

European Union Declaration of Conformity

The “CE” mark affixed to the equipment means that it conforms to the

above directives. Lucent Technologies Business Communications Sys-

tems declares that APS equipment specified in this document conforms to

the referenced European Union(EU) Directives and Harmonized Stan-

dards listed below:

EMC Directive 89/336/EEC

Low-Voltage Directive 73/23/EEC

Comments

To comment on this document, return the comment card at the back of this

document.

Acknowledgment

This document was prepared by the Product Documentation Develop-

ment, Lucent Technologies, Denver, CO and Columbus, OH Middletown,

NJ.

101-1830-001 Issue 1.0 iii101-1830-001 Issue 1.0

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Audience Statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

Purpose Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

Help and Technical Support. . . . . . . . . . . . . . . . . . . . . . .19

Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Electronic Version. . . . . . . . . . . . . . . . . . . . . . . . . . .21

Other Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Informix Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Sun Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

NewNet Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

ISSG Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Lucent and Octel Manuals . . . . . . . . . . . . . . . . . . . .21

Commenting on This Document . . . . . . . . . . . . . . . . . . .22

Trademarks and Registered Trademarks . . . . . . . . . . . . .22

Chapter 1 Overview

Overview of the APS Environment . . . . . . . . . . . . . . . . . . . .25

Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

Software Constructs. . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

APS 4.1 Environment . . . . . . . . . . . . . . . . . . . . . . . . . . .28

APS 4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

ERP 2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

APS 4.1 New Features. . . . . . . . . . . . . . . . . . . . . . . . . . .29

Upgrade to Informix 7.3 . . . . . . . . . . . . . . . . . . . . . .29

TCP/IP Interface to Sierra/CA . . . . . . . . . . . . . . . . .29

TCP/IP Alarm Functionality. . . . . . . . . . . . . . . . . . .29

TCP/IP Connectivity Check . . . . . . . . . . . . . . . . . . .29

ERP 2.0 New Features. . . . . . . . . . . . . . . . . . . . . . . . . . .30

Inclusion of ERP as a Custom Application. . . . . . . .30

ERP Supports Multiple APSs . . . . . . . . . . . . . . . . . .30

Initialization on Reboot . . . . . . . . . . . . . . . . . . . . .30

APS 4.0 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

SS7 Interface to HLR . . . . . . . . . . . . . . . . . . . . . . . .32

Upgrade to Solaris 2.6 . . . . . . . . . . . . . . . . . . . . . . .32

Software Packaging Improvements. . . . . . . . . . . . . .32

Initialization on Reboot . . . . . . . . . . . . . . . . . . . . .32

APS (Application Plus Server) 4.1 Users Guide

iv 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

Passive Alarm Monitoring Interface . . . . . . . . . . . . 32

System Heartbeat. . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Communication Protocols. . . . . . . . . . . . . . . . . . . . . . . . . . . 34

OCL Versions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

SMPP Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

SS7, IS-41C, TCAP. . . . . . . . . . . . . . . . . . . . . . . . . 34

SMTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

TCP/IP Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

PPP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Description of APS Hardware . . . . . . . . . . . . . . . . . . . . . . . 36

APS Sun System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

APS System Hardware Configuration. . . . . . . . . . . 36

ERP System Hardware Configuration. . . . . . . . . . . 37

Hardware Base for Small ERP Configuration. . . . . 38

Hardware Base for Large ERP Configuration. . . . . 38

Description of APS Software . . . . . . . . . . . . . . . . . . . . . . . . 39

APS Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

ERP Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

VPM Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

License Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Chapter 2 Installing APS

Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Routine Operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Required Items and Information. . . . . . . . . . . . . . . . . . . . . . 43

Installing New Hardware Systems . . . . . . . . . . . . . . . . . . . . 45

Assembling the Sun Hardware. . . . . . . . . . . . . . . . . . . . 45

Setting Up APS Hardware . . . . . . . . . . . . . . . . . . . . . . . 45

Installing Circuit Cards . . . . . . . . . . . . . . . . . . . . . . 46

Installing the Second Hard Disk . . . . . . . . . . . . . . . 46

Installing the External Disks . . . . . . . . . . . . . . . . . . 46

Powering Up the A1000 . . . . . . . . . . . . . . . . . . . . . 47

Modem Connections . . . . . . . . . . . . . . . . . . . . . . . . 47

Assembling the ERP Hardware . . . . . . . . . . . . . . . . . . . 48

Cabling the ERP System . . . . . . . . . . . . . . . . . . . . . . . . 48

Setting Up the LAN Switch . . . . . . . . . . . . . . . . . . . . . . 48

Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

APS (Application Plus Server) 4.1 Users Guide

v 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

Installing the APS Tape . . . . . . . . . . . . . . . . . . . . . . . . . 50

Installing the ERP Tape . . . . . . . . . . . . . . . . . . . . . . . . . 54

Installing the Application. . . . . . . . . . . . . . . . . . . . . . . . 54

Configuring the System Heartbeat File . . . . . . . . . . . . . 54

Configuring Communications . . . . . . . . . . . . . . . . . . . . 54

Cabling and Configuring TCP/IP

from the Sierra/CA Side . . . . . . . . . . . . . . . . . . . . . 55

Cabling and Configuring TCP/IP

from the APS Side. . . . . . . . . . . . . . . . . . . . . . . . . . 58

Cabling and Configuring

X.25 Links on the Sierra/CA Side. . . . . . . . . . . . . . 58

Cabling and Configuring

X.25 Links on the APS Side . . . . . . . . . . . . . . . . . . 61

Starting the X.25 Tool . . . . . . . . . . . . . . . . . . . . . . . 62

Using the Link Editor . . . . . . . . . . . . . . . . . . . . . . . 64

LAPB/WAN Parameters . . . . . . . . . . . . . . . . . . . . . 66

Addressing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

CUG and Facilities . . . . . . . . . . . . . . . . . . . . . . . . . 68

Link Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Timers and Counters . . . . . . . . . . . . . . . . . . . . . . . . 71

Special . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

X32 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . 73

Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Modifying the Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Placing Test Calls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Generating Test Reports. . . . . . . . . . . . . . . . . . . . . . . . . 76

Soaking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Software Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Upgrading from APS 3.x to APS 4.1. . . . . . . . . . . . . . . 77

Upgrading from APS 4.0 to APS 4.1 . . . . . . . . . . . . . . 77

Required Items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Check the External Disk Array . . . . . . . . . . . . . . . . 77

Procedure to Upgrade to APS 4.1 . . . . . . . . . . . . . . 79

Chapter 3 Menu Interface

Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

APS Menu Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

APS (Application Plus Server) 4.1 Users Guide

vi 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Script Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

New, Open, and Delete Items. . . . . . . . . . . . . . . . . . . . . 86

Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Gen Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Debug Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Script Information Log. . . . . . . . . . . . . . . . . . . . . . . . . . 89

Status Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

System Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Script Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

The Profile Window. . . . . . . . . . . . . . . . . . . . . . . . . 91

Parts of the Profile Window. . . . . . . . . . . . . . . . . . . 92

Server/Protocol Enable Options . . . . . . . . . . . . . . . 94

TCP/IP Enable Option. . . . . . . . . . . . . . . . . . . . . . . 95

SMPP Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

OSA Server Options . . . . . . . . . . . . . . . . . . . . . . . . 97

HLR Server Options . . . . . . . . . . . . . . . . . . . . . . . . 98

SS7 Enable Options. . . . . . . . . . . . . . . . . . . . . . . . . 99

Disable Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Auto Restart Option. . . . . . . . . . . . . . . . . . . . . . . . . 101

Type 40 Mailbox Number . . . . . . . . . . . . . . . . . . . . 101

Script Type Option. . . . . . . . . . . . . . . . . . . . . . . . . . 101

Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Scripts Control Manager . . . . . . . . . . . . . . . . . . . . . . . . 103

Configurable Parameters . . . . . . . . . . . . . . . . . . . . . . . . 103

Runtime Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Application Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Logger Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Script Tracer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

RMPP Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

SS7 Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Utility Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Wizard Backup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

APS (Application Plus Server) 4.1 Users Guide

vii 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

Printer Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

System Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Cron Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Database Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Dynamic SQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Select SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Chapter 4 Procedures

APS System-wide Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Starting the APS Interface . . . . . . . . . . . . . . . . . . . . . . . 112

Quitting the APS Interface. . . . . . . . . . . . . . . . . . . . 113

Starting the Informix Database . . . . . . . . . . . . . . . . 113

Closing an Informix Session . . . . . . . . . . . . . . . . . . 113

Setting the Status Log File Size. . . . . . . . . . . . . . . . 114

Stopping the Volume Manager . . . . . . . . . . . . . . . . 114

Using Sun’s X.25 Tool . . . . . . . . . . . . . . . . . . . . . . 114

Monitoring System Performance. . . . . . . . . . . . . . . 115

Administering Hostnames and TCP/IP Addresses . 115

Replacing a Hard Disk. . . . . . . . . . . . . . . . . . . . . . . 116

Application-specific Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Working with Scripts, Script Groups,

and Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Managing Scripts, Script Groups, and Applications . . . 118

Creating Script Groups or Applications . . . . . . . . . 119

Starting an Application Automatically . . . . . . . . . . 121

Starting a Script Group or Application Manually . . 122

Stopping a Script Group or Application . . . . . . . . . 122

Starting a Single Script . . . . . . . . . . . . . . . . . . . . . . 123

Stopping a Single Script . . . . . . . . . . . . . . . . . . . . . 124

Deleting a Script from a Script Group. . . . . . . . . . . 125

Deleting a Script Group. . . . . . . . . . . . . . . . . . . . . . 125

Shutting Down All Active Sessions . . . . . . . . . . . . 126

Shutting Down a Script Group . . . . . . . . . . . . . . . . 126

Monitoring Scripts, Script Groups, and Applications . . 127

Creating, Opening, and Deleting Scripts. . . . . . . . . 127

Starting Scripts in Test Mode . . . . . . . . . . . . . . . . . 128

APS (Application Plus Server) 4.1 Users Guide

viii 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

Stopping a Script in Test Mode . . . . . . . . . . . . . . . . 128

Monitoring a Script Session. . . . . . . . . . . . . . . . . . . 129

Monitoring a Script with the X.25 Trace Tool. . . . . 129

Checking an Application’s Runtime Status. . . . . . . 129

Checking an Application’s Runtime Status

by Process Level . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Checking an Application’s Runtime Status

by Usage Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Debugging Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Working with Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Viewing the Profile Window . . . . . . . . . . . . . . . . . . 134

Renaming Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Modifying Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . 135

Creating New Profiles . . . . . . . . . . . . . . . . . . . . . . . 136

Importing and Exporting Data . . . . . . . . . . . . . . . . . . . . . . . 138

Importing Application-specific Utilities . . . . . . . . . 138

Importing Scripts. . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Copying Scripts to a Diskette . . . . . . . . . . . . . . . . . 139

Backing Up Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Backing Up APS Files. . . . . . . . . . . . . . . . . . . . . . . 140

Regular Backup of APS. . . . . . . . . . . . . . . . . . . . . . 140

Registration and Licensing Tasks . . . . . . . . . . . . . . . . . . . . . 141

Registering APS Software. . . . . . . . . . . . . . . . . . . . 141

Checking the License. . . . . . . . . . . . . . . . . . . . . . . . 142

SS7 Gateway Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Changing an SS7 Configuration File. . . . . . . . . . . . 145

Configuring the SS7 Gateway. . . . . . . . . . . . . . . . . 146

Starting and Stopping the SS7 Gateway . . . . . . . . . 147

Administering the Signaling Point Code. . . . . . . . . 148

Monitoring SS7 Gateway . . . . . . . . . . . . . . . . . . . . 150

Displaying the State of the SS7 Links. . . . . . . . . . . 151

Changing the State of the SS7 Links. . . . . . . . . . . . 151

Application Manager Tasks . . . . . . . . . . . . . . . . . . . . . . . . . 156

Starting and Stopping the Application Manager . . . 156

Checking the Application Manager’s

Runtime Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Logger Manager Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Starting and Stopping the Logger Manager. . . . . . . 159

Checking Logger Manager Status . . . . . . . . . . . . . . 159

101-1830-001 Issue 1.0 ix101-1830-001 Issue 1.0

Cron Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161

Starting and Stopping Cron Tasks. . . . . . . . . . . . . . .161

Modifying Cron Tasks. . . . . . . . . . . . . . . . . . . . . . . .161

Monitoring Cron Task Status . . . . . . . . . . . . . . . . . .163

Using SQL Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164

Executing SQL Commands Without Output. . . . . . .164

Executing SQL Queries With Output . . . . . . . . . . . .165

Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167

Configuring Printers . . . . . . . . . . . . . . . . . . . . . . . . .167

Printing a Script . . . . . . . . . . . . . . . . . . . . . . . . . . . .168

Viewing Logs and Script Information . . . . . . . . . . . . . . . . . .169

Viewing the Status Log File . . . . . . . . . . . . . . . . . . .169

Viewing Script Information. . . . . . . . . . . . . . . . . . . .171

Viewing the Debug Log . . . . . . . . . . . . . . . . . . . . . .173

Chapter 5 Troubleshooting

Starting and Stopping the Sun System. . . . . . . . . . . . . . . . . .176

Starting the APS Sun System . . . . . . . . . . . . . . . . . . . . .176

Starting the ERP Sun System . . . . . . . . . . . . . . . . . . . . .177

Rebooting the Sun System. . . . . . . . . . . . . . . . . . . . . . . .177

Graceful Reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . .178

Hard or Emergency Reboot. . . . . . . . . . . . . . . . . . . .178

Shutting Down the APS Sun System. . . . . . . . . . . . . . . .179

Shutting Down the ERP Sun System. . . . . . . . . . . . . . . .180

Shutting Down the X.25 Links . . . . . . . . . . . . . . . . . . . .180

Tracking APS Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . .181

General Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . .181

Keeping Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181

Checking Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . .181

Starting Two APS Sessions . . . . . . . . . . . . . . . . . . . . . . .182

Troubleshooting Connectivity Problems . . . . . . . . . . . . . . . .183

No Connectivity Between APS Machine and Sierra/CA 184

For Sites That Use X.25. . . . . . . . . . . . . . . . . . . . . . . . . .186

Check the X.25 Physical Connectivity . . . . . . . . . . .186

From the APS, Check the Link. . . . . . . . . . . . . . . . .186

From the Sierra/CA, Check the Link . . . . . . . . . . . .187

Place a Test Call Over the X.25 Link . . . . . . . . . . . .188

APS (Application Plus Server) 4.1 Users Guide

x 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

Escalate the Problem . . . . . . . . . . . . . . . . . . . . . . . . 189

For Sites That Use TCP/IP. . . . . . . . . . . . . . . . . . . . . . . 190

Check TCP/IP Physical Connectivity . . . . . . . . . . . 190

From the Sierra/CA, Check TCP/IP . . . . . . . . . . . . 190

From the APS, Check the TCP/IP . . . . . . . . . . . . . . 190

Check the Application’s Profiles. . . . . . . . . . . . . . . 191

Place a Test Call Over the TCP/IP Link . . . . . . . . . 191

Escalate the Problem . . . . . . . . . . . . . . . . . . . . . . . . 192

Remote User Cannot Connect to APS Machine. . . . . . . 193

APS Cannot Connect to LAN/WAN . . . . . . . . . . . . . . . 195

APS Cannot Communicate With HLR. . . . . . . . . . . . . . 196

No Prompt When Accessing APS Over the Modem . . . 198

Troubleshooting Software Problems. . . . . . . . . . . . . . . . . . . 200

Loss of System Heartbeat. . . . . . . . . . . . . . . . . . . . . . . . 200

Call Tracing TCAP Messages . . . . . . . . . . . . . . . . . . . . 201

Cannot Start Application Manager. . . . . . . . . . . . . . . . . 203

Cannot Load SS7 Drivers. . . . . . . . . . . . . . . . . . . . . . . . 205

Troubleshooting Hardware Problems. . . . . . . . . . . . . . . . . . 206

Sun Reboots Without Warning. . . . . . . . . . . . . . . . . . . . 206

Common Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

General Notes about Replacing Cards . . . . . . . . . . . . . . 207

Replacing the NewNet Card. . . . . . . . . . . . . . . . . . . . . . 209

Replacing the X.25 Card . . . . . . . . . . . . . . . . . . . . . . . . 210

Replacing the TCP/IP Card . . . . . . . . . . . . . . . . . . . . . . 210

Cleaning the Tape Drive. . . . . . . . . . . . . . . . . . . . . . . . . 211

Chapter 6 Backing Up and Restoring Data

Backing Up and Restoring the Sun System . . . . . . . . . . 213

Automatic Backups . . . . . . . . . . . . . . . . . . . . . . . . . 214

Making Manual Backups. . . . . . . . . . . . . . . . . . . . . 214

Restoring a Full or Partial Image . . . . . . . . . . . . . . . . . 215

Full System Installation and Setup . . . . . . . . . . . . . 215

Full System Recovery (no setup). . . . . . . . . . . . . . . 216

Partial System Recovery and Setup. . . . . . . . . . . . . 216

Partial System Recovery (no setup). . . . . . . . . . . . . 216

APS Backup and Restore . . . . . . . . . . . . . . . . . . . . . . . . 216

Backing Up Only APS 4.1. . . . . . . . . . . . . . . . . . . . 216

101-1830-001 Issue 1.0 xi101-1830-001 Issue 1.0

Restoring Only APS 4.1 Data . . . . . . . . . . . . . . . . .216

Informix Software Backup and Restore . . . . . . . . . . . . .217

Informix Database Backup and Restore . . . . . . . . . . . . .217

Example Output of a Database Restore . . . . . . . . . .217

Example Output of

install_fs:full recovery, (setup) . . . . . . . . . . . . . . . . .218

Example Output of

install_fs:full recovery (no setup) . . . . . . . . . . . . . . .221

Example Output of

install_fs:partial recovery (setup) . . . . . . . . . . . . . . .223

Example Output of

install_fs, partial recovery (no setup) . . . . . . . . . . . .226

Chapter 7 Errors

The Status Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229

Description of the Status Log File. . . . . . . . . . . . . . . . . .229

File Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230

Specifying an ASCII Format. . . . . . . . . . . . . . . . . . .230

What Makes Up an Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . .231

Message Syntax for Alarms. . . . . . . . . . . . . . . . . . . . . . .231

Interpreting an Error with Status Log File Codes . . . . . .232

Status Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233

Module Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233

Error Code Ranges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235

Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237

Development Alarms . . . . . . . . . . . . . . . . . . . . . . . .238

Error Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239

200001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243

200005. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244

200008. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245

400000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246

501001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247

501002. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250

501006. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251

501012. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252

501013. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253

501020. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254

503001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255

APS (Application Plus Server) 4.1 Users Guide

xii 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

505001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

505002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

505005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

505011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

506002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

506003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

506004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

506005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

506006 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

506007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

506011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

508001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

508002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

508003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

508004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

508005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

517003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

518003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

518004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

518005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

518006 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

518007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

518010 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

523000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

5230002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

5230003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

5230005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

5230008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

5230012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

524027 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

600000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

600001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

600002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

600003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

600004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

600010 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

600011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

600012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

101-1830-001 Issue 1.0 xiii101-1830-001 Issue 1.0

600013. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299

600014. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .300

600015. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301

600016. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302

600017. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303

600018. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304

600019. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305

600020. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306

600021. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307

600022. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308

600023. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .309

600024. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310

600025. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311

600026. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312

600027. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313

600028. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314

600029. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315

600030. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316

600031. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317

600032. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .318

600033. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319

600034. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320

600035. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321

600037. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .322

600038. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323

600039. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324

600040. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325

600041. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326

600042. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327

700001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329

700002. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330

700003. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331

700004. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .332

700005. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333

700006. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .334

700007. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .335

700008. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .336

Passive Alarm Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . .337

APS (Application Plus Server) 4.1 Users Guide

xiv 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

EAP-related Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

Interpreting EAP Errors . . . . . . . . . . . . . . . . . . . . . . . . . 338

Resolving EAP-related Errors . . . . . . . . . . . . . . . . . . . . 343

TCAP Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

TCAP Return Error Codes. . . . . . . . . . . . . . . . . . . . 345

TCAP Access Denied Reasons . . . . . . . . . . . . . . . . 346

TCAP Non-requested Specific Errors . . . . . . . . . . . 346

Appendix A Enhanced Reporting Platform

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

Advantages of ERP . . . . . . . . . . . . . . . . . . . . . . . . . 348

Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

Processing Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

Assembling the ERP Hardware . . . . . . . . . . . . . . . . . . . . . . 350

Cabling the ERP System. . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

Installing and Administering ERP . . . . . . . . . . . . . . . . . . . . 352

Phase I Installation Procedures . . . . . . . . . . . . . . . . . . . 352

Required Items and Information . . . . . . . . . . . . . . . 352

Loading the ERP System. . . . . . . . . . . . . . . . . . . . . 353

Loading ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

Installing the License Information. . . . . . . . . . . . . . 355

Phase II Installation Procedures. . . . . . . . . . . . . . . . . . . 358

Phase III Installation Procedures . . . . . . . . . . . . . . . . . . 360

Configuration File Description . . . . . . . . . . . . . . . . 360

Report Executables . . . . . . . . . . . . . . . . . . . . . . . . . 364

Administering Reports. . . . . . . . . . . . . . . . . . . . . . . 366

Uninstall Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

Executing ERP Software . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

Error Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

Backup and Restore Procedures . . . . . . . . . . . . . . . . . . . . . . 372

Backing Up ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Full Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Restoring ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Partial Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Full Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Troubleshooting ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

101-1830-001 Issue 1.0 xv101-1830-001 Issue 1.0

Developing Custom Reports . . . . . . . . . . . . . . . . . . . . . . . . .377

Relinking with Logging Stub . . . . . . . . . . . . . . . . . .377

Indexing on hr_int. . . . . . . . . . . . . . . . . . . . . . . . . . .377

Glossary, Abbreviations, and Acronyms . . . . . . . . . . . . . . . . . 379

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

APS (Application Plus Server) 4.1 Users Guide

xvi 101-1830-001 Issue 1.0101-1830-001 Issue 1.0

101-1830-001 Issue 1.0 17

About This Book

This manual describes the Application Plus Server (APS) 4.1 software

platform. Use this manual with applications such as Inbound Call

Completion (ICC) 1.1.

Audience Statement

This documentation is written for the following audiences:

This guide is not intended for programmers developing custom

applications or for the end customer with the exception of the customer as

maintainer.

Software support staff Both onsite and remote. This

audience is familiar with

programming wizards, may or

may not be familiar with the

C programming language, and

has an intermediate understanding

of UNIX or SunOS. Specifically,

this audience includes application

programmers, application

maintainers, and members of RSC

(Regional Service Center).

Platform maintainers Lucent employees or customers

who maintain the APS platform

software at APS sites

Lucent’s applications sales force Lucent employees who market

APS (Application Plus Server)

software and its applications

APS (Application Plus Server) 4.1 Users Guide

18 101-1830-001 Issue 1.0

In general, the audience for this book should have the following

experience and expertise:

n Sun system administration

n Beginning-level Sierra and CA (Caller Applications)

maintenance knowledge

n X.25 networking experience

n TCP/IP networking experience

n Knowledge of SS7 (Signaling System 7) protocol, including HLR

(Home Location Register)

n Beginning understanding of relational database commands

n Beginning understanding of C programming language

n Basic techniques for handling hardware and electrical

components

Purpose Statement

The purpose of this document is to:

n Help the onsite work force, system administrator, or programmer

to use the APS platform software

n Instruct an installer how to load new versions and upgrade

previous versions of APS in 2 hours or less

n Provide a reference to alarms generated by the APS platform

software

n Provide fault isolation and problem-solving procedures for

troubleshooting errors

This guide does not discuss the Sun hardware components of the APS

system. Please refer to the documentation that came with your hardware.

101-1830-001 Issue 1.0 19

Help and Technical Support

You can reach Lucent Octel Messaging Division (OMD) by phone, fax,

e-mail, and the Internet.

For telephone assistance about APS software:

Call 408-922-1822.

This is the Lucent Technologies OMD help line.

Press 1 (Sierra menu option ) and then 4 (Direct Support menu

option) to navigate the phone menu.

Have ready:

n The serial number of the Sierra/CA

n Which Sierra/CA you are calling on

n The APS system’s serial number

For specific training information:

Call 1-800-OCTEL92 (1-800-628-3592), or 1-408-324-6572

To reach us by e-mail:

Address us at educational.services@octel.com

For documentation:

Call 1-800-41-OCTEL (US only)

Call 1-303-294-3735 (International)

To fax an order:

Dial 1-303-294-3737 (US and International)

If you have world wide web access go to:

http://merchant.hibbertco.com/octel/

To return to the APS help system, use the Back button in the

browser interface, or click on the Company Store book icon in the

help system navigation pane.

APS (Application Plus Server) 4.1 Users Guide

20 101-1830-001 Issue 1.0

Conventions

This book uses the following conventions:

n The term Sierra refers to a Sierra VPM (voice processing

module).

n The term CA stands for Caller Applications VPM and was

formerly known as IMA-CA (Intelligent Messaging

Architecture-Caller Applications).

n The term Sierra/CA means either a Sierra VPM or CA VPM.

n Keys on the keyboard are all capitals:

ENTER.

n When you must press two keys at the same time, it looks like this:

STOP+a

n When you are told to enter a command, it means type the

command on the command line and then press the ENTER key.

n Commands are bold, regular typeface, variables in a command

line are bold and italicized:

snoop -d hme0 -x 0 > /export/home0/issg/issg_main/test.ossg

n Menu names are capitalized

n Menu items are capitalized

n Field names use Courier type:

...the Script Name field...

n Menu selections look like this:

Utility

Export

Page is loading ...

Lucent Technologies AP-5 User manual

This manual is also suitable for

Lucent Technologies AP-5 User manual

Related papers

Other documents