EntireX Version 9.7
Quick Reference

 —  Administration  —

Broker Attributes

Note:
This section lists all EntireX Broker parameters. Not all parameters are applicable to all supported operating systems.

The Broker attribute file contains a series of parameters (attributes) that control the availability and characteristics of clients and servers, publishers and subscribers as well as of the Broker itself. You can customize the Broker environment by modifying the attribute settings.

This document covers the following topics:


Name and Location of Attribute File

The name and location of the broker attribute file is platform-dependent.

Platform File Name/Location
z/OS Member EXBATTR in the EntireX Broker source library.
UNIX File etbfile in directory <InstDir>/EntireX/config/etb/<BrokerName> (default) *
Windows File <BrokerName>.atr in directory <InstDir>\EntireX\config\etb\<BrokerName> (default) *
BS2000/OSD File ETB-ATTR in library EXX970.JOBS.
z/VSE Library member ETBnnn.ATR, where nnn is a placeholder specifying the broker instance (e.g.nnn= the assigned broker ID).
* When starting a broker manually, name and location of the broker attribute file can be overwritten with the environment variable ETB_ATTR.

Top of page

Attribute Syntax

Each entry in the attribute file has the format:

ATTRIBUTE-NAME=value

The following rules and restrictions apply:

Top of page

Broker-specific Attributes

The broker-specific attribute section begins with the keyword DEFAULTS=BROKER. It contains attributes that apply to the broker. At startup time, the attributes are read and duplicate or missing values are treated as errors. When an error occurs, the broker stops execution until the problem is corrected.

Tip:
To avoid resource shortages for your applications, be sure to specify sufficiently large values for the broker attributes that define the global resources.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

ABEND‑LOOP‑DETECTION YES | NO O z u w v b
YES Stop broker if a task terminates abnormally twice, that is, the same abend reason at the same abend location already occurred. This attribute prevents an infinite abend loop.
NO Use only if requested by Software AG Support. This setting may make sense if a known error leads to an abnormal termination, but a hotfix solving the problem has not yet been provided. Reset to "YES" when the hotfix has been installed.
ABEND‑MEMORY‑DUMP YES | NO O z u w v b
YES Print all data pools of the broker if a task terminates abnormally. This dump is needed to analyze the abend.
NO If the dump has already been sent to Software AG, you can set to "NO" to avoid the extra overhead.
ACCOUNTING NO | 128-255 O z        
NO | YES [SEPARATOR=char] O   u w v b

Determines whether accounting records are created.

NO Do not create accounting records.
nnn The SMF record number to use when writing the accounting records.
YES Create accounting data.
char= separator character(s). Up to seven separator characters can be specified using the SEPARATOR suboption, for example ACCOUNTING = (YES, SEPARATOR=;). If no separator character is specified, the comma character will be used.

See also Accounting in EntireX Broker.

ACCOUNTING‑VERSION 1 | 2 | 3 | 4 | 5 O z u w v b

Determines whether accounting records are created.

1 Collect accounting information. This value is supported for reasons of compatibility with EntireX Broker 7.2.1 and below.
2 Collect extended accounting information in addition to that available with option 1.
3 Create accounting records in layout of version 3.
4 Create accounting records in layout of version 4.
5 Create accounting records in layout of version 5.

This parameter applies when ACCOUNTING is activated.

APPLICATION‑MONITORING or
APPMON
YES | NO O z u w v  
Enable application monitoring in EntireX Broker.
YES Enable application monitoring.
NO Disable application monitoring.

See Application Monitoring.

AUTOLOGON YES | NO O z u w v b
YES LOGON occurs automatically during the first SEND or REGISTER.
NO The application has to issue a LOGON call.
BLACKLIST‑PENALTY‑TIME 5m | n | n S | n M | n H R z u w v b

Define the length of time a participant is placed on the PARTICIPANT-BLACKLIST to prevent a denial-of-service attack.

n Same as n S.
n S Non-activity time in seconds (max. 2147483647).
n M Non-activity time in minutes (max. 35791394).
n H Non-activity time in hours (max. 596523).

See Protecting a Broker against Denial-of-Service Attacks under z/OS | UNIX | Windows.

BROKER‑ID A32 R z u w v b
Identifies the broker to which the attribute file applies. The broker ID must be unique per machine.

Note:
The numerical section of the BROKER-ID is no longer used to determine the DBID in the EntireX Broker kernel with Entire Net-Work transport (NET). To determine the DBID, use attribute NODE in the DEFAULTS=NET section of the attribute file.

CLIENT‑NONACT 15M | n | nS | nM | nH R z u w v b

Define the non-activity time for clients.

n Same as nS.
nS Non-activity time in seconds (max. 2147483647).
nM Non-activity time in minutes (max. 35791394).
nH Non-activity time in hours (max. 596523).

A client that does not issue a broker request within the specified time limit is treated as inactive and all resources for the client are freed.

CMDLOG NO | YES O z u w v b
NO Command logging will not be available in the broker.
YES Command logging features will be available in the broker.
CMDLOG‑FILE‑SIZE 1024 | n O z u w v b
Defines the maximum size of the file that the command log is written to, in kilobytes. The value must be 1024 or higher. The default value is 1024. When one command log file grows to this size, broker starts writing to the other file. For more details, see Command Logging in EntireX.
CONTROL‑INTERVAL 60s | n | nS | nM | nH | O z u w v b

Defines the time interval of time-driven broker-to-broker calls.

  1. It controls the time between handshake attempts.

  2. The standby broker will check the status of the standard broker after the elapsed CONTROL-INTERVAL time.

n Same as nS.
nS Interval in seconds (max. 2147483647).
nM Interval in minutes (max. 35791394).
nH Interval in hours (max. 596523).
The minimum value is 16 seconds. We strongly recommend the default value (60 seconds), except for very slow machines.
CONV‑DEFAULT UNLIM | n O z u w v b

Default number of conversations that are allocated for every service.

UNLIM The number of conversations is restricted only by the number of conversations globally available. Precludes the use of NUM-CONVERSATION.
n Number of conversations.

This value can be overridden by specifying a CONV-LIMIT for the service.
A value of 0 (zero) is invalid.

DEFERRED NO | YES O z u w v b

Disable or enable deferred processing of units of work.

NO Units of work cannot be sent to the service until it is available.
YES Units of work can be sent to a service that is not up and registered. They will be processed when the service becomes available.
DYNAMIC‑MEMORY‑MANAGEMENT YES | NO O z u w v b
YES An initial portion of memory is allocated at broker startup based on defined NUM-* attributes or internal default values if no NUM-* attributes have been defined. More memory is allocated without broker restart if there is a need to use more storage. Unused memory is deallocated. The upper limit of memory consumption can be defined by the attribute MAX-MEMORY. See Dynamic Memory Management.
NO All memory is allocated at broker startup based on the calculation from the defined NUM-* attributes. Size of memory cannot be changed. This was the known behavior of EntireX 7.3 and earlier.

If you run your broker with attribute DYNAMIC-MEMORY-MANAGEMENT=YES, the following attributes are not needed:

  • CONV-DEFAULT

  • HEAP-SIZE

  • LONG-BUFFER-DEFAULT

  • PUBLICATION-DEFAULT

  • SERVER-DEFAULT

  • SHORT-BUFFER-DEFAULT

  • SUBSCRIBER-DEFAULT

  • NUM-CLIENT

  • NUM-CMDLOG-FILTER

  • NUM-COMBUF

  • NUM-CONV[ERSATION]

  • NUM-LONG[-BUFFER]

  • NUM-PUBLICATION

  • NUM-PUBLISHER

  • NUM-SERVER

  • NUM-SERVICE-EXTENSION

  • NUM-SERVICE

  • NUM-SHORT[-BUFFER]

  • NUM-SUBSCRIBER-TOTAL

  • NUM-SUBSCRIBER

  • NUM-TOPIC-EXTENSION

  • NUM-TOPIC-TOTAL

  • NUM-TOPIC

  • NUM-UOW|MAX-UOWS|MUOW

  • NUM-WQE

Caution:
However, if one of these attributes is defined, it determines the allocation size of that particular broker resource.

DYNAMIC‑WORKER‑MANAGEMENT NO | YES O z u w   b
NO All worker tasks are started at broker startup. The number of worker tasks is defined by NUM-WORKER. After this initial step, no further worker tasks can be started. This is default and simulates the behavior of EntireX version 8.0 and earlier.
YES As above, the initial portion of worker tasks started at broker startup is determined by NUM-WORKER. However, if there is a need to handle an increased workload, additional worker tasks can be started at runtime without restarting broker. Conversely, if a worker task remains unused, it is stopped. The upper and lower limit of running worker tasks can be defined by the attributes WORKER-MIN and WORKER-MAX.

If you run broker with DYNAMIC-WORKER-MANAGEMENT=YES, the following attributes are useful to optimize the overall processing:

The attribute NUM-WORKER defines the initial number of worker tasks started during initialization. See Dynamic Worker Management.

FORCE NO | YES O   u      
NO Go down with error if IPC resources still exist.
YES Clean up the left-over IPC resources of a previous run.

Notes:

  1. If broker is started twice, the second instance will kill the first by removing the IPC resources.
  2. For BS2000/OSD, z/OS and z/VSE, see separate attribute FORCE in section Adabas SVC/Entire Net-Work-specific Attributes.
HEAP‑SIZE 1024 | n O z u w v b

Defines the size of the internal heap in KB. Not required if you are using DYNAMIC-MEMORY-MANAGEMENT. If you are not using dynamic memory management, we strongly recommend specifying - as a minimum - the default value of 1024 KB.

ICU‑CONVERSION YES | NO O z u w v b

Disable or enable ICU conversion. Default for z/VSE is NO; other platforms YES.

YES ICU is loaded and available for conversion. It is a prerequisite for SAGTCHA and SAGTRPC.
NO ICU is not loaded and not available for conversion. SAGTCHA and SAGTRPC cannot be used.

If any of the broker service definitions uses the internationalization approach "ICU conversion", that is, the conversion methods SAGTCHA and SAGTRPC are defined by the service-specific or topic-specific attribute CONVERSION, ICU-CONVERSION must be set to "YES". The internationalization approaches "Translation", "Translation User Exit" and "SAGTRPC User Exit" do not require ICU conversion. If all broker service definitions use these internationalization approaches, ICU-CONVERSION can be set to "NO".

ICU requires additional storage to run properly. If ICU conversion is not needed, setting ICU-CONVERSION to "NO" will help to avoid unnecessary storage consumption.

ICU‑SET‑DATA‑DIRECTORY YES | NO O   u w    

Disable or enable ICU custom converter usage. Not defined for mainframe platforms.

YES The broker tries to locate ICU custom converters with the mechanism defined by the platform, see Building and Installing ICU Custom Converters under UNIX | Windows.
NO Use of ICU custom converters is not possible.
IPV6 YES | NO O z u w   b
YES Establish SSL and TCP/IP transport in IPv6 and IPv4 networks according to the TCP/IP stack configuration.
NO Establish SSL and TCP/IP transport in IPv4 network only.

This attribute applies to EntireX version 9.0 and above.

LONG‑BUFFER‑DEFAULT UNLIM | n O z u w v b

Number of long buffers to be allocated for each service or topic.

UNLIM The number of long message buffers is restricted only by the number of buffers globally available. Precludes the use of NUM-LONG-BUFFER.
n Number of buffers.

This value can be overridden by specifying a LONG-BUFFER-LIMIT for the service. A value of 0 (zero) is invalid.

MAX‑MEMORY 0 | n | nK | nM | nG | UNLIM O z u w v b

Defines the upper limit of memory allocated by broker if DYNAMIC-MEMORY-MANAGEMENT=YES has been defined.

0, UNLIM No memory limit.
others Defines the maximum limit of allocated memory. If limit is exceeded, error 671 "Requested allocation exceeds MAX-MEMORY" is generated.
MAX‑MESSAGE‑LENGTH 2147483647 | n O z u w v b
Maximum message size that the broker kernel can process. This value is transport-dependent. The default value represents the highest positive number that can be stored in a four-byte integer.
MAX‑MESSAGES‑IN‑UOW 16 | n O z u w v b
Maximum number of messages in a UOW (or publication).
MAX‑MSG See MAX-MESSAGE-LENGTH.
MAX‑UOW‑MESSAGE‑LENGTH See MAX-MESSAGE-LENGTH.
MAX‑UOWS 0 | n O z u w v b
The maximum number of UOWs that can be concurrently active broker-wide. The default value is 0 (zero), which means that the broker will process only messages that are not part of a unit of work. If UOW processing is to be done by any service, a MAX-UOWS value must be 1 or larger for the broker.

The MAX-UOWS value for the service will default to the value set for the broker. NUM-UOW is an alias of this parameter.

MESSAGE‑CASE NONE | UPPER | LOWER O z u w v b

Indicates if certain error message texts returned by the broker to its clients or written by the broker to its log file are to be in mixed case, uppercase, or lowercase.

