Using SMIT to configure CD entries (AIX only)

When using CICS for AIX, you can use the AIX® System Management Interface Tool (SMIT) to configure the Communications Definitions (CD) entries. To add a CD entry for CICS® PPC TCP/IP to your region, you must:

Ensure you are logged on to AIX with enough privileges to change the region database. (For example, log onto AIX as the root user.)
Optionally set the environment variable CICSREGION to the name of your CICS region. For example:
```
  % export CICSREGION=cics
  %
```
Enter smitty cicsregion to start SMIT.
Use option Change Working CICS Region to select your CICS region. (This is required only if you have not set up CICSREGION before starting SMIT.)
Select options:
```
      → Define Resources for a CICS Region
          → Manage Resource(s)
              → Communications
                  → Add New
```
This displays the Add Communication panel. Enter a model Communications Definition (CD) entry name. This could be the name of a CD entry that you have defined already. Alternatively, press the Enter key to use the default.

Figure 1 shows an example of a SMIT Add Communication panel.
Communication Identifier is the name of the CD entry.
Name of remote system is the LU name of the remote system, and SNA network name for the remote system is the name of the network that to which the remote system is attached.
If the remote system is a CICS on Open Systems or CICS for Windows region, you should set the Name of remote system attribute to the name of the remote region, and the SNA network name for the remote system to the value that is coded in the remote region's Region Definitions (RD) attribute Network name to which local region is attached.
Timeout on allocate (in seconds) defines how long your CICS region should wait for the remote system to accept requests. A value of 60 seconds is suggested. The default value is 0, which means "wait forever". You should set this timeout field to a value such as 60 in order to activate the timeout process. Then, if the remote system becomes overloaded, or fails while accepting an intersystem request, the CICS transaction that is issuing the intersystem request is not left hanging.
The security levels that your CICS region will use are configured with:
- Send userids on outbound requests?
- Security level for inbound requests
- UserId for inbound requests
- Transaction Security Level (TSL) Key Mask
- Resource Security Level (RSL) Key Mask
Configuring intersystem security describes how CICS security is configured.
See Data conversion for transaction routing for information about how to configure the Code page for transaction routing field.
The following fields are not required for a CICS PPC TCP/IP connection and can remain as the default value:
- SNA profile describing the remote system
- Gateway Definition (GD) entry name
- Listener Definition (LD) entry name
- TCP address for the remote system
- TCP port number for the remote system
- Transmission encryption level
- Default modename for a SNA connection
Press the Enter key to create the CD entry.

Figure 1 shows an example of the SMIT panel for adding a new CD entry.

Figure 1. SMIT panel for adding a CD entry for CICS PPC TCP/IP support

                               Add Communication
 
Type or select values in entry fields.
Press Enter AFTER making all desired changes.
 
                                                        [Entry Fields]
* Communication Identifier                           [OPEN]
* Model Communication Identifier                      ""
* Region name                                        [cics]               +
  Add to database only OR Add and Install             Add                     +
  Group to which resource belongs                    []
  Activate the resource at cold start?                yes                     +
  Resource description                               [Connection
to cicsopen]
* Number of updates                                   0
  Protect resource from modification?                 no                      +
  Connection type                                     ppc_tcp                 +
  Name of remote system                              [cicsopen]
  SNA network name for the remote system             []
  SNA profile describing the remote system           []
  Default modename for a SNA connection              []
  Gateway Definition (GD) entry name                 []
  Listener Definition (LD) entry name                []
  TCP address for the remote system                  []
  TCP port number for the remote system              [1435]                    #
  Timeout on allocate (in seconds)                   [60]                    #
  Code page for transaction routing                  [ISO8859-1]
  Set connection in service?                          yes                     +
  Send userids on outbound requests?                  sent                    +
  Security level for inbound requests                 trusted +
  UserId for inbound requests                        [LINKOPEN]
  Transaction Security Level (TSL) Key Mask          [none]
  Resource Security Level (RSL) Key Mask             [none]
  Transmission encryption level                       none                    +
 
 
F1=Help             F2=Refresh          F3=Cancel           F4=List
F5=Reset            F6=Command          F7=Edit             F8=Image
F9=Shell            F10=Exit            Enter=Do

For more information, see Communications Definitions (CD).

Table 1. Road map
If you want to...	Refer to...
Read a summary of CICS configurations	Summary of CICS attributes for TCP/IP resource definitions
Read about configuring CICS resources	Configuring resources for intercommunication
Read about controlling intersystem security	Configuring intersystem security
Read about intersystem data conversion	Data conversion
Read about setting the CICS_HOSTS environment variable	Setting up the CICS_HOSTS environment variable