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.