LST parameters for BSA CI

Overview

This section describes the LST parameters that are available for controlling the BSA CI.

_app suffix

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

SSL port

Keyword: Bnn_TCPIP_SSL_PORT

Keyword: Bnn_TCPIP_SSL_PORT_app

Value

Description

Option

Default

(port,[sport],
ipa,ssid,
mode[,ddn])

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

Authorized sport addresses

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

 

Logon exit

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

 

Max. number of threads

Keyword: BSA_TCPIP_MAXTHREADS

Keyword: Bnn_TCPIP_MAXTHREADS_app

Before specifying this parameter, it is important to first ascertain the following:

  • How many can threads the system can handle?
  • How many threads must be available to avoid having the communication system come to a standstill?

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.

  • Parameter information messages are issued at startup.
  • Once the max. no. of threads is reached, the server waits 5 secs before attempting to open the next thread. A message is issued every 3 minutes.

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.

  • The number of threads specified for applications must not exceed the global maximum.
  • Parameter information messages are issued at startup.
  • Once the max. no. of threads is reached, the server waits 5 secs before attempting to open the next thread. A message is issued every 3 minutes.

    Note: If the BSA global port is used, this limit will always apply, no matter which application logs on via this port.

optional

200 or the maximum specified for global limit

Timeout

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

Retry

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

Compression

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_ CRYPT_EXIT. Only use this keyword if the product concerned uses compression.

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".

Encryption

Keyword: Bnn_TCPIP_ENCRYPT

Keyword: Bnn_TCPIP_ENCRYPT_app

Value

Description

Option

Default

(method
[,key])

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,
key length >=16 and <=128, divisible by 2

NO

No encryption required

optional

NO

SVC

Keyword: BSA_SVC_NUMBER

Value

Description

Option

Default

nnn

Number of the BETA SVC that is to be used.

required

none

BSA Service Manager support

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

Buffer data trace

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