                 GreenTools for USP (G4UPS) v2.00
--------------------------------------------------------------------
                         Installation
                     
1. If you are installing G4UPS for the first time, skip to step 2.
    If you are installing G4UPS as an upgrade to a previous release,
    rename your G4UPS library to G4UPSOLD.  Do this by issuing the
    following command:
    
    RNMOBJ OBJ(G4UPS) OBJTYPE(*LIB) NEWOBJ(G4UPSOLD)

2. Issue the IBM i command: 
    CRTSAVF FILE(QGPL/G4UPS)    

3. FTP the file G4UPS from your PC to the IBM i in BINARY mode
    into the save file G4UPS in library QGPL.

4. Issue the IBM i command:
    RSTLIB SAVLIB(G4UPS) DEV(*SAVF) SAVF(QGPL/G4UPS)

5. If you are installing G4UPS for the first time, skip to step 6.
  
   If you are installing G4UPS as an upgrade from a previous	
    version, you will want to restore the control files used
    by G4UPS.   

    Issue the following command:
    ADDLIBLE LIB(G4UPS)
    G4UPSUPDAT OLDLIB(G4UPSOLD) NEWLIB(G4UPS)

6.  If you are upgrading, please make sure that
     the /COPY members in QCOPYSRC were restored.  Recompile any 
     programs using the F.G4UPS service programs.
	 
7. See the documentation for G4UPS at http://docs.bvstools.com for more
    information on functionality.  (coming soon)

8. If you are installing for the first time, you will want to sign onto your
    UPS Account and create an application named G4UPS.  Make sure to specify the
    following in the setup:

    Callback URL: https://www.bvstools.com/g4upsoauth

    Once this is done you will need to update the G4UPSSVCPF file. 
     For each record you will update:
      [clientid] = Your app's client ID.
      [clientsecret] = Your app's client secret.
      [account number] = Your app's account number.
     
     DO NOT CHANGE ANY OTHER VALUES on the records.

9. If you are using any of the Auth Code services, you will need to register 
    your account using the G4UPSREGSV command.  Specify your UPS ID 
    for the ID and *G4UPS_AC_TEST or *G4UPS_AC_LIVE as the service.  
    
    If you are re-registering for any reason, be sure to specify REDO(*YES) 
     on the G4UPSREGSV command.
    
    Follow the instructions on the screen, and then the web page(s) you will 
     be directed to.

10. You can now test using the G4UPSTOKEN program supplied in the QRPGLESRC
     source member.  Just fill in your UPS id in the id field, compile the 
     program and run it in debug mode to see if you are retrieving a token.
  
---------------------------------------------------------------------
                          Requirements

G4UPS was created on a IBM i running V7R5.  G4UPS  
 requires at least V7R3 of the operating system.

G4UPS requires GETURI v13.00 (included in G4UPS library) or higher 
 (www.bvstools.com/geturi.html) as a base component for functionality.  
 
Each addon included with G4UPS requires separate registration.  You can
 receive temporary keys for each using the Quick key feature located
 at the top of any page on our site (www.bvstools.com). 
 
This version of G4UPS includes the following addons:
 - None
 ---------------------------------------------------------------------
                         Registration 

A variety of registration options are available.  Please visit:

           http://www.bvstools.com/G4UPS.html           
        
---------------------------------------------------------------------                     
                              Updates 
G4UPS
v1.00 - Original  
        SP250304 - Updated JSON processing to make sure that the pointer
         isn't null before freeing it.
V2.00 - Changed to create services that are as follows:
        *G4IPS_AC_TEST - Auth Code Flow for Test Environment
          Requires registration with G4UPSREGSV command
        *G4IPS_AC_LIVE - Auth Code Flow for Live Environment
          Requires registration with G4UPSREGSV command
        *G4IPS_CC_TEST - Client Credentials Flow for Test Environment
          Does NOT Require registration with G4UPSREGSV command
        *G4IPS_CC_LIVE - Client Credentials Flow for Live Environment
          Does NOT Require registration with G4UPSREGSV command

         In most cases the last 2 will be used.  See program G4UPSTOKEN
          in QRPGLESRC for examples.

         Added a control file (G4UPSCTLPF) for static values.
---------------------------------------------------------------------
-=-=-=-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

                   DISCLAIMER OF WARRANTY

 THIS SOFTWARE IS SOLD "AS IS" AND WITHOUT WARRANTIES AS TO
 PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER
 EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE
 ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF
 FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING
 PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH
 NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER MUST ASSUME THE
 ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER
 WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF
 THE PURCHASE PRICE.

       If you do not agree, please do not use this product.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=