Skip to main content

Red Apps Developer FAQs

FAQs

Note: When you contact a Sabre software support center, you need the PIN for your PCC.

Sabre Red 360 Developer Toolkit (informally referred to as SDK)

  • I need help downloading and installing the Toolkit.

  • I need help setting up my Red App target platform, run configuration, wizards, and Red App help.

  • I need help upgrading my Red App target platform, wizards, and Red App help.

Warning
JCSAPIConnector: Exception occurred during getting shared session com.sabre.edge.cf.host.exception.JSAPIException: Exception occured during getting shared session …​

Question: I do not see any documentation about creating plug-ins as Red Apps or how to use the Sabre Red 360 Developer Toolkit in the Sabre Red 360 Developer Toolkit archive file. Is there any developer documentation or help?

Question: I upgraded my Red App target platform to the latest release, however, I see an old version of Red App wizards and help in Eclipse IDE help. How can I get the latest Red App wizards and help?

Question: My Red App utilizes external services. How should it connect to them?

Question: I would like to use the SSO mechanism in my Red App. How can I do that? Where should I start?

Question: My Red App fails validation because the certificate/signature is not valid, but I’m certain that I did everything correctly. What may be the reason behind this behavior?

Question: When I try to create a Red App bundle using the Red App export wizard provided as part of the Sabre Red 360 Developer Toolkit, I get an error saying that a cycle was detected in a plug-in fragment that was not even selected to be exported. How can I fix this?

Question: When I start SR360 from Target Platform with the Sabre Profiles add-on, SR360 freezes for some time and OutOfMemoryError is thrown. How can I resolve this problem?

com.sabre.edge.cf.host.Communication Service

Question: When I use com.sabre.edge.cf.host.Communication from multiple threads I sometimes get HOST000 error. What is HOST000 error and how to avoid this problem?

Sabre GDS (Sabre Host) Help

Question: I am logged in to the CERT environment of the Sabre GDS, but I want to log into PRODUCTION. Can I change from one environment to the other in Sabre emulator without shutting down Sabre Red 360?

Answers

Note: When you contact a Sabre software support center, you need the PIN for your PCC.

Sabre Login Issues

Question: Why am I unable to log in to the Sabre GDS?

Answer: There are many reasons for the inability to log in. Some of these reasons may be because a refresh of the CERT partition occurred, your password expired in the Sabre GDS because of inactivity, or other reasons.

First, contact the CREATE Agent at your PCC. If your login issue is not resolved, contact your regional software support desk.

Question: Why am I unable to log in to Sabre Red 360?

Answer: The reason you cannot log in may be because a refresh of the CERT partition has occurred, your password expired in the Sabre GDS because of inactivity, or other reasons.

First, contact the CREATE Agent at your PCC. If your login issue is not resolved, contact your regional software support desk.

Question: Why am I unable to log in to Sabre Red 360 in development mode from Eclipse IDE?

Answer: The reason you cannot log in may be because a refresh of the CERT partition has occurred, your password expired in the Sabre GDS because of inactivity, or other reasons.

First, contact the CREATE Agent at your PCC. If your login issue is not resolved, contact your regional software support desk.

Question: Why am I unable to log in to Agency eServices?

