7
Using the Configuration Editor

This chapter describes how to use the Configuration Editor to configure the CICS adapter. The Configuration Editor is only used at runtime. The following topics are discussed:

• Using the Configuration Editor

• Configuration Editor Login

• Configuration Editor Security

Using the Configuration Editor

Using the Configuration Editor, you can customize the settings to specify how the CICS adapter and Service Provider components interact with your system. You can change these settings by accessing the Editors through the Configuration Editor.

Note: Profiles and Deployment are sensitive to the Master Key setting. If using a shared machine, before accessing the Configuration Editor, ensure the Master Key is set to either that of User1 or create a new Master Key for your profiles.

To configure settings for the CICS adapter you must access the CICS Configuration Editor as follows:

1. Change directories to the ...\oai\9.0.4\config\configeditor using a DOS prompt.

2. Type configeditor and press Enter.

   The Configuration Editor displays.

3. Click Profile and select iStudio.

   Note: Under some circumstances you may wish to run your adapter under a profile other than iStudio. This may be needed, for example, if you want to run two instances of the CICS adapter on the same machine. You may want to have two instances of the same type of adapter if these instances need to connect to different backend system installations. To accomplish this you need to create a new profile using the configuration editor and fill in the settings for this new profile. The name of the new profile should be the same as the name of the application. For example, if your application is called APP2, create a profile called APP2. Now APP2 will use the settings in the profile called APP2, whenever it runs.

4. Double-click on CICS to edit the CICS configuration settings for iStudio profile.

5. Click to expand the Login node.

6. Click to expand the General node.

   Figure 7-1 Configuration Settings Editor - Expanding the General folder

   

   Text description of the illustration configeditorexpanded.gif

7. Click to unselect Use Global Settings in both the Login and General dialogs.

Configuration Editor Login

In the CICS adapter, the configuration dialog allows the user to set the login and password for the CICS region.

To set the login information:

1. Click Login on the Login dialog.

   Figure 7-2 Configuration Editor Login Screen

   

   Text description of the illustration configedlogin.gif

2. Enter a username in the Username field. A username in CICS can be up to eight characters long.

3. Enter a password in the Password field. A password in CICS can be up to eight characters long. The password is stored encrypted in the registry.

General

General settings only apply to the SNA LU 6.2 protocol. This section will explore the General settings that need to be set in the Configuration Editor for the CICS adapter. In the General Setting section, you can define the Synchronization Level and Security. From the Configuration Settings Editor dialog:

1. Expand the General branch.

2. Expand the Use Global Settings branch.

Mode Name

To use a different Mode Name, enter the name of the Mode Name. The Mode Name must be defined in both your local and remote system network architecture servers. If you have any questions, please refer to your communication system administrator.

Synchronization Level

In the Synchronization Level section, you can define the type of confirmation the remote CICS system requires when exchanging buffers with the CICS adapter.

1. Expand the Synchronization Level branch.

   Figure 7-3 Configuration Settings Editor - Synchronization Level

   

   Text description of the illustration configeditorsync.gif

2. Click None if there will be no confirmation when exchanging buffers with the CICS adapter.

   Click Confirm if there will be confirmation.

Configuration Editor Security

In the Security section, you can define the type of security CICS is using to exchange data with the CICS adapter.

1. Expand the Security branch.

   Figure 7-4 Configuration Settings Editor - Security section

   

   Text description of the illustration configeditorsecurity.gif

2. Click None if there will be no security when exchanging data with the CICS adapter.

   Click Program if there will be security when exchanging data.