Configuring the Listener Job

Date:Archived
Product/Release:General
Abstract:To prepare the AS/400 for TCP/IP and LANSA's Workstation Products, a Listener job must be started
Submitted By:N/A

Description:

To prepare the AS/400 for TCP/IP and LANSA's Workstation Products, a Listener job must be started.

The Listener job can be submitted to run in the subsystem defined in your default job description. How to do this is described in AS/400 Configuration in the LANSA Communications Setup Guide.

Should you wish to have the Listener job run in an alternative subsystem, follow these steps to create the required objects on the AS/400.

Step 1

Ensure that you have QSECOFR authority or equivalent authority level.

Step 2

From the command line enter CRTJOBQ to create a job queue.

Press F4 to display the Create Job Queue screen and enter:

Job queue:LANLISTEN - suggested default.
Library:QGPL – where most job queues are created by default.
Text description:LISTENER JOB QUEUE - suggested naming convention.

Press Enter to create the job queue.

Step 3

From the command line enter CRTJOBD to create a job description.

Press F4 to display the Create Job Description parameters. Press F10 for additional parameters (press PageDown or Shift-Rollup to see additional parameters) and enter:

Job description:LANLISTEN - suggested default.
Library:QGPL - where most job queues are created by default. 
CCCCCCCCC - LANSA communications library
XXXXXXXXX - LANSA program library

where CCCCCCCCC is the default LANSA Program Library
where XXXXXXXXX is the default LANSA Program Library
Job Queue:LANLISTEN - name of the job queue created in Step 2.
User:Should be the LANSA owner, normally QOTHPRDOWN.
Request data or command:SBMJOB CMD(XXXXXXXXX/LANSA REQUEST(STRLISTEN)) JOB(LISTENER) JOBQ(LANLISTEN)

where XXXXXXXXX is the default LANSA Program Library

Press Enter to complete the creation of the job description for the Auto Start job.

Step 4

From the Command line, enter CRTSBSD to Create SubSystem Description.

Press F4 to display the Create Subsystem Description screen and enter:

Subsystem description: LANLISTEN - suggested default.
Library:QGPL - required to run in this library.
Pool identifier:1 - required value.
Storage size:*BASE - required value.
Text 'description':LANSA Server Listener Subsystem.

Step 5

From the command line, enter ADDJOBQE to add a job queue entry to the subsystem description previously created in Step 4.

Press F4 to display the Add Job Queue Entry screen and enter:

Subsystem description:LANLISTEN - description as entered in Step 4.
Library:QGPL - required to run in this library
Job queue:LANLISTEN - job queue created in Step 2.
Library:QGPL - required to run in this library
Maximum active jobs:*NOMAX - required value

Step 6

From the Command Line, enter ADDAJE to add an auto start job entry to the subsystem description created in Step 4. Enter:

Subsystem description:LANLISTEN - job description as created in Step 4.
Library:QGPL - required to run in this library.
Job name:LISTENER - job name used in Step 3.
Job description:LANLISTEN - job description created in Step 3.
Library:QGPL - required to run in this library.

Step 7

To add the first routing entry for the LANLISTEN subsystem description created in Step 4, on the command line enter ADDRTGE .

Press F4 to display the Add Routing Entry screen and enter:

Subsystem description:LANLISTEN - subsystem description as created in Step 4.
Routing entry sequence #:10 - suggested sequence.
Compare value:QCMDI - required compare value.
Program to call:QCMD - system program to execute.
Class:QINTER - priority of job.

Press Enter to create the first routing entry.

Step 8

The Listener job requires two routing table entries for the subsystem description.

To add an additional routing entry for the LANLISTEN subsystem description created in Step 4, on the command line enter ADDRTGE and enter:

Subsystem description:LANLISTEN - subsystem description as created in Step 5
Routing entry sequence #:999 - required value
Compare value:*ANY - required compare value
Program to call:QCMD - system program to execute
Class:QINTER - priority of job

Press Enter to create the second routing entry.

Step 9

To start the Listener job, on the command line enter STRSBS XXXXXXXXX (where XXXXXXXXX equals the name of the subsystem created in Step 4).

If you wish to verify that the Listener job is running, from the command line enter WRKACTJOB and you should see these three items in the Work Active Job display:

Subsystem created in step 4:LANLISTEN
Listener Job defined in the Job Description:LISTENER
A TP (Transaction job):started by the Listener job e.g. TP000000001