This section describes the LST parameters that are available for controlling the BSA CI.
Some applications (add-ons) may need to be controlled differently from other applications. This is why you can define global ports, which can be shared by different applications of one product, and application ports, which are can only be used by the specified application of the product.
Keywords with the _app suffix define values for application ports, where app is the 3‑character identifier of the application (add-on). Keywords without the _app suffix are generally valid for all applications of the product or define values for global ports. Most keywords can be coded with and without this suffix. Keywords with the prefix BSA_ are valid for all applications and products.
Examples:
B93_TCPIP_SSL_PORT
B93_TCPIP_SSL_PORT_BWE
B92_TCPIP_SSL_PORT_OSY
B92_TCPIP_SSL_PORT_BWE
BSA_TCPIP_MAXTHREADS
Keyword: Bnn_TCPIP_SSL_PORT
Keyword: Bnn_TCPIP_SSL_PORT_app
Value |
Description |
Option |
Default |
(port,[sport], |
Values are coded as a comma-separated list of positional parameters. The port number, IP address, product subsystem ID, and runtime mode are required. Other parameters are optional. Each parameter is described in more detail below: |
|
|
port |
The port used by the product application to communicate with the Beta Systems product. |
required |
|
sport |
The service port that enables the z/OS product to send specific service requests to a product client agent. The entry is only necessary if the product uses such clients (also see LST parameter Bnn_TCPIP_SERVICE_IPA). If this port is used, BSA CI must be customized for SSL support. |
optional |
|
ipa |
The IP address (a symbolic name of up to 255 characters) of the BSA Communication Integrator. |
required |
|
ssid |
Reserved for future use. |
n/a |
|
mode |
The runtime mode of the application port. Possible values are SSLAUTH, SSL, NOSSL. |
required |
|
ddn |
The name of the DD statement used to define the key ring and key label definitions for the application and service ports. |
optional |
BSSOSEC |
Keyword: Bnn_TCPIP_SERVICE_IPA
Keyword: Bnn_TCPIP_SERVICE_IPA_app
Value |
Description |
Option |
Default |
(ipa[,ipa][,ipa]...) |
Defines all the IP addresses that are authorized to use the service port sport Use this keyword to ensure that the service port can only be used by authorized servers. In addition, the service port can be secured by a firewall. |
optional |
|
Keyword: Bnn_TCPIP_LOGON_EXIT
Keyword: Bnn_TCPIP_LOGON_EXIT_app
Value |
Description |
Option |
Default |
name |
Name (max. 8 digits) of a logon exit that is called by logon exit B02UXSIN The default logon behavior of the clients can be changed in the exit. |
optional |
|
Keyword: BSA_TCPIP_MAXTHREADS
Keyword: Bnn_TCPIP_MAXTHREADS_app
Before specifying this parameter, it is important to first ascertain the following:
Value |
Description |
Option |
Default |
50..99999 |
BSA_TCPIP_MAXTHREADS specifies the maximum number of threads to be handled globally by the Communication Integrator at any one time.
|
required |
200 |
2 - maximum specified for global limit |
Bnn_TCPIP_MAXTHREADS_app specifies the maximum number of threads to be handled by the Communication Integrator specifically for each application, for example OSY.
|
optional |
200 or the maximum specified for global limit |
Keyword: Bnn_TCPIP_SESS_TIME_LIMIT
Value |
Description |
Option |
Default |
nnnnnnnnn |
The maximum period of time (time limit) in minutes a user can remain inactive before being timed out. When the time is exceeded, the user will be disconnected and must relog onto the z/OS system before the user can proceed. The value defined via this keyword also applies to all application ports defined for the product (i.e. ports with suffix _app). |
optional |
60 |
Keyword: Bnn_TCPIP_RETRY_INTERVAL
Value |
Description |
Option |
Default |
ttttttttt, zzzzzzzzz |
The time and the number of the retry intervals (max. 9 digits each). If the task is not active or the connection is lost, an attempt will be made to automatically reconnect the server to the TCP/IP started task after the time specified by t has elapsed. This will be repeated z number of times. |
optional |
60,0 |
Keyword: Bnn_TCPIP_COMPRESS
Keyword: Bnn_TCPIP_COMPRESS_app
Value |
Description |
Option |
Default |
method |
This keyword is only used when runtime mode NOSSL has been defined for the associated application port. method describes the compression method to be used. This keyword excludes the use of keyword Bnn_TCPIP_
The following values are allowed: STD Beta-specific standard compression NO No compression required |
optional |
NO |
For BSA_WLM_SUBSYS_TYPE, see "LST parameters for ZIF".
Keyword: Bnn_TCPIP_ENCRYPT
Keyword: Bnn_TCPIP_ENCRYPT_app
Value |
Description |
Option |
Default |
(method |
The keyword is only used for the relevant application port when the runtime mode NOSSL has been defined. It specifies the encryption method to be used and the key to be applied. If no key is specified, a key based on the indicated method will be generated automatically during each connect. Keys must consist of HEX values only (0123456789ABCDEF) Use this keyword only if the product concerned uses encryption. The following values are allowed: DES DES algorithm; key length = 16 TRD Triple DES algorithm, key length = 48 AES Advanced encryption standard, key length = 64 (encryption mode CBC; fallback to Triple DES if client does not support AES) BFS Blowfish algorithm, NO No encryption required |
optional |
NO |
Keyword: BSA_SVC_NUMBER
Value |
Description |
Option |
Default |
nnn |
Number of the BETA SVC that is to be used. |
required |
none |
Keyword: BSA_TCPIP_BSM_PORT
Value |
Description |
Option |
Default |
bsmport |
Port used for communication with the BSA Service Manager of one or more products. This parameter must be specified if BSA Service Manager commands are to be executed in a different address space to the one they were initiated in. |
(required) |
none |
Keyword: BSA_TCPIP_TRACE_BUF
Value |
Description |
Option |
Default |
YES | NO |
This keyword logs all buffer data from SEND or RECEIVE requests in dump format. Set this parameter to YES only if requested by Beta Systems support. Note: An enormous amount of data is produced. If you want to write these data to a SYSOUT class, use DD statement BSATRACE. If you do not use BSATRACE, all the data will be written to the system SYSLOG. |
optional |
NO |