Select a help topic by 'clicking' on it. The page will then jump to the description of the selected topic. You can go back to the top of the page by clicking on Back to top link.

If you can not find the necessary information in this page, you can contact our WW customer support center, phone number and email addresses can be found under Contacts

User guidelines and other work instructions in PDF format

This is a list of help content available in pdf format for printing of offline wieving.

To view or print the materials below you will need a PDF viewer like Adobe Reader or similar Get the Adobe® Reader®


Sign in

  1. Register for a IBM id
    Make sure that you have registered for a user id an IBM registration.
  2. User id/password combination not known:
    A valid combination of user id and password is required to complete the sign in transaction. Passwords are case sensitive.
    1. Make sure that caps lock is not on accidentally.
    2. Make sure that you have registered for a user id an IBM registration.
  3. First time registration
    To work with the application, an access profile needs to be created. A combination of customer number and order number, (visible on the packing list), is necessary to validate the users access to the hardware inventory.


Administrator functions

Administrator functions provide a way to manage the authority of users to work with the software to which your company is entitled.

There are two administrator functions: register an IBM customer number, and manage customer numbers.

Register an IBM customer number

This is the first step, and is required one time only. The reason that the customer number must be registered is so IBM can (1) validate whether a person is entitled to work with the software, and (2) establish the primary contact for the customer number.


To register a customer number, enter the customer number and either of the following: order number or system number.

You can find the customer number, order number, and system number in the documentation that was shipped with your software order.

After the customer number is registered, other user IDs can be authorized to the applications by the administrator.

Manage customer numbers

The applications within Entitled Software Support require that users obtain authorization from a person who is an employee of the company that is entitled to the software.

There are two types of authorities: application authorities and special authorities.

Application authorities are specific to each application, and provide a way to grant access to some portions of the application, but limit access to the most critical portions of the application. For example, the administrator may set up the authorites for three users as follows.

  1. Two users can view electronic Proof of Entitlement, but not transfer electronic Proof of Entitlement.
  2. One user can view electronic Proof of Entitlement, and can transfer electronic Proof of Entitlement.

The administrator may grant a different level of authority to each person, and may grant access to some applications and not to other applications.

Special authorities include primary contact and administrator authority.

Each administrator has the same ability as another administrator to manage the authorizations, including the ability to manage who the primary contact is. Ensure that the appropriate person has this role.

To administer user IDs, do the following.

  1. Click on Manage customer numbers on the left side of the page.
  2. Select either Show all customer numbers or Show only this customer number, and click the Continue button.
  3. Select the customer number, and click the Manage authorizations button.
  4. Enter the user ID, and click the Continue button.
  5. Select the authorities for the user ID, and click either the button to Update or Remove user ID.

The administrator functions also provide the ability to specify a nickname for each system. To work with the nicknames, do the following.

  1. Click on Manage customer numbers on the left side of the page.
  2. Select either Show all customer numbers or Show only this customer number, and click the Continue button.
  3. Select the customer number, and click the Edit nicknames button.
  4. Enter the nickname next to the machine type and serial number, and click the Update nicknames button.


View my authorizations

Any authorized user may view his or her authorities by doing the following.

  1. Click on View my authorizations on the left side of the page.
  2. Select either Show all customer numbers or Show only this customer number, and click the Continue button.
  3. Select the customer number, and click the View authorization details button.


Software Updates

This application is currently supported for IBM i and AIX. A current IBM Software Maintenance Agreement (SWMA) or Software Subscription contract is required. If you do not have a current SWMA in place, please contact your IBM sales point. If you have signed a contract with IBM, you may contact your IBM sales point or send an e-mail to Products ordered through Passport Advantage are NOT supported by this application.

Overview: "Entitled Software Updates" is a web-based application tool that provides IBM Customers and IBM Business Partners (on behalf of a Customer) with a new simplified, streamlined process for ordering entitled (i.e. no charge) software updates for IBM i and AIX systems. This process eliminates the need for configuration reports, hardcopy electronic Proof of Entitlement (ePoE(s)), and purchase orders (unless still required by your internal processes) previously required by the existing order process. You can now request your entitled software updates when you want them via the web.

Step 1: Select a Customer number and a Hardware serial number.

Select a customer number.

