User Tools

Site Tools


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 [2016/10/25 11:49] kenpub:installation_for_idocs_6.x [2022/06/25 17:02] (current) – external edit 127.0.0.1
Line 92: Line 92:
  
 Prior to restoring your new iDocs 6.x software, you will need to rename your current library from FMG or current name, to a new name.  For example, most people rename their current FMG library to FMGOLD.  If you already have previous library called FMGOLD, maybe from a previous upgrade, you can delete your previous version of FMGOLD and then remain your current library to FMGOLD, or you can give the already existing FMGOLD library a new name, like FMGOLD2, and then continue renaming your current FMG library to FMGOLD. Prior to restoring your new iDocs 6.x software, you will need to rename your current library from FMG or current name, to a new name.  For example, most people rename their current FMG library to FMGOLD.  If you already have previous library called FMGOLD, maybe from a previous upgrade, you can delete your previous version of FMGOLD and then remain your current library to FMGOLD, or you can give the already existing FMGOLD library a new name, like FMGOLD2, and then continue renaming your current FMG library to FMGOLD.
 +
 +**Note:** If you have created any user output queues or files in your iDocs library you will have to save them and manually restore to the new iDocs library.  The COPYDATA procedure will NOT copy user created objects. 
  
 __COMMANDS you can use__: __COMMANDS you can use__:
Line 113: Line 115:
 Then place the new library on the first position on your library list: \\ **ADDLIBLE LIB(ZZZ) POSITION(*FIRST)** Where ZZZ = The new iDocs library name  Then place the new library on the first position on your library list: \\ **ADDLIBLE LIB(ZZZ) POSITION(*FIRST)** Where ZZZ = The new iDocs library name 
  
-The next step is to copy over your form, check, and engine definitions. Use this Command to copy your information from your old FMG library to your new FMG library. Type the command **COPYDATA** and F4 to Prompt: \\ + 
-**COPYDATA** \\+ 
 +===Confirm your current Java version:=== 
 + 
 +On the command line type STRQSH to start QSHELL. 
 +Once QSHELL is started, type java –version and the select [Enter] to evoke the command.  
 +The command will return the current Java version you are using.  Most likely 1.7 or 1.8.  Make note of the version number, and the select [F3] to exit. 
 +  
 + 
 +Confirm the current location of the IFDJAVA.JAR file: 
 + 
 +The IFDJAVA.JAR file will be in one of two locations; 1.) Under QIBM; or 2.) Unique Directory 
 + 
 +First find out if under a unique directory: 
 + 
 +On the command line type WRKENVVAR LEVEL(*SYS) on the command line and [Enter] 
 +If the CLASSPATH already exist, then take option 5=Display details to view the settings and location of the current IFDJAVA.JAR file. 
 +If the CLASSPATH does not exist, then most likely the IFDJAVA.JAR file is under QIBM. 
 +Second find out if under QIBM: 
 + 
 +On the command line type wrklnk '/qibm/UserData/Java400/ext/*' and select [Enter] 
 +Look for the IFDJAVA.JAR file 
 +  
 + 
 +If the IFDJAVA.JAR file is in a unique directory and not under QIBM, then do this:  
 + 
 +Create a new directory location for the new IFDJAVA.JAR file you will be installing during the COPYDATA process.  
 +Type CRTDIR on the command line and prompt with option F4 
 +On the Directory parameter type in the new directory location 
 +For the Public authority for data parameter user *RWX 
 +For the Public authority for object parameter use *ALL  
 +Then enter to create and note the directory path.\\ 
 +Example screenshot: 
 + 
 +{{:pub:idocs:install0001.jpg?600|}} 
 + 
 +Add the new directory path to the CLASSPATH. 
 +On the command line type WRKENVVAR LEVEL(*SYS) on the command line and [Enter] 
 +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/idocs697/ifdjava.jar to '/idocs/idocs688/ifdjava.jar', then it would look like this: 
 +'/idocs/idocs697/ifdjava.jar:/idocs/688/ifdjava.jar' 
 +  
 + 
 +  
 + 
 +If the IFDJAVA.JAR file is under QIBM and not under a unique directory, then do this:  
 + 
 +Navigate to wrklnk'/qibm/UserData/Java400/ext/*' 
 +Delete or move the current IFDJAVA.JAR file 
 +  
 + 
 +Now you are ready to run the COPYDATA command  
 + 
 +**NOTE: Be cautious as once this command is applied it will copy the settings from one library to another and the only way to restore will be from your backup tapes.**  
 + 
 +After confirming the Java version you are using and the location of the IFDJAVA.JAR file sign off and then back on.\\ 
 +Add the new iDocs 6.x library to the top of your library list.\\ 
 +Type COPYDATA on the command line and prompt with option F4.\\ 
 +Fill in the parameters: 
 +From Library parameter will be your current iDocs library, 
 +To Library parameter will be your new iDocs library.\\ 
 +Output queue for log file, \\ 
 +Keep as QPRINT with *LIBL for the library.\\ 
 +Restore Jar files do dir parameter will be the directory path to install the new IFDJAVA.JAR file.\\ 
 +Current system JRE version will be your Java version you are using.\\ 
 +Sample screenshot:  
 + 
 +{{:pub:idocs:install0002.jpg?600|}}  
 + 
 +Once you confirm the information is correct, select [Enter] to process 
 +During the processing you will be prompted if using fax, select N and then [Enter] to continue 
 +  
 + 
 +You can bring up iDocs by typing GO IDOCS and you will see all your information. 
 + 
 +===COPYDATA: Run the COPYDATA command to copy all your settings from your current iDocs library=== 
 +The next step is to copy over your form, check, and engine definitions and spool file mapping. Use this Command to copy your information from your old FMG library to your new FMG library. Type the command **COPYDATA** and F4 to Prompt: \\ 
 \\  \\ 
