2. Computers & electronics
  3. Software
  4. Software manuals
  5. Lucent Technologies
  6. AP-6
AP-6

Lucent Technologies AP-6, AP-3, AP-4, AP-5 User manual

  • Hello! I am an AI chatbot trained to assist you with the Lucent Technologies AP-6 User manual. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
APS (Application Plus Server) 4.1
Users Guide
101-1830-001
Issue 1.0
June 1999
Copyright 1999, Lucent Technologies
All Rights Reserved, Printed in U.S.A.
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
/