This step identifies the Customer number that this transaction will be processed for. By clicking on the drop down menu titled, "Customer Number", you are presented with two alternatives.

Select a machine type and a hardware serial number.

This step selects the specific IBM i or AIX system for which the entitled software update is being ordered. Clicking on the drop down menu titled, "Machine Type/Serial Number", will present you a list of machine type and serial numbers for which you have been authorized, based on your search argument in the step above. You MUST SELECT a MACHINE TYPE and a SERIAL NUMBER to continue entering your order. If you do not see the desired machine type and serial number combination in the displayed list, contact your administrator or customer focal point to have it added to your list of authorizations.

Upon selecting a machine type/serial number, you will be presented with a list of software products entitled to be updated for that specific system.

Step 2: Verify the software inventory records.

Step 3: Select a language.

Note: IBM i V7 products use language groups. See IBM i V7 language groups for a list of languages included in each group.

Step 4: Order summary - Verify 'Ship To' Address and select the delivery and media option.

Verifying the delivery address: The application presents the user with a summary of the order and the "ship to" address contained in IBM's records for the selected customer number. If a modification is desired, click on edit shipping address. The following changes may be made:

Edit e-mail distribution list: As the user (i.e. person entering the order), you will automatically be sent an e-mail confirming receipt of your order by IBM. You are also given the option of adding additional recipients of this e-mail, that you would want to notify that an order has been submitted. If desired, add the additional e-mail addresses in the input fields presented on the screen, and click on the Go or Continue button to continue.

Before submitting the order, the user will need to select the delivery Option and media option.

Delivery option: The User have 3 options for delivery:

The media option: There is several media options for physical delivery. Clicking on the drop down menu for "Media type for physical delivery" presents a choice for how you would like your software provided in this order. The options range from shipping both SW media and publications to only ship publications. Only one choice is permitted.

Note For physical delivery you can follow the shipment of your order, check the delivery date, contact Online Support if the package is lost or damaged, on the Track my orders link on the right hand menu bar under the Software updates function.

Step 5: Submit the Order

Verify that everything is now correct, and click on the Submit button to submit your order to IBM for the entitled software update.

An "order confirmation" message with the order numbers will be sent to your e-mail address and any other e-mail addresses you might have included. Use the customer number and the order numbers to trace your physical delivery on Track my orders link.

NOTE: If you still have questions or are having problems with this application, contact the Customer support. All contact information are available under contacts in the right hand menu .


Power i, iSeries, AS/400 software keys

This application provides Power i, iSeries, AS/400 software keys for machine hardware serial numbers registered under your profile.

To work with your keys, after sign on click on Power i, iSeries, AS/400 software keys on the left hand menu and you will be directed to your software keys.

  1. Step 1: Machine selection
    Select a customer number and a machine serial number from the list and click to continue, or use the quick search to look for a machine registered under your profile.
  2. Step 2: Keys version and release selection
    select the IBM i OS version and release for which you want to work with keys. Note that only V5R3 and higher are supported on the website. For any lower version or release, please contact customer support.
  3. Step 3 : software keys selection
    Select at least one product key before you click on one of the options below. You can use the "select all" button at the end of the page if you want to work with all the software keys.

Note: The software license keys generated for a machine hardware serial number are based on the entitlements for this machine . Check under Entitlements function for a list of ePoe's.

For non entitled keys, request should be send to Customer Support. Phone number and e-mail address can be found under "contacts".

Below is a list of actions you can do with your keys

  1. View key sheet
    To view the key sheet(s) select the product(s) and press the view key sheet button at the bottom of the page. From this page you will be able to install the keys, to download or to send the key sheet(s).
  2. Download key sheet
    To download the key sheet(s) follow the below instructions:
    1. Create a new directory in a well identified location on your disk
    2. To download the key sheet(s), select the product(s) and press the Download key(s) button at the bottom of the page
    3. Save the key sheet in this new directory
    4. The key sheet(s) has been downloaded in a .doc file
  3. Install key
    To install a key select product(s) and press the install button.
    1. Before installing the key(s) you must give your permission to let an applet connect to your IBM i machine.
    2. A java security / security warning page will be displayed and you must grant the requested privilege to the certificate by clicking Yes.
    3. Once the certificate has been accepted, click Continue to proceed.
    4. Once the applet has run, you will be prompted to sign on to the IBM i system. Enter a valid host name or TCP/IP address, user id and password. Click OK
    5. The applet will connect you to your IBM i system.

    NB: Note that hardware serial number and key(s) must match with the hardware serial number on the IBM i box. If not, access can not be obtained

  4. Send key sheet
    To send the key sheet(s) to your e-mail address, select product(s) and press the send button.
    If the key sheets have been sent successfully you will be directed to the send confirmation page.
    Note that it is not possible to forward a key to any e-mail address other than the one for which you are signed on.