NONE No changes are made to message case.
UPPER Messages are changed to uppercase.
LOWER Messages are changed to lowercase.
MUOW See NUM-UOW.
NEW‑UOW‑MESSAGES YES | NO O z u w v b
YES New UOW messages are allowed.
NO New UOW messages are not allowed.

This applies to UOW when using Persistence and should not be used for non-persistent UOWs. A usage example could be the following:

The broker persistent store reaches capacity and the broker shuts down. You can set NEW-UOW-MESSAGES to "NO" to prevent new UOW messages from being added after a broker restart. This action allows only consumption (not production) of UOWs to occur after broker restart. After the persistent store capacity has been sufficiently reduced, the EntireX Broker administrator can issue a CIS command, see ALLOW-NEWUOWMSGS. This action allows new UOW messages to be sent to the broker. Reset attribute NEW-UOW-MESSAGES to "YES", which permits new UOW messages to be produced in subsequent broker sessions.

NUM‑BLACKLIST‑ENTRIES 256 | n O z u w v b
Number of entries in the participant blacklist. Default value is 256 entries. Together with BLACKLIST-PENALTY-TIME and PARTICIPANT-BLACKLIST, this attribute is used to protect a broker running with SECURITY=YES against denial-of-service attacks. See Protecting a Broker against Denial-of-Service Attacks under z/OS | UNIX | Windows.
NUM‑CLIENT n R z u w v b
Number of clients that can access the broker concurrently. A value of 0 (zero) is invalid.
NUM‑CMDLOG‑FILTER 1 | n O z u w v b
Maximum number of filters that can be specified simultaneously.

Tip:
We recommend you limit this value to the number of services that are being monitored. Minimum value is 1. A value of zero is invalid when the attribute CMDLOG is set to "YES". See Command Logging in EntireX for more information.

NUM‑COMBUF 1 - 999999 R z u w v b
Determines the maximum number of communication buffers available for processing commands arriving in the broker kernel. The size of one communication buffer is usually 16 KB split into 32 slots of 512 bytes, but it ultimately depends on the hardware architecture of your CPU. A value of 0 (zero) is invalid.
NUM‑CONVERSATION or
NUM-CONV
n | AUTO R z u w v b

Defines the number of conversations that can be active concurrently. The number specified should be high enough to account for both conversational and non-conversational requests. (Non-conversational requests are treated internally as one-conversation requests.)

n Number of conversations.
AUTO Uses the CONV-DEFAULT and the service-specific CONV-LIMIT values to calculate the number of conversations. The values used in the calculation must not be set to "UNLIM".

Notes:

  1. A value of 0 (zero) is invalid. If a wildcard service is defined in the service-specific section of the attribute file, the value of AUTO is invalid.
  2. See Wildcard Service Definition.
NUM‑LONG‑BUFFER or
NUM-LONG
n | AUTO R z u w v b

Defines the number of long message containers. Long message containers have a fixed length of 4096 bytes and are used to store requests that are larger than 2048 bytes. Storing a request of 8192 bytes, for example, would require two long message containers.

n Number of buffers.
AUTO Uses the LONG-BUFFER-DEFAULT and the service-specific LONG-BUFFER-LIMIT values to calculate the number of long message buffers. The values used in the calculation must not be set to "UNLIM".

A value of 0 (zero) is invalid.

In non-conversational mode, message containers are released as soon as the client receives a reply from the server. If no reply is requested, message containers are released as soon as the server receives the client request.

In conversational mode, the last message received is always kept until a new one is received.

Notes:

  1. If a catch-all service is defined in the service-specific section of the attribute file, the value of AUTO is invalid.
  2. See Wildcard Service Definition.
NUM‑PUBLICATION n | AUTO O z u w v b

Defines the number of publications that can be active concurrently.

n Number of publications
AUTO Uses the PUBLICATION-DEFAULT and the topic-specific PUBLICATION-LIMIT to calculate the number of publications. The values used in the calculation must not be set to "UNLIM"

Notes:

  1. A value of 0 (zero) is invalid.
  2. If a wildcard topic is defined in the topic-specific section of the attribute file, the value of AUTO is invalid.
NUM‑PARTICIPANT‑EXTENSION n O z u w v b

Defines the number of participant extensions to link participants as clients and servers.

n Number of participant extensions
not specified If this attribute is not set, the default value is calculated based on NUM-CLIENT and NUM-SERVER.

A value of 0 (zero) is invalid.

NUM‑PUBLISHER n O z u w v b
Number of publishers that can access the broker concurrently. A value of 0 (zero) is invalid.
NUM‑SERVER n | AUTO R z u w v b

Defines the number of servers that can offer services concurrently using the broker. This is not the number of services that can be registered to the broker (see NUM-SERVICE).

n Number of servers.
AUTO Uses the SERVER-DEFAULT and the service-specific SERVER-LIMIT values to calculate the number of servers. The values used in the calculation must not be set to "UNLIM".

Notes:

  1. Setting this value higher than the number of services allows the starting of server replicas that provide the same service.
  2. A value of 0 (zero) is invalid. If a wildcard service is defined in the service-specific section of the attribute file, the value of AUTO is invalid.
  3. See Wildcard Service Definition.
NUM‑SERVICE n R z u w v b
Defines the number of services that can be registered to the broker. This is not the number of servers that can offer the services (see NUM-SERVER). A value of 0 (zero) is invalid.
NUM‑SERVICE‑EXTENSION n | AUTO O z u w v b

Defines the number of service extensions to link servers to services.

n Number of service extensions.
AUTO Uses the value specified or calculated for NUM-SERVER + NUM-CLIENT, plus an extra cushion.
not specified If this attribute is not set, the default value is NUM-SERVER multiplied by NUM-SERVICE.

The minimum value is NUM-SERVER.
The maximum value is NUM-SERVER multiplied by NUM-SERVICE.

Caution is recommended with this attribute:

  • Set this attribute only if the storage resources allocated for service extensions need to be restricted.

  • Note that the value <n> allows only the specified number of server instances of <n> to be used.

  • Value AUTO will calculate the number of allowed server instances from NUM-SERVER, which itself might be set to AUTO. In this case, this also considers the value of SERVER-DEFAULT and even the individual SERVER-LIMIT for each service definition (see note below).

NUM‑SHORT‑BUFFER or
NUM-SHORT
n | AUTO R z u w v b

Defines the number of short message containers. Short message containers have a fixed length of 256 bytes and are used to store requests of no more than 2048 bytes. To store a request of 1024 bytes, for example, would require four short message containers.

n Number of buffers.
AUTO Uses the SHORT-BUFFER-DEFAULT and the service-specific SHORT-BUFFER-LIMIT values to calculate the number of short message buffers. The values used in the calculation must not be set to "UNLIM".

Notes:

  1. In non-conversational mode, message containers are released as soon as the client receives a reply from the server. If no reply is requested, message containers are released as soon as the server receives the client request.
  2. In conversational mode, the last message received is always kept until a new one is received.
  3. If a wildcard service is defined in the service-specific section of the attribute file, the value of AUTO is invalid.
  4. See Wildcard Service Definition.
NUM‑SUBSCRIBER n | AUTO O z u w v b

Defines the number of subscribers that can be active concurrently.

n Number of subscribers.
AUTO Uses the SUBSCRIBER-DEFAULT and the topic-specific SUBSCRIBER-LIMIT to calculate the number of subscribers.

A value of 0 (zero) is invalid. If a wildcard topic is defined in the topic-specific section of the attribute file, the value of AUTO is invalid.

NUM‑SUBSCRIBER‑TOTAL n | AUTO O z u w v b

Defines the total number of subscribers that can be durably subscribed. Their subscription information is saved in the persistent store.

n Total number of subscribers.
AUTO Uses the value defined or calculated for NUM-SUBSCRIBER.

A value of 0 (zero) is invalid. This value must be greater than or equal to the NUM-SUBSCRIBER value. Parameter is required if SUBSCRIBER-STORE=PSTORE is defined.

NUM‑TOPIC n O z u w v b

Defines the number of topics that can be active in the broker. A value of 0 (zero) is invalid.

NUM‑TOPIC‑EXTENSION n | AUTO O z u w v b

Defines the number of topic extensions to link subscribers to topics.

n Number of topic extensions.
AUTO Uses the value specified for NUM-SUBSCRIBER + NUM-PUBLISHER, plus an extra cushion.
not specified If this attribute is not set, the default value is NUM-SUBSCRIBER multiplied by NUM-TOPIC.

The minimum value is NUM-SUBSCRIBER.
The maximum value is NUM-SUBSCRIBER multiplied by NUM-TOPIC.

Caution is recommended with this attribute.

  • Set this attribute only if the storage resources allocated for topic extensions need to be restricted.

  • Note that the value <n> allows only the specified number of topic instances of <n> to be used.

  • Value AUTO calculates the number of allowed server instances from NUM-SUBSCRIBER, which itself might set to AUTO. In this case, this also considers the value of SERVER-DEFAULT and even the individual SERVER-LIMIT for each topic definition (see note below).

NUM‑TOPIC‑TOTAL n | AUTO O z u w v b

Defines the total number of topics for which durable subscribers are allowed.

n Total number of topics that allow durable subscriptions.
AUTO Uses the value defined for NUM-TOPIC.

This value must be greater than or equal to the NUM-TOPIC value. This parameter is required if SUBSCRIBER-STORE=PSTORE is defined.

NUM‑UOW 0 | n O z u w v b
The maximum number of UOWs that can be concurrently active broker-wide. The default value is 0 (zero), which means that the broker will process only messages that are not part of a unit of work. If UOW processing is to be done by any service, a NUM-UOW value must be 1 or larger for the broker. (MAX-UOWS is an alias for this attribute.)

The NUM-UOW value for the service will default to the value set for the broker.

NUM‑WORKER 1 | n (max. 10) R z u w v b
Number of worker tasks that the broker can use. The number of worker tasks determines the number of functions (SEND, RECEIVE, REGISTER, etc.) that can be processed concurrently. At least one worker task is required; this is the default value.
NUM‑WQE 1 - 32768 R z u w v b
Maximum number of requests that can be processed by the broker in parallel, over all transport mechanisms.

Each broker command is assigned a worker queue element, regardless of the transport mechanism being used. This element is released when the user has received the results of the command, including the case where the command has timed out.

PARTICIPANT‑BLACKLIST YES | NO R z u w v b

Determines whether participants attempting a denial-of-service attack on the broker are to be put on a blacklist.

YES Create a participant blacklist.
NO Do not create a participant blacklist.

See Protecting a Broker against Denial-of-Service Attacks under z/OS | UNIX | Windows.

PARTNER‑CLUSTER‑ADDRESS A32 R z u w v b

This is the address of the load/unload broker in transport-method-style. Transport methods TCP and SSL are supported. See Transport-method-style Broker ID for more details. This attribute is required if the attribute RUN-MODE is specified.

POLL YES | NO O z u   v  

In earlier EntireX versions, the maximum number of TCP/IP connections per communicator was limited; see Maximum TCP/IP Connections per Communicator for platform-specific list. With attribute POLL introduced in EntireX version 9.0, this restriction can be lifted under z/OS, UNIX and z/VSE.

NO This setting is used to run the compatibility mode in Broker. The poll() system call is not used. The limitations described under Maximum TCP/IP Connections per Communicator apply.
YES The poll() system call is used to lift the resource restrictions with select() in multiplexing file descriptor sets.

Note:
Setting this attribute to YES increases CPU consumption. POLL=YES is only useful if you need more than the maximum number of TCP/IP connections per communicator; we recommend POLL=NO to reduce CPU consumption.

PSTORE NO | HOT | COLD O z u w v b

Defines the status of the persistent store at broker startup, including the condition of persistent units of work (UOWs). With any value other than "NO", PSTORE-TYPE must be set.

NO No persistent store.
HOT Persistent UOWs are restored to their prior state during initialization.
COLD Persistent UOWs are not restored during initialization, and the persistent store is considered empty.

Note:
For a hot or cold start, the persistent store must be available when your broker is restarted.

PSTORE‑REPORT NO | YES O z u w v b

Determines whether PSTORE report is created.

NO Do not create the PSTORE report file.
YES Create the PSTORE report file.

See also Persistent Store Report.

PSTORE‑TYPE DIV (z/OS) | CTREE (UNIX, Windows) | Adabas (all platforms) | FILE (UNIX, Windows) O z u w v b

Describes the type of persistent store driver required.

DIV Data in Virtual. z/OS only, and default on this platform. See DIV-specific Attributes below and Implementing a DIV Persistent Store under Managing the Broker Persistent Store.
CTREE c-tree database. UNIX and Windows only. See c-tree-specific Attributes and c-tree Database as Persistent Store under UNIX | Windows.
ADABAS Adabas. All platforms. See also Adabas-specific Attributes (below) and Managing the Broker Persistent Store under z/OS | UNIX | Windows | BS2000/OSD | z/VSE.
FILE B-Tree database. UNIX and Windows only. No longer supported.
PSTORE‑VERSION 2 | 3 | 4 O z u w v b

