Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

[ Image Removed |../../index.htm#lansa/comms_listener_recs.htm]
You are here:

...

(COMMS_LISTENER_RECS)

Configuration item COMMS_LISTENER_RECS allows the creation, change and deletion of LANSA Communications Extensions Listener Records. These records define the parameters used by the listener job when employing the listener record's communications method.
Select configuration item COMMS_LISTENER_RECS from the COMMS_EXTENSIONS group to review these records.
The screen presented looks something like this:

 
  LCOADMP404       Work with Communications Listener Records
 
   Type options, press Enter.
   2=Review/Change        4=Delete
 
                                    Prestart   Connection 
  Sel   Comms Method            Session Jobs   Id 
  __    SOCKET                             3   4545 
 
 
 
 
 
 
 
   Object /etc/dc_pgmlib/lroute.dat now locked by this job.
   F1=Help  F6=Add/Create  F12=Cancel  F14=Messages
 

 |
This screen lists all the listener records stored in the LANSA Communications Extensions routing table.
Working from this screen you can, by entering one of the options beside a list entry, perform these actions:
2=Review/Change: Display the details for the listener record. From the screen displayed, press the Change function key to enable the fields to be amended.
4=Delete: Delete the listener record on which this option is entered.
Pressing the Add/Create function key will present the Add Communications Listener Record screen which allows the addition of a new listener record.

 
  LCOADMP411            Add Communications Listener Record
 
    Communications method . . . . . . . ____________________ 
    Number of session jobs to prestart  _____1 
    Connection identifier . . . . . . . ________________ 
    Cryptographic algorithm . . . . . . *NONE     +
    Data compression  . . . . . . . . . YES   
    Login timeout (seconds) . . . . . . 10
    TCP_NODELAY TCP/IP socket option  . YES
    Enable Ipv6   . . . . . . . . . . . NO
    TCP_KEEPALIVE TCP/IP socket option  YES
    Check exclusive use of port . . . . YES
  
   Tracing Options
     Errors . . . . . . .  External IPC calls .  IPC data . . . . . . _
     Debug listener . . .  Calls to CPIC  . . .  Internal IPC calls . _
     CPIC data  . . . . .  System info  . . . . . Cryptographic info . 
 
   Logging Options  
     Connect in . . . . .  Connect out  . . . .  
 
 
   F1=Help  F4=Prompt  F12=Cancel  F14=Messages
 

 |
These input options are required on the Add Listener Record screen:
Communications Method
Is the communications method used by the Listener.  The communications methods supported on the IBM i by LANSA Communications Extensions are:

...

The default value is *NONE. That is, the data is not encrypted.
The use of encryption and/or compression algorithms cause more CPU cycles to be consumed during communication sessions. However this overhead is quite small when compared to other communication overheads found in most normal operational situations. 
Note: If a cryptographic algorithm is selected, the listener job will only accept connection requests from clients that support the selected cryptographic algorithm. If you have clients that are on an earlier version of LANSA Communications Extensions (versions 1.x) which doesn't support encryption, then you can only accept connection requests from them if you select *NONE.
Press the prompt key on this field to select from the list of valid cryptographic algorithms.
Cryptographic Algorithm Selection
From this panel, you can select a cryptographic algorithm by typing its name in the input field or by positioning the cursor on the required cryptographic algorithm and pressing the Enter/record advance key.

 
LCOADMP410         Change Communications Listener Record                  
                                                                          
 Communications method . . . . . . . SOCKET                               
 Number of  .........................................................     
 Connection : LCOADMP415      Select Cryptographic Algorithm        :     
 Cryptograp :                                                       :     
 Data compr :            Cryptographic algorithm . . . . . . *NONE  :     
 Login time :                                                       :     
 TCP_NODELA : Algorithm   Description                               :     
 Enable Ipv : *NONE       No encryption                             :     
 TCP KeepAl : SSL         Secure Sockets Layer                      :     
            : DES         Data Encryption Standard (DES)            :     
            : TWF         Twofish cryptographic algorithm           :     
 Tracing Op :                                                       :     
   Errors . :                                                       : . .
   Debug li :                                               Bottom  : lls 
   CPIC dat : F1=Help  F12=Cancel  F14=Msgs                         : nfo
            :.......................................................:     
 Logging Options                                                          
   Connect in . . . . .      Connect out  . . . .                         
                                                                          
                                                                          
 F1=Help  F4=Prompt  F12=Cancel  F14=Msgs  F16=SelBasic    F17=Select All 
 F18=Clear All                                                            

 |
Data Compression
Whether the transmitted data should be compressed or not:

...

Tracing Options
Check which events or actions require tracing when the listener job is running.
Refer to Tracing Options in the LANSA Communications Extensions Facility Tracing Records for the details of each option.
Logging Options
Enables the recording of normal events which need tracking when the listener job is running. On the IBM i messages are sent to the job's external message queue and will be listed in the job log.
Refer to 10.2.3 LANSA Communications Extensions Facility Tracing Records (COMMS_FACILITY_TRACE) for the details of each option.
[ Image Removed |../../index.htm#lansa/comms_listener_recs.htm]