PreviousNext
Help > EASYCOM Server > EASYCOM behavior > EASYCOM Server configuration commands > CFGEACTCP (Configure Easycom TCP/IP)
CFGEACTCP (Configure Easycom TCP/IP)

 This command is automatically called when automatic installation is performed.

It creates the subsystem and all the related objects, and it sets the TCP/IP port number used by Easycom service.

 

Objects created: SBSD, JOBD, JOBQ, CLS.

 

Object name

Object type

Description

EASYCOM (default)

*SBSD

Subsystem in which service is running, and client jobs are submitted.

EACJOBD

*JOBD

Descriptions for client jobs.

EACJOBQ

*JOBQ

Client job queue.

EACCLS

*CLS

Class for client jobs.

EASYCOMD

*JOBD

Job description for the EASYCOMD job, which must always be active in the subsystem.

 

Note: this command creates the required objects to have a subsystem running and starts it. But it doesn’t store any of the parameters.

 

EASYCOM library (LIB)

Enter EASYCOM server objects library name, where new sub-system will be created, with all related objects.

If the objects already exist in the library, they will be replaced.

 

System library in LIBL (SYSLIB)

This parameter is no used.

 

EASYCOM sub-system name (SBS)

Enter the subsystem name to be created in the library.

The subsystem name must be unique on the system. If you have more than one Easycom Server running on the system, each server must have its own library and subsystem. See Installing an additional Easycom Server.

When the subsystem will be active, job associated with each connection will run in this subsystem.

 

EASYCOM service port (PORT)

Enter the TCP port number to be assigned to the EASYCOM server. If multiple EASYCOM servers will run on the same machine, a different port number must be assigned to each one.

Possible values are:

*DFT : If a service named easycom exists in the port services table, the associated port will be used. See WRKSRVTBLE system command to manage the services table. If Easycom service does not exist, default port 6077 is used.

Number : port number to be allocated to new EASYCOM server.

If port number is changed, it must be changed in the client configuration, using "Easycom configuration utility", or by changing the connection properties in your client application.

When a non default port number is configured, port number must be added at the end of the server’s name or address in the client application, separated by a colon (:).

 Example: my_server:6090

 

Authorize pre started jobs (PJ)

Possible values are:

*OFF: "Prestart" jobs are not used when client session requires a connection, even if they are configured in the subsystem.

*ON / *AUTO: To use pre-started jobs on the subsystem if they are configured and active.

 

This option only authorizes Easycom to use pre started jobs at connection time, if they are active.

You need to configure the pre started jobs manually (available on V4R4 and above).

To configure pre started jobs, after running CFGEACTCP command, you need to proceed as following:

Stop EASYCOM subsystem.

 Example: ENSSBS EASYCOM *IMMED

Run ADDPJE command.

 Example:

 ADDPJE SBSD(EASYCOM/EASYCOM)

  PGM(EASYCOM/EASYCOM)

  USER(QUSER) INLJOBS(4)

  JOB(PJEASYCOM) JOBD(EASYCOM/EACJOBD)

  CLS(EASYCOM/EACCLS)

Start subsystem again:

 STRSBS EASYCOM/EASYCOM

 

 

Comments:

Command CFGEACTCP starts the Easycom subsystem.

TCP/IP must be on when subsystem is started!

Starting Easycom subsystem, automatically starts EASYCOMD job.
If EASYCOMD is not started, check EASYCOMD *JOBD, and see message queue EACMSGQ in Easycom library:

 DSPMSG EACMSGQ