Determines the version of the persistent store. PSTORE=COLD is not needed to upgrade the PSTORE to version 3. Any broker restart with PSTORE-VERSION=3 will upgrade the PSTORE version.

PSTORE-VERSION=3 is needed for ICU support. We recommended setting PSTORE-VERSION=3.

The DIV PSTORE requires PSTORE-VERSION=4.

Caution:

  • If you go back to PSTORE-VERSION=2 after upgrading to PSTORE-VERSION=3, the broker will only process data previously created with version 2. No version 3 data will be accessible.

  • If you change the DIV PSTORE from version 3 to 4, perform a COLD restart for the change to take effect, or run PSTORE UNLOAD/LOAD first.

PUBLICATION‑DEFAULT n | UNLIM O z u w v b

Default number of publications that are allocated for every topic.

n Number of publications.
UNLIM The number of publications is restricted only by the number of publications globally available. Precludes the use of NUM-PUBLICATION=AUTO.

This value can be overridden by specifying a PUBLICATION-LIMIT for the topic. A value of 0 (zero) is invalid.

PUBLICATION‑LIFETIME n | nS | nM | nH | nD | nY O z u w v b

Lifetime of a publication in absolute time units. Publications are retained by broker until they are either received by all subscribers or the publication lifetime has expired.

n Same as nS.
nS Publication lifetime in seconds (max. 2147483647).
nM Publication lifetime in minutes (max. 35791394).
nH Publication lifetime in hours (max. 596523).
nD Publication lifetime in days (max. 24855).
nY Publication lifetime in years (max. 68).

The publication lifetime is calculated even for periods of time when broker is stopped.

PUBLISH‑AND‑SUBSCRIBE YES | NO O z u w v b
Run publish and subscribe subsystem. Subsystem requires a license.
RUN‑MODE STANDARD | STANDBY | PSTORE-LOAD | PSTORE-UNLOAD O z u w v b

Determines the initial run mode of the broker.

STANDARD Default value. Normal mode.
STANDBY Deprecated. Supported for compatibility reasons.
PSTORE-LOAD Broker will run as load broker to write Persistent Store data to a new persistent store. See also Migrating the Persistent Store.
PSTORE-UNLOAD Broker will run as unload broker to read an existing persistent store and pass the data to a broker running in PSTORE-LOAD mode. See also Migrating the Persistent Store.
SECURITY NO | YES O z u w v b

Determines whether the EntireX Broker security exits are activated.

NO The security exits are not activated.
YES The security exits are activated. If the security routines cannot be activated, the broker will not start.

Broker trace reports the type of security which is active and from where the security module USRSEC is loaded:

  • EntireX Security

  • User-written USRSEC.

SECURITY‑PATH A255 O z u w   b
Full path and file name of an executable file (for example, DLL for Windows or shared library for UNIX) containing the user security exit which the kernel will load and call. Example:
SECURITY-PATH=usersec.dll

This assumes the DLL is in the default path. Or:

SECURITY-PATH=c:\brokerexit\yoursecu.dll

If the path name contains spaces, enclose it in quotation marks. Example:

SECURITY-PATH="c:\Software AG\broker exit\yoursecu.dll"

Note:
This attribute is used only when implementing a user-written security exit.

SERVER‑DEFAULT n | UNLIM O z u w v b

Default number of servers that are allowed for every service.

n Number of servers.
UNLIM The number of servers is restricted only by the number of servers globally available. Precludes the use of NUM-SERVER=AUTO.

This value can be overridden by specifying a SERVER-LIMIT for the service. A value of 0 (zero) is invalid.

SERVICE‑UPDATES YES | NO O z u w v b

Switch on/off the automatic update mode of the broker.

YES The broker reads the attribute file whenever a service registers for the first time. This allows the broker to honor modifications in the attribute file without a restart. The attribute file is read only when the first server registers for a particular service; it is not reread when a second replica is activated.
NO The attribute file is read only once during broker startup. Any changes to the attribute file will be honored only if the broker is restarted.
SHORT‑BUFFER‑DEFAULT UNLIM | n O z u w v b

Number of short buffers to be allocated for each service.

UNLIM The number of short message buffers is restricted only by the number of buffers globally available. Precludes the use of NUM-SHORT-BUFFER=AUTO.
n Number of buffers.

This value can be overridden by specifying a SHORT-BUFFER-LIMIT for the service. A value of 0 (zero) is invalid.

SSLPORT See PORT.
SSL‑RESTART See RESTART.
SSL‑RETRY‑LIMIT See RETRY-LIMIT.
SSL‑RETRY‑TIME See RETRY-TIME.
SSTORE
SSTORE‑TYPE
These parameters are obsolete. The subscriber store in a secondary store is no longer supported. We recommend you use the PSTORE persistent store to store your subscriber data. For this, set broker-specific parameter SUBSCRIBER-STORE=PSTORE.
STORAGE‑REPORT NO | YES O z u w v b

Create a storage report about broker memory usage.

NO Do not create the storage report.
YES Create the storage report.

See Storage Report.

STORE OFF | BROKER O z u w v b

Sets the default STORE attribute for all units of work. This attribute can be overridden by the STORE field in the Broker ACI control block.

OFF Units of work are not persistent.
BROKER Units of work are persistent.
SUBSCRIBER‑DEFAULT n | UNLIM O z u w v b
 

Default number of subscribers that are allowed for every topic.

n Number of subscribers
UNLIM The number of subscribers is restricted only by the number of subscribers globally available. Precludes the use of NUM-SUBSCRIBER=AUTO.

This value can be overridden by specifying a SUBSCRIBER-LIMIT for the topic. A value of 0 (zero) is invalid.

SUBSCRIBER‑STORE NO | PSTORE O z u w v b

Determines whether subscriber information is stored and where.

NO No subscriber information is to be stored.
PSTORE Save subscriber data in PSTORE.

Tip:
The subscriber store in a secondary store is no longer supported. We recommend you use the PSTORE persistent store to store your subscriber data.

TCPPORT See PORT.
SWAP‑OUT‑NEW‑UOWS NO | YES O z u w v b

Determines whether conversations with units of work remain in memory or are swapped. See also Swapping out New Units of Work.

NO All conversations with UOWs remain in memory.
YES Conversations with UOWs (STORE=BROKER) created by a client and finished with an EOC without being accepted by a server will be swapped out of memory. The data is persisted on PSTORE and there is no need to keep it in memory unless a server wants to receive this data.

Note:
See service-specific attribute MIN-UOW-CONVERSATIONS-IN-MEMORY for defining a minimum number of UOW conversations kept in memory to improve the performance for servers receiving new UOW conversations without waiting for swap-in of data from PSTORE. During broker restart, all new and unassigned UOW conversations remain in PSTORE only. This reduces the restart time significantly.

See also Swapping out New Units of Work.

TCP‑RESTART See RESTART.
TCP‑RETRY‑LIMIT See RETRY-LIMIT.
TCP‑RETRY‑TIME See RETRY-TIME.
TOPIC‑UPDATES YES | NO O z u w v b

Switch on/off automatic update of topic defaults in the broker.

YES The broker reads the attribute file whenever a topic is being subscribed for the first time. This allows broker to honor modifications in the attribute file without a restart. The attribute file is read only when the first subscriber subscribes to a particular topic. It is not reread when a second subscriber subscribes to the same topic.
NO The attribute file is read only once during broker startup. Any changes to the attribute file will be honored only if the broker is restarted.
TRACE‑DD A255 O z        

A string containing data set attributes enclosed in quotation marks. These attributes describe the trace output file and must be defined if you are using using a GDG (generation data group) as output data set. See Flushing Trace Data to a GDG Data Set under Tracing EntireX Broker.

The following keywords are supported as part of the TRACE-DD value:

  • DATACLAS

  • DCB including BLKSIZE, DSORG, LRECL, RECFM

  • DISP

  • DSN

  • MGMTCLAS

  • SPACE

  • STORCLAS

  • UNIT

Refer to your JCL Reference Manual for a complete description of the syntax.

Example:

TRACE-DD = "DSNAME=EXX.GDG, 
          DCB=(BLKSIZE=1210,DSORG=PS,LRECL=121,RECFM=FB),
          DISP=(NEW,CATLG,CATLG), 
          SPACE=(CYL,(100,10)),
          STORCLAS=SMS"
TRACE‑LEVEL 0 - 4 O z u w v b

The level of tracing to be performed while the broker is running.

0 No tracing. Default value.
1 Traces incoming requests, outgoing replies, resource usage and conversion errors if SAGTRPC is used for CONVERSION with the conversion options SUBSTITUTE-NONCONV or STOP.
2 All of trace level 1, plus all main routines executed.
3 All of trace level 2, plus all routines executed.
4 All of trace level 3, plus Broker ACI control block displays.

If you modify the TRACE-LEVEL attribute, you must restart the broker for the change to take effect. For temporary changes to TRACE-LEVEL without restarting the broker, use System Management Hub or ETBCMD.

Trace levels 2, 3, and 4 should be used only when requested by Software AG support.

TRANSPORT TCP-NET | TCP | SSL | NET O z     v b
TCP | SSL O   u w    

The broker transport may be specified as any combination of one or more of the following methods:

TCP TCP/IP is supported.
SSL SSL/TLS is supported.
NET Entire Net-Work is supported. This value is not supported for a broker under UNIX or Windows.
Examples:

TRANSPORT=NET specifies that only the Entire Net-Work transport method will be supported by the broker.

TRANSPORT=TCP-NET specifies that both the TCP/IP and Net-Work transport methods will be supported by the broker.

TRANSPORT=TCP-SSL-NET specifies that the TCP/IP, SSL/TLS, and Entire Net-Work transport methods will be supported by the broker.

The parameters for each transport method are described in the respective section: TCP | SSL | NET.

TRAP‑ERROR nnnn O z u w   b

Where nnnn is the four-digit API error number that triggers the trace handler, for example 0007 (Service not registered). Leading zeros are not required. There is no default value.

See Deferred Tracing under z/OS | UNIX | Windows.

TRBUFNUM n O z u w   b

Changes the trace to write trace data to internal trace buffers. n is the size of the trace buffer in 64 KB units. There is no default value.

TRMODE WRAP O z u w   b

Changes the trace mode. "WRAP" is the only possible value. This value instructs broker to write the trace buffer (see TRBUFNUM) if an event occurs. This event is triggered by a matching TRAP-ERROR during request processing or when an exception occurs.

UMSG

See MAX-MESSAGES-IN-UOW.

UOW‑MSGS

See MAX-MESSAGES-IN-UOW.

UWSTAT‑LIFETIME no value | n[S] | nM | nH | nD O z u w v b

The value to be added to the UWTIME (lifetime of associated UOW). If a value is entered, it must be 1 or greater; a value of 0 will result in an error. If no value is entered, the lifetime of the UOW status information will be the same as the lifetime of the UOW itself.

nS Number of seconds the UOW status exists longer than the UOW itself (max. 2147483647).
nM Number of minutes (max. 35791394).
nH Number of hours (max. 596523).
nD Number of days (max. 24855).

The lifetime determines how much additional time the UOW status is retained in the persistent store and is calculated from the time at which the associated UOW enters any of the following statuses: "PROCESSED", "TIMEOUT", "BACKEDOUT", "CANCELLED", "DISCARDED". The additional lifetime of the UOW status is calculated only when broker is executing. Value in UWSTAT-LIFETIME supersedes the value (if specified) in attribute UWSTATP.

Note:
If no unit is specified, the default unit is seconds. The unit does not have to be identical to the unit specified for UWTIME.

UWSTATP 0 | n O z u w v b

Contains a multiplier used to compute the lifetime of a persistent status for the service. The UWSTATP value is multiplied by the UWTIME value (the lifetime of the associated UOW) to determine the length of time the status will be retained in the persistent store.

0 The status is not persistent.
1 - 254 Multiplied by the value of UWTIME to determine how long a persistent status will be retained.

Note:
This attribute has not been supported since EntireX version 7.3. Use UWSTAT-LIFETIME instead.

UWTIME 1D | nS | nM | nH | nD O z u w v b

Defines the default lifetime for units of work for the service.

nS Number of seconds the UOW can exist (max. 2147483647).
nM Number of minutes the UOW can exist (max. 35791394).
nH Number of hours the UOW can exist (max. 596523).
nD Number of days the UOW can exist (max. 24855).

If the UOW is inactive - that is, is not processed within the time limit - it is deleted and given a status of "TIMEOUT". This attribute can be overridden by the UWTIME field in the Broker ACI control block.

See Timeout Considerations for EntireX Broker.

WAIT‑FOR‑ACTIVE‑PSTORE NO | YES O z u w v b

Determines whether broker should wait for the Adabas Persistent Store to become active.

