          eRPG Software Development Kit (eRPG SDK) v3.30  
--------------------------------------------------------------------
                         Installation

**Please Note**
If you are upgrading from a version prior to v3.00 you will need to
apply a temporary key and then notify us of your version upgrade so 
we can send you a new license key.

1. Create a save file that will hold the eRPG SDK Library:
    
    CRTSAVF FILE(QGPL/ERPGSDK)    
    
2. FTP the ERPGSDK save files from your PC to the 
    IBM i in BINARY mode into the save file(s) with the same 
    name created in the previous steps.

3. Restore the ERPGSDK save file.  Keep in mind that if you have
    already installed the eRPG SDK the following commands will remove
    any changes that you made to any of the included files, templates,
    etc.
    
     If the ERPGSDK library does not exist, create it:
      
      CRTLIB LIB(ERPGSDK)

     If you are installing from a previous version, rename your ERPGSDK library:

      RNMOBJ OBJ(ERPGSDK) OBJTYPE(*LIB) NEWOBJ(ERPGSDKOLD)
       
     Restore the eRPG SDK objects to the ERPGSDK library:
      
      RSTOBJ OBJ(*ALL) SAVLIB(ERPGSDK) DEV(*SAVF) SAVF(QGPL/ERPGSDK) MBROPT(*ALL) ALWOBJDIF(*ALL)
 
4. Add the library ERPGSDK to the top of your library list.

    ADDLIBLE LIB(ERPGSDK)

5. If you haven't already requested a temporary registration key or purchased
    a permanent registration key, please visit http://www.bvstools.com/erpgsdk/.
    You will need a registration key (temporary or permanent) to enter during 
    the next step.

6.  If you are upgrading from a previous version, you should be done at this point.
     All you need to do is make sure that any production or development libraries get
     new copies of the service programs in the ERPGSDK library and the /COPY members
     are updated as well (these are located in source physical file QCOPYSRC).

    If you are installing for the first time, continue on with the following instructions.
 
7. Run the SETUP command in the ERPGSDK library.  

    ERPGSDK/SETUP

   Note:  If you changed the default file location for the HTTP Configuration 
    File on the SETUP command, you will need to also update the HTTP server 
    instance to point to the right configuration file.  Contact me
    for assistance with this.

8. Start the HTTP server assigned to the eRPG SDK. 

    STRTCPSVR SERVER(*HTTP) HTTPSVR(ERPGSDK)
    
9. Point your browser to:
  
    http://yourserver:port/

    Where "yourserver" is the IP address and "port" is the port you specified
    on the SETUP command.

Note:  If you encounter any problems during the installation of the eRPG SDK, 
 feel free to concact me.  Contact information can be found at:

 http://www.bvstools.com/contact.html
    
---------------------------------------------------------------------
                          Requirements

The eRPG SDK was created on a IBM i running V5R4.  The 
eRPG SDK requires at least V5R2 of the operating system.

---------------------------------------------------------------------
                         Registration 

Temporary or permanent registration keys can be aquired by contacting me.

 http://www.bvstools.com/contact.html

---------------------------------------------------------------------                     
                              Updates 
v1.00 - Original    
v1.01 - Changed max template and buffer sizes from 32k to 64k  
v2.00 - Minor changes, moved out of Beta status to Production status
        SP150203 - Fixed bug in #replaceData subprocedure for V4R5 machines.
           Added more initialization to #startup procedure.
           Updated #buildCookie subprocedure to accept a negative number
            in order to expire cookies.
           Fixed bug in #replaceData when the replacement value was blank
            it would use a single space.  Now it will replace with no value.
            Example:
             <data>/%mydata%/</data>
             #replaceData('/%mydata%/':myvalue)
             If myvalue is blank, the result will be:
              <data></data>
			Added the name of the calling program to the job log when an error
			 was encountered on subprocedures such as #replaceData, #loadSection, etc.
            Added #CovertTimeZone() to the F.DATE service program.  Any programs that use
             F.DATE or F.ERPGSDK should be recompiled.
            Fixed bug when setting cookie.  Year was getting put at the end of the string.
v2.10 -  Added #setCCSIDStdOut() subprocedure which allows you to set the CCSID of the output
          going to Standard Output (StdOut).  This is useful when the content type of your
          output is something other than text/* (such as application/json) as the HTTP
          server will not automatically convert the data from EBCDIC to ASCII.
         Added DSPJSON example and updated template files used in examples.
v3.00 -  Updated for SaaS/subscription licensing.
         SP211215 - Recompiled SETUP programs because of damage object(s).
v3.10 - Updated F.IFSSTD functions to include a couple new functions. 
v3.20 - Increased sizes of some fields/parameters from 65k to 102k.  Recomiple may be
         necessary for any programs using the eRPG SDK functions.
        SP231224 - Added HttpOnly option to BuildCookie() function.
v3.30 - Deprecated #setCodePage() function.  Use the new #setCCSID() function instead.
        Updated IFS functions to be more friendly with V7R2 and up (ie using CCSID instead
         of code page). 
---------------------------------------------------------------------
-=-=-=-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

                   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.


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