Creating licenses from an electronic entitlement (Passport Advantage PPA)

Customers who have purchased IBM software may download into Maximo IT the electronic entitlements for those products from the IBM Passport Advantage site (PPA). The PPAIMPORT cron task is used for this.

The PPA and Enterprise Software Management Tool (ESMT) procurement systems have the ability to export information in spreadsheet or CSV format. Once exported, the data can be easily modified to conform to the CSV format. Please note that the column names provided by PPA or ESMT may not align with what is described below. The modified CSV file can then be copied to a directory in the application server that is being monitored by the new cron task.

To set up and enable the PPAIMPORT cron task, complete these steps:
  1. Open the Cron Task Application. (Open menu > System Configuration > Platform Configuration > Cron Task Setup).
  2. In the Cron Task Instances section, set the Schedule, Run as User, and Active values.
  3. Set the Schedule to select how often this instance is to be called.
  4. Set the Run as User to select the user and privileges that this instance will have when it runs.
  5. Set the Active value if you want the instance to run according to its schedule.
  6. Reference the Parameters tab to view the names, current value, and description of the parameters that are accepted by the cron task.
    Parameter Default Value Description
    COMPANY Company to use when creating a license.
    DELIMITER The character used to separate values in a row. Typically this is a comma.
    DIRECTORY C:\\TEMP\\ The directory on the application server to poll for files to import. This directory must be readable and writable by the OS server running the application server. Back slashes in Windows paths must be escaped (e.g. C:\\temp\\) or replaced with forward slashes. Trailing slashes should be included (e.g. /tmp/). Relative paths will be resolved in context of the current directory for the application server.
    ORGANIZATION Organization to use when creating a license.
    STATUS Status to use when creating a license. Valid status values are DRAFT, ACTIVE, REQUESTED, CANCELED or EXPIRED. For a non-English environment, non-English values need to be used here. Takes one of the values based on the synonym domain TLOAMLICSTATUS.
    TEXQUALIFIER Character used to wrap values (e.g. "10,000"). Typically, this is a double quote.
  7. Click Save Cron Task Definition.
  8. Go to More Actions > Reload Request to complete the installation.