NO If broker should start with a PSTORE-TYPE=ADABAS and the database is not active or is not accessible, broker will stop.
YES If broker should start with a PSTORE-TYPE=ADABAS and the database is not active or is not accessible, broker will retry every 10 seconds to initiate communications with the PSTORE. Broker will reject any user requests until broker is able to contact the Adabas database.
WORKER‑MAX 32 | n  (min. 1, max. 32) O z u w   b

Maximum number of worker tasks the broker can use.

WORKER‑MIN 1 | n (min. 1, max. 32) O z u w   b

Minimum number of worker tasks the broker can use.

WORKER‑NONACT 70S n | nS | nM | nH O z u w   b
Non-activity time to elapse before a worker tasks is stopped.
n Same as nS.
nS Non-activity time in seconds (default 70, max. 2147483647).
nM Non-activity time in in minutes (max. 35791394).
nH Non-activity time in hours (max. 596523).

Caution:
A value of 0 (zero) is invalid. If you set this value too low, additional overhead is required for starting and stopping worker tasks. The default and recommended value is 70S.

WORKER‑QUEUE‑DEPTH 1 | n (min. 1) O z u w   b

Number of unassigned user requests in the input queue before another worker task gets started. The default and recommended value is 1. A higher value will result in longer broker response times.

WORKER‑START‑DELAY internal-value | n O z u w   b
n Delay is extended by n seconds.

Delay after a successful worker task invocation before another worker task can be started to handle current incoming workload. This attribute is used to avoid the risk of recursive invocation of worker tasks, because starting a worker task itself causes workload increase.

If no value is specified, an internal value calculated by the broker is used to optimize dynamic worker management. This calculated value is the maximum time required to start a worker task.

Top of page

Service-specific Attributes

Each section begins with the keyword DEFAULTS=SERVICE. Services with common attribute values can be grouped together. The attributes defined in the grouping apply to all services specified within it. However, if a different attribute value is defined immediately following the service definition, that new value applies. See also the sections Wildcard Service Definition and Service Update Modes below the table.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

APPLICATION‑MONITORING or
APPMON
YES | NO O z u w v  
YES Enable application monitoring for the specified services.
NO Disable application monitoring for the specified services.

See Application Monitoring.

APPLICATION‑MONITORING‑NAME or
APPMON-NAME
A100 O z u w v  
Specifies the application monitoring name. Used to set the value of the ApplicationName KPI.

If omitted, the default value from the APPLICATION-MONITORING section is used. If this value is also not specified, the corresponding CLASS/SERVER/SERVICE names are used.

See Application Monitoring.

CLASS A32 (case-sensitive) R z u w v b
Part of the name that identifies the service together with the SERVER and SERVICE attributes. CLASS must be specified first, followed immediately by SERVER and SERVICE.

Classes starting with any of the following are reserved for use by Software AG and should not be used in customer-written applications: BROKER, SAG, ENTIRE, ETB, RPC, ADABAS, NATURAL. Valid characters for class name are letters a-z, A-Z, numbers 0-9, hyphen and underscore. Do not use dollar, percent, period or comma. See also the restriction for SERVICE attribute names.

CLIENT‑RPC‑AUTHORIZATION N | Y O z       b
Determines whether this service is subject to RPC authorization checking.
N No RPC authorization checking is performed.
Y RPC library and program name are appended to the authorization check performed by EntireX Security. Specify "YES" only to RPC-supported services.

To allow conformity with Natural Security, the CLIENT-RPC-AUTHORIZATION parameter can optionally be defined with a prefix character as follows: CLIENT-RPC-AUTHORIZATION= (YES,<prefix-character>).

CONV‑LIMIT UNLIM | n O z u w v b

Allocates a number of conversations especially for this service.

UNLIM The number of conversations is restricted only by the number of conversations globally available. Precludes the use of NUM-CONVERSATION=AUTO in the Broker section of the attribute file.
n Number of conversations.

A value of 0 (zero) is invalid.
If NUM-CONVERSATION=AUTO is specified in the Broker section of the attribute file, CONV-LIMIT=UNLIM is not allowed in the service section. A value must be specified or the CONV-LIMIT attribute must be suppressed entirely for the service so that the default (CONV-DEFAULT) becomes active.

CONV‑NONACT 5M | n | nS | nM | nH R z u w v b

Non-activity time for connections.

n Same as nS.
nS Non-activity time in seconds (max. 2147483647).
nM Non-activity time in minutes (max. 35791394).
nH Non-activity time in hours (max. 596523).

A value of 0 (zero) is invalid. If a connection is not used for the specified time, that is, a server or a client does not issue a broker request that references the connection in any way, the connection is treated as inactive and the allocated resources are freed.

CONVERSION Format: A255

( SAGTCHA [, TRACE =n] [, OPTION =s] |

  SAGTRPC [, TRACE =n] [, OPTION =s] |

  name [, TRACE =n] |

  NO )

O z u w v b

Defines conversion for internationalization. See Internationalization with EntireX and What is the Best Internationalization Approach to use? for help on making decisions about the internationalization approach.

SAGTCHA (1) Conversion using ICU Conversion for ACI-based Programming.
SAGTRPC (2) Conversion using ICU Conversion for RPC-based Components and Reliable RPC.

We recommend always using SAGTRPC for RPC data streams. Conversion with Multibyte, Double-byte and other Complex Codepages will always be correct, and Conversion with Single-byte Codepages is also efficient because SAGTRPC detects single-byte codepages automatically. See Conversion Details.

<name(3) Name of the SAGTRPC user exit for RPC-based components. See also Configuring SAGTRPC User Exits under z/OS | UNIX | Windows and Writing SAGTRPC User Exits under z/OS | UNIX | Windows.
NO If conversion is not to be used, either omit the CONVERSION attribute or specify CONVERSION=NO, for example for binary payload.

Only one internationalization approach can be active at one time for a service. The CONVERSION attribute for internationalization overrides the TRANSLATION attribute when defined for a service. That is, when TRANSLATION and CONVERSION are both defined, TRANSLATION will be ignored.

Notes:

  1. See also Configuring ICU Conversion under z/OS | UNIX | Windows | BS2000/OSD | z/VSE.
  2. Conversion with Multibyte, Double-byte and other Complex Codepages is not supported on BS2000. For Conversion with Single-byte Codepages, use SAGTCHA.
  3. SAGTRPC user exit is not supported on z/VSE and BS2000.
TRACE

If tracing is switched on, the trace output is written to the broker log file:

0 No tracing  
1 Trace level STANDARD This level is an "on-error" trace. It provides information on conversion errors only. For RPC calls this includes the IDL library, IDL program and the data. Please note that if OPTION Values for Conversion are set, errors are ignored.
2 Trace level ADVANCED Tracing of incoming, outgoing parameters and the payload.
3 Trace level SUPPORT This trace level is for support diagnostics and should only be switched on when requested by Software AG support.

OPTION

See table of possible values under OPTION Values for Conversion.

DEFERRED NO | YES O z u w v b

NO Units of work cannot be sent to the service until it is available.
YES Units of work can be sent to a service that is not up and registered. The units of work will be processed when the service becomes available.
ENCRYPTION‑LEVEL 0 | 1 | 2 O z u w v b

Enforce encryption when data is transferred between client and server.

0 No encryption is enforced.
1 Encryption is enforced between server and broker kernel.
2 Encryption is enforced between server and broker kernel, and also between client and broker.

See also ENCRYPTION-LEVEL in Broker ACI control block and Encryption under Writing Applications using EntireX Security.

Note:
The per service ENCRYPTION-LEVEL attribute is to be specified only where the broker attribute SECURITY=YES has been specified and only if you are using EntireX Security.

LOAD‑BALANCING YES | NO O z u w v b
YES When servers that offer a particular service are started, new conversations will be assigned to these servers in a round-robin fashion. The first waiting server will get the first new conversation, the second waiting server will get the second new conversation, and so on.
NO A new conversation is always assigned to the first server in the queue.
LONG‑BUFFER‑LIMIT UNLIM | n O z u w v b

Allocates a number of long message buffers for the service.

UNLIM The number of long message buffers is restricted only by the number of buffers globally available. Precludes the use of NUM-LONG-BUFFER=AUTO in the Broker section of the attribute file.
n Number of long message buffers.

A value of 0 (zero) is invalid. If NUM-LONG-BUFFER=AUTO is specified in the Broker section of the attribute file, LONG-BUFFER-LIMIT=UNLIM is not allowed in the service section. A value must be specified or the LONG-BUFFER-LIMIT attribute must be suppressed entirely for the service so that the default (LONG-BUFFER-DEFAULT) becomes active.

MAX‑MESSAGES‑IN‑UOW 16 | n O z u w v b
Maximum number of messages in a UOW.
MAX‑MESSAGE‑LENGTH 2147483647 | n O z u w   b

Maximum message size that can be sent to a service.

This is transport-dependent. The default value represents the highest positive number that can be stored in a four-byte integer.

MAX‑MSG

See MAX-MESSAGE-LENGTH.

MAX‑UOW‑MESSAGE‑LENGTH

See MAX-MESSAGE-LENGTH.

MAX‑UOWS 0 | n O z u w v b

0 The service does not accept units of work, i.e. it processes only messages that are not part of a UOW. Using zero prevents the sending of UOWs to services that are not intended to process them.
n Maximum number of UOWs that can be active concurrently for the service. If you do not provide a MAX-UOWS value for the service, it defaults to the MAX-UOWS setting for the broker. If you provide a value that exceeds that of the broker, the service MAX-UOWS is set to the broker's MAX-UOWS value and a warning message is issued.

Specify MAX-UOWS=0 for Natural RPC Servers. This restriction will be removed with a later release.

MIN‑UOW‑CONVERSATIONS‑IN‑MEMORY 256 | n O z u w v b

Defines the minimum number of UOW conversations (STORE=BROKER, created by a client and finished with an EOC without being accepted by a server) kept in memory to improve the performance for servers receiving new UOW conversations without waiting for data to be swapped in from PSTORE. See also Swapping out New Units of Work.

256 The default value should be used if producer (client) and consumer (server) of UOW conversations are both active at the same time regardless of the speed producing or consuming UOW conversations. It guarantees a reasonable balance between memory being used and swap-out/swap-in activities.
n Minimum number of UOW conversations kept in memory. The value n is equal to or greater than 256.

Note:
If broker-specific attribute SWAP-OUT-NEW-UOWS is set to "NO", MIN-UOW-CONVERSATIONS-IN-MEMORY has no effect.

MUOW

See MAX-UOWS.

NOTIFY‑EOC NO | YES O z u w v b

Specifies whether timed-out conversations are to be stored or discarded.

NO Discard the EOC notifications if the server is not ready to receive.
YES Store the EOC notifications if the server is not ready to receive and then notify the server if possible.

If a server is not ready to receive an EOC notification, it can be stored or discarded. If it is stored, the server is notified, if possible, when it is ready to receive.

Caution:
The behavior activated by this parameter can be relied upon only during a single lifetime of the broker kernel. Specifically, conversations containing units of work, whose lifetime can span multiple broker kernel sessions, cannot be assumed to show this behavior, even with NOTIFY-EOC=YES.

NUM‑UOW

Alias for MAX-UOWS.

SERVER A32 (case-sensitive) R z u w v b

Part of the name that identifies the service together with the CLASS and SERVICE attributes.

CLASS must be specified first, followed immediately by SERVER and SERVICE.

Valid characters for server name are letters a-z, A-Z, numbers 0-9, hyphen and underscore. Do not use dollar, percent, period or comma.

SERVER‑DEFAULT n | UNLIM O z u w v b

Default number of servers that are allowed for every service.

n Number of servers.
UNLIM The number of servers is restricted only by the number of servers globally available. Precludes the use of NUM-SERVER=AUTO.

A value of 0 (zero) is invalid.

This value can be overridden by specifying a SERVER-LIMIT for the service.

SERVER‑LIMIT n | UNLIM O z u w v b

Allows a number of servers especially for this service.

n Number of servers.
UNLIM The number of servers is restricted only by the number of servers globally available. Precludes the use of NUM-SERVER=AUTO in the Broker section of the attribute file.

A value of 0 (zero) is invalid.

If NUM-SERVER=AUTO is specified in the Broker section of the attribute file, SERVER-LIMIT=UNLIM is not allowed in the service section. A value must be specified or the SERVER-LIMIT attribute must be suppressed entirely for the service so that the default (SERVER-DEFAULT) becomes active.

SERVER‑NONACT 5M | n | nS | nM | nH R z u w v b

Non-activity time for servers. A server that does not issue a broker request within the specified time limit is treated as inactive and all resources for the server are freed.

n Same as nS.
nS Non-activity time in seconds (max. 2147483647).
nM Non-activity time in minutes (max. 35791394).
nH Non-activity time in hours (max. 596523).

If a server registers multiple services, the highest value of all the services registered is taken as non-activity time for the server.

SERVICE A32 (case-sensitive) R z u w v b

Part of the name that identifies the service together with the CLASS and SERVER attributes.

CLASS must be specified first, followed immediately by SERVER and SERVICE.