The ePoE constitutes the official record of your entitlement and contains the following information: Product name, product number, product option number, version, install code id, quantity, proof number, customer number, machine type/serial number (optional). To work with your ePoE(s), after sign on click on the Entitlements link. You will be then directed to your electronic proof(s) of entitlement. On this page, you can either Transfer ePoE(s) or View ePoE(s) list.

  1. Transfer ePoE To transfer ePoE(s) click on the Transfer ePoE button
    1. Select the ePoE transfer source customer number and machine type/serial number in "Step 1: Select transfer from customer / machine."
    2. Select the ePoE transfer target customer number and machine type/serial number in "Step 2: Select transfer to customer / machine."
    3. Click on the Go button. A list of all ePoEs available on the transfer from Machine is displayed.
    4. Select all ePoE(s) to be transferred and click on the Continue button.
    5. You will be then directed to the ePoE(s) validate transfer page. After verification click on the Continue button. The applet sign on procedure starts (see Install key for more information).
    6. Once the transfer is completed, a transfer confirmation page will be displayed.

NB: If an ePoE does not have a hardware serial number assigned, you can transfer it to the hardware serial number attached to it. This can be done without being signed on to the IBM i server.

  1. View ePoE list
    To view the complete ePoE list click on the View ePoE list button.
    1. Select a customer number and a machine type/serial number (you can also choose all available) and click on the Go button.
    2. Select at least one ePoE, and click on the View/Print button.
    3. To print the ePoE(s), click on the Print this page button.

