inFORM Decisions Information Portal

User Tools

Site Tools

Trace:
pub:installation_for_idocs_6.x

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
pub:installation_for_idocs_6.x [2021/12/06 18:20] – [Step 3. Complete the Installation on the Power System] kkramerpub:installation_for_idocs_6.x [2022/06/25 17:02] (current) – external edit 127.0.0.1
Line 252: Line 252:
   *    If they reflect the values of the originally installed file, then select F3 to exit and continue instructions.   *    If they reflect the values of the originally installed file, then select F3 to exit and continue instructions.
  
-Using the WRKLNK command navigate to /qibm/UserData/Java400/ext [The command is wrklnk '/qibm/UserData/Java400/ext/*'] and inspect the directory for the IFDJAVA.JAR file.  +Using the WRKLNK command navigate to /qibm/UserData/Java400/ext [The command is **wrklnk '/qibm/UserData/Java400/ext/*'**] and inspect the directory for the IFDJAVA.JAR file.  
 If you don’t find the file continue with the next Step 2.  If you don’t find the file continue with the next Step 2. 
  
 If you find the IFDJAVA.JAR file select the file with option 8=Display attributes and inspect the dates to confirm if the file is the currently installed file.  If it’s the currently installed file, then you can simply move it to the directory you want the file to be saved to for use.  If the file is not currently installed, then it’s most likely the file in use.  At this point you will want to move the file to a new directory.  Follow the steps in Step 2 of the instructions to move the file or delete. If you find the IFDJAVA.JAR file select the file with option 8=Display attributes and inspect the dates to confirm if the file is the currently installed file.  If it’s the currently installed file, then you can simply move it to the directory you want the file to be saved to for use.  If the file is not currently installed, then it’s most likely the file in use.  At this point you will want to move the file to a new directory.  Follow the steps in Step 2 of the instructions to move the file or delete.
  
-Step 2. Remove or move the currently installed poi and IFDJAVA.JAR files to new directory+==Step 2. Remove or move the currently installed poi and IFDJAVA.JAR files to new directory==
  
-Note: These files will not be needed anymore once the new IFDJAVA.JAR file is restored to the directory.  Optionally, these files can be deleted instead of being moved to a new directory.+**Note:** These files will not be needed anymore once the new IFDJAVA.JAR file is restored to the directory.  Optionally, these files can be deleted instead of being moved to a new directory.
  
-To Move the files to a new directory:+**To Move the files to a new directory:**
 Make a new directory by using the MKDIR command for example mkdir ‘/home/idocs681’ Make a new directory by using the MKDIR command for example mkdir ‘/home/idocs681’
 Select the poi and IFDJAVA.JAR files in the original directory with option 10 to move to the newly created directory Select the poi and IFDJAVA.JAR files in the original directory with option 10 to move to the newly created directory
  
-To delete the files:+**To delete the files:**
 Select the poi and IFDJAVA.JAR files with option 4=Remove and [Enter] Select the poi and IFDJAVA.JAR files with option 4=Remove and [Enter]
  
-Step 3. Restore the new IFDJAVA.JAR file to the directory of your choice+===Step 3. Restore the new IFDJAVA.JAR file to the directory of your choice===
  
 On the command line type RST and prompt with F4 On the command line type RST and prompt with F4
 Fill in the parameters as shown below and select [Enter] to execute Fill in the parameters as shown below and select [Enter] to execute
  
