Académique Documents
Professionnel Documents
Culture Documents
2 Support Guide
V1.0
Author: TOPS SER PTS Nice Date: 04/2005 Published by: AMADEUS s.a.s 155 Route du Pin Montard B.P. 69 06902 Sophia Antipolis FRANCE
REVISION HISTORY
Page 2/68
Contents
1. INTRODUCTION.............................................................................................. 5 1.1 1.2 1.3 2.1 2.2 2.3 3.1 3.2 3.3 4.1 4.2 4.3 4.4 4.5 5.1 5.2 5.3 5.4 5.5 5.6 6.1 ABOUT THIS GUIDE ....................................................................................... 5 INTENDED AUDIENCE ..................................................................................... 5 ASSOCIATED DOCUMENTS ............................................................................. 5 GLOBAL ARCHITECTURE ................................................................................ 6 VISTA CLIENT ARCHITECTURE ........................................................................ 6 SERVER ARCHITECTURE ................................................................................ 6 GOOD INSTALLATION ..................................................................................... 6 CLIENT HAS A HWID BUT HAS NOT MIGRATED YET ........................................ 6 BAD INSTALLATION (NO MIGRATION OR REGISTRATION) .................................. 6 STARTING VISTA W ITH PARAMETERS.............................................................. 6 WELCOME PAGE FLOWCHART ........................................................................ 6 WINDOWS XP, VISTA 2.2P200 AND AMADEUSLAUNCHER ............................... 6 WINDOWS XP SP2 CASE .............................................................................. 6 VISTA SHELL FLOWCHART ............................................................................. 6 INSTALLATION ............................................................................................... 6 STARTUP...................................................................................................... 6 CONFIGURATION FILE .................................................................................... 6 LOG FILE ...................................................................................................... 6 DEFAULT CONFIGURATION VALUE .................................................................. 6 CONCEPT DIAGRAM ...................................................................................... 6 VISTA 2.X CID MIGRATION ............................................................................. 6
2. VISTA ARCHITECTURE.................................................................................. 6
6. UPGRADING FROM VISTA 2.0 OR 2.1 .......................................................... 6 7. FAQ.................................................................................................................. 6 8. TROUBLESHOOTING ..................................................................................... 6 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 DIAGNOSTIC PAGE ........................................................................................ 6 VISTA GUI DEBUG PAGE ............................................................................... 6 VISTA CP CONFIGURATION PAGE ................................................................... 6 VISTA CP DEBUG PAGE ................................................................................ 6 VISTA TN3270 EMULATOR PROPERTY PAGE .................................................. 6 CHECKING W EB CONFIG DATA ....................................................................... 6 LOCAL DATA ................................................................................................. 6 VISTA ERROR CODE RANGES ........................................................................ 6
Page 3/68
APPENDIX B. START-UP ERRORS ..................................................................... 6 APPENDIX C. COMMAND PAGE ERRORS ......................................................... 6 APPENDIX D. TN3270 EMULATOR ERRORS ..................................................... 6 APPENDIX E. COMCORE CLIENT COMMUNICATION ERRORS (10002999) . 6 APPENDIX F. WASH CLIENT COMMUNICATION ERRORS (10002999) ........ 6 APPENDIX G. SPECIFIC SERVER OBJECT ERRORS (60007999) .................. 6 APPENDIX H. GENERAL SERVER OBJECT ERRORS COMCORE (80008999) 6 APPENDIX I. GENERAL SERVER OBJECT ERRORS WASH (80008999) .... 6 APPENDIX J. EDIFACT HANDLER ERRORS (900011999) .............................. 6 APPENDIX K. MPCPIA ERRORS (12000-12499)................................................. 6
Page 4/68
1. Introduction
1.1 About This Guide
This guide describes the basic components and steps for supporting Amadeus Vista 2.2. This is not a functional User Guide. Printing facility is not covered by this guide, but by the Amadeus Pro Printer support guide. Vista customisation is not covered by this guide, but by the Vista Customisation Training Support document. The new features of Vista 2.2 are detailed in the Vista 2.2 installation guide and in the Vista technical release notes.
To know more on the configuration part: Host Window & Session Configuration Guide, Folders XML Configuration Guide, Smart Keys XML Configuration Guide, Toolbars XML Configuration Guide.
2. Vista Architecture
ICSAT
WC DB 1A Central System API ComCore Components S-K DB Wash
Data (SOAP/HTTPS)
ComCore Ext.
RecordSets / HTTPS
Data XML)
ComCore
Wash
3270
UTS
Ace
Files +Ace UI Config
XChange
Vista Graphic Vista Command Page
Automaticupdate
Client
Page 6/68
Vista Server
The above drawing shows the main components of the Vista client with its two communication components: WASH and ComCore. WASH Wash is a C++ module that communicates with the Vista server in XML format. Wash is currently used by the Vista shell for all communications concerning the session as well as
Page 7/68
Amadeus Vista 2.2 Support guide by the command page for all cryptic commands. WASH is also the component communicating with the Security Gateway modules to get the list of ATIDs associated with the Hardware ID on the machine.
ComCore The Com Core Proxy is a Visual Basic module being used for communication by all graphical components in Vista. The ComCore proxy is instantiated by the Vista shell when the first component makes a request to it (this means the first functional call made by a graphical module e.g. Retrieve PNR, Air availability etc.).
Xchange Xchange is a C++ ActiveX that is responsible for the cross component communication within the application.
Vista Server
Utilities (Certificates / Tokens) Web Config (Deployment / Configuration) Agent Smart Keys (Wash: SOAP XML) Microsoft IIIS START Transactions (SOAP XML) GUI Transactions (ComCore: MS Recordset) 1ACA Cryptic Transactions (Wash: SOAP XML) Customer Profiles (ComCore) TCP / I-EDI WebConf SQL
Agent Smart Keys START SIP TPF Front End START ASW
TCP / XML
Vista client
TCP / I-EDI
TCP / I-EDI
CSX
Page 8/68
Clicking on the version will display a HWID/CID information page. This page can be used to quickly troubleshoot the client installation.
Page 9/68
Page 10/68
Page 11/68
To supply parameters to the Vista URL you have to specify the web site entry page followed by ? and then each parameter, separated by &: http://amadeusvista.com/?BYPASS=1&XML_CONF=D:\Vista\ResSeparation\WebConf.xml
The parameters available are: BYPASS: If set to 1, the Welcome Page is not displayed and Vista is automatically started. http://amadeusvista.com/?BYPASS=1 DEVEL_PATH: This gives the possibility to specify a source code different than the standard Vista installation that you wish to run. http://amadeusvista.com/?DEVEL_PATH=D:\Vista\VistaDev XML_CONF: This allows running a local Web Config date file: http://amadeusvista.com/?XML_CONF=D:\Vista\ResSeparation\WebConf.xml PACKAGE_DEF: This allows you to specify a file that will allow the overriding of the installed component list returned by Automatic Update. http://amadeusvista.com/?PACKAGE_DEF=D:\Vista\ResSeparation\PackageDef.x ml The packagedef file has the following format: <ComponentList> <Component> <name>PNR</name> </Component> <Component> <name>AIR</name> </Component> </ComponentList>
Page 12/68
XXXXXX.amadeusvista.com/german
*
?LANGUAGE=DE
no
Copyright 2004 - AMADEUS s.a.s All Rights reserved Unauthorized use and disclosure strictly forbidden
XXXXXX.amadeusvista.com
yes
germanstart.htm
start.htm
no
no Au installed yes yes /germanOld redirection yes /VWP redirection AU.setWebServer (using XXXXX.) WEBCONFIG (XXXXX.amadeusvista.com
Registration Site redirection (ALWAYS PRODUCTION) AU.setWebServer (using XXXXX.) Old German Welcome Page
AU.forceUpdate
deployment check
no
language?
language?
language
SUPPORTED LANGUAGE NON SUPPORTED OR ENGLISH SUPPORTED translated/ customized Welcome Page NON SUPPORTED OR ENGLISH
SUPPORTED
In those cases the registration site includes a text explaining why the user has been redirected
this page is actually a call to the "Common" Welcome Page where the language is forced (See )
certificates.amadeusvista.com/sgwadmin
Vista WP flow
manual registration
German flow
Registration Site
Page 13/68
Amadeus Vista 2.2 Support guide Important remarks (doesnt concern German page)
If no Vista product is installed, the page is redirected to the old Welcome Page. If Automatic Update is not installed, or if the Vista release is below 2.2, the old Welcome Page is displayed. Automatic Update is no longer installed, started nor synchronized from the Welcome Page. If Vista is launched, but Automatic Update is not started, a Vista error WCG001 is displayed. The page is displayed in the language of the product installed (for supported languages). The URL of the old Welcome Page is *.amadeusvista.com/VWP.
Vista 2.2P200 runs natively on Service Pack2. From this version, when Vista is started on a Windows XP workstation (not only SP2), a new program called AmadeusLauncher is started. This tool embeds an Internet Explorer control and will replace Internet Explorer to display the screens. When running Vista through AmadeusLauncher, the Internet Explorer name is removed from the Windows title. Vista running in AmadeusLauncher:
Page 14/68
The AmadeusLauncher is installed with Automatic Update since 2.4P200 release. The executable file (AmadeusLauncher.exe) is located in the Automatic Update kernel directory.
For some components using JavaApplets (German market), it may be necessary to update a display setting to solve a flickering problem (PTR1309375): Open the Display Properties window (through the control panel), go to the Effects tab, and uncheck Show window contents while dragging.
Page 15/68
no
Force launcher?(*)
No
Is XP SP2?
yes
no
no
yes
yes
Use Open windowin IE for launching Vista (****) yes is AU version >= 2.4P200?
no
yes
Figure 1: SP2 Patch and Launch flow (*) The force launcher parameter is passed in the URL when calling the welcome page. For example: amadeusvista.com?LAUNCHER=Y (**) When an action is done concerning the SP2 patch (apply or remove) a flag is set through an xml persistent object. This object can be only accessed from the creator URL. (***) This action is not changed from the way it for SP2 and Vista below 2.2P200. A patch is applied in the registry and the client is marked as applied. For more information refer to SP2 patch documents.
Page 16/68
Amadeus Vista 2.2 Support guide (****) It is the same way of launching Vista as today for all versions of Vista previous to V2.2P100. No Launcher used.
Removing the Amadeus patch means that the Windows registry keys modified by the patch are set to the Microsoft default value:
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Lockdown_Zones\0]
"2101"=dword:00000003 [HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Zones\0] "2101"=dword:00000003 [HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_LOCALMACHINE_LOCKDOWN] "iexplore.exe"=dword:00000001
The Amadeus patch for XP SP2 is also currently mandatory to run Cruise. As Vista 2.2P200 remove the patch, Cruise may not work anymore as a standalone application unless reapplying the patch. The workaround is to run Cruise inside Vista 2.2P200 until the new Cruise Welcome Page (Cruise 3.7 and future 3.8) is released. This means that there are now dependencies between Vista and Cruise releases. Please refer to the Cruise documentation for more information.
A support page is available on the Vista or Cruise welcome page through a hidden link: http://amadeusvista.com/vwps_common/xpsp2.htm .This page can be used to detect or install the patch manually. More information can be found in the Amadeus Upgrade for XP SP2 Support document.
Page 17/68
: T/A LoadWindow( )
: Vista
: WebConfManagement
: Travel
: securityutils.js
: Wash
: signin.htm
: workArea
initialize( )
If not already signed, shows modal dialog signin.htm Display signin ProceedAmadeusSignInRequest( )
Sign-in finished display marketing message and end of openVistaSession() loadtravelPage( ) buildVistaXML( )
will get the list of possible eggs from web conf, check against list of installed eggs from autoupdate and build list of eggs to display loadOneSet( ) loads the scriptlet that are marked as preloaded or first
load finished
Page 18/68
Amadeus Vista 2.2 Support guide The above sequence diagram shows the flow of the Vista Start up. Below, you will find a more detailed explanation of some of the key steps.
SetXchange This function will initialise Xchange with its configuration file that is found in the folder ../Xchange/Xchange_config.xml. This is the file that provides the rules for how Xchange will route its information flows. Furthermore, this function will register Xchange in the Running Objects Table. Vst_SetPropsFromURL This function parses the URL being passed from the Welcome Page to initialise Vista global parameters, and to publish these parameters in Xchange to make them available for third party components. Vst_connectWash This function instantiates the WASH client module, then passes certain parameters recuperated from the URL in the previous step to WASH, and if there is a problem with some of these parameters, WASH will return an error message. It then asks for the certificate that is available for this machine. WASH is itself handling whether there is a HWID installed and the certificates should be recuperated from the machine registry or from the Security Gateway mechanism. In the case of Security Gateway, the function will at this point be able to return the full range of SG errors (note that only the error number will correspond to the SG range with this format SG_XXXX whereas the text will be a standard line saying: The attempt to connect to the Amadeus system has failed). The next step is to handle the certificate collection being returned: If 0 are certificates returned, the function will throw the error WCG_003. If 1 certificate is returned, the function continues the start up with the CID, OFFICE and ATID of this certificate. If 2 or more certificates are returned, the function displays the certificates prompt to ask the user to select one certificate, and will then use the information from the selected certificate to continue start up. Wcm_GetWebConfData This function will use an interface of Automatic Update to get the Web Configuration data. The errors that are thrown are the following: If the response of this function is nothing, the error WCG_001 will be displayed. If there is a response but there is no value for the XML //wcfgResponse/Status/Success, the error WCG_001 will be displayed. node
If there is a response but there is no value for the XML node //wcfgResponse/Data, the error WCG_002 will be displayed.
Page 19/68
Amadeus Vista 2.2 Support guide The process that follows will be described in less detail. The first communication that is made with Central System is a request for the session information. This information will be inspected by the Vista shell to detect if the user is already signed in a work area and if he has a PNR open: If the user is signed, the sign-in screen of Vista will be bypassed and the application starts directly. If the user has a PNR open as well, the PNR module will be asked to retrieve the PNR information. If the user is not signed in, he will be prompted to through the sign in screen. After that step, a sign in request will be sent to Central System to sign in the user. Both of these requests are done through WASH and are also always immediately followed by a request to retrieve the office indicators.
Page 20/68
5.1 Installation
VTLD is distributed by Automatic Update since 2.4 release. AU installs (in its own kernel directory) and registers the VTLD_COM_Cplus_DLL.dll. Vista components will then use the logging API provided by the DLL.
5.2 Startup
When Vista is started, VTLD is loaded and searches for the Vistalog.xml configuration file in the %USERPROFILE%\Application Data\Amadeus\ directory. If it is not found there, VTLD looks for it in an Amadeus folder in the system directory, then in the temporary directory. In the case where the Vistalog.xml configuration file is not found, VTLD will assume default values (see later in this chapter) for its operations and create the file in the above directory. The Vistalog.xml file indicates the log file location.
Page 21/68
The GeneralConfiguration section defines log file characteristics: VTLD location: fileName: extension True/False Enable or disable the traces, Log file directory Will be created if necessary, Log file directory, Log file extension (a character text (TAB) separated value (.CSV) file with each line representing a different record.), maxSize: defaultLevel Maximum size (KB) of the log file, Tracing level. Value are (from more to less detailed): Debug Info Warn Error Fatal The PerformanceLog is reserved for development usage.
The ComponentConfiguration section defines the log level for each individual component. If component node and level element is defined then this level will be in effect for that component. If component node is defined and level element is not defined OR component node is not defined at all, in these cases default level permissions from the GeneralConfiguration section will take effect. Also component codes and all values are case insensitive. Any problem(s) with the Configuration process will be logged as an error in VTLD output log file. Components Code can be: VLT Trace Tool SHL Shell WCL Wash client PNR ACE CCP COMcore proxy CPS Command Page Shell (Command page Area container) CPB Command Page Business CPU Command Page UI PQA Plus QC Admin PQE Plus QC RuleEditor PQR Plus QC RuleChecker SWP Simplified Welcome Page (Vista 2.2) SLB SGLib (into SGDLL and WASH) for SGW functionalities SLT SGLibLite (into the WASH proxy, AU and CCCert) for migration and registration SGD SGDLL (called by the CC proxy to access SGW functionalities) SGI SGInterface (VB cls into the CC proxy) SGE SGExe.exe (from AU) Level values are the same as in the <GeneralConfiguration> section.
Page 22/68
Record Format: Type Date Time MessageType: Size Date(9) Time 24 hr(12) char(1) Description DdMMMyyyy hh:mm:ss.ms A one character as follows: F Fatal E Error W Warning I Info D Debug Component code should match the XML definition for overwriting defaults. Internally it will identify ComponentCode with FIRST 3 letters for config level purposes. Component version code. The ErrorCode is generated by appending the following information: ComponentCode.ErrorNumber.Occurance Source File Name. Function Name. LineNumber(C++) or Localisation. The FreeFlow message to be written. Excel cell will be limited to 30000 char (Excel 8.0 and onward). MAX FreeFlow Cells numbers will be kept at 200. Double quote free flow text in each cell. Replace any Tab with Space within Free flow. Also replace any Double quote as part of free flow text with 2 Double quotes.
ComponentCode
String(8)
ComponentVersion ErrorCode
String(12) String(20)
Page 23/68
<PerformanceLog> active: subtasks: snapshots: file: maxStackSize: FALSE FALSE FALSE PerfLog 50
Page 24/68
VLTD management
Com Interface
VTLD_ReloadConfiguration
Com Component
XML Config
Vista Components
Vista Client
Page 25/68
Page 26/68
7. FAQ
Can I run multiple front-office products on the same workstation? Amadeus does not support the installation of several front-office products on the same PC: it is not possible to install Amadeus Pro Tempo, Amadeus Pro Web and/or Amadeus Vista on the same computer. If for instance a PC is installed with Amadeus Pro Tempo, the application has to be removed first before installing a new product like Amadeus Vista.
This generally occurs when Automatic Update is stopped, Check that Automatic Update is up and running, See Error chapter of this guide to get more information.
This error generally occurs when the Amadeus Root Certification Authority is not installed. Install the Amadeus Root CA.
Page 27/68
The HWID is configured with high encryption but the certificate can not be found. Check that the certificate is installed. If not installed, reissue/reinstall the HWID.
The HWID has been reissued but not reinstalled. Register again the CID.
Hotel picture or map are not displayed Internet access is required to access hotel multimedia feature. Check the network requirement in the installation guide.
How to reinstall Automatic Update Automatic Update is not anymore installed from the Welcome Page. If you want to reinstall it: Go to the SGW registration site, Move the cursor over the registration site logo, Hold the Shift key and click on left button of the mouse, Click on the new link that appears at the bottom of the page. (See picture on the next page)
Page 28/68
Page 29/68
8. Troubleshooting
8.1 Diagnostic Page
Before any troubleshooting, use the Amadeus diagnostic page to check that all Vista requirements are fulfilled. Refer to Amadeus diagnostic page technical documentation.
Page 30/68
Page 31/68
Page 32/68
Checking the products and components deployed for a CID http://amadeusvista.com/WebConfV1/wcfgGetDeployedComponent.asp?CertificateId=theci d&ModifCounter=0
UserData Persistence Vista options like the Vista tabs order, User sign-in parameters. Hotel preferences.
Page 33/68
Amadeus Vista 2.2 Support guide This mechanism of Internet Explorer stores data on the directory %userprofile%\UserData\XXXX. The data are stored in the XML file, accessible only by the Web sites that created them. This caching has priority over the data coming from Web Config unless some major changes have been made in the data. If a vendor wants to change the egg that is being displayed by default for the clients, the change will not take effect for most of the clients because their local cache will override the Web Config data. If you suspect that the local cache is causing problems, delete the Userdata directory. This directory will be automatically recreated but all data customised through this mecanism will be lost. Cookies Command Page customisation like fonts/colours used. Cookies store data in text files located under the %userprofile%\Cookies directory. Internet Explorer should be configured to accept cookies. Moreover, the Internet Explorer Internet Options window allows the deletion of all cookies.
Security Gateway client errors Security Gateway server errors Specific server object errors General server COMCore/WASH object
Page 34/68
Appendix A.
IE Scripts Errors
Important notice: An IE java script error message will be displayed in the Vista application window only if the advanced option Display notification on every script error is checked. Each time the application is not working, this advanced option should be checked to detect script errors.
If a JavaScript error occurs on the client, IE will display an error message box as below. Report the error to support teams with all information provided (You may have to click on Show Details command button to view details).
or:
Page 35/68
Appendix B.
Error WCG_001 Description
Start-up Errors
No answer from the Web Config server. Automatic Update is not running or doesnt have access to Web Conf. The version of the product installed is different than the version deployed in Web Config. Check that Automatic Update is started, Look for errors in the Automatic Update log file.
WCG_002
The Web Config data returned are not correct. Delete the Automatic Update cache. Check the Web Config deployment and configuration.
WCG_003
No HWID or CID available. No CID is attached to the HWID. Check the security gateway environment, Check through the a CID is attached to the HWID.
Page 36/68
Appendix C.
This list of errors is extracted from the Pro Web support document and some errors are not applicable to Vista. Number Message / Description Probable cause Recommended actions
<rc> (any)
There has been an error <rc> on initialisation of the SmartKey API application server. Description : <e.description> If this continues to happen please contact your help desk.
SmartKey WASH server service cant be reached. Report to WASH error message section for details, WASH error number is given by rc value.
alert
Error: The requested Command Page server version ("Version directory name") does not exist on the server. Please contact your Amadeus help desk.
1. Version parameter value provided within the Pro Web Url does not exist on the server (directory). 2. Problem with Microsoft XML Dom object (unable to uncompress XML file).
Re install IE.
The Certificate being checked is not valid. Please contact your help desk.
For Vista CmdPage : Command page cant find a certificate from WASH certificate collection with a CID that mach the one selected on GUI side and used by CCCert4. For Vista/ProWeb: Same as above but certificate cant be found because of an error in WASH cert while calling LoadCertificateList method.
COM Components (ActiveX dlls) that belong to Emulator 3270 Web Components not installed or registered on the client machine.
Page 37/68
Amadeus Vista 2.2 Support guide Number Message / Description Probable cause Recommended actions
COM Components (ActiveX dlls) that belong to Emulator 4505 or Client4505API Web Components not installed or registered on the client machine.
COM Components (ActiveX dlls) that belong to CmdPageUI Web Components not installed or registered on the client machine.
COM Components (ActiveX dlls) that belong to Emulator 4505 or Client4505API Web Components not installed or registered on the client machine.
Idem description.
The switch to session [SessionName] is not possible because no Certificates match your session definition. Please contact your Help Desk.
Idem description.
Check Host-OfficeId attribute definition in HostList WebConf component. OfficeId attribute value must match with one of the Office attached to the client certificates.
10
1) No Certificates installed on the client PC are deployed on Pro Web product. 2) Activation date not reached. 3) Automatic Update unable to install Pro Web.
Deploy the certificate. Wait until activation date Refers to Automatic Update trouble shooting documentation.
21
Forces reinstall.
Page 38/68
Amadeus Vista 2.2 Support guide Number Message / Description Probable cause Recommended actions
22
The Smartkey Parser Module is not installed. Please contact your help desk.
Forces reinstall.
23
The Macro Parser Module is not installed. Please contact your help desk.
Forces reinstall.
100
Could not create object ProgId=<ProgId>. Object is not installed on the machine.
A ScriptCOM is configured but COM object not installed on client machine. The other possibility is that the ScriptCOM parameters are not valid.
Check in registry if ScriptCOM correctly installed/registered. Check in WebConf ScriptCOM element definition.
101
Could not find method to call for object ProgId=<ProgId>. Check your configuration.
A ScriptCOM is configured but COM object method not found. The other possibility is that the ScriptCOM parameters are not valid.
102
Could not launch COM object <ProgId> <Method><Params> Method or parameters invalid. Error description : <description>
Parameters given to COM object are not defined in the COM object interface or COM object crashes. Error description displayed gives the system error description.
103
<ScriptName> script is not installed on the machine or the System PATH variable is not correctly set.
Check EXE is installed on the client machine at the given path. If no path is given in the WebConfig it should be installed on one of the system path or the system PATH variable must contain the script path.
200
No configuration available.
Certificate selected not deployed. Open more detail section to see the exact cause. A certificate has been reissued and installed on the client PC, WebConf System not already refreshed with the active status (update performed each hour).
Page 39/68
Amadeus Vista 2.2 Support guide Number Message / Description Probable cause Recommended actions
210
Config error in Folder component for ScriptFolderItem with wcfgIndex=xx. There is no Script Element node defined.
Add missing Script element configuration in Folder component, or remove ScriptFolderItem element that caused the error. Add missing ScriptEXE/COM/URL element configuration in Folder component, or remove ScriptFolderItem element that caused the error.
211
Config error in Folder component for ScriptFolderItem with wcfgIndex=xx. There is no ScriptEXE or ScriptCOM or ScriptURL Element node defined.
300
Command page Error: No Host defined in your configuration. Please ensure one of the optional emulators is deployed for your terminal.
No Emulator deployed.
Deploy one of the optional Emulator from Web Conf for this terminal. Do a force Update from Automatic Update window.
Page 40/68
Appendix D.
Number 1
Message / Description The configuration of the emulator is not correct. Please verify xxx.
Further information At the end of this message you will see which items will need to be verified. This will be one or both of the following: Host name, Host Ip number.
The emulator was not able to start a connection, as there is a network problem. Check : The network / modem cable correctly attached. There have been no network error messages shown by the OS.
There is no answer coming back from the host system. A connection is not possible. Check : The host can be seen by doing an "nslookup" from a command prompt. The host name is correct in the configuration.
The address of this Host cannot be found. xxx Please verify the configuration.
The host name given in the configuration (xxx) is not visible on the network. A connection is not possible. Check : The host name is correct in the configuration.
Page 41/68
Number 5
Further information The emulator has successfully connected to the host but, during negotiation, the host has refused the access to a specific LU/session. The host will return the reason, which will be displayed as well. The user has clicked on "Disconnect".
The connection to the Host system has been closed by user request. The cursor is in the wrong place. Press Reset, or move the cursor.
The cursor was in a protected area of the screen when the user tried to enter a character. The keyboard will be locked until the cursor is moved or the 'Reset' key is pressed. The keyboard is in 'Insert' mode and the field where the cursor is, is full. The keyboard will be locked until; either the cursor is moved, the 'Reset' key is pressed, or the insert key is pressed to go to 'overwrite' mode. The field where the cursor is is a numeric field. Thus, only numeric characters can be entered into it. The keyboard will be locked until either the cursor is moved or the 'Reset' key is pressed. The emulator is in the process of communicating with the host. During this time, the keyboard is locked and no change of the presentation space is permitted. This is the 'X: SYSTEM' message as seen in PCom. Here, the host has sent data to the emulator, but has not indicated that the keyboard can be unlocked. You can wait for the host to unlock the keyboard or press the 'Reset' key. A problem has been detected by the security package. The specific problem will be indicated here.
10
only
accepts
11
There is a transaction in progress between the emulator and the Host. You are not able to modify the display at this time.
12
The keyboard has not been unlocked by the host. Press Reset, or move the cursor.
13
Page 42/68
Appendix E.
Further information Client cannot make an object call onto the Vista server. Network may be down, or Server may be down, or Server may be badly configured. Network: re-establish network connectivity. Server: re-start, or switch to hot-standby server. Check server configuration (MTS components).
1010
"A communication ConnectPooled failed. Pooled ATID mode (connection without a error has occurred." certificate) is not supported in production, so it does not occur in Version0. "An error occurred Client failed to create an Object on the server. This does not occur attempting to create when the transport is RDS/HTTP, so it does not occur in Version0. a business object." "An error occurred An object creation failed within the COMCore proxy (client piece). attempting to create Probably indicates a faulty proxy installation. a ComCore local object." On the client machine, remove all COMCore components (In the windows explorer, in c:\winnt\Downloaded Program Files, right click on components, and select 'remove'). At the next connection, a fresh proxy will be downloaded and installed. The remote server returned no data. Error in Services.ProcessRawResponse().the variant response received from COMCore server is empty. In ConnectNew() call. Check authority to do SSL, transportURL as before for 2003. An error occurred Only occurs if XML response requested, during the deserialisation while processing the process. variant response. Check VTLD log and get the line # for UnMarshalDownStreamCentralXML. Generic Error in ConnectNew(), check VTLD & Security Gateway log file.
1020
1030
1001
1088
1089
1091
Page 43/68
Further information Generic Error in SetSessionData(), check VTLD & Security Gateway log file.
1094
An error occurred Error in Marshal.UnMarshalDownStreamCentral. Check CC Log while processing the Service traces (Variant + EDIFACT) to see what was returned by the variant response. COMCore server. The variant response received from COMCore server is empty. Server Method not correctly initialised by the Client. Server Component not correctly initialised by the Client. Error in Marshal.UnMarshalDownStreamCentral. Check CC Log Service traces (Variant + EDIFACT) to see what was returned by the COMCore server.
1095
1096
1097
1098
Cannot create Failed to call CC server component remotely. Check network Server Component. connectivity. Server config. Services.Connect was not completed successfully. "The certificate on the client side is valid "The certificate on the client side is not valid" "The reference to the utils object is not valid" Re-try call to Connect.
1099
2001
2002
2003
Page 44/68
Appendix F.
Further information
Unexpected error Unexpected error. An exception has been caught in the main thread. Programmatic error. Log a PTR.
1000
Server not accessible - a request is currently in progress. Only one server request is permitted at a time for a single Wash client instance.
1099
An exception has occurred in the secondary (server communications) thread. Log a PTR.
1100
An unknown failure code has been returned from the secondary (server communications) thread. The failure code is written to the Debug field of the logged error. Log a PTR.
1101
Unexpected internal error should not get passed initialization without this parameter being defined Log a PTR.
1102
Unexpected internal error should not get passed initialisation without this parameter being defined. Log a PTR.
1103
Connector: Invalid Format of server URL supplied to initialise method is not correct. URL: Verify Web configuration of Emulator4505 component.
Page 45/68
Amadeus Vista 2.2 Support guide Number Message 1104 Connector: Unable to initialise internet access. Further information Unexpected WinInet failure. Log a PTR.
1105
Connector: Failed Unexpected WinInet failure. to connect to Log a PTR. server on URL:
1106
Connector: Failed Unexpected WinInet failure. to open http Log a PTR. request on URL: Connector: Failed Unexpected Connector failure. to add http Log a PTR. headers.
1107
1108
Connector: Failed Unexpected Connector failure. to send http Log a PTR. request on URL:
1109
Connector: Failed Unexpected Connector failure. to end http Log a PTR. request on URL:
1110
Connector: Failed Technically this means that the client has not received an to obtain acknowledgement of the tcp request that was sent. In practice this response from can have many causes, e.g.: URL: Incorrect url specified, Loss of network connectivity, This error is generated when using https protocol if the authority for the server certificate has not been installed on the client. Verify Web Configuration of Emulator4505 component and verify network, routers, proxies, firewalls. If using SSL, (i.e. internet) check that the authority for the server certificate has been installed on the client.
1111
Connector: Failed Unexpected WinInet failure. to obtain Log a PTR. response headers from URL:
1112
The tcp request has been acknowledged by the server, but the response has not arrived within the specified timeout period. Typically indicates a network connectivity problem. Verify network, routers, firewalls, proxies and server availability.
Page 46/68
Amadeus Vista 2.2 Support guide Number Message 1113 Further information
Http Error: Status An http status other than 200 was received from the server. The code = is included in the message and, if available, the description Do the appropriate checks depending on the Http error code. See appendix 10.2 for HTTP error codes.
1114
Connector: Failed Unexpected WinInet failure. to retrieve http Log a PTR. status from URL:
1115
Unspecified Soap Soap fault returned from the server. Normally the description will be fault. fault string Unspecified Soap fault is only displayed if the true fault string is unavailable. May indicate a problem on the server, or a problem with the request which was sent. Check server application.
1116
Invalid Soap Effectively, this is a connectivity error although no error has been response: no data reported by WinInet, no response data is available. Typically indicates a network connectivity problem. returned. Verify network, routers, firewalls and server availability.
1117
Invalid Soap Soap request returned invalid xml if possible a trace is written to response: unable WashSoapError.xml in the TEMP directory (typically C:\Documents to parse xml. and Settings\username\Local Settings\Temp on NT/2000/XP, c:\Windows\Temp on W98/ME, but can be verified by checking the value of the environment variable TEMP). Recover and analyse error file. Then check server application or XML version on client. Log a PTR.
1118
Soap request returned invalid xml if possible a trace is written to WashSoapError.xml in TEMP directory. Recover and analyse error file. Then check server application or XML version on client. Log a PTR.
1119
Invalid Soap Soap request returned invalid xml if possible a trace is written to response: unable WashSoapError.xml in TEMP directory. to retrieve element: Recover and analyse error file. Then check server application or XML version on client. Log a PTR.
1120
Unable to write header data to Soap request unexpected error Log a PTR.
Page 47/68
Amadeus Vista 2.2 Support guide Number Message 1121 Header Handler: Failed to read Soap headers. Further information Unable to read header data from Soap response. Can indicate a problem with MSXML dll on the client. Log a PTR if MSXML is correctly installed.
1122
Connector: Error condition in communications module. WinInet deadlock was detected after a delay of %d ms on URL:
Problem detected due to the combination of a tcp reset and a bug in the WinInet dll. Note that this error is only generated after performing the number of attempts specified by the Connector property WinInetAttempts Increase the WinInetAttempts value (in Emulator4505 WebConf)
1123
Connector: Failed Unexpected WinInet failure. This can occur after the detection of the to close request WinInet blocking condition when the value of the Connector property handle on URL: WinInetAttempts is greater than one. Log a PTR.
1200
Unable to create internal COM object WashClient dll not correctly registered. Check product installation.
1201
Unable to create COM object WashCert dll not correctly registered. Check product installation.
1202
Unable to create internal COM object WashClient dll not correctly registered. Check product installation.
1203
Failed to marshal Unable to marshal internal COM object WashClient dll not correctly header handler. registered. Check product installation.
1204
Failed to marshal Unable to marshal internal COM object WashClient dll not correctly local properties. registered. Check product installation.
1205
Unable to create internal COM object WashClient dll not correctly registered. Check product installation.
Page 48/68
Amadeus Vista 2.2 Support guide Number Message 1206 Further information
Failed to marshal Unable to marshal internal COM object WashClient dll not correctly Soap client. registered. Check product installation.
1208
Unable to create internal COM object WashClient dll not correctly registered. Reinstall the product.
1300
1301
1302
1303
1304
1305
Failed to retrieve The timings required for the specified interval have not been stored. one (or both) of Log a PTR. the following timing properties:
1306
1307
UseWSDL property was set but wsdl file could not be retrieved from specified location. Log a PTR.
Page 49/68
Amadeus Vista 2.2 Support guide Number Message 1308 Invalid URL: Further information Unexpected internal error. Log a PTR.
1309
Can occur when a local wsdl file is specified without setting the UseWSDL property (http requests can not be sent to a local file). Log a PTR.
1310
MSXML not registered sending Soap requests requires v1 as a minimum. Check that there is a MSXML installed/registered on the client machine.
1311
1312
1313
1314
1315
1316
1317
The ActiveHeader local property has been set, but no header properties have been set and therefore the map has not yet been created. Setting a header property will cause the map to be created. Log a PTR.
Page 50/68
Amadeus Vista 2.2 Support guide Number Message 1318 Unable to create property map for current active header: Further information Unexpected internal error. Log a PTR.
1319
1320
1321
Failed to initialize Unexpected failure during initialisation. Host Access client. Log a PTR.
1322
Connector property map is not available until initialisation complete. Log a PTR (application side).
1323
1400
No certificate has Initialise has been called without retrieving the certificate collection been selected and setting an active certificate. from the certificate Log a PTR (application side). collection.
1401
Unexpected error Unknown error returned from certificate server. during certificate check. Check certificate server or log PTR (AhaUtilities).
1402
1403
Certificate service Local property CertificateServiceName should be set before name not initialisation (normally to aHaUtilities). supplied. Log a PTR (application side).
Page 51/68
Amadeus Vista 2.2 Support guide Number Message 1404 Further information
"Failed to retrieve This error can occur during the attempt to re-negotiate an expired server Security Gateway token if the ServerUrl or CertificateServiceName parameters" local properties are not available. Normally these properties are cached and shared between all Wash Client instances, so this error should not occur in normal circumstances.
2002
2003
2004
2005
Initialisation of the Failure to initialize Soap client. SoapClient for This could be the consequence of one of the following problems: Certificate Checking failed Most often this will be a result of a failure to obtain the WSDL file from the server (the message will confirm this). This could also occur if Root certificate authority is not installed. In the first case, the Wash service address should be verified by concatenating the service address with the relative path of the cryptic (or utilities) wsdl file, e.g. https://ncepdt2k.farm2.transport.amadeusvista.com/aHaUtilities/aHaU tilities01.wsdl Using the browser to retrieve this file. If it is not available, then the configuration of the transport URL should be checked and modified as necessary. For the second case, install the Root certificate authority.
2006
2007
Page 52/68
Amadeus Vista 2.2 Support guide Number Message 2008 Invoke method failed on SOAP Toolkit Further information Problem communicating with server. This can be caused by network problems, or by installation problems. Solutions: Verify that the server is reachable, If server is reachable, re-install.
Page 53/68
Appendix G.
Number Message 6002 The object cannot open the certificate store on the computer. 6003 The certificate already exists on the server.
Both.
6004
There was en error decoding certificate Log PTR. on the server. Invalid argument serialising certificate Log PTR. to store. Could not open the root store on server. Log PTR. Issuer of certificate not found on server. Failed to certify the certificate. The certificate is on the revocation list on the server. The certificate signature is incorrect. The certificate time stamp validation failed. The certificate is marked as inactive. The certificate has expired. Incorrect certificate type.
Both.
6005
Both.
6006
Both.
6007
Both.
6008
6009
6010
Both.
6011
Both.
6012
Both.
6013
Both.
6014
Both.
Page 54/68
Amadeus Vista 2.2 Support guide Number Message Further information 6015 There was an unknown error trying to serialise the certificate to the store. 6016 Could not open the certificate authority store on server. The server side utilities ran out of memory. Verify that the correct certificate authority has been installed on the server. Wash/ComCore Both.
Both.
6021
6022
Failed to create a safe array in utilities Log PTR. component on server. No certificate has been selected from the certificate collection. Error detected at Initialise time (Sign-in time). No active certificate. Programmatic error the ActiveCertificate property of the CertificateCollection object must be set before the first call to Initialise. Log PTR.
Both.
6050
Wash.
6051
Unexpected error during certificate check. Failed to retrieve ATID from certificate.
Unexpected certificate error, e.g. ATID not available from certificate. Log PTR.
Wash.
6052
CertificateService name property has not Wash. been set. This needs to be done before the call to initialise (normally the value should be "aHaUtilities"). Programmatic error. Log PTR.
Page 55/68
Appendix H.
8001
Invalid Parameters.
8002
EDIFACT message received from Global Core could not be interpreted on the Vista server (DSC parsing failed). This indicates an application error either on Global Core or on the Vista server. Retry. If reproducible, log PTR.
8003
An unexpected EDIFACT message is received by the Vista server from Global Core. This indicates an application error either on Global Core or on the Vista server. Retry. If reproducible, log PTR.
8004
Invalid Parameter.
Cryptic mapper failed. Usually happens if a mandatory parameter is missing. Since this is already checked in the proxy, this error should not occur. If it does, it indicates an application error. Retry. If reproducible, log PTR.
8005
Invalid ATID.
Blank ATID was passed to the server. Indicates an application error. Retry. If reproducible, log PTR.
8006 8007
SEH_EXCEPTION_THROWN. COM error. General com error. Retry. If reproducible, log PTR.
8008 8009
Amadeus Vista 2.2 Support guide Number Message 8010 8011 8012 8013 Invalid agent sign specified. TCP Error. Invalid Component. Edifact Version-Release no longer supported. Bnf Parser error. Unable to process PNR response. Retry. If reproducible, log PTR. Retry. If reproducible, log PTR. Further information
8014 8015
Unable to process input request. Retry. If reproducible, log PTR. Security Gateway error. Retry. If reproducible, log PTR.
The server timed out waiting for No answer was received by ComCore from central a response. system. Time out is set in registry to 45s. Retry. If reproducible, here are the different possibilities. You are not requesting the correct BackEnd. Your ATID is not defined on this BE. Solution: Change to the appropriate BE. It depends (in order of investigation) of your VistaServer, your systemID, Your UNTO, and the state of your UNTO redirection. If you are on the correct Back-End, maybe you need to reset your ATID because the flag "In use" is always activated. Solution: Go to a 3270 session with another ATID, and do the following for the ATID that is blocked (here 6790005b) OK-WD/L-6790005b OK-WI/C-C3DAP/W-AMAD/T-MUC/S80X22/O-MUC1A0701/A-MUC/U-AFCHK/L6790005b. Maybe the request you try to make is too complex and is lost in central system. PTR to central system.
Failed to create the socket. Failed to allocate a UDP Port. Failed to bind socket to local server. Failed to Connect and send to Server. Failed to set the timeout.
8504
8505
Page 57/68
Amadeus Vista 2.2 Support guide Number Message 8506 Windows Sockets did not respond to the WSAStartup() call 8508 Failed to bind to local server. 8509 8600 Failed to create the semaphore. Semaphore timed out. Further information
Page 58/68
Appendix I.
8001
Invalid Parameters.
Yes
8002
Yes EDIFACT message received from Global Core could not be interpreted on the Vista server (DSC parsing failed). This indicates an application error either on Global Core or on the Vista server. Retry. If reproducible, log PTR.
8003
An unexpected EDIFACT message is received by the Vista server from Global Core. This indicates an application error either on Global Core or on the Vista server. Retry. If reproducible, log PTR.
Yes
8004
Invalid Parameter.
Yes Cryptic mapper failed. Usually happens if a mandatory parameter is missing. Since this is already checked in the proxy, this error should not occur. If it does, it indicates an application error. Retry. If reproducible, log PTR.
8005
Invalid ATID.
Blank ATID was passed to the server. Indicates an application error. Retry. If reproducible, log PTR.
Yes
8008
Configuration problem on the server for the service specified. If the problem persists, log a PTR detailing
No
Page 59/68
Amadeus Vista 2.2 Support guide Number Message Further information the service used, the request sent and the ATID and Office ID. 8500 The server timed out No answer was received by ComCore from waiting for a response. central system. Time out is set in registry to 45s. Retry. If reproducible, here are the different possibilities. You are not requesting the correct Back-End. Your ATID is not defined on this BE. Solution: Change to the appropriate BE. It depends (in order of investigation) of your VistaServer, your systemID, Your UNTO, and the state of your UNTO redirection. If you are on the correct Back-End, maybe you need to reset your ATID because the flag "In use" is always activated. Solution: Go to a 3270 session with another ATID, and do the following for the ATID that is blocked (here 6790005b) OK-WD/L-6790005b OK-WI/C-C3DAP/W-AMAD/TMUC/S-80X22/O-MUC1A0701/AMUC/U-AFCHK/L-6790005b. Maybe the request you try to do is too complex and is lost in central system. PTR to central system. Yes Exists in ComCore ?
Page 60/68
Appendix J.
Number 9001
Message The Addressee or sytemID used for this call was unrecognised. The initialisation of the handler failed.
9002
9003
Unknown handler for General Handler Errors. addressee and systemId. Retry. If reproducible, log PTR. No handler assigned General Handler Errors. for addressee and systemId. Retry. If reproducible, log PTR. Windows socket not responding. Misc error. Minimum number of sockets required. Timed out waiting for No response received after 40 sec. by Vista server from Global response. Core. This message number is for pooled ATID connection. 9511 is for ATID connection. This usually indicates an outage of either the link to the UDP gateway, the UDP gateway, the FE or the BE. Check availability of the above systems.
9004
9501
9502 9503
9504
9505 9506
Inactivity time out. No sessions available in the handler. Terminate not found on CLTRES. No timer sessions available for handler. Response time out on trying to start
9507
9508
9509
Page 61/68
Amadeus Vista 2.2 Support guide Number Message conv. Response time out on trying to end conv. Timed out waiting for No response received after 40 sec. by Vista server from Global response. Core. This message number is for non-pooled ATID connection. This usually indicates an outage of either the link to the UDP gateway, the UDP gateway, the FE or the BE. Check availability of the above systems. If systems are up, and problem is reproducible, log a PTR. 9511 Response time out on trying to start One-Off conv. Handle not found. Miscellaneous EDIFACT handler problems. Further information
9510
9511
9512 9513
Recipient Unto Miscellaneous EDIFACT handler problems. Name not registered. Session not available. Session not available on the host. ito < rto. Missing sender. Missing recv. Missing DeliverSystemID. Missing DeliverLocation. Missing OriginAgentID. Missing OriginLocation. Missing OriginSystemID. Missing OriginSystemType. Missing OriginCountry. Missing Miscellaneous EDIFACT handler problems.
9514
9515
Miscellaneous EDIFACT handler problems. Miscellaneous EDIFACT handler problems. Miscellaneous EDIFACT handler problems. Miscellaneous EDIFACT handler problems.
9521
9522
9523
9524
9525
9526
9527
Page 62/68
Amadeus Vista 2.2 Support guide Number Message OriginCurrency. Missing OriginLanguage. Missing OriginAgentInitials. Missing OriginDutyCode. Further information
9528
9529
9530
Missing CompanyID. Miscellaneous EDIFACT handler problems. Missing OfficeID. Miscellaneous EDIFACT handler problems.
Missing ORG Miscellaneous EDIFACT handler problems. Section Elements for CLTREQ. Miscellaneous EDIFACT handler problems. Shutdown the EDIFACT handler and re-start. If problem recurs, log PTR. Miscellaneous EDIFACT handler problems. Shutdown the EDIFACT handler and re-start. If problem recurs, log PTR.
1004-1024 Windows Sockets redefinitions of regular Microsoft C error constants. 1053-1101 Windows Sockets redefinitions of regular Berkeley error constants. 10061
Host communication Vista server component cannot communicate with EDIFACT unavailable. handler. Usually indicates that the EDIFACT handler process is not running. Start the EDIFACT handler.
Others
Host communication Miscellaneous EDIFACT handler problems. unavailable. Shutdown the EDIFACT handler and re-start. If problem reoccurs, log PTR.
Page 63/68
Appendix K.
12003
MPCPIA Resource API problem. A request for an internal resource in the API part cannot be resolved. Check if 1ACA service is started on the server.
This is a generic error that can flag a configuration mistake, a lack of system resources or a network problem. Possible causes could be: Configuration mistake in the Configuration File, Library cannot connect to 1ACA, Thread cannot be started, Select call is failing, Memory cannot be allocated. Check 1ACA's logs to get an indication of the exact cause. Based on the information, verify the configuration file or call support.
12004
MPCPIA Resource There can be two possible causes for such an error: Communication Adapter problem. A request for an To be able to send and receive messages internal resource in the through 1ACA, an application using the communication adapter can not MPCPIA library has to create a 'Path' object. be resolved. The creation of the Path object within 1ACA has failed. Before executing any API call, the MPCPIA library checks that the connection to 1ACA is up and running. There is no connection to 1ACA. Both causes are a symptom either of lack of system resources (e.g. overloaded machine) or of a 1ACA problem (e.g. service not available due to a crash). Error should be transient. If problem persists, call support.
12005
Server Timeout.
There are several situations that can lead 1ACA and MPCPIA library to generate a Timeout event. An application using the MPCPIA library has requested 1ACA to wait for a reply for a supplied amount of time (using for example ReceiveDatagram, Receive, WaitForEvent API calls). The reply did not come within the specified time interval. Since every MPCPIA API call is synchronous, every call expects an ACK from 1ACA within a
Page 64/68
Amadeus Vista 2.2 Support guide Number Message Further information given time. This time is set by default to 1 minute. 1ACA has not acknowledged an API request within the given time. An application using the MPCPIA library has one or more threads blocked in a MPCPIA API call (e.g. WaitForEvent, ReceiveDatagram) and 1ACA crashes. The library on user's side realises that the connection to 1ACA has been lost and initiates an 'Emergency Close' to release all locked threads. Every API call returns control to its thread reporting a Timeout event. Check 1ACA's logs to get an indication of the exact cause. If cause of Timeout is: 1ACA is behaving properly. A response timeout has expired. Check the remote application. Something is wrong with 1ACA. Request OnCall support. This is to protect user's application, avoiding to leave any user's thread blocked. Error should be transient since 1ACA will be automatically or manually re-started. 12006 MPCPIA application invalid name. The user application tried to create a 'Path' object, but the supplied name for the Path is invalid. The Path creation fails with a MPCPIA_APP_NAME_INVALIDE exception. The only thing that 1ACA checks is the name length: it must be included within 1 and max_name_len, where max_name_len is: 8 for library versions < 1.15, 35 for library versions >= 1.15. This can be considered as a configuration error. 1ACA is not involved. The Path's name has to be changed. 12007 MPCPIA unknown destination. The connection with the destination application cannot be established. Please check 1ACA.ini file and the registry UNTO. The user application tried to send a message to a destination application, but the name used to reach the destination is unknown. The destination name is wrong or there is a configuration mistake along the chain of applications in front of the destination. Check with the Links Group. The user application tried to send a message to a destination application using the 'SingleQueryReply' API call, but the send has failed because 1ACA could not parse the IEDI header/trailer due to a syntactical error. The IEDI message built by the user application is wrong. Message has to be changed. 12010 MPCPIA abnormal initialisation. The user application tried to create a 'Path' object, but Page 65/68
12009
MPCPIA send request failed. Please check the link between 1ACA server and customer server.
Amadeus Vista 2.2 Support guide Number Message Further information Please check if 1ACA service is the library has detected an error in its initialisation. correctly started. Could be a symptom of lack of system resources on the machine. 1ACA is not involved. If problem persists, call support. 12011 MPCPIA receive response failed. Please check the link between 1ACA server and customer server. When a MPCPIA call is done, the user thread that has performed the call (like ReceiveDatagram) is blocked waiting for a reply or an ACK from 1ACA. Calls like ReceiveDatagram can be issued also with an infinite timeout. If the user application wants to shutdown or terminate such a blocked thread, it should call the 'EmergencyClose' API or delete the Path object. The Path object keeps a list of pending requests (like for ReceiveDatagram) and terminates all of them with MPCPIA_RECEIVE_FAILED exception, avoiding leaving some user thread hanging forever. No action required. This is just a response to user requested action. 12013 MPCPIA unknown UID. This error should never happen. Log PTR. 12014 MPCPIA Protocol Resource API This error should never happen. Something is wrong at problem. source code level (State Machine). Log PTR. 12015 MPCPIA message rejected. The Any MPCPIA API call can be seen as a request to message has been rejected by 1ACA to perform one or more actions. For doing so, the host application. 1ACA uses internal tables. Insertion in one of these tables has failed and 1ACA could not handle user's request. Could be a symptom of lack of system resources on the machine. Check 1ACA's logs to get an indication of the exact cause. If problem persists, request on call support. 12016 MPCPIA Path name is invalid. An MPCPIA 'Identifier' is a token that is used to match queries and replies. It can be seen as a conversation ID and the user's application can freely set it and pass it to 1ACA. The user's application tried to open/close an 'Identifier' using the 'OpenIdentifier' or 'CloseIdentifier' API call, but no value has been supplied for the identifier. 1ACA is not involved. User's application has to correct the error providing a value for the Identifier. 12017 MPCPIA Path identifier is not An MPCPIA 'Identifier' is a token that is used to match unique. queries and replies. It can be seen as a conversation ID and the user's application can freely set it and pass it to 1ACA. The user's application tried to open/close an 'Identifier' using the 'OpenIdentifier' or 'CloseIdentifier' API call, but the value has been supplied for the identifier is already used and so it is not unique. Page 66/68
Amadeus Vista 2.2 Support guide Number Message Further information 1ACA is not involved. User's application has to correct the error providing a value for the Identifier. 12019 MPCPIA send warning. The user application has tried to send a message to a destination application using the 'SendDatagram' API call, but the send has failed. The message cannot be sent. Most probably the transport to the destination application is no longer available or the destination application is so overloaded that it cannot read fast enough from its TCP/IP buffers. The buffers become full and 1ACA gets a 'flow control' error that prevents it from sending the message. Check the destination application. 12020 MPCPIA close Association Error. An MPCPIA 'Association' is the object used to handle IEDI conversation between the user's application and a destination application. 1ACA is responsible for managing the IEDI conversation, building UNB-UNZ segments, running response and inactivity timeouts, validating a message against the IEDI state machine. The user application has requested to close an Association but the request has been rejected. 1ACA is not involved. There are two cases to be considered: The MPCPIA_Library is Initiator of a Conversation. In this case, the conversation can be closed always. The peer will enter in a timeout process and he will understand that the Conversation is lost. The MPCPIA_Library is Responder of a Conversation. In this case, the application shouldn't close the conversation at any time but only when it is IDLE or Inactive. 12021 MPCPIA close Application Error. Same as 12020. 1ACA is not involved. The conversation could not be found either because the user application has already closed it or because the inactivity timeout is expired. 12023 MPCPIA Application Error. The user application has requested an action on an Association object but the requested action could not be executed because it violates the IEDI State Machine. 1ACA is not involved. User application is trying to perform a wrong sequence of actions not allowed by the IEDI protocol standard. 12024 MPCPIA Application Error. The user application has requested an action on an Association object but the requested action could not be executed because the conversation is in the 'Invalid State'. 1ACA is not involved. User application is trying to perform a wrong sequence of actions not allowed by the Page 67/68
Amadeus Vista 2.2 Support guide Number Message Further information IEDI protocol standard. A conversation is put by 1ACA in 'Invalid State' as a response to an abnormal condition handled by the IEDI State Machine. The user application has requested to open an association to start a new conversation, but the creation of the conversation object within 1ACA has failed. Could be a symptom either of lack of system resources (e.g. overloaded machine) or of a 1ACA problem (e.g. service not available due to a crash). Error should be transient. If problem persists, request on-call support. 12026 MPCPIA Application Error. The user application has requested an action on an Association object but the corresponding conversation within 1ACA has already been terminated. 1ACA is not involved. The conversation has already been removed either because the user application has closed it or because the inactivity timeout is expired. 12027 MPCPIA Protocol Error. Applications use protocol stack to communicate to each other. A typical protocol stack between MPCPIA library and 1ACA is 'MPCPIA IEDI'. The user's application tried to send a message but 1ACA has found an error while parsing the protocol stack's headers and/or trailers. The message sent by the application is syntactically wrong. 1ACA is not involved. User's application has to correct the message. 12031 12050 1ACA creation has failed within Retry. a timeout. 1ACA Path Creation Semaphore returned WAIT_ABANDONNED. Retry.
12025
12051
Page 68/68