Micro Focus Enterprise Developer 2.3 for Visual Studio 2015 > Deployment > Mainframe Support for Deployed Applications > MSS Configuration and Administration > Running EZASOKET Applications on Enterprise Server > Configuring and Managing EZASOKET Support for CICS Applications > Using the Configuration Transaction (EZAC)

Using the Configuration Transaction (EZAC)

The EZAC transaction enables you to add, delete, or modify items in the configuration file while your CICS region is running. The following table lists and describes the functions supported by the EZAC transaction.

Command	Object	Function
ALTER	CICS/Listener	Modifies the attributes of an existing resource definition
DEFINE	CICS/Listener	Creates a new resource definition
DISPLAY	CICS/Listener	Shows the parameters specified for the CICS/Listener object
DELETE	CICS/Listener	CICS - Deletes the CICS object and all of its associated listeners Listener - Deletes the listener object

Start a TN3270 session, connect to the port for the TN3270 listener on your enterprise server and start the EZAC transaction. When you enter EZAC, the following screen is displayed:

Figure 1. Initial EZAC screen

Enter the command you want to execute followed by the type of object. For creating a CICS object for your CICS region, you type:

EZAC DEF CICS or EZAC,DEF,CICS or EZAC,DEFINE,CICS or EZAC DEF and then select CICS on the screen. You are now presented with a screen in which you specify the CICS region for which you are configuring EZASOKET.

Figure 2. EZAC, Define, CICS screen

Enter the name of the CICS APPLID for which you are defining configuration information. In this case, the APPLID is the name of your enterprise server. The field defaults to this value.

When you press Enter, the following screen is displayed.

Figure 3. Application parameters screen

Specify the parameters you require for EZASOKET support in your CICS region. For more information, please refer to the IBM document SC31-8807-02, "z/OS Communications Server: IP CICS Sockets Guide Version 1 Release 5".

A CICS region will typically have one or more listeners. Each listener may be an instance of the supplied listener or a user-written listener. Define a CICS listener for your region using: EZAC DEF LIST or EZAC DEFINE LISTENER or EZAC,DEF,LIST or EZAC,DEFINE,LISTENER as shown in the following screenshots:

Figure 4. Listener screen

The following screen allows you to define the characteristics of your listener

Figure 5. Listener characteristics screen

For more information on this topic, please refer to the IBM document SC31-8807-02, "z/OS Communications Server: IP CICS Sockets Guide Version 1 Release 5".

Note:

The supplied transaction used in this example, CSKL, uses the default listener program, EZACIC02. This listener is written in ASCII. The rules described in the table below determine whether or not it converts the transaction id and the user data in the Transaction Initial Message from EBCDIC to ASCII.

TRANTRN	TRANUSR	Tranid format	Translate tranid?	Translate user data?
YES	YES	ASCII	NO	NO
YES	NO	ASCII	NO	NO
NO	YES	ASCII	NO	YES
NO	NO	ASCII	NO	NO
YES	YES	EBCDIC	YES	YES
YES	NO	EBCDIC	YES	NO
NO	YES	EBCDIC	YES	YES
NO	NO	EBCDIC	YES	NO