-Device = ‘/qsys.lib/fmg.lib/jarfiles.file’ [This is where we are getting the files from] +**Device** = ‘/qsys.lib/fmg.lib/jarfiles.file’ [This is where we are getting the files from]\\ 
-Objects: Name = ‘/qibm/userdata/java400/ext/ifdjava.jar’ [This is the file we need] +**Objects: Name** = ‘/qibm/userdata/java400/ext/ifdjava.jar’ [This is the file we need]\\ 
-Include or Omit = *INCLUDE [We want the file to be included] +**Include or Omit** = *INCLUDE [We want the file to be included]\\ 
-New object name = ‘/xxxx/ifdjava.jar’ [xxxx equals the directory path you want to use.  For example ‘/qibm/ifdjava.far’] +New object name = ‘/xxxx/ifdjava.jar’ [xxxx equals the directory path you want to use.  For example ‘/qibm/ifdjava.far’]\\ 
-New pattern: Pattern = ‘*’ [Keep the default] +**New pattern: Pattern** = ‘*’ [Keep the default]\\ 
-Include or Omit = *INCLUDE [We want the file to be included]+**Include or Omit** = *INCLUDE [We want the file to be included]\\
  
 Sample screenshot below… Sample screenshot below…
 +<html><pre>
 +                              Restore Object (RST)                              
 +                                                                                
 + Type choices, press Enter.                                                     
 +                                                                                
 + Device . . . . . . . . . . . . .   '/qsys.lib/fmg.lib/jarfiles.file'           
 +                                                                                
 +                + for more values                                               
 +                                                                                
 + Objects:                                                                       
 +   Name . . . . . . . . . . . . .   'qibm/userdata/java400/ext/ifdjava.jar      
 +                                                                                
 +   Include or omit  . . . . . . .   *INCLUDE      *INCLUDE, *OMIT               
 +   New object name  . . . . . . .   '/qibm/ifdjava.jar'                         
 +                                                                                
 +                + for more values                                               
 + Name pattern:                                                                  
 +   Pattern  . . . . . . . . . . .   '*'                                         
 +                                                                                
 +   Include or omit  . . . . . . .   *INCLUDE      *INCLUDE, *OMIT               
 +                + for more values                                               
 +                                                                        More... 
 + F3=Exit   F4=Prompt   F5=Refresh   F10=Additional parameters   F12=Cancel      
 + F13=How to use this display        F24=More keys                               
 +                                                                                
 +</pre></html>
 +Once done, navigate to the directory using the WRKLNK command to confirm the new file has been installed.
 +If installed, then log-off/log-on and test
 +If not installed, inspect the job log for any error and try to resolve any issues.
  
 +===Step 4: Testing===
 +Try sending out an email.  
 +  - If it works and you receive your test email, then you are done.
 +  - If you do not receive a Java error because the .jar file can’t be located, then you will need to add a CLASSPATH setting.  See below for how to setup the CLASSPATH.  Once you setup the CLASSPATH, log-off/log-on and retest.
 +
 +===Instructions To Add CLASSPATH to run IFDJAVA.JAR file===
 +
 +**Notes before we setup Classpath:**
 +Move the ifdjava.jar file to a directory on the IBMi that is not in /qibm/UserData/Java400/ext
 +Example /idocs/idocs694/
 +
 +** To add CLASSPATH:**
 +Type WRKENVVAR LEVEL(*SYS) on the command line and [Enter]
 +Note: You want the level to be *SYS and not *JOB.  *JOB is for the current job only
 +
 +If a CLASSPATH already exist, then take option 2. Change on the CLASSPATH to add to the new value.
 +To Add to the New Value parameter, add the new string value after the starting single quote and end the string with a semicolon at the end of the new string value and the start of the current value.  Then [Enter] to save.
 +Example: If we are adding /idocs/idocs694/ifdjava.jar to '/qopensys/QIBM/ProdData/JavaVM/jdk60/32bit', then it would look like this:
 +'/idocs/idocs694/ifdjava.jar:/qopensys/QIBM/ProdData/JavaVM/jdk60/32bit'
 +
 + If a no CLASSPATH already exist, then take option 1. Add on the first row and type CLASSPATH then [Enter]
 +Example:
 +<html><pre>
 +                       Work with Environment Vars (*SYS)                        
 +                                                                                
 + Type options, press Enter.                                                     
 +   1=Add   2=Change   4=Remove   5=Display details   6=Print                    
 +                                                                                
 + Opt  Name                        Value                                         
 +  .                                                                             
 +  .   JAVA_HOME                   '/qopensys/QIBM/ProdData/JavaVM/jdk' >        
 +      JAVA_OPTS                   '-Dos400.awt.native=true -Djava.awt' >        
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                         Bottom 
 +</pre></html>                                                                               
 +
 +In the Initial value parameter add the string value in between singles quotes, and then [Enter]\\
 +Example ‘/idocs/idocs694/ifdjava.jar’
 +
 +Once done sign off and then back on for testing
  
 **To save memory, in version 6.94 and higher any iMail log data will not be migrated into the new library. You will have to visit the old library to view the old email logging entries.** **To save memory, in version 6.94 and higher any iMail log data will not be migrated into the new library. You will have to visit the old library to view the old email logging entries.**
pub/installation_for_idocs_6.x.1638843630.txt.gz · Last modified: 2022/06/25 17:02 (external edit)