How to install Aperio framework?

Prerequisite check

Make sure that all RPG method sources are available. Current version of metadata retrieves information directly from the source on the fly. If the RPG source members for methods are not available or stored in library which is not on library list, then this process will fail. Make sure that all sources contain necessary @APIDOC_ tags which describes Your methods. If the RPG programs source location is specific in Your environment, make sure to write exit program which will be able to localize source file based on RPG program location. The example of exit programs are located in QSAMPLES source file delivered together with Aperio.

Installation process

To install do the following:

  1. See prerequisite check heading.
  2. Create user profile APIPRF (if not already existing).
  3. Restore IAF100AP library.
  4. Decide where the metadata information should be placed. Usually the metadata information is placed in API framework library (IAF100AP).
  5. Decide where the control information should be placed. Usually the control information is placed in API framework library (IAF100AP).
  6. Decide where the configuration information will be placed. Usually the configuration information is placed in API framework library (IAF100AP).
  7. Add API framework library to current job library list (ADDLIBLE IAF100AP).
  8. If the metadata library is different than API framework library, then add metadata library to current library list.

NOTE: It must be above API framework library (ADDLIBLE XXXXX).

  1. If the control library is different than API framework library, then add control library to current library list.

NOTE: It must be above API framework library (ADDLIBLE XXXXX).

  1. If the configuration library is different than API framework library, then add configuration library to current library list.

NOTE: It must be above API framework library (ADDLIBLE XXXXX).

  1. Run command INZAPIF to initialize API framework.

NOTE: You must provide metadata, control, configuration and notification data libraries.

  • If metadata library is the same as framework library, then enter IAF100AP as metadata library.
  • If control library is the same as framework library, then enter IAF100AP as control library.
  • If configuration library is the same as framework library, then enter IAF100AP as configuration library.
  • If notification data library is the same as framework library, then enter IAF100AP as notification data library.
  • Set mode selection to *ALL.
  1. Add APIPRF as supplemental group profile to users who should have access to API.

NOTE: All objects in IAF100AP library are owned by APIPRF. Administrator can either add supplemental group profile APIPRF to each user who uses API or just change authority for objects in IAF100AP library.