Preparing for Generation and Compilation › Managing Your Work Environment › Verifying Your Work Environment Setup

Verifying Your Work Environment Setup

To successfully generate and compile your application, verify how your work environment is set up.

Two types of subsystem configuration are possible on the IBM i: QBASE and QCTL. QCTL is recommended for the controlling subsystem.

Before you can verify the settings in your work environment, you need to identify:

• The value of your controlling subsystem; from an i OS command line, type DSPSYSVAL QCTLSBSD and press Enter.
• The model job queue from the model job description. Enter DSPJOBD QBATCH (or your job description name), and record the job queue attached to this JOBD.

The steps below cover both configurations:

• If your controlling subsystem is QBASE and the job queue name in your model job description is QBATCH, follow all the steps.
• If your controlling subsystem is QCTL, or if you are using a job queue other than QBATCH, begin with step 7.

Note: To perform the following steps, sign on as QSECOFR or as a user profile that belongs to the same group profile as QSECOFR.

To manage your work environment:

Steps 1-6 apply only to QBASE subsystem or non-QBATCH job description.

1. Verify that the job queue entry QGPL/QBATCH exists:
   1. On the command line, type WRKSBSD QBATCH. Press Enter.
   2. To display the subsystem description, enter 5 at the Work with Subsystem Description panel.
   3. Verify that QBATCH exists in QGPL at the Display Job Queue Entries panel.
2. If needed, create job queue entry QBATCH2, in library QGPL, for subsystem QBATCH. At a command line, type the following command string and press Enter.

   CRTDUPOBJ OBJ(QBATCH) FROMLIB(QGPL) +
    OBJTYPE(*JOBQ) NEWOBJ(QBATCH2)

   Note: QBASE has a job queue named QBATCH. If your job queue is also named QBATCH (the default), the submitted job will go to the QBATCH job queue in QBASE.

3. Stop subsystem QBATCH. Type the following command string and press Enter:

   ENDSBS QBATCH

4. Add job queue entry QBATCH2 to subsystem QBATCH. Type the following command string and press Enter:

   ADDJOBQE SBSD(QBATCH) +
    JOBQ(QGPL/QBATCH2)

5. Restart subsystem QBATCH. Type the following command string and press Enter:

   STRSBS QBATCH

   Now that you have reviewed and changed your subsystem, complete steps 6-9 to make sure it works correctly in CA 2E.

6. In every model, change the job description to use the job queue name QBATCH2. For each model, type the following command string and press Enter:

   CHGJOBD JOBD(model-library-name/QBATCH+
    or your-job-description-name) +
    JOBQ(QGPL/QBATCH2)

   Note: You should check any job descriptions explicitly referenced in the model profiles for the model. You can edit the model profile for a user using the Change Model Profile (YCHGMDLPRF) command or by pressing F18 from the Edit Model Object List panel.

   For more information on compiling right after generation, see the Sending Generations and Compilations to Separate Queues section in this chapter.

7. In every model, do the following:
   1. Verify that the job description library list is correct for the model. Type one of the following command strings, as appropriate, and press Enter to access the Display Job Description panel:

DSPJOBD JOBD(QGPL/QBATCH)

DSPJOBD JOBD(model-library-name +
You should check the library list for the model using the Edit Library List (YEDTLIBLST) command. You can determine the model's library list using one of the following:

• The Display Model Value (YDSPMDLVAL) command to display the YLIBLST model value.
• The Library list options on the Designer (*DSNR) Menu. Enter:

    YGO DSNR *Y2

to display this menu.

Suggested list:

• QTEMP (must be at top of library list)
• Generation library
• Library for SQL collection (optional)
• Model library
• QGPL
• National Language Support libraries (Y1SYVxxx and Y2SYVxxx) (optional)
• CA 2E product (Y2SY)
• Toolkit product (Y1SY)
  1. Verify that the routing data value in the model job description is YCRTOVR. To verify the value, locate it on the Display Job Description panel. If needed, you can enter the following command string to change the routing data value:

CHGJOBD +
 JOBD(model-library-name/QBATCH) +
 RTGDTA('YCRTOVR') You should check any job descriptions explicitly referenced in the model profiles for the model.

Note: YCRTOVR must be in capital letters.

1. Verify that the routing entries are correct in the subsystem to which you will submit the CA 2E jobs. The subsystem must contain a routing entry with a value of YCRTOVR to match the routing entry in the job description the model uses. Perform the following to verify routing entries:
   1. Type WRKSBSD QBATCH (or your subsystem name) and press Enter to access the Work with Subsystem Descriptions panel.
   2. To display the subsystem description, at Work with Subsystem Descriptions type 5 and press Enter. The Display Subsystem Description panel displays.
   3. To display routing entries, at the Display Subsystem Description panel select option 7. Your subsystem should contain the following routing entries.

2. 2 . If needed, change or add routing entries using either the i OS command, Change Routing Entry (CHGRTGE) or Add Routing Entry (ADDRTGE), as appropriate. Be sure to terminate the subsystem before adding a routing entry.