-Note: //Make sure to use the correct library names on the To and FROM fields.  Once done, it cannot be undone.// +IMPORTANT: //Insure to use the correct library names on the FROM library and TO library fields.  Once done, it cannot be undone.//  
 +<html><pre> 
 +                            Copy Data File (COPYDATA)                            
 +                                                                                 
 + Type choices, press Enter.                                                      
 +                                                                                 
 + From Library . . . . . . . . . .   oldlibrary    Name                           
 + To Library . . . . . . . . . . .   newlibrary    Name                           
 + Output queue for log file  . . .   QPRINT        Name                           
 +   Library  . . . . . . . . . . .     *LIBL       Name, *LIBL, *CURLIB           
 + Restore Jar files to dir . . . .   JARDIR                                       
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                         Bottom  
 + F3=Exit   F4=Prompt   F5=Refresh   F10=Additional parameters   F12=Cancel       
 + F13=How to use this display        F24=More keys  
 +</pre></html> 
 +                             
 +__In version 6.91 we’ve added an additional parameter option on the COPYDATA command.__  With the recent versions of iDocs we load up a .JAR file which is available for those folks using the Java option with iMail.  In order to install the .JAR file in its own separate directory create a directory and use it when prompted for the directory path during the COPYDATA process.  If you leave the .JAR file directory path field empty, the .JAR file will be saved to the QIBM directory.  If you use WebSphere or similar, we recommend that you use a different directory for our .JAR file as to not interfere with other Java based programs.  
 + 
 +To create a directory use: MKDIR 
 +Example: 
 +<html><pre> 
 +C:\IDOCS> ftp 
 +                            Create Directory (MKDIR)                             
 +                                                                                 
 + Type choices, press Enter.                                                      
 +                                                                                 
 + Directory  . . . . . . . . . . . > /home/JARDIR/                         
 +                                                                                 
 + Public authority for data  . . .   *INDIR        Name, *INDIR, *RWX, *RW...     
 + Public authority for object  . .   *INDIR        *INDIR, *NONE, *ALL...         
 +                + for more values                                                
 + Auditing value for objects . . .   *SYSVAL       *SYSVAL, *NONE, *USRPRF...     
 + Scanning option for objects  . .   *PARENT       *PARENT, *YES, *NO, *CHGONLY   
 + 
 + Restricted rename and unlink . .   *NO           *NO, *YES                      
 +</pre></html> 
 + 
 +===Steps to confirm that the IFDJAVA.JAR file was restored to the expected directory configured in the COPYDATA step when upgrading iDocs.=== 
 + 
 +==Step 1. Confirm that the IFDJAVA.JAR file was installed== 
 +  - Confirm that the IFDJAVA.JAR file is in the expected directory by using the WRKLNK command to navigate to the directory and inspecting the directory for the file.   
 +  - If the file is in the directory, select the file with option 8=Display attributes and then selecting the [Enter] key.   
 +  - Once the attributes are displayed, page down one page to view Creation Date/Time, Last access data/time, Data change data/time, and Attribute change date/time.   
 +  *    If this reflects current changes, then you are done.   
 +  *    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.   
 +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. 
 + 
 +==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. 
 + 
 +**To Move the files to a new directory:** 
 +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 
 + 
 +**To delete the files:** 
 +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=== 
 + 
 +On the command line type RST and prompt with F4 
 +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]\\ 
 +**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]\\ 
 +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]\\ 
 +**Include or Omit** = *INCLUDE [We want the file to be included]\\ 
 + 
 +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.** 
 + 
 + 
 +If you already are using iFax, before executing the COPYDATA command find out your COM port by going to a command line and typing in WRKLIND FAXCOM*. 
 + 
 +This will display a list of current lines being used for your FAXCOM (most likely one line).  Select the line with 5 to Display and make note of the value for Resource Name, and if internal modem or external.  You will use these values during the execution of the COPYDATA command if you are using iFax.\\
  
 Then verify that the data area contains the name of the library as installed on your system by using this Command: \\ Then verify that the data area contains the name of the library as installed on your system by using this Command: \\
pub/installation_for_idocs_6.x.1477421360.txt.gz · Last modified: 2022/06/25 17:02 (external edit)