Listener Configuration Editor - Options

Describes each field on the Listener Configuration Editor, and provides a list of and descriptions for each valid value.
Note: This is a technology preview feature only. It is being made available to allow you to test and provide feedback on this new capability; however, this feature is not intended for production use and it is not supported as such.
Data Trace
Optional file path or URL for data-trace output.
Enabled
Specifies whether or not the listener is enabled. Set to True (default) or False.
Heartbeat
A number, in seconds, that represents the amount of time to keep the listener active before timing out.
lpVersion
The IP protocol version. Set to IPv4, IPv6, or BOTH (default).
Name
A name that identifies the listener channel in console messages.
Port
The port on which the channel listens.
Protocol
The communication protocol of the listener channel. This value is set when you create the listener channel and cannot be changed. Valid values are:
  • TN3270
  • MFBINP
  • HTTP
  • MQ
  • P2P
  • DCAS
Certificate type
Specifies one of the following types of certificate storage:
None
Default. No specified certificate storage type.
File
Store certificates in a file. When specified, you must supply values for the File certificate passphrase and File certificate path options.
Store
Store certificates in a Windows store. When specified, you must supply values for the Store certificate name and Store certificate store options.
Client auth: Certificate requirement
Determines whether client certificates are allowed but not requested, requested but not required, or required.
Note: Some clients send a certificate only when the channel is configured to require, not merely allow, client certificates.
Allowed
Default. Client certificates are allowed but not requested.
Requested
Client certificates are requested but not required.
Required
Client certificates are required.
Client auth: Check revocation
Check for client certificate revocation. Set to True or False (default).
Client auth: Check usage
Check client certificate key-usage permissions. Set to True (default) or False.
Client auth: Match hostname
Specifies whether or not the client certificate name must match client host name. Set to True (default) or False.
Client auth: Enable ELF
Applies to TN3270 listeners only. Enable the Express Logon Facility. Set to True or False (default).
ELF: APPLID template
Applies to TN3270 listeners only. Specify the APPLID to be passed in the DCAS request. Default is blank, meaning that the APPLID is an arbitrary value supplied by the client, or, if the client does not supply an APPLID, the value is the region name.

For information on APPLID formatting, see the applidTemplate attribute section in the TN3270 Listener Channel Configuration - XML Reference topic.

ELF: DCAS userid
Applies to TN3270 listeners only. Specifies a name value for a user ID known to the region, such as SYSAD. This name is used to invoke the DCAS system transaction. Default is blank, meaning the DCAS request executes under the default CICS user ID.

For information about setting an appropriate DCAS user ID, see the dcasUserID attribute section in the Channel ConfigurationTN3270 Listener Channel Configuration - XML Reference topic.

File certificate path
Specifies the full path to and filename of the certificate file. Required when the Certificate type option is set to File.
File certificate passphrase
Specifies the passphrase to use with the certificate file. Required when the Certificate type option is set to File and the certificate file specified is secured by a private key.
Store certificate name
Specifies the full or partial subject name of the certificate in the Windows certificate store. Required when the Certificate type option is set to Store.
Store certificate store
Identifies the Windows certificate store that holds the certificate.
CurrentUser
Certificates and private keys held by Windows for the user account under which the seelistener process is running.
LocalMachine
Default. Certificates and private keys held by Windows for all processes running on this Windows system.
Note: See your Microsoft documentation for more information about Windows certificate stores, CurrentUser, and LocalMachine.