Install AS400/iSeries Commands

Overview

This guide provides the necessary commands for installing eFORMz on an AS/400 system. It can also serve as a reference for troubleshooting potential steps that may have been missed during a migration of eFORMz to a different system.

Symptoms

1. Unable to process jobs using eFORMz on AS400/iSeries.
2. Job queues are not functioning as expected.
3. Subsystem not starting or failing during execution.
4. User profile for eFORMz missing or misconfigured.

Possible Causes

1. Missing or incorrect library setup.
2. Job queue not properly created or linked to the subsystem.
3. Incorrect or missing job description and class assignments.
4. User profile not configured properly.
5. Service Manager not started correctly.

Troubleshooting Steps

1. Create an eFORMz Library

   1. Enter the following command at the command line:

      CRTLIB LIB(EFZLIB) TEXT('Minisoft eFORMz Library')
      

2. Create an eFORMz Job Queue

   1. Run the command:

      CRTJOBQ JOBQ(EFZLIB/EFZJOBQ) TEXT('Minisoft eFORMz Job Queue')
      

3. Create an eFORMz Job Description

   1. Execute:

      CRTJOBD JOBD(EFZLIB/EFZJOBD) JOBQ(EFZLIB/EFZJOBQ)
      

4. Create and Start a Subsystem

   1. Run the following:

      CRTSBSD SBSD(EFZLIB/EFZSBS) POOLS((1 *BASE)) TEXT('Minisoft eFORMz Subsystem')
      STRSBS SBSD(EFZLIB/EFZSBS)
      

5. Determine Next Available Sequence Number

   1. Enter:

      DSPSBSD SBSD(EFZLIB/EFZSBS)
      

   2. Select option #6 (Job Queue Entries) and check for an unused sequence number.

6. Attach Job Queue to Active Subsystem

   1. Use the previously determined sequence number or 10 for a new/empty SBSD:

      ADDJOBQE SBSD(EFZLIB/EFZSBS) JOBQ(EFZLIB/EFZJOBQ) MAXACT(3) SEQNBR(10)
      

7. Create a Class for Subsystem Routing

   1. Execute:

      CRTCLS CLS(EFZLIB/EFZCLS) RUNPTY(50) TEXT('Minisoft eFORMz Class')
      

8. Add Job Routing to Subsystem

   1. Run:

      ADDRTGE SBSD(EFZLIB/EFZSBS) SEQNBR(1999) CMPVAL(*ANY) PGM(QCMD) CLS(EFZLIB/EFZCLS)
      

9. Create a New eFORMz User

   1. Enter the command:

      CRTUSRPRF USRPRF(EFORMZ) USRCLS(*SYSOPR) TEXT('Minisoft eFORMz User') JOBD(EFZLIB/EFZJOBD)
      

10. Start eFORMz (Service Manager)

    1. Execute the following command:

       SBMJOB CMD(QSH CMD('cd /minisoft ; /QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit/bin/java -Djava.awt.headless=true -Duser.dir=/minisoft -jar /minisoft/Run.jar -Monitor=true /minisoft ')) JOB(DIRECTOR) JOBD(EFZLIB/EFZJOBD) USER(EFORMZ)
       

11. Stop eFORMz (Service Manager)

    1. Run:

       QSH CMD('cd /minisoft ; /QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit/bin/java -Djava.awt.headless=true -Duser.dir=
       

Assistance

If any further assistance is needed, please contact our Support team.

Related Articles