{"id":6070,"date":"2017-12-27T19:43:06","date_gmt":"2017-12-27T19:43:06","guid":{"rendered":"https:\/\/alt2.minisoft.com\/support\/?p=6070"},"modified":"2021-02-23T10:06:00","modified_gmt":"2021-02-23T18:06:00","slug":"setting-up-eformz-on-iseries","status":"publish","type":"post","link":"https:\/\/alt2.minisoft.com\/support\/setting-up-eformz-on-iseries\/","title":{"rendered":"Setting up eFORMz on iSeries"},"content":{"rendered":"

This post describes setting up eFORMz on iSeries, including licensing eFORMz and setting up the Director to run as an automated process.<\/p>\n

Licensing eFORMz on iSeries<\/h1>\n

For additional details, consult the following post on creating\u00a0an unsigned license file:\u00a0License eFORMz on an AS\/400 (iSeries) system<\/a><\/p>\n

Connect to the iSeries using a tn5250 terminal emulator, such as the \u201cMinisoft IBM Emulation\u201d application. At the login prompt, enter your user name and password and press Enter to log in:<\/p>\n

\"\"<\/a><\/p>\n

The Main Menu will now be displayed:<\/p>\n

\"\"<\/a><\/p>\n

Before licensing eFORMz on the iSeries, we need to know what Java version is installed.<\/p>\n

Finding the Java Version Installed on iSeries<\/h2>\n

To find the installed Java version, launch a command shell by typing the command \u201ccall qp2term\u201d and pressing Enter:<\/p>\n

\"\"<\/a><\/p>\n

We need to be in the minisoft directory a few steps below, so change to this directory by typing the following command:<\/p>\n

cd \/minisoft<\/code><\/p>\n

Then at the command prompt, type \u201cjava -version\u201d to see the default Java version installed on the iSeries.<\/p>\n

\"\"<\/a><\/p>\n

In the example shown in the screen shot, the default Java version is 8, but it is a 32-bit version, indicated by \u201cppc -32\u201d on the line showing the Java build. We want to find a 64-bit Java version if one exists. Go to the following IBM website to see the Java versions that can be present on various iSeries operating systems (you can find this website by typing \u201ciSeries java version\u201d into a search engine, and look for a link with the text \u201cIBM Supported Java Development Kit (JDK) Versions\u2026\u201d<\/p>\n

http:\/\/www-01.ibm.com\/support\/docview.wss?uid=nas8N1011999<\/a><\/p>\n

Scroll down the page to the table showing the operating system version (in the leftmost column), the JDK version and Bit Level and the JAVA_HOME value (in the rightmost column). The latter is the directory where that version of Java is installed. For example, I am looking for operating system version 7.3, and I want to find the most recent 64-bit Java version that is supported:<\/p>\n

\"\"<\/a><\/p>\n

The last row shows the JAVA_HOME value for JDK 8.0. To test whether this version is indeed installed on the iSeries, I paste this directory into the shell prompt, then append \u201c\/bin\/java -version\u201d to run the following command:<\/p>\n

\/QOpenSys\/QIBM\/ProdData\/JavaVM\/jdk80\/64bit\/bin\/java -version<\/code><\/p>\n

\"\"<\/a><\/p>\n

If I get back something like the following response, this is a valid Java version:<\/p>\n

\"\"<\/a><\/p>\n

If a \u201cnot found\u201d error is returned, I know this is not an installed Java version on this iSeries:<\/p>\n

\"\"<\/a><\/p>\n

Create the eFORMz License File<\/h2>\n

To create the eFORMz license file (eFORMz.xml), run the following command from a shell (be sure there is a space between the last minus sign and \u201ccom.minisoft.Check\u201d, and also be sure to capitalize everything exactly as written:<\/p>\n

\/QOpenSys\/QIBM\/ProdData\/JavaVM\/jdk80\/64bit\/bin\/java -jar Run.jar \u2013 com.minisoft.Check<\/code><\/p>\n

Success is indicated by the following output:<\/p>\n

\"\"<\/a><\/p>\n

This command creates the unlicensed eFORMz.xml file, which can be copied from the iSeries, licensed, and copied back. After copying the eFORMz.xml file back, you can verify that it was licensed correctly by re-entering the command above. You should see output like the following:<\/p>\n

\"\"<\/a><\/p>\n

Configure eFORMz as an Automated Process on iSeries<\/h1>\n

Following is the default \u201cStart Director Command\u201d for iSeries:<\/p>\n

SBMJOB CMD(QSH CMD('cd \/minisoft ; \/QOpenSys\/QIBM\/ProdData\/JavaVM\/jdk80\/32bit\/bin\/java -Djava.awt.headless=true -Duser.dir=\/minisoft -jar \/minisoft\/Run.jar \/minisoft com.minisoft.Director.Director')) JOB(DIRECTOR) JOBD(*USRPRF)<\/pre>\n
Reformatting this command makes it easier to figure out what is going on:<\/p>\n
SBMJOB CMD(\n\n\u00a0\u00a0 QSH CMD('cd \/minisoft ;\n\n\u00a0\u00a0\u00a0\u00a0\u00a0 \/QOpenSys\/QIBM\/ProdData\/JavaVM\/jdk80\/32bit\/bin\/java\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 -Djava.awt.headless=true\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 -Duser.dir=\/minisoft\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 -jar \/minisoft\/Run.jar\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/minisoft com.minisoft.Director.Director'\n\n\u00a0\u00a0 )\n\n)\n\nJOB(DIRECTOR)\n\nJOBD(*USRPRF)<\/pre>\n
This creates a job with the name \u201cDIRECTOR\u201d that runs the QSH command shown. We need to replace the path to the Java command with the correct one for the iSeries operating system and installed Java version. Refer to the above section \u201cFinding the Java Version Installed on iSeries\u201d to learn how to do that.<\/p>\n
Example with 64-Bit Java<\/h3>\n
Let\u2019s say that you research which Java versions are installed, and you find a 64-bit Java version installed in the following path:<\/p>\n
\/QOpenSys\/QIBM\/ProdData\/JavaVM\/jdk80\/64bit\/bin\/java<\/code><\/p>\n
Putting this into the SBMJOB string above gives us the following string that will start Director as a 64-bit process:<\/p>\n
SBMJOB CMD(\n\n\u00a0\u00a0 QSH CMD('cd \/minisoft ;\n\n\u00a0\u00a0\u00a0\u00a0\u00a0 \/QOpenSys\/QIBM\/ProdData\/JavaVM\/jdk80\/64bit\/bin\/java\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 -Djava.awt.headless=true\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 -Duser.dir=\/minisoft\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 -jar \/minisoft\/Run.jar\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/minisoft com.minisoft.Director.Director'\n\n\u00a0\u00a0 )\n\n)\n\nJOB(DIRECTOR)\n\nJOBD(*USRPRF)<\/pre>\n
Copy this string into the \u201cStart Director Command\u201d:<\/p>\n
\"\"<\/a><\/p>\n
Then click Start. If there are no errors and the Director starts successfully, you will see the running configuration files and tasks, as shown in the example below:<\/p>\n
\"\"<\/a><\/p>\n
If an error occurs on starting the Director, that error will be displayed as shown below. To simulate an error, I change the path to the java command to an invalid path (note the \u201cjdk90\u201d in the path):<\/p>\n
\/QOpenSys\/QIBM\/ProdData\/JavaVM\/jdk90\/64bit\/bin\/java<\/code><\/p>\n
When I click Start, I now see the following error:<\/p>\n
\"\"<\/a><\/p>\n
Click the Cancel button. Now we need to figure out why the Director failed to launch.<\/p>\n
Troubleshooting Start Director as an Automated Process<\/h2>\n
For some reason, the Director does not start successfully when you pressed Start on the Director tab of the Director Toolkit for iSeries. How do you figure out what went wrong? To find the answer, you need to first launch a terminal session with the iSeries. Pick your favorite tn5250 terminal emulator (Minisoft has one!), and connect to the iSeries and login. When you are at the main menu, your screen should look like this:<\/p>\n
\"\"<\/a><\/p>\n
Type \u201cwrkjob director\u201d at the prompt, then press Enter:<\/p>\n
\"\"<\/a><\/p>\n
A list of jobs named \u201cDIRECTOR\u201d is shown. You probably want the one with the most recent date (12\/21\/17 in the screen shot below), so type a \u201c1\u201d in the Option column for the one you want:<\/p>\n
\"\"<\/a><\/p>\n
When you press Enter, you are given a list of tasks you can perform with the job:<\/p>\n
\"\"<\/a><\/p>\n
A record of what happened when the job was run is kept in a spool file, so you want to select the option \u201c4. Work with spooled files\u201d, by typing a 4 and pressing Enter, to show the following screen with the contents of the spool file:<\/p>\n
\"\"<\/a><\/p>\n
The error message in the spool file indicates that the command \u201cQOpenSys\/QIBM\/ProdData\/JavaVM\/jdk90\/64bit\/bin\/java\u201d could not be found. That is because \u201cjdk90\u201d was entered instead of \u201cjdk80\u201d. I can now go back and correct the command and start the Director again.<\/p>\n\n\n
Related posts<\/strong><\/p>\n\n\n\n