The SERVICE attribute names "EXTRACTOR" and "DEPLOYMENT" are reserved for Software AG internal use and should not be used in customer-written applications. Valid characters for service name are letters a-z, A-Z, numbers 0-9, hyphen and underscore. Do not use dollar, percent, period or comma. See also the restriction for CLASS attribute names.

SHORT‑BUFFER‑LIMIT UNLIM | n O z u w v b

Allocates a number of short message buffers for the service.

UNLIM The number of short message buffers is restricted only by the number of buffers globally available. Precludes the use of NUM-SHORT-BUFFER=AUTO in the Broker section of the attribute file.
n Number of short message buffers.

If NUM-SHORT-BUFFER=AUTO is specified in the Broker section of the attribute file, SHORT-BUFFER-LIMIT=UNLIM is not allowed in the service section. A value must be specified or the SHORT-BUFFER-LIMIT attribute must be suppressed entirely for the service so that the default (SHORT-BUFFER-DEFAULT) becomes active.

STORE OFF | BROKER O z u w v b

Sets the default STORE attribute for all units of work sent to the service.

OFF Units of work are not persistent.
BROKER Units of work are persistent.

This attribute can be overridden by the STORE field in the Broker ACI control block.

TRANSLATION Format: A255

SAGTCHA | NO | <name>

O z u w v b

Activates translation or translation user exit for internationalization (see Translation User Exit). For help on deciding the right internationalization approach for your environment, see What is the Best Internationalization Approach to use?

SAGTCHA Conversion routine SAGTCHA for ACI-based Programming, RPC-based Components and Reliable RPC.
NO If translation is not to be used - e.g., for binary payload (broker messages) - either omit the TRANSLATION attribute or specify TRANSLATION=NO.
<name> Name of Translation User Exit. See also Configuring Translation User Exits under z/OS | UNIX | Windows | BS2000/OSD | z/VSE or Writing Translation User Exits under z/OS | UNIX | Windows | BS2000/OSD | z/VSE.

The CONVERSION attribute for internationalization overrides the TRANSLATION attribute when defined for a service; that is, when TRANSLATION and CONVERSION are both defined, TRANSLATION will be ignored.

UMSG

Alias for MAX-MESSAGES-IN-UOW.

UOW‑MSGS

Alias for MAX-MESSAGES-IN-UOW.

UWSTAT‑LIFETIME no value | n[S] | nM | nH | nD O z u w v b

The value to be added to the UWTIME (lifetime of associated UOW). If a value is entered, it must be 1 or greater; a value of 0 will result in an error. If no value is entered, the lifetime of the UOW status information will be the same as the lifetime of the UOW itself.

nS Number of seconds the UOW status exists longer than the UOW itself (max. 2147483647).
nM Number of minutes (max. 35791394).
nH Number of hours (max. 596523).
nD Number of days (max. 24855).

The lifetime determines how much additional time the UOW status is retained in the persistent store and is calculated from the time at which the associated UOW enters any of the following statuses: "PROCESSED", "TIMEOUT", "BACKEDOUT", "CANCELLED", "DISCARDED". The additional lifetime of the UOW status is calculated only when broker is executing. Value in UWSTAT-LIFETIME supersedes the value (if specified) in attribute UWSTATP.

Note:
If no unit is specified, the default unit is seconds. The unit does not have to be identical to the unit specified for UWTIME.

UWSTATP 0 | n O z u w v b

Contains a multiplier used to compute the lifetime of a persistent status for the service. The UWSTATP value is multiplied by the UWTIME value (the lifetime of the associated UOW) to determine the length of time the status will be retained in the persistent store.

0 The status is not persistent.
1 - 254 Multiplied by the value of UWTIME to determine how long a persistent status will be retained.

Note:
This attribute has not been supported since EntireX version 7.3. Use UWSTAT-LIFETIME instead.

UWTIME 1D | n S | n M | n H | nD O z u w v b

Defines the default lifetime for units of work for the service.

nS Number of seconds the UOW can exist (max. 2147483647).
nM Number of minutes the UOW can exist (max. 35791394).
nH Number of hours the UOW can exist (max. 596523).
nD Number of days the UOW can exist (max. 24855).

If the unit of work (UOW) is inactive, that is, not processed within the time limit, it is deleted and given a status of TIMEOUT. This attribute can be overridden by the UWTIME field in the Broker ACI control block.

Wildcard Service Definition

The special names of CLASS = *, SERVER = * and SERVICE = * are allowed in the service-specific section of the broker attribute file. These are known as "wildcard" service definitions. If this name is present in the attribute file, any service that registers with the broker and does not have its own entry in the attribute file will inherit the attributes that apply to the first wildcard service definition found.

For example, a server that registers with CLASS=ACLASS, SERVER=ASERVER and SERVICE=ASERVICE can inherit attributes from any of the following entries in the attribute file (this list is not necessarily complete):

CLASS = *, SERVER = ASERVER, SERVICE = ASERVICE 
CLASS = ACLASS, SERVER = *, SERVICE = * 
CLASS = *, SERVER = *, SERVICE = *

Of course, if there is a set of attributes that are specifically defined for CLASS=ACLASS, SERVER=ASERVER, SERVICE=ASERVICE, then all of the wildcard service definitions will be ignored in favor of the exact matching definition.

Service Update Modes

EntireX has two modes for handling service-specific attributes. See broker-specific attribute SERVICE-UPDATES.

OPTION Values for Conversion

The different option values allow you to either handle character conversion deficiencies as errors, or to ignore them:

  1. Do not ignore any character conversion errors and force an error always (value STOP). This is the default behavior.

  2. Ignore if characters can not be converted into the receiver's codepage, but force an error if sender characters do not match the sender's codepage (value SUBSTITUTE-NONCONV).

  3. Ignore any character conversion errors (values SUBSTITUTE and BLANKOUT).

The situations 1 and 2 above are reported to the broker log file if TRACE option for CONVERSION is set to level 1.

Value Description Options Supported for Report Situation in Broker Log File if TRACE Option for CONVERSION is set to 1
SAGTCHA SAGTRPC Bad Input Characters (Sender's Codepage) Non-convertible Characters (Receiver's Codepage)
SUBSTITUTE Substitutes both non-convertible characters (receiver's codepage) and bad input characters (sender's codepage) with a codepage-dependent default replacement character. yes yes No message. No message
SUBSTITUTE-NONCONV If a corresponding code point is not available in the receiver's codepage, the character cannot be converted and is substituted with a codepage-dependent default replacement character. Bad input characters in sender's codepage are not substituted and result in an error. yes yes Write detailed conversion error message. No message.
BLANKOUT Substitutes non-convertible characters with a codepage-dependent default replacement; blanks out the complete RPC IDL field containing one or more bad input characters. no yes No message. No message.
STOP Signals an error on detecting a non-convertible or bad input character. This is the default behavior if no option is specified. yes yes Write detailed conversion error message. Write detailed conversion error message.

Top of page

Topic-specific Attributes

The topic-specific attribute section begins with the keyword DEFAULTS=TOPIC as shown in the sample attribute file. It contains attributes that apply to the publish and subscribe communication model.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

ALLOW‑DURABLE YES | NO O z u w v b

Determines whether a subscriber is allowed to perform a durable subscription to a topic.

YES Subscriber may perform durable subscription.
NO Durable subscription not allowed.

If users are allowed to durably subscribe to any topic, you must specify a value for the SUBSCRIBER-STORE parameter.

ALLOW‑USER‑SUBSCRIBE YES | NO O z u w v b

Determines if it is possible for a user to subscribe to a topic directly (YES) or only by Administrator.

YES Users are allowed to subscribe to the topic.
NO Users must be subscribed by the Administrator through CIS. See Broker Command and Information Services. The subscribe request of users is rejected.

AUTO‑COMMIT‑FOR‑SUBSCRIBER NO | YES O z u w v b
NO No COMMIT performed.
YES An implicit COMMIT is performed by broker when the subscriber receives a publication, that is, the subscriber does not need the CONTROL_PUBLICATION option COMMIT after receiving each publication.
Warning:
You may lose your last message.
CONVERSION Format: A255

( SAGTCHA [TRACE =n] [, OPTION =s] )

O z u w v b

Defines conversion for internationalization. See Internationalization with EntireX. For help on making decisions about the internationalization approach, see What is the Best Internationalization Approach to use?

SAGTCHA Conversion using ICU Conversion for ACI-based Programming. For more information see Conversion Details.

See also Configuring ICU Conversion under z/OS | UNIX | Windows | BS2000/OSD | z/VSE.

NO If conversion is not to be used, either omit the CONVERSION attribute or specify CONVERSION=NO, for example for binary payload.

Only one internationalization approach can be active at one time for a topic. The CONVERSION attribute for internationalization overrides the TRANSLATION attribute when defined for a topic, that is, when TRANSLATION and CONVERSION are both defined, TRANSLATION will be ignored.

TRACE

If tracing is switched on, the trace output is written to the broker log file:

0 No tracing  
1 Trace level STANDARD This level is an "on-error" trace. It provides information on conversion errors only. Please note that if OPTION Values for Conversion are set, errors are ignored.
2 Trace level ADVANCED Tracing of incoming, outgoing parameters and the payload.
3 Trace level SUPPORT This trace level is for support diagnostics and should only be switched on when requested by Software AG support.

OPTION

See OPTION Values for Conversion under Service-specific Attributes above.

LONG‑BUFFER‑LIMIT UNLIM | n O z u w v b

Allocates a number of long message buffers for the topic.

UNLIM The number of long message buffers is restricted only by the number of buffers globally available. Excludes the use of NUM-LONG-BUFFER=AUTO in the Broker section of the attribute file.
n Number of long message buffers.

A value of 0 (zero) is invalid. If NUM-LONG-BUFFER=AUTO is specified in the Broker section of the attribute file, LONG-BUFFER-LIMIT=UNLIM is not allowed in the topic section. A value must be specified or the LONG-BUFFER-LIMIT attribute must be suppressed entirely for the topic so that the default (LONG-BUFFER-DEFAULT) becomes active.

MAX‑MESSAGES‑IN‑PUBLICATION 16 | n O z u w v b

Maximum number of messages in a publication.

MAX‑PUBLICATION‑MESSAGE‑LENGTH 31647 | n O z u w v b

Maximum size of a message in a publication. The actual publication size is transport-dependent.

PUBLICATION‑LIFETIME n | nS | nM | nH | nD | nY O z u w v b

Lifetime of a publication in absolute time units. Publications are retained by broker until they are either received by all subscribers or the publication lifetime has expired.

n Same as nS.
nS Publication lifetime in seconds (max. 2147483647).
nM Publication lifetime in minutes (max. 35791394).
nH Publication lifetime in hours (max. 596523).
nD Publication lifetime in days (max. 24855).
nY Publication lifetime in years (max. 68).

The publication lifetime is calculated even for periods of time when broker is stopped.

PUBLICATION‑LIMIT n | UNLIM O z u w v b

There is no default. Maximum number of publications possible for this topic. If specified, this overrides the publication default value, which is a general maximum value per topic. If neither parameter is specified, the total number of publications for the topic is limited only by NUM-PUBLICATION.

n Number of publications.
UNLIM The number of publications is restricted only by the number of publications globally available. Excludes the use of NUM-PUBLICATION=AUTO in the Broker section of the attribute file.

A value of 0 (zero) is invalid. If PUBLICATION-LIMIT=AUTO is specified in the Broker section of the attribute file, PUBLICATION-LIMIT=UNLIM is not allowed in the topic section. A value must be specified, or the PUBLICATION-LIMIT attribute must be suppressed entirely for the topic so that the default (PUBLICATION-DEFAULT) becomes active.

PUBLISHER‑NONACT 5M | n | nS | nM | nH | nD | nY O z u w v b

Non-activity of the publisher, after which an auto-logoff is performed and the publisher's resources are freed.

n Same as nS.
nS Non-activity time in seconds (max. 2147483647).
nM Non-activity time in minutes (max. 35791394).
nH Non-activity time in hours (max. 596523).
nD Non-activity time in days (max. 24855).
nY Non-activity time in years (max. 68).

If not specified, defaults to 5 minutes. This is the time after which the publisher's internal memory structures will be cleaned up and a subsequent logon is required.

SHORT‑BUFFER‑LIMIT UNLIM | n O z u w v b

Allocates a number of short message buffers for the topic.

UNLIM The number of short message buffers is restricted only by the number of buffers globally available. Excludes the use of NUM-LONG-BUFFER=AUTO in the Broker section of the attribute file.
n Number of short message buffers.

A value of 0 (zero) is invalid. If NUM-SHORT-BUFFER=AUTO is specified in the Broker section of the attribute file, SHORT-BUFFER-LIMIT=UNLIM is not allowed in the topics section. A value must be specified, or the SHORT-BUFFER-LIMIT attribute must be suppressed entirely for the topic so that the default (SHORT-BUFFER-DEFAULT) becomes active.

SSTORE
SSTORE‑TYPE
These parameters are obsolete. The subscriber store in a secondary store is no longer supported. We recommend you use the primary persistent store (PSTORE) to store your subscriber data. For this, set broker-specific parameter SUBSCRIBER-STORE=PSTORE.
SUBSCRIBER‑LIMIT n | UNLIM O z u w v b

There is no default. Maximum number of subscriptions possible for this topic. If specified, this overrides the subscriber default value, which is a general maximum value per topic. If neither parameter is specified, the total number of subscribers for the topic is limited only by NUM-SUBSCRIBER.

n Number of subscribers.
UNLIM The number of subscribers is restricted only by the number of subscribers globally available. Excludes the use of NUM-SUBSCRIBER=AUTO in the Broker section of the attribute file.

A value of 0 (zero) is invalid. If NUM-SUBSCRIBER=AUTO is specified in the Broker section of the attribute file, SUBSCRIBER-LIMIT=UNLIM is not allowed in the topic section. A value must be specified, or the SUBSCRIBER-LIMIT attribute must be suppressed entirely for the topic so that the default (SUBSCRIBER-DEFAULT) becomes active.

SUBSCRIBER‑NONACT 5M | n | nS | nM | nH | nD | nY O z u w v b

Non-activity of the subscriber after which an auto-logoff is performed and the publisher's resources are freed.

n Same as nS.
nS Non-activity time in seconds (max. 2147483647).
nM Non-activity time in minutes (max. 35791394).
nH Non-activity time in hours (max. 596523).
nD Non-activity time in days (max. 24855).
nY Non-activity time in years (max. 68).

In the case of a non-durable subscriber, the user's subscription is also cancelled. In the case of a durable subscriber, the user's subscription is persisted, and it is not necessary for the user to issue any subsequent SUBSCRIBE commands. The subscription of a durable subscriber is also persisted even while broker is stopped.

If not specified, defaults to 5 minutes. This is the time after which the subscriber's internal memory structures will be cleaned up and a subsequent logon is required.

SUBSCRIPTION‑EXPIRATION NEVER | n | nS | nM | nH | nD | nY O z u w v b

Lifetime of a user's subscription in absolute time units. Subscriptions are retained by broker until either the user issues an UNSUBSCRIBE command or the subscription lifetime has expired.

NEVER Subscriber will never be purged from PSTORE.
n Same as nS.
nS Expiration time in seconds (max. 2147483647).
nM Expiration time in minutes (max. 35791394).
nH Expiration time in hours (max. 596523).
nD Expiration time in days (max. 24855).
nY Expiration time in years (max. 68).

Durable subscriptions remain effective even if the user performs the LOGOFF command or broker is stopped. The subscription lifetime is calculated also for periods of time when broker is stopped.

SUBSCRIPTION-EXPIRATION is the time after which the subscription expires. In the case of durable subscription, the subscription is removed from the PSTORE. Broker removes expired subscriptions only when the user is not currently active, for example when the user has issued a LOGOFF command or after the SUBSCRIBER-NONACT has passed if no LOGOFF is issued.

If SUBSCRIBER-NONACT is specified greater than SUBSCRIPTION-EXPIRATION, broker adjusts SUBSCRIPTION-EXPIRATION to the value of SUBSCRIBER-NONACT.

TOPIC A96 (case-sensitive) R z u w v b

Name of the topic for publish and subscribe processing. Valid characters for topic name are letters a-z, A-Z, numbers 0-9, hyphen and underscore. Do not use dollar, percent, period or comma.

TRANSLATION Format: A255

SAGTCHA | NO | <name>

O z u w v b

Activates translation or translation user exit for internationalization (see Translation User Exit). See also What is the Best Internationalization Approach to use?

SAGTCHA Conversion routine SAGTCHA for ACI-based programming, RPC-based components and for Reliable RPC.
NO If translation is not to be used, e.g. for binary payload (broker messages), either omit the TRANSLATION attribute or specify TRANSLATION=NO.
<name> Name of Translation User Exit. See also Configuring SAGTRPC User Exits under z/OS | UNIX | Windows and Writing SAGTRPC User Exits under z/OS | UNIX | Windows.

The CONVERSION attribute for internationalization overrides the TRANSLATION attribute when defined for a service, i.e. when TRANSLATION and CONVERSION are both defined, TRANSLATION will be ignored.

Top of page

Codepage-specific Attributes

The codepage-specific attribute section begins with the keyword DEFAULTS=CODEPAGE as shown in the sample attribute file. You can use the attributes in this section to customize the broker's locale string defaults and customize the mapping of locale strings to codepages for the internationalization approaches ICU conversion and SAGTRPC user exit. These attributes do not apply to other approaches. See Internationalization with EntireX for more information.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

DEFAULT_ASCII Any ICU converter name or alias. See also Additional Notes below. O z u w v b

Customize the broker's locale string defaults by assigning the default codepage for EntireX components (client or server, publisher or subscriber). See Broker's Locale String Defaults. This value is used instead of the broker's locale string defaults if

  • the calling component does not send a locale string itself, and

  • the calling component is running on an ASCII platform (UNIX, Windows, etc.), and

  • one of the internationalization approaches ICU conversion or SAGTRPC user exit is used. See ICU Conversion and SAGTRPC User Exit.

Example:

DEFAULTS=CODEPAGE 
    /* Broker Locale String Defaults */ 
    DEFAULT_ASCII=windows-950

For more examples, see Configuring Broker's Locale String Defaults and also Additional Notes below.

DEFAULT_EBCDIC_IBM Any ICU converter name or alias O z u w v b

Customize the broker's locale string defaults by assigning the default codepage for EntireX components (client or server, publisher or subscriber). See Broker's Locale String Defaults. This value is used instead of the broker's locale string defaults if

  • the calling component does not send a locale string itself and

  • the calling component is running on an IBM mainframe platform (z/OS, z/VSE etc.) and

  • one of the internationalization approaches ICU conversion or SAGTRPC user exit is used.

Example:

DEFAULT=CODEPAGE
    DEFAULT_EBCDIC_IBM=ibm-937

For more examples, see Configuring Broker's Locale String Defaults and also Additional Notes below.

DEFAULT_EBCDIC_SNI Any ICU converter name or alias O z u w v b

Customize the broker's locale string defaults by assigning the default codepage for EntireX components (client or server, publisher or subscriber). See Broker's Locale String Defaults. This value is used instead of the locale string defaults if

  • the calling component does not send a locale string itself, and

  • the calling component is running on a Fujitsu EBCDIC mainframe platform (BS2000/OSD), and

  • one of the internationalization approaches ICU conversion or SAGTRPC user exit is used.

Example:

DEFAULT=CODEPAGE
    DEFAULT_EBCDIC_SNI= bs2000-edf03drv

For more examples, see Configuring Broker's Locale String Defaults and also Additional Notes below.

locale‑string Any ICU converter name or alias. See also Additional Notes below. O z u w v  

Customize the mapping of locale strings to codepages and bypass the broker's locale string processing mechanism. See Broker's Locale String Processing. This is useful:

  • if the broker's locale string processing fails - i.e. leads to no codepage or to the wrong codepage - you can explicitly assign the codepage which meets your requirements.

  • if you want to install user-written ICU converters (codepages) into the broker, see Building and Installing ICU Custom Converters under UNIX | Windows.

The attribute (locale string) is the locale string sent by your EntireX component (client or server, publisher or subscriber) and the value is the codepage that you want to use in place of that locale string. In the first line of the example below, the client or server application sends ASCII as a locale string; the broker maps this to the codepage ISO 8859_1. In the same way EUC_JP_LINUX is mapped to ibm-33722_P12A-1999. All other locale strings are mapped by the broker's mapping mechanism, see Broker's Built-in Locale String Mapping. Example:

DEFAULTS=CODEPAGE 
    /* Broker Locale String Codepage Assignments */ 
    ASCII=ISO8859 
    EUC_JP_LINUX=ibm-33722_P12A-1999
    /* Customer-written ICU converters */
    CP1140=myebcdic
    CP0819=myascii

For more examples, see Bypassing Broker's Built-in Locale String Mapping and also Additional Notes below.

Additional Notes

Top of page

Adabas SVC/Entire Net-Work-specific Attributes

The Adabas SVC/Entire Net-Work-specific attribute section begins with the keyword DEFAULTS=NET as shown in the sample attribute file. The attributes in this section are needed to execute the Adabas SVC/Entire Net-Work communicator of the EntireX Broker kernel.

Note:
This section applies to mainframe platforms only. It does not apply to UNIX and Windows.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

ADASVC nnn R z     v  

Sets the Adabas SVC number for EntireX Broker access.

The Adabas SVC is used to perform various internal functions, including communication between the caller program and EntireX Broker.

Not supported on BS2000/OSD.

EXTENDED‑ACB‑SUPPORT NO | YES O z     v b

Determines whether extended features of Adabas version 8 (or above) are supported.

NO No features of Adabas version 8 or above will be used.
YES Informs broker kernel to provide Adabas/WAL version 8 transport capability. This parameter is required for sending/receiving more than 32 KB data over Adabas [NET] transport. This value should be set only if you have installed Adabas/WAL version 8, Adabas SVC, and included Adabas/WAL version 8 load libraries into the steplib of broker kernel; otherwise, unpredictable results can occur.
FORCE NO | YES O z     v b

Determines whether DBID table entries can be overwritten.

NO Overwrite of DBID table entries not permitted.
YES Overwrite of DBID table entries permitted. This is required when the DBID table entry is not deleted after abnormal termination.

Caution:
Overwriting an existing entry prevents any further communication with the overwritten node. Use FORCE=YES only if you are absolutely sure that no target node with that DBID is active.

IDTNAME FORMAT: A8 idtname | ADABAS5B O         b
If an ID table name is specified with the appropriate ADARUN parameter for Entire Net-Work, Adabas or Natural, the same name must be specified here. The ID table is used to perform various internal functions, including communication between the caller program and the EntireX Broker. Only supported under BS2000/OSD.
IUBL 8000 | n O z     v b

This parameter sets the maximum length (in bytes) of the buffer that can be passed from the caller to EntireX Broker. The maximum size of IUBL is the same as the maximum value of the Adabas parameter LU (see the Adabas Operations Manual).

IUBL must be large enough to hold the maximum send-length plus receive-length required for any caller program plus any administrative overhead for Adabas and Entire Net-Work control structures.

LOCAL NO | YES O z     v b

Specifies whether the broker ID is local.

NO Broker ID can be accessed from remote nodes.
YES The broker ID is local. It is not accessible from remote nodes.
MAX‑MESSAGE‑LENGTH 2147483647 | n O z u w v b
Maximum message size that the broker kernel can process using transport method NET. The default value represents the highest positive number that can be stored in a four-byte integer.
NABS 10 | n O z     v b

The number of attached buffers to be used (max. 524287).

An attached buffer is an internal buffer used for interprocess communication. An attached buffer pool equal to the NABS value multiplied by 4096 will be allocated. This buffer pool must be large enough to hold all data (IUBL) of all parallel calls to EntireX Broker.

The following formula can be used to calculate the value for NABS:
NABS = NCQE *IUBL / 4096.

NCQE 10 | n O z     v b
NCQE defines the number of command queue elements which are available for processing commands arriving at the broker kernel over Adabas SVC / Net-Work transport mechanism. Sufficient NCQE should be allocated to allow this transport mechanism to process multiple broker commands concurrently. Each command queue element requires 192 bytes, and the element is released when either the user (client or server) has received the results of the command, or if the command is timed out.

The number of command queue elements required to handle broker calls depends on the number of parallel active broker calls that are using the transport mechanism Adabas SVC / Entire Net-Work. For example, all broker commands issued by any of the following application components using this transport mechanism:

  • clients

  • servers

  • publishers

  • subscribers

NODE 1-65534 R z     v b

Defines the unique DBID for EntireX Broker.

Used for internode Adabas/Entire Net-Work communication. There is no default; the value of NODE must be a value greater than or equal to 1 or less than or equal to 65534. If you set the parameter LOCAL=YES, you can use the same node number for different installations of EntireX Broker in an Entire Net-Work environment.

TIME 30 | n O z     v b

This parameter sets the timeout value for broker calls in seconds. The results of a broker call must be received by the caller within this time limit.

TRACE‑LEVEL 0 - 4 O z     v b

The level of tracing to be performed while the broker is running with transport method NET. It overrides the global value of trace level for all NET routines.

0 No tracing. Default value.
1 Display invalid Adabas commands.
2 All of trace level 1, plus errors if request entries could not be allocated.
3 All of trace level 2, plus all routines executed.
4 All of trace level 3, plus function arguments and return values.

If you modify the TRACE-LEVEL attribute, you must restart the broker for the change to take effect. For temporary changes to TRACE-LEVEL without restarting the broker, use System Management Hub or ETBCMD.

Trace levels 2, 3, and 4 should be used only when requested by Software AG support.

Top of page

Security-specific Attributes

The security-specific attribute section begins with the keyword DEFAULTS=SECURITY as shown in the sample attribute file. This section applies only if broker-specific attribute SECURITY=YES is specified.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

ACCESS‑SECURITY‑SERVER NO | YES O         b

Determines where authentication is checked.

NO Authentication is checked in the broker tasks. This requires broker to be running under TSOS in order to execute privileged security checks.
YES Authentication is checked in the EntireX Broker Security Server for BS2000/OSD. This does not require broker to be running under TSOS. See EntireX Broker Security Server for BS2000/OSD.
APPLICATION‑NAME A8 O z        

Specifies the name of the application to be checked if FACILITY-CHECK=YES is defined. In RACF, for example, an application "BROKER" with read permission for user "DOE" is defined with following commands:

  RDEFINE APPL BROKER UACC(NONE)
  PERMIT BROKER CLASS(APPL) ID(DOE) ACCESS(READ)
  SETROPTS CLASSACT(APPL)

See attribute FACILITY-CHECK for more information.

AUTHENTICATION‑TYPE OS | ldapUrl O z u w   b
OS Authentication is performed against the local operating system. Default if SECURITY=YES is specified and section DEFAULTS=SECURITY is omitted from the attribute file.
ldapUrl Authentication is performed against the LDAP repository specified under ldapUrl. Not supported under BS2000/OSD.
  • TCP
    Specify repository URL:
    AUTHENTICATION-TYPE="ldap://HostName[:PortNumber]"

  • SSL/TLS
    Specify repository URL with ldaps:
    AUTHENTICATION-TYPE="ldaps://HostName[:PortNumber]"

If no port number is specified, the default is the standard LDAP port number 389 for TCP transport. Examples for TCP and SSL/TLS:
AUTHENTICATION-TYPE="ldap://myhost.mydomain.com"
AUTHENTICATION-TYPE="ldaps://myhost.mydomain.com:636"

AUTHORIZATIONDEFAULT YES | NO O   u w    

Determines whether access is granted to a specified service if the specified could not be found listed in the repository of authorization rules.

YES Grant access.
NO Deny access.

Applies only when using EntireX Security under UNIX and Windows. Authorization rules can be stored within a repository. When an authorization call occurs, EntireX Security uses the values of this parameter and AUTHORIZATIONDEFAULT to perform an access check for a particular broker instance against an (authenticated) user ID and list of rules.

See also Administering Authorization Rules using System Management Hub under UNIX | Windows.

AUTHORIZATIONRULE A32 O   u w    

List of authorization rules. Multiple sets of rules can be defined, each set is limited to 32 chars. The maximum number of AUTHORIZATIONRULE entries in the attribute file is 16.

Applies only when using EntireX Security under UNIX or Windows. Authorization rules can be stored within a repository. When an authorization call occurs, EntireX Security uses the values of this parameter and AUTHORIZATIONDEFAULT to perform an access check for a particular broker instance against an (authenticated) user ID and list of rules.

See also Administering Authorization Rules using System Management Hub under UNIX | Windows.

CHECK‑IP‑ADDRESS YES | NO O z        

Determines whether the TCP/IP address of the caller is subject to a resource check.

ERRTXT‑MODULE NA2MSG0 | NA2MSG1 | NA2MSG2 | ModuleName O z        

Specifies the name of the security error text module. Default is "NA2MSG0", English messages. For instructions on how to customize messages, see Build Language-specific Messages (Optional) under Installing EntireX Security under z/OS.

FACILITY‑CHECK NO | YES O z        

It is possible to check whether a particular user is at all allowed to use an application before performing a password check. The advantage of this additional check is that when the user is not allowed to use this application, the broker returns error 00080013 and does not try to authenticate the user. Failing an authentication check may lead to the user's password being revoked; this situation is avoided if the facility check is performed first. See attribute APPLICATION-NAME for further details.

Note:
This facility check is an additional call to the security subsystem and is executed before each authentication call.

IGNORE‑STOKEN NO | YES O z u w   b

Determines whether the value of the ACI field SECURITY-TOKEN is verified on each call.

INCLUDE‑CLASS YES | NO O z        

Determines whether the class name is included in the resource check.

INCLUDE‑NAME YES | NO O z        

Determines whether the server name is included in the resource check.

INCLUDE‑SERVICE YES | NO O z        

Determines whether the service name is included in the resource check.

LDAP‑PERSON‑BASE‑BINDDN ldapDn O z u w    

Used with LDAP authentication to specify the distinguished name where authentication information is stored. This value is prefixed with the user ID field name (see below). Example:

LDAP-PERSON-BASE-BINDDN="cn=users,dc=mydomain,dc=com"

LDAP‑REPOSITORY‑TYPE OpenLDAP | ActiveDirectory | SunOneDirectory | Tivoli | Novell | ApacheDS O z u w    
Use predefined known fields for the respective repository type. Specify the repository type that most closely matches your actual repository. In the case of Windows Active Directory, the user ID is typically in the form domainName\userId.
LDAP‑SASL‑AUTHENTICATION NO | YES O     w    

Specifies whether or not Simple Authentication and Security Layer (SASL) is to perform the authentication check. In practice, this determines whether or not the password supplied by the user is passed in plain text between the broker kernel and the LDAP server. If SASL is activated, this implies that the password is encrypted.

NO Password is sent to LDAP server in plain text.
YES Password is sent to LDAP server encrypted.
LDAP‑USERID‑FIELD cn | uidFieldName O z u w    

Used with LDAP authentication to specify the first field name of a user in the Distinguished Name, for example:

LDAP-USERID-FIELD=uid

MAX‑SAF‑PROF‑LENGTH 1-256 O z        

This parameter should be increased if the length of the resource checks - that is, the length of the profile comprising "<class>.<server>.<service>" - is greater than 80 bytes.

This parameter defaults to 80 if a value is not specified.

PASSWORD‑TO‑UPPER‑CASE NO | YES O z     v  

Determines whether the password and new password are converted to uppercase before verification.

PRODUCT RACF | ACF2 | TOP-SECRET O z        

Specifies the name of the installed security product. This attribute is used to analyze security-system-specific errors. The following systems are currently supported:

ACF2 Security system ACF2 is installed.
RACF Security system RACF is installed. Default.
TOP-SECRET Security system TOP-SECRET is installed.

The default value is used if an incorrect or no value is specified.

PROPAGATE‑TRUSTED‑USERID YES | NO O z        

Determines whether a client user ID obtained by means of the trusted user ID mechanism is propagated to a server using the ACI field CLIENT-USERID.

SAF‑CLASS NBKSAG | SAFClassName O z        

Specifies the name of the SAF class/type used to hold the EntireX-related resource profiles.

SAF‑CLASS‑IP NBKSAG | SAFClassName O z        

Specifies the name of the SAF class/type used when performing IP address authorization checks.

SECURITY‑LEVEL AUTHORIZATION | AUTHENTICATION | ENCRYPTION O z u w v b

Specifies the mode of operation.

AUTHORIZATION Authorization, authentication, and encryption (not under BS2000/OSD or z/VSE).
AUTHENTICATION Authentication and encryption.
ENCRYPTION Encryption only.

Caution:
In version 8.0, the default value for this parameter was "AUTHORIZATION".

SECURITY‑NODE YES | name O z        

This parameter can be used to specify a prefix that is added to all authorization checks, enabling different broker kernels, in different environments, to perform separate authorization checks according to each broker kernel. For example, it is often important to distinguish between production, test, and development environments.

YES This causes the broker ID to be used as a prefix for all authorization checks.
name This causes the actual text (maximum 8 characters) to be prefixed onto all authorization checks.

Note:
By not setting this parameter, no prefix is added to the resource check (the default behavior).

TRACE‑LEVEL 0 - 4 O z u w v b

Trace level for EntireX Security. It overrides the global value of trace level in the attribute file.

TRUSTED‑USERID YES | NO O z        

Activates the trusted user ID mechanism for broker requests arriving over the local Adabas IPC mechanism.

USERID‑TO‑UPPER‑CASE NO | YES O z     v  

Determines whether user ID is converted to uppercase before verification.

UNIVERSAL NO | YES O z        

Determines whether access to undefined resource profiles is allowed.

WARN‑MODE NO | YES O z u w   b

Determines whether a resource check failure results in just a warning or an error.

Top of page

TCP/IP-specific Attributes

The TCP/IP-specific attribute section begins with the keyword DEFAULTS=TCP as shown in the sample attribute file. It contains attributes that apply to the TCP/IP transport communicator. The transport is activated by TRANSPORT=TCP in the Broker-specific section of the attribute file. A maximum of five TCP/IP communicators can be activated by specifying up to five HOST/PORT pairs.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

CONNECTION‑NONACT n | nS | nM | nH O z u w v b

Non-activity of the TCP/IP connection, after which a close is performed and the connection resources are freed. If this parameter is not specified here, broker will close the connection only when the application (or the network itself) terminates the connection.

n Same as nS.
nS Non-activity time in seconds (min. 600, max. 2147483647).
nM Non-activity time in minutes (min. 10, max. 35791394).
nH Non-activity time in hours (max. 596523).

If not specified, the connection non-activity test is disabled. On the stub side, non-activity can be set with the environment variable ETB_NONACT. See Limiting the TCP/IP Connection Lifetime under z/OS | UNIX | Windows | z/VSE.

HOST 0.0.0.0 | HostName | IP address O z u w v b

The address of the network interface on which broker will listen for connection requests.

If HOST is not specified, broker will listen on any attached interface adapter of the system (or stack).

A maximum of five HOST/PORT pairs can be specified to start multiple instances of broker's TCP/IP transport communicator.

MAX‑MESSAGE‑LENGTH 2147483647 | n O z u w v b
Maximum message size that the broker kernel can process using transport method TCP/IP. The default value represents the highest positive number that can be stored in a four-byte integer.
PORT 1025 - 65535 O z u w v b

The TCP/IP port number on which the broker will listen for connection requests.

If specified, PORT overrides broker attribute TCPPORT.

Note:
TCPPORT will be retired with the next version.

If PORT is not specified but TCPPORT is specified, TCPPORT is used.

If TCPPORT is not specified, the broker will attempt to find its TCP/IP port number from the TCP/IP Services file, using getservbyname. If broker cannot find its TCP/IP port number from the TCP/IP Services file, it will use the default value of 1971.

A maximum of five HOST/PORT pairs can be specified to start multiple instances of broker's TCP/IP transport communicator.

RESTART YES | NO O z u w v b
YES The broker kernel will attempt to restart the TCP/IP communicator.
NO The broker kernel will not try to restart the TCP/IP communicator.

If specified, RESTART overrides broker attribute TCP-RESTART.

Note:
TCP-RESTART will be retired with the next version.

If RESTART is not specified but TCP-RESTART is specified, TCP-RESTART is used.

The RESTART setting applies to all TCP/IP communicators.

RETRY‑LIMIT 20 | n | UNLIM O z u w v b

Maximum number of attempts to restart the TCP/IP communicator.

If specified, RETRY-LIMIT overrides broker attribute TCP-RETRY-LIMIT.

Note:
TCP-RETRY-LIMIT will be retired with the next version.

If RETRY-LIMIT is not specified but TCP-RETRY-LIMIT is specified, TCP-RETRY-LIMIT is used.

The RETRY-LIMIT setting applies to all TCP/IP communicators.

RETRY‑TIME 3M | n | nS | nM | nH O z u w v b

Wait time between stopping the TCP/IP communicator due to an unrecoverable error and the next attempt to restart it.

n Same as n S.
n S Wait time in seconds (max. 2147483647).
n M Wait time in minutes (max. 35791394).
n H Wait time in hours (max. 596523).

Minimum wait time is 1S.

If specified, RETRY-TIME overrides broker attribute TCP-RETRY-TIME.

Note:
TCP-RETRY-TIME will be retired with the next version.

If RETRY-TIME is not specified but TCP-RETRY-TIME is specified, TCP-RETRY-TIME is used.

The RETRY-TIME setting applies to all TCP/IP communicators.

REUSE‑ADDRESS YES | NO O z u   v b
YES | NO O     w    
YES The TCP port assigned to the broker can be taken over and assigned to other applications (this is the default value on all non-Windows platforms).
NO The TCP port assigned to the broker cannot be taken over and assigned to other applications. This is the default setting on Windows, and we strongly advise you do not change this value on this platform.
Note:
This setting might be required at your site when restarting broker immediately after stopping it. This is due to the inherent latency of the TCP/IP stack when closing connections.
STACK‑NAME StackName O z        

Name of the TCP/IP stack that the broker is using.

If not specified, broker will connect to the default TCP/IP stack running on the machine.

TRACE‑LEVEL 0 - 4 O z u w v b

The level of tracing to be performed while the broker is running with transport method TCP/IP. It overrides the global value of trace level for all TCP/IP routines.

0 No tracing. Default value.
1 Display IP address of incoming request, display error number of outgoing error responses.
2 All of trace level 1, plus errors if request entries could not be allocated.
3 All of trace level 2, plus all routines executed.
4 All of trace level 3, plus function arguments and return values.