NB: i5/OS Base 5722-SS1, V5R3M0 (Install Code Id's of 5050 and 5051) and its Bonus Programs are bundled with the hardware. The two products will be shown under the View/Print ePoE(s) but not under the transfer option as both are not transferable.


Hardware set up and configuration

  1. System set-up
    For IBM i :
    1. Ensure that TCP/IP is installed and configured on the system.
    2. The operating system must be OS/400 V4R2 or higher.
    3. The BOSS option 12 must be installed on the system (host servers) and the host servers must be active. The "STRHOSTSVR * ALL" command can be used to start the servers.
    4. Ensure that the QUSER profile is enabled. This is required by the host servers.
  2. Client configuration
    For the workstation or PC:
    1. Ensure that TCP/IP is installed and configured on the workstation.
    2. Ensure that the workstation is connected to the IBM i server over TCP/IP.
    3. The web browser used can be either Netscape 4.7 (or higher) or Microsoft Internet Explorer 4.0 (or higher). Also newer versions of Opera & Mozilla can be used.
    4. Java support must be enabled in the browser. To enable this support, use the preferences (Netscape) or tools (Internet Explorer) options on your browser.
    5. Your company must accept applets to run within your browser.
    6. When prompted, you must accept the security certificate in order to allow the signed, trusted applet to connect to the system within your network.


Data report

The data in the report will be extracted from your Entitled Software Support profile.
Check Administrator functions for any additional information on how to register a customer number.

  1. Submitting a report
  2. Report descriptions.
  3. Comma-separated values (CSV) format.


IBM i Evaluation, Try & Buy and NLV download

IBM i Evaluation, Try & Buy and NLV download will allow IBM i and AIX users to download IBM i evaluation software products and any secondary National Language Version without the need of an entitlement. A current SWMA is not required neither.

Users can download the below software products under this function.

Step 1: Machine selection.

IBM i and AIX systems registered under your profile are both available. Click on the drop down menu titled "Machine Type/Serial Number" to present you a list of machine type and serial numbers. A MACHINE TYPE and a SERIAL NUMBER must be selected to continue with IBM i Evaluation, Try & Buy and NLV download. If the desired machine is not listed, contact your administrator or customer focal point to have it added to your list of authorizations. Upon selecting a machine type/serial number, you will be presented with a list of software products. The list will be the same for every machine.

Step 2: Select a product and a language :

Select the product number for the required version and release and the desired language (for i/OS evaluation software only), then click on Continue. Only one product can be selected at a time.

Step 3: Download

For further information on how to download, use the Help section of Electronic Software Delivery.

Note: For IBM i/OS evaluation software, the trial use period will be of 70 days. An additional 70-day trial use period for the same VRM level will not install on a customer\'s machine. Call center: click on Contacts on the right hand menu for e-mail or phone number information.


IBM i V7 language groups

IBM i V7 products will use language groups instead of specific languages like in previous versions. there are 3 groups available and the mapping to the presious language features can be found below.

Language groups for IBM i V7
Lang Grp 1 Americas/EuropeLang Grp 2 CEEMEALang Grp 3 Asia Pacific
5770-SS1 feature 5817 5770-SS1 feature 5818 5770-SS1 feature 5819
- 2924 English - 2924 English - 2924 English
- 2963 Belgian Dutch IVINCS - 2995 Albanian - 2938 English DBCS
- 2909 Belgium English - 2954 Arabic - 2984 English DBCS
- 2966 Belgian French IVINCS - 2974 Bulgarian - 2930 Japanese Universal
- 2980 Brazilian Portuguese - 2912 Croatian - 2962 Japanese Katakana
- 2981 Canadian French IVINCS - 2975 Czech - 2986 Korean
- 2926 Danish - 2902 Estonian - 2906 Laotian
- 2923 Dutch Netherlands - 2998 Farsi - 2989 Simplified Chinese
- 2925 Finnish - 2957 Greek - 2987 Traditional Chinese
- 2928 French - 2961 Hebrew - 2972 Thai
- 2940 French IVINCS - 2976 Hungarian - 2905 Vietnamese
- 2929 German - 2904 Latvian
- 2939 German IVINCS - 2903 Lithuanian
- 2958 Icelandic - 2913 Macedonian
- 2932 Italian - 2978 Polish
- 2942 Italian IVINCS - 2992 Romanian
- 2933 Norwegian - 2979 Russian
- 2922 Portuguese - 2914 Serbian
- 2996 Portuguese IVINCS - 2994 Slovakian
- 2931 Spanish - 2911 Slovenian
- 2937 Swedish - 2956 Turkish


Products Specification

  1. Development/demo licensed products


SWMA records

The SWMA Records function is to be used to verify Software Maintenance inventory data for purchased software programs. This function is available for IBM I, AIX and Storage. An active SWMA is required for any software update, including Software Updates support. An active SWMA is required for AIX on Electronic Software Download support. Both Order update and Software downloads are discussed elsewhere in this document.


User preferences

You can use user preferences to narrow search to IBM i, AIX or storage Brand. You can also decide to receive email notificaton for SWMA about to expire, ESD notification and Newflash


View, Download and request update access keys

Existing hardware keys for one or multiple machines can be viewed, downloaded, send by email and renewed.

A list of machines and related keys you want to work with can be created by entering one or more machines manually by stating machine type (4 characters) and machine serial (7 characters). Alternatively a .txt file can be uploaded. The file should contain machine type and machine serial separated by comma.

A machine in the list can be removed from the listing at any time by selecting the machine and using the 'delete' function button.

  • View Key:

    Viewing the key will present the selected machines' current key(s) on the screen. ESS will show the most current key which might be active or expired.

  • Send Key:

    Sending the key will provide the selected key(s) as email to the email address associated with the IBM ID used.

  • Download Key:

    Downloading key(s) will make selected hardware keys available for download in a file format.

  • Request new standard key:

    Using the 'request new standard key function' renew an existing active or inactive key for the selected machine. A renewal attempt will only be possible if the machine has an active or inactive initial key installed and the country stated matches with the country listed in the IBM database. A key renewal will require an active and valid hardware maintenance subscription. Without a valid subscription the renewal request will be denied and the request will result in an error. Furthermore a renewal will only be processed if the expiration date of a potential renewal key will exceed the expiration date of the current installed key. In this case ESS will keep reflecting the current valid key.

If you expect a selected machine to have an initial key assigned but no key is available or a renewal is denied even though you believe the machine is entitled please contact our Exception Handling Team (e-mail address:

Content navigation

Related links