Answer: The eServices login credentials are the same credentials that you use for PRODUCTION Sabre GDS. If your PRODUCTION Sabre GDS credentials are expired or disabled, then your eServices login credentials are also disabled. (The URL for eServices is http://eservices.sabre.com.)

First, contact the CREATE Agent at your PCC. If your login issue is not resolved, contact your regional software support desk.

Question: Why am I unable to log in to the Dev Centre or Sabre Red App Centre?

Answer: The login credentials for the Red App Centre are the same credentials that you use for the PRODUCTION Sabre GDS. If your PRODUCTION Sabre GDS credentials are expired or disabled, then your Red App Centre login credentials are also disabled. (To access the Dev Centre, you log in to the Sabre Red App Centre.)

First, contact the CREATE Agent at your PCC. If your login issue is not resolved, contact your regional software support desk.

Question: How can my Terminal Address, or TA, get access to the CERT environment?

Answer: If your TA is not set up to access the CERT environment of the Sabre GDS, contact your Sabre account manager.

Question: I recently changed my password in the CERT Sabre GDS, but CERT Sabre does not recognize it.

Answer: This is possibly a result of the refresh schedule for the CERT Sabre GDS. If you change your password in CERT between the time when the snapshot of the PRODUCTION host is created and actually implemented in CERT, your password in CERT reverts to the previous password in the PRODUCTION Sabre GDS.

For an explanation about how CERT is refreshed and the impact on passwords and data, obtain a copy of Working in the CERT System on eservices.sabre.com.

For resets of your Sabre GDS password in any environment, contact the CREATE agent at your PCC. If you need more help, then contact your regional software support desk.

Question: I changed my password for Sabre Red 360, but I get connection errors, password expired errors, etc.

Answer: Passwords that you use for Sabre Red 360 and eservices.sabre.com are the same passwords that you use for PRODUCTION Sabre GDS. If CERT Sabre GDS is refreshed, or your host password has expired in a PRODUCTION or CERT environment, your Sabre Red 360 password also expires.

For a reset, contact the CREATE agent at your PCC. For more help, contact your regional software support desk.

Question: Are passwords in all Sabre GDS environments synchronized?

Answer: Passwords across all Sabre GDS environments are NOT synchronized, unless you change them individually. Therefore, when logging in to CERT, use your CERT password and likewise, use your PRODUCTION password to log in to the PRODUCTION environment.

Remember that when a refresh of the CERT Sabre GDS occurs, your CERT password may not work. A document is available that explains CERT refreshes.

Tip: You may want to synchronize your passwords in both the CERT and PRODUCTION Sabre GDS by making your passwords in both environments the same on the same date.

Question: Is any information available that explains CERT refreshes and the impact on passwords?

Answer: For additional information about the CERT environment, including the impact of CERT partition refreshes, obtain a copy of the document Working in the CERT System on eServices.sabre.com. In this document, refer to the topic "Refresh/Recreate."

Log in to eservices.sabre.com using your PRODUCTION Sabre GDS credentials, and make the following selections:

From Training, choose Quick References > Workflow Efficiency Tools > Productivity Tools. A link to the document is displayed.

Sabre Red 360 Developer Toolkit (informally referred to as the SDK)

Question: How can I get help with the Sabre Red 360 Developer Toolkit?
  • I need help downloading and installing the Toolkit.

  • I need help setting up my Red App target platform, run configuration, wizards, and Red App help.

  • I need help upgrading my Red App target platform, wizards, and Red App help.

Answer: For assistance with the Sabre Red 360 Developer Toolkit, the Red App IDE, or development tools in the Toolkit, send e-mail to second level support at the following address: redappsupport@sabre.com

Question: How can I get help installing and upgrading the Red App development tools?

Answer: For assistance with the Sabre Red 360 Developer Toolkit, the Red App IDE, or Red App development tools, send e-mail to second level support at the following address: redappsupport@sabre.com

Question: How do I report bugs or documentation errors in the Sabre Red 360 Developer Toolkit?

Answer: For bugs, documentation, or other issues that are related to the Sabre Red 360 Developer Toolkit, send e-mail to second level support at the following address: redappsupport@sabre.com

Question: How do I report other issues that I find in the Sabre Red 360 Developer Toolkit?

Answer: For other issues that are related to the Sabre Red 360 Developer Toolkit, send e-mail to second level support at the following address: redappsupport@sabre.com

Question: Why do I receive a JCSAPIConnector exception when I am using the host communications service (com.sabre.edge.cf.host.Communication)?
Warning
JCSAPIConnector: Exception occured during getting shared session com.sabre.edge.cf.host.exception.JSAPIException: Exception occured during getting shared session …​

Answer: This is a known issue on the Microsoft Windows 7 platform.

If you are using the host communications service on the Windows 7 platform, you must run Eclipse as an administrator. Right-click eclipse.exe, and choose Run as an administrator.

Question: What is the Red App ID?

Answer: The Red App ID is a unique alphanumeric identifier that Sabre assigns to every Red App. A Red App ID identifies the Red App within the Sabre Red 360 environment. Every Red App bundle must include this ID in the id attribute of the RedApp entity in the redapp.xml configuration file. The Red App ID is also passed as the requestorId in the Java code of Red Apps that use communications services.

Question: I lost my Red App ID. How can I find it?

Answer: You can find your Red App ID in the Message Centre on the Sabre Red App Centre (https://www.sabreredappcentre.sabre.com/). Look for the "Proposal Approved" message. The message contains your Red App ID.

Question: My Red App seems to run differently in CERT Sabre Red 360 than in Eclipse IDE development mode. How can I troubleshoot this?

Answer: Your Red App is provisioned to the CERT environment of Sabre Red 360 as part of the Red App certification process. If you notice any differences between your Red App in development mode and CERT, you can troubleshoot Red Apps as follows:

  • Analyze the logs produced by CERT Sabre Red 360.

  • Use the Remote Debug option in Eclipse IDE for remote debugging when you are working in CERT Sabre Red 360.

Instructions for setting up remote debugging in Eclipse follow.

  1. In the executable path of the Sabre Red 360 CERT location, open the mysabre.ini file using a text editor. Add the following lines:

-Xdebug
-agentlib:jdwp=transport=dt_socket,server=y,address=8578,suspend=n

The flag suspend=n prevents Sabre Red 360 from hanging until the debugger is started in Eclipse IDE.

Tip: The mysabre.ini file is in the same path as mysabre.exe.

A sample mysabre.ini file with this addition follows:

#utf8 (do not remove)
-startup
../../Common/plugins/org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
-vm
C:/Program Files/Sabre Red Workspace-CERT/Common/binary/com.sun.java.jre.win32.x86_1.6.0.012/bin/client/jvm.dll
-configuration
C:\Program Files\Sabre Red Workspace-CERT\Profiles\*<PCC_EPR>*\configuration
--launcher.library
../../Common/plugins/org.eclipse.equinox.launcher.i18n.win32.win32.x86_3.2.0.v201103301700
-install
C:\Program Files\Sabre Red Workspace-CERT\Profiles\*<PCC_EPR>*
-vmargs
-Xms128m
-Xmx1024m
-Xdebug
-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8578
-Declipse.registry.nulltoken=true

Make sure to replace the paths that refer to SR360 installation folder with proper values. Use your PCC and EPR in –configuration and -­install options instead of <PCC_EPR> token.

  1. In Eclipse IDE, add a new Debug Configuration.

Choose Run > Debug Configurations. Select Remote Java Application > New. Type a name for your new run configuration. Type port 8578, and click Apply.

  1. Start DEBUG from Eclipse IDE.

  2. Add a breakpoint where needed.

  3. Launch the CERT environment of Sabre Red 360. You should be able to debug your Red App.

image1

Question: How can I change the language that Sabre Red 360 uses when I launch it from my Red App target platform and Eclipse IDE?

Answer: If you run Eclipse IDE on a desktop with locales set to one of the languages that Sabre Red 360 supports, this setting is applied automatically. To override this behavior, specify the –nl argument in your run configuration.

The supported languages follow: de (German), en (English), es (Spanish), fr (French), it (Italian), ja (Japanese), pt (Portuguese), ru (Russian), zh (Simplified Chinese) and zh_TW (Traditional Chinese).

Default language setting: en

For related information, see the "Internationalization" book under "Plug-in Services" in the Red App Help table of contents. In particular, see the topic "Preparing Your Plug-in for Internationalization."

image2

Question: I do not see any documentation about creating plug-ins as Red Apps or how to use the Sabre Red 360 Developer Toolkit in the Sabre Red 360 Developer Toolkit archive file. Is there any developer documentation or help?

Answer: After you set up your Red App target platform, you must install the Red App development tools software. The Red App help system is integrated into Eclipse IDE help. For procedures to set up the target platform, run configuration, and development tools, see Getting Started with Red Apps. When you extract Sabre Red 360 Developer Toolkit archive file, Getting Started is in the documentation folder.

Question: I upgraded my Red App target platform to the latest release, however, I see an old version of Red App wizards and help in Eclipse IDE help. How can I get the latest Red App wizards and help?

Answer: After you upgrade your target platform, you must also upgrade the Red App development tools software to the newest version. This automatically integrates the latest release of the Red App help into Eclipse IDE help. For procedures to upgrade your target platform, run configuration, and development tools, see Getting Started with Red Apps. When you extract Sabre Red 360 Developer Toolkit archive file, Getting Started is in the documentation folder.

Question: My Red App utilizes external services. How should it connect to them?

Answer: For connection to external services the use of java.net.URLConnection is recommended because it’s proven to handle all kinds of proxies well (at all locations where SR360 is deployed). Other commonly used methods (like HttpClient) can cause issues working behind NTLMv2 proxy (widely used in corporations).

Question: How can I develop my Red App without access to the Sabre host?

Answer: You can do this with the Sandbox mechanism, which is provided as a part of the Sabre Red 360 Developer Toolkit. For more details, please consult the Sabre Red 360 Developer Toolkit Getting Started Guide.

Question: Can I develop Red Apps on my Mac?

Answer: Yes, you can. However, keep in mind that there are some limitations. Not all technologies available for Red App developers on Windows systems are available on a Mac. Also, because a majority of agents use Windows machines, you should test every Red App on a Windows system before submitting to the Red App Centre. For more details regarding Sabre Red 360 Developer Toolkit Mac support, please consult Sabre Red 360 Developer Toolkit documentation.

Question: I would like to use the SSO mechanism in my Red App. How can I do that? Where should I start?

Answer: All Red Apps can take advantage of single sign on (SSO), but first they must go through a setup process. The setup process and usage of this mechanism are described in detail in the Sabre Red 360 Developer Toolkit documentation.

Question: My Red App fails validation because the certificate/signature is not valid, but I’m certain that I did everything correctly. What may be the reason behind this behavior?

Answer: There are many factors that could cause this. The most common factors are:

  • Your certificate does not come from a vendor supported by Sabre. Please consult the Sabre Red 360 Developer Toolkit documentation to learn which certificate vendors are considered trusted.

  • Your certificate is issued by trusted vendor, but it is not of CodeSigning type. You can only use CodeSigning certificates to sign a Red App.

  • You are using JDK 1.7 or 1.8 to run Eclipse IDE with Dev Tools in version 21.4 or older. You should use AdoptOpenJDK 8u282 with Dev Tools in version 21.5 or newer. For more information on System Requirements please consult Sabre Red 360 Developer Toolkit Getting Started Guide.

Question: When does my Red App need to be PCI / PII compliant?

Answer: Generally Red Apps that process credit card information, or personal information, are required to be PCI or PII compliant. For more details please consult Red App Security Requirements in Developer Resources section of the Dev Centre. This information is organized into sections that describe requirements for secure coding practices, handling of cardholder and personal data, certification testing, and developer skills that you need to create compliant Red Apps.

Question: When I try to create a Red App bundle using the Red App export wizard provided as part of the Sabre Red 360 Developer Toolkit, I get an error saying that a cycle was detected in a plug-in fragment that was not even selected to be exported. How can I fix this?

Answer: This is a known issue of Eclipse Platform (#309321). Currently the best workaround for this problem is to close the problematic plug-in fragment, and then perform the export operation.

Question: When I start SR360 from Target Platform with the Sabre Profiles add-on, SR360 freezes for some time and OutOfMemoryError is thrown. How can I resolve this problem?

Answer: Sabre Profiles requires more memory to run properly. Please set VM arguments in your Run Configuration according to Setting VM arguments section in Getting Started with Red Apps chapter of Sabre Red 360 Developer Toolkit documentation.

com.sabre.edge.cf.host.Communication Service

Question: When I use com.sabre.edge.cf.host.Communication from multiple threads I sometimes get HOST000 error. What is HOST000 error and how to avoid this problem?

Answer: This error might occur when session is locked and with obtained LockId com.sabre.edge.cf.host.Communication service is used from multiple threads. In general it is not recommended to use multiple threads to communicate with Sabre Host as, due to nature of this communication, there is no possibility to match properly responses to commands sent from multiple threads. Also, in such scenario it is not possible to handle commands with multiple responses.

To communicate with Sabre Host either let com.sabre.edge.cf.host.Communication service handle locking and unlocking session or use only one thread to send commands.

EMU_COMMAND Service

Question: What does Sabre Red 360 do if multiple Red Apps register active listening for the same emulator command in EMU_COMMAND?

Answer: Sabre Red 360 displays a Conflict Detected dialog to an end-user with a selection list of the Red Apps that are trying to process the command prefix. An end-user selects the Red App that he or she wants to complete its processing.

image3

Question: How does an end-user use this Conflict Detected dialog?

Answer: An end-user chooses the Red App that he or she wants Sabre Red 360 to process. The end-user has the option to save his or her selection. Whenever a conflict occurs again, Sabre Red 360 uses this selection without presenting the dialog to the user. If the end-user does not save the Red App that he or she selected, the dialog is presented again.

Each Red App in the list includes the Red App name, version, and vendor. When the user selects the Red App in the list, the dialog also displays a description of the app, the service name, version, event, and registered action code. The event, which is the command, will be processed according to how the Red App is designed to handle it.

Question: Can end-users view their selections or update their preferences?

Answer: End-users can view the list of services that they saved for processing. In Sabre Red 360, they choose Tools > Options > Red Apps Settings.

image4

If they highlight a service in the list, the Red App name, version, and vendor are shown on the Settings page. The source of the description is the desc attribute of the RedApp element in redapp.xml.

End-users can remove an operation or service by highlighting it and clicking Remove.

If end-users remove an operation from the Settings page and a conflict occurs, Sabre Red 360 displays the Conflict Detected dialog again.

Question: What happens if a Red App that has been saved in the Red Apps Settings page is updated in Sabre Red 360, and a conflict among services occurs?

Answer: After the updated plug-in is installed on a user’s local workspace, the saved Red App is removed from the Red Apps Settings page. When a conflict occurs, Sabre Red 360 presents the Conflict Detected dialog again, and the user must choose the Red App or operation to complete its processing.

Question: As a Red App developer, how can I see and experiment with Red Apps that may result in a conflict?

Answer: Add the following Red App sample plug-ins together to your run configuration:

com.sabre.edge.example.cf.emu.bridge and com.sabre.edge.example.scribe

After you launch Sabre Red 360, type the 1 command in the emulator. Both of these samples listen for a command that begins with 1.

Sabre Travel Network Software Support

Question: How can I contact my regional software support desk?

Answer: Log in to eservices.sabre.com with your PRODUCTION Sabre GDS credentials. On the Support menu, choose Software Support. You will see all of the information that you need to contact Support.

Question: How do I find the PIN for my PCC?

Answer: Log in to eservices.sabre.com with your PRODUCTION Sabre GDS credentials. From Home, click Support. The PIN for your PCC is displayed on the right under Sabre Support PIN.

The 8-digit PIN is the same for every agent within a specific PCC. The PIN never changes.

Sabre GDS (Host) Help

Question: What resources are available for help with Sabre formats?

Answer: The preferred first step is to consult Format Finder(tm) on eServices.sabre.com. Use your PROD Sabre GDS credentials. From Home, choose Products > Format Finder.

Tip: If the search box is not displayed, try using Internet Explorer or log in to Format Finder directly on http://format-finder.sabre.com.

If you need additional help, contact your regional software support desk.

Question: I am logged in to the CERT environment of the Sabre GDS, but I want to log in to PRODUCTION. Can I change from one environment to the other in Sabre emulator without shutting down Sabre Red 360?

Answer: If you are logged in to one environment of the Sabre GDS, you can log out, change to another environment, and then log in to the new environment. In the blue screen, type the [ key in place of the change key.

For information about how to change partitions in the Sabre GDS, obtain a copy of Working in the CERT System on eServices. The topic that explains this is "Sign into Cert."

Log in to eservices.sabre.com with your PROD Sabre GDS credentials and make the following selections: From Training, choose Quick References > Workflow Efficiency Tools > Productivity Tools. A link to the document is displayed.

Question: I cannot log in to DevStream on http://devstream.cubeless.com/account/login.

Answer: If you forgot your login name, click the Forgot Login link and type your email address. If you forgot your password, click the Forgot Password link and supply your login name. For more help, contact your Sabre account manager.

Question: How can I get access to the Developer Resource Center, or DRC, on https://drc.sabre.com?

Answer: When you purchase a contract to use Sabre Web Services, you receive login credentials for the Developer Resource Center. For information, contact your Sabre account manager.

Sabre Red 360

Question: Does Sabre Red 360 inform end-users when Red Apps are installed, upgraded, or removed from their workspace?

Answer: Sabre Red 360 displays a single alert to end-users whenever one or more Red Apps is installed, removed, upgraded or downgraded to a different version. The alert also prompts users to restart Sabre Red 360.

image5

Question: How does our agency use the Agency Admin Tool to "turn on" or enable a Red App in Sabre Red 360 for our agents?

Answer: Obtain a copy of the Agency Administration Tools User Guide. Log in to Agency eServices on http://eservices.sabre.com with your PROD Sabre GDS credentials. Choose Training > Quick References > Sabre Red 360, and then Agency Administrator Tools. This guide explains how to enable applications in Sabre Red 360.

Sabre Red App Centre and Dev Centre

Question: How can I verify the syntax of my company name?

Answer: Log in to the Dev Centre (https://www.sabreredappcentre.sabre.com/) and select Settings.

Question: Where can I review the information that I included on my Red App proposal?

Answer: You can view the information on your proposal in the Message Centre. Look for the "Proposal Submitted" message. The message lists everything you included on the Red App Proposal form.

Question: I lost my Red App ID. How can I find it?

Answer: You can find your Red App ID in the Message Centre on the Sabre Red App Centre (https://www.sabreredappcentre.sabre.com/). Look for the "Proposal Approved" message. The message contains your Red App ID.

Question: Can I provide a description of my Red App in multiple languages on the Sabre Red App Market Centre?

Answer: English is the required default language, however, you can select additional languages when you submit your Red App proposal or when you upload your Red App to Sabre for certification.

You can choose any of the languages that the Red App Centre supports:

English, French, German, Italian, Japanese, Portuguese, Russian, and Spanish

You must provide a translated description of your Red App for each language that you select. Buyers will see your translated descriptions on the Market Centre.

It is optional to provide tags and screen captures for any language, including English. If you do not provide these items for your optional languages, buyers will see the English versions.