If you modify the TRACE-LEVEL attribute, you must restart the broker for the change to take effect. For temporary changes to TRACE-LEVEL without restarting the broker, use System Management Hub or ETBCMD.

Trace levels 2, 3, and 4 should be used only when requested by Software AG support.

Top of page

c-tree-specific Attributes

The c-tree-specific attribute section begins with the keyword DEFAULTS = CTREE. The attributes in this section are optional. This section applies only if PSTORE-TYPE = CTREE is specified.

Not available under z/OS, BS2000/OSD, z/VSE.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

MAXSIZE n | nM | nG O   u w    

Defines the maximum size of c-tree data files. Broker allocates one data file for control data and another data file for message data:

n Maximum size in MB.
nM Maximum size in MB.
nG Maximum size in GB.
PAGESIZE n | nK O   u w    

Determines how many bytes are available in each c-tree node. PSTORE COLD start is required after changing this value.

n Same as nK
nK PAGESIZE in KB.

The default and minimum value is 8 KB.

If PSD Reason Code = 527 is returned during UOW write processing, increase the PAGESIZE value and restart broker with PSTORE=COLD, or migrate the existing PSTORE to a new PSTORE with an increased PAGESIZE value. See Migrating the Persistent Store and define the increased PAGESIZE value for the load broker.

PATH  A255 O   u w    

Path name of the target directory for c-tree index and data files.

SYNCIO NO | YES O   u w    

Controls the open mode of the c-tree transaction log.

NO c-tree transaction log is not opened in synchronous mode. Default.
YES c-tree transaction log is opened in synchronous mode to improve data security. It may degrade performance of PSTORE operations, but offers the highest level of data security. See c-tree Database as Persistent Store under UNIX | Windows.
TRACE‑LEVEL 0-8 O   u w    

Trace level for c-tree persistent store. It overrides the global value of trace level in the attribute file.

Top of page

SSL-specific Attributes

The SSL-specific attribute section begins with the keyword DEFAULTS=SSL as shown in the sample attribute file. The attributes in this section are needed to execute the SSL communicator of the EntireX Broker kernel. In this section, "SSL" also applies to TLS (Transport Layer Security).

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

CIPHER‑SUITE string O z u w   b

String that is passed to the underlying SSL/TLS implementation. SSL/TLS is a standardized protocol that uses different cryptographic functions (hash functions, symmetric and asymmetric encryption etc.). Some of these must be implemented in the SSL/TLS stack; others are optional. When an SSL/TLS connection is created, both parties agree by "handshake" on the cipher suite, that is, the algorithms and key lengths used. In a default scenario, this information depends on what both sides are capable of. It can be influenced by setting the attribute CIPHER-SUITE for the SSL/TLS server side (the broker always implements the server side). Thus stubs connect to the broker and thereby become the SSL/TLS clients.

Under UNIX, Windows and BS2000/OSD, the OpenSSL implementation is used; under z/OS it is GSK.

The SSL protocol is obsolete and should no longer be used for secure operations. The TLS protocol is the successor of SSL and is readily available in OpenSSL and GSK. The following examples show how to configure strong encryption:

  • OpenSSL
    This example uses FIPS-approved algorithms, but without ADH, MD5 or other low or export-grade implementations.
    It requires authentication and encryption, that is, do not use NULL ciphers:

    CIPHER-SUITE=FIPS:!ADH:!LOW:!EXP:!MD5:!aNULL:!eNULL:@STRENGTH

    Default configuration:

    CIPHER-SUITE=TLSv1:!ADH:!LOW:!EXP:!MD5:@STRENGTH

    See http://www.openssl.org/docs/apps/ciphers.html

  • GSK
    Default configuration:

    CIPHER-SUITE=35363738392F303132330A1613100D

    This list of cipher suites starts with a strong '256-bit AES encryption with SHA-1 message authentication and RSA key exchange' (35) and ends with a relatively weak '168-bit Triple DES encryption with SHA-1 message authentication and fixed Diffie-Hellman key exchange signed with a DSA certificate' (0D).

    See IBM documentation: z/OS V2R1.0 System SSL Programming, SC14-7495-00, Appendix C: Cipher Suite Definitions.

CONNECTION‑NONACT n | nS | nM | nH O z u w   b

Non-activity of the SSL connection, after which a close is performed and the connection resources are freed. If this parameter is not specified here, broker will close the connection only when the application (or the network itself) terminates the connection.

n Same as nS.
nS Non-activity time in seconds (min. 600, max. 2147483647).
nM Non-activity time in minutes (min. 10, max. 35791394).
nH Non-activity time in hours (max. 596523).

If not specified, the connection non-activity test is disabled.

HOST hostname O z u w   b

The address of the network interface on which broker will listen for connection requests.

If HOST is not specified, broker will listen on any attached interface adapter of the system (or stack).

A maximum of five HOST/PORT pairs can be specified to start multiple instances of EntireX Broker's TCP/IP transport communicator.

KEY‑LABEL name O z        

The label of the key in the RACF keyring that is used to authenticate the broker kernel (see also TRUST-STORE parameter).

(Example: "ETBCERT")

KEY‑FILE file name R   u w   b

File that contains the broker's private key (if not contained in KEY-STORE).

(Example: MyAppKey.pem)

Note:
EntireX Broker supports only key files of type .pem. Files of type .jks are not supported.

KEY‑PASSWD password (A32) R   u w   b

Password used to protect the private key. Unlocks MyAppKey.pem. Deprecated. See KEY-PASSWD-ENCRYTPED below.

KEY‑PASSWD‑ENCRYPTED encrypted value (A64) R   u w   b

Password used to protect the private key. Unlocks MyAppKey.pem. This attribute replaces KEY-PASSWD to avoid a clear-text password as attribute value. If KEY-PASSWD and KEY-PASSWD-ENCRYTPED are both supplied, KEY-PASSWD-ENCRYTPED takes precedence.

KEY‑STORE file name R   u w   b

SSL certificate; may contain the private key.

(Example: ExxAppCert.pem)

Note:
EntireX Broker supports only keystores of type .pem. Files of type .jks are not supported.

MAX‑MESSAGE‑LENGTH 2147483647 | n O z u w   b
Maximum message size that the broker kernel can process using transport method SSL. The default value represents the highest positive number that can be stored in a four-byte integer.
PORT 1025 - 65535 O z u w   b

The SSL port number on which the broker will listen for connection requests. If not changed, this parameter takes the standard value as specified in the example attribute file.

If the port number is not specified, the broker will use the default value of 1958.

RESTART YES | NO O z u w   b
YES The broker kernel will attempt to restart the SSL communicator (this is the default value).
NO The broker kernel will not attempt to restart the SSL communicator.
RETRY‑LIMIT 20 | n | UNLIM O z u w   b

Maximum number of attempts to restart the SSL communicator.

RETRY‑TIME 3M | n | nS | nH O z u w   b

Wait time between suspending SSL communication due to unrecoverable error and the next attempt to restart it.

n Same as nS.
nS Wait time in seconds (max.2147483647).
nM Wait time in minutes (max. 35791394).
nH Wait time in hours (max. 596523).

Minimum: 1S

REUSE‑ADDRESS YES | NO O z u w   b
YES The SSL port assigned to the broker can be taken over and assigned to other applications (this is the default value).
NO The SSL port assigned to the broker cannot be taken over and assigned to other applications.
Note:
This setting might be required at your site when restarting broker immediately after stopping it. This is due to the inherent latency of the TCP/IP stack when closing connections.
STACK‑NAME name O z u w    

Name of the TCP/IP stack that the broker is using.

If not specified, broker will connect to the default TCP/IP stack running on the machine.

TRACE‑LEVEL 0 - 4 O z u w   b

The level of tracing to be performed while the broker is running with transport method SSL/TLS. It overrides the global value of trace level for all SSL/TLS routines.

0 No tracing. Default value.
1 Display IP address of incoming request, display error number of outgoing error responses.
2 All of trace level 1, plus errors if request entries could not be allocated.
3 All of trace level 2, plus all routines executed.
4 All of trace level 3, plus function arguments and return values.

If you modify the TRACE-LEVEL attribute, you must restart the broker for the change to take effect. For temporary changes to TRACE-LEVEL without restarting the broker, use System Management Hub or ETBCMD.

Trace levels 2, 3, and 4 should be used only when requested by Software AG support.

TRUST‑STORE file name|keyring R z u w   b

Location of the store containing certificates of trust Certificate Authorities (or CAs).

z/OS Specify the RACF keyring using the following format: [USER-ID/]RING-NAME. If no value for USER-ID is provided, the keyring is assumed to be associated with the user ID that the broker kernel is running under.
BS2000/OSD/Windows/UNIX Specify the file name of the CA certificate store. Examples: EXXCACERT.PEM, C:\Certs\ExxCACert.pem
VERIFY‑CLIENT NO | YES O z u w   b
YES Additional client certificate required.
NO No client certificate required (default).

Top of page

DIV-specific Attributes

The DIV-specific attribute section begins with the keyword DEFAULTS = DIV. The attributes in this section are required if PSTORE-TYPE = DIV is specified.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

DIV A511 R z        

The VSAM Persistent Store parameters, enclosed in double quotes (""). The value can span more than one line. See Format Parameters for details of the parameters. In previous versions of EntireX, these parameters were read from the SYSIN DD during broker kernel startup.

Top of page

Adabas-specific Attributes

The Adabas-specific attribute section begins with the keyword DEFAULTS = ADABAS. The attributes in this section are required if PSTORE-TYPE = ADABAS is specified. In previous versions of EntireX, these Adabas-specific attributes and values were specified in the broker-specific PSTORE-TYPE attribute.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

BLKSIZE 126-20000 O z u w v b

Optional blocking factor used for message data. If not specified, broker will split the message data into 2 KB blocks to be stored in Adabas records. The maximum value depends on the physical device assigned to data storage. See the Adabas documentation.

For reasons of efficiency, do not specify a BLKSIZE much larger than the actual total size of the UOW data to be written. The total UOW size is the sum of all messages in the UOW plus 41 bytes of header information. This takes effect only after COLD start.

The BLKSIZE parameter applies only for a cold start of broker; subsequently the value of BLKSIZE is taken from the last cold start.

Default value is 2000.

DBID 1 - 32535 R z u w v b

Database ID of Adabas database where the persistent store resides.

FNR 1 - 32535 R z u w v b

File number of broker persistent store file.

FORCE‑COLD N | Y O z u w v b

Determines whether a broker cold start is permitted to overwrite a persistent store file that has been used by another broker ID and/or platform.

Specify Y to allow existing information to be overwritten.

MAXSCAN 0-n O z u w v b

Limits display of persistent UOW information in the persistent store through Command and Information Services.

Default value is 1000.

OPENRQ N | Y O z u w v b

Determines whether driver for Adabas persistent store is to issue an OPEN command to Adabas.

SVC 200-255 R z     v  

Use this parameter to specify the Adabas SVC number to be used by the Adabas persistent store driver.

TRACE‑LEVEL 0-8 O z u w v b

Trace level for Adabas persistent store. It overrides the global value of trace level in the attribute file.

Top of page

Application Monitoring-specific Attributes

The application monitoring-specific attribute section begins with the keyword DEFAULTS=APPLICATION-MONITORING. It contains attributes that apply to the application monitoring functionality. At startup time, the attributes are read if the Broker-specific attribute APPLICATION-MONITORING=YES is specified. Duplicate or missing values are treated as errors. When an error occurs, application monitoring is turned off and EntireX Broker continues execution. See Application Monitoring.

Attribute Values Opt/
Req
Operating System

graphics/zos.gif

graphics/unix.gif

graphics/windows.gif

graphics/vse.gif

graphics/bs2.gif

APPLICATION‑MONITORING‑NAME or
APPMON-NAME
A100 O z u w v  
Specifies a default application monitoring name. Used to set the value of the ApplicationName KPI.
COLLECTOR‑BROKER‑ID A64 R z u w v  
Identifies the Application Monitoring Data Collector. Has the format host_name:port_number, where host_name is the host where the Application Monitoring Data Collector is running and port_number is the port number of the Application Monitoring Data Collector. The default port is 57900.
TRACE‑LEVEL 0 - 3 O z u w v  
The level of tracing to be performed while the Broker is running with application monitoring.
0 No tracing. Default value.
1 Display application monitoring errors.
2 All of trace level 1, plus measuring points for application monitoring.
3 All of trace level 2, plus application monitoring buffers.

A trace level should be used only when requested by Software AG support.

Top of page

Variable Definition File

The broker attribute file contains the configuration of one EntireX Broker instance. In order to share attribute files between different brokers, you identify the attributes that are unique and move them to a variable definition file. This file enables you to share one attribute file among different brokers. Each broker in such a scenario requires its own variable definition file.

The following attributes are considered unique for each machine:

How you use the variable definition file will depend upon your particular needs. For instance, some optional attributes may require uniqueness - for example, DBID and FNR in DEFAULTS=ADABAS - so that you may specify the persistent store.

Top of page