ESB Interface Parameters

You must configure the member that specifies the parameters for the ESB interface or Substation ES ESB. These templates are stored in the SXSIEMS1 or SXSIRV1 files.

If you make a copy of this member, you can point to it by specifying the member name on the INTF-MEMBER keyword in the main SIP definition member.

The following table lists the ESB member parameters:

ESB Member Parameters
Parameter Description
DESCR = {description} See DESCR = {description}.
INTF-ID = {name} See INTF-ID = {name}.

INTF-TYPE = {number}

See INTF-TYPE = {number}.
MODULE-NAME = {TIBSSXFR/E | name} The MODULE-NAME parameter specifies the name of the ESB interface load module. R stands for Rendezvous; E, for EMS.
RECIPE-GROUP = {group name} Optional.

The RECIPE-GROUP parameter specifies a name that must be defined in the Substation ES data configuration file as a group.

This parameter is useful for the following scenarios:
  • You share the configuration file among many implementations of Substation ES and must group the recipe and trigger services that belong to a certain Substation ES implementation. Only recipe and trigger services that belong to the specified group are activated during Substation ES startup.
  • You have a mixture of recipe and trigger services in the file for QA and development or you must group recipe and trigger services for different projects within an environment. Group parameters enable different projects to share the same file and its definitions, but the projects do not affect each other if they use separate instances of Substation ES.
SERVICE-SUSPEND = {Y | Yes, No} The SERVICE-SUSPEND parameter, which is a keyword for the EMS ESB endpoint, determines whether this ESB interface turns on the suspended function or not.

When SERVICE-SUSPEND is enabled and the BES is not available, the ESB interface automatically suspends all recipe services connected to the BES interface. When the BES becomes available, all suspended recipe services are resumed automatically.

The default value is Y.

START-YN = {N | Yes, No} See START-YN = {Yes, No}.
WORKERS = {5 | number} The WORKERS parameter specifies the number of concurrent worker subtasks that are started to service Substation ES requests. The valid values range from 5 through 40.
WORKERS-EOT = {30 | number} The WORKERS-EOT parameter specifies the number of End of Task (EOT) concurrent worker threads that are created for ESB to allow faster output for DPL worker connections. The valid values range from 5 through 40.

Contact your TIBCO knowledgeable product specialist before changing the default WORKERS-EOT setting. A large value might have an adverse effect on performance, in particular if insufficient processors are available to satisfy all requests.

To review current thread usage, run the SHOW,SYS,DEBUG command.

XFRCFG-DDN = {TIBCFG | name} The XFRCFG-DDN parameter specifies the DD name of the file for storing the ESB configuration definitions of Substation ES. A set of sample definitions is loaded at installation and used by the Substation ES IVPs.

The definitions are normally specified through the ESB Definition panels, which tell the Substation ES ESB how to transform data between the TIBCO applications and other Substation ES interfaces, such as online transaction processing systems on z/OS. Outbound data from z/OS can also be transformed into TIBCO application information.

The default name is TIBCFG.