Version 8.2.2
 —  Adabas System Coordinator Parameters  —

Parameter Types

Adabas System Coordinator operation is controlled by the following types of parameters:

Adabas System Coordinator parameters can be maintained using Adabas System Coordinator Online Services, function Maintenance.


Parameter Descriptions

This section provides a description of each Adabas System Coordinator parameter:

Client Runtime Controls Daemon Group Parameters
Control Name Full crash recovery disk file
Service Member Name (Expand function) Daemon SVC
Operation Mode Messages - database
Activity pulse
Daemon connection messages Messages – daemon
API Runtime Overrides Daemon Group Name
Threadsafe operation System Type
Use Additional Exits  
Maximum Idle Time Continuous Operation
Daemon latency/activity services
Non-terminal Idle Time Unified trace settings
Debug settings
Generate RSP009/79 Daemon pool settings for BS2000
Latency Controls  
Site Information Menu Function  
Transaction, Stepname or Login Override (Override function)  
Cleanup at Start, Cleanup at End  
Message Controls  
Command retry  
Debug settings  
Unified trace settings  
UTM pool settings  
Site-dependent controls  

Client Runtime Control Parameters

This section describes the client runtime control parameters.

Control Name

Parameter Type Use Minimum Maximum Default
Client Runtime Control

For a batch job, or a standard (single-job) TP monitor, this is the name of the job. If the value ‘*’ is specified, the control will be used for all jobs that do not have a specific control defined.

For a multi-job TP monitor service, this is a unique name for the service. Individual jobs within the service are defined as Service Member Names, using the runtime control Expand function.

1 character 8 characters see text

Service Member Name

Parameter Type Use Minimum Maximum Default
Client Runtime Control

The name of a job that runs as part of a multi-job TP monitor service. This control is maintained with the runtime control menu Expand service.

1 character 8 characters see text

Operation Mode

Parameter Type Use Possible Values Default
Client Runtime Control

Indicate operation mode for COR

Normal autodetect

COR detects other products and switches itself off if none are found

Enable without products

COR remains active, even if no other products are detected

Disable all

COR switches itself off and disables any other active products

Normal autodetect

Activity pulse

Parameter Type Use
Client Runtime Control

You can use a System Coordinator daemon to enable "single-seat" display of session activities in any client job. To enable a client job for this feature, specify:

  • The group in which the daemon runs. When you choose to make these statistics available externally a daemon is required. During periods when the daemon is unavailable (planned or unplanned outage) statistics are unavailable.

  • The frequency at which statistics are pulsed to the daemon:

    • Every nnnnnnn Adabas calls and/or

    • Every nnnnn seconds

Set both to zeroes to disable the refresh.

The statistics are held in shared memory, so you must configure your daemon to use shared memory (refer to the section Daemon latency/activity services for information on configuring the daemon to use shared memory).

Note:
For dynamic transaction routing (DTR) systems (CICS/MRO, CICS/PLEX, IMS/TM, UTM) you must always specify a group, even if you do not want to make use of "single-seat" activity displays. This is because the System Coordinator daemon is also responsible for managing DTR client sessions while they are at rest.

Daemon connection messages

Parameter Type Use Possible Values Default
Client Runtime Control

Indicates whether or not the client job should issue information messages when it connects (message COR060I) or disconnects (message COR061I) from the daemon.

Y | N N

API Runtime Overrides

Parameter Type Use Possible Values Default
Client Runtime Control

Indicates whether controls can be dynamically overridden at runtime via a customised API call to COR.

Y | N N

Threadsafe operation

Parameter Type Use
Client Runtime Control

This parameter is only applicable to runtime controls of type CICS and CICS/DTR and specifies whether or not the System Coordinator client environment runs in CICS threadsafe mode.

Use Additional Exits

Parameter Type Use Default
Client Runtime Control

Enables calling of additional installation exits (IEXIT1, IEXIT2) before and after the Adabas command. Refer to Before You Install in the Installation section for information about installing additional exits.

N

Maximum Idle Time

Parameter Type Use Possible Values Default
Client Runtime Control

Indicates a time limit after which terminal sessions are eligible for timeout termination if no activity has occurred.

0 - nnnnnnnnn seconds Terminal Sessions: 3600 seconds

Non-Terminal Idle Time

Parameter Type Use Possible Values Default
Client Runtime Control

Indicates a time limit after which non-terminal sessions are eligible for timeout termination if no activity has occurred.

0 - nnnnnnnnn seconds none

Generate RSP009/79

Parameter Type Use Possible Values Default
Client Runtime Control

Indicates a time limit for sessions that are timed out to receive response code 9, subcode 79 if they are re-activated.

Specifies a number of seconds after which response code 9, subcode 79 will no longer be returned to re-activated sessions that were previously timed out. 0 means that response code 9, subcode 79 is always returned to sessions that were previously timed out, no matter how much time has passed since they were timed out.

Y|N (enable or disable RSP009/79 setting)

0-nnnnnnnnnn (time limit for setting RSP009/79

Y

0

Latency Controls

Parameter Type Use
Client Runtime Control

Specify where context information is stored when sessions are at rest. For standard jobs (local mode, the default) all context usually resides in local memory. Specify Y for Latency – Local. In CICS jobs, a temporary storage queue is used to expedite context operations and you can specify a prefix for that queue.

Note:
If you use the Client Versioning feature, be sure to specify a different prefix for each System Coordinator version active in the CICS job.

Daemon latency is normally used by dynamic transaction routing (DTR) systems (CICS/MRO, CICS/PLEX, IMS and/or UTM). These options require the job runs with a local daemon. For these jobs, Y is enforced for Latency – Daemon. You can additionally choose whether or not context information is written to disk to provide crash-recovery. If you choose not to write to disk, the information is stored in shared memory if the daemon is configured to use shared memory or in daemon local memory if the daemon is not configured to use shared memory. Shared memory provides better performance.

Site Information Menu Function

Parameter Type Use
Client Runtime Control – Information Menu option

Used to define up to 256 bytes of alphanumeric data, which is stored with the runtime control definition and may be retrieved at runtime using the site information API.

Transaction, Stepname or Login Override (Override function)

Parameter Type Use Possible Values
Client Runtime Control – Override Menu option

Used to define runtime overrides of the basic control for the job. After definition the override can be modified with the Modify menu option.

Depending on Job Type, Stepname, Login or Transaction overrides can be defined.

Cleanup at Start, Cleanup at End

Parameter Type Use Possible Values Default
Client Runtime Control Override

Indicate whether session cleanup is required when a session override is activated (Cleanup at Start) or deactivated (cleanup at End).

Y | N N

Message Controls

Parameter Type Use Possible Values Default
Client Runtime Control

Indicates where messages are written.

If you elect to use a DDMSG file, you must select "Forward to the Daemon DDMSG file" for TP systems because sequential files are not suited to TP.

If you select "Local DDMSG file" for batch type systems, you must add the Adabas load library to the job’s loading environment.

The DDMSG file should be defined as fixed records of length 133, with an appropriate blocksize. It is possible that operating system factors (such as blocking, caching) may cause messages not to be seen until the job terminates.

Console message job log
Local DDMSG file
Forward to the Daemon DDMSG file

Console

Command Retry

Parameter Type Use Possible Values Default
Client Runtime Control

Allows automatic retry of Adabas commands that receive the specified response codes. You can also

  • restrict retry to particular sub-codes

  • restrict it to certain database ids and file numbers

  • specify the number and frequency of retry attempts

  • specify whether or not command retry should cause a console message to be issued

  • specify whether or not retried commands should be shown to user exits

  None

Debug Settings

Parameter Type Use Possible Values Default
Client Runtime Control Define client debug events. For more information, refer to the section Using the Client Event Debug Monitor .   None

Unified Trace Settings

Parameter Type Use Possible Values Default
Client Runtime Control Defines whether or not unified tracing should be active for a job. Normally, tracing is disabled at the job level to avoid overheads and enabled for an override, or, dynamically, for an individual session. Specify:
  • in-memory trace size

  • trace collection

  • dynamic tracing options for capturing non-zero response codes

0 - 32 None

UTM pool settings

Parameter Type Use Possible Values Default
Client Runtime Control

Specify the virtual address and size of the common memory pool for this UTM service.

Pool address, this fixed address will be used by both the System Coordinator daemon and all the jobs in this UTM service.

Hexadecimal address None

Size(mb)

Pool size in megabytes None

Site-dependent controls

Parameter Type Use Possible Values Default
Client Runtime Control You can define two eight-character runtime controls for your own use. By default the controls are called "Area” and “System". They can be specified for jobs, overrides and dynamically and are shown in the Adabas Client Activities displays. Anything None

Daemon Parameters

This section describes the daemon parameters.

Full Crash Recovery Disk File

Parameter Type Use Possible Values Default
Daemon Group

Indicates whether or not a disk file is used by daemons in this group to provide full crash recovery for client sessions.

Y | N N

Daemon Group Name (Daemon Group Parameter)

Parameter Type Use Default
Daemon Group

The identifier for a daemon group.

In a sysplex environment, this is the XCF group name.

none

Daemon SVC

Parameter Type Use Default
Daemon Group

The router (SVC) number that is used for communicating with the group. This must be the same in all parts of a cluster.

none

Messages – database

Parameter Type Use Possible Values Default
Daemon Group

Indicates where messages are written for databases.

The DDMSG file should be defined as fixed records of length 133, with an appropriate blocksize. It is possible that operating system factors (such as blocking, caching) may cause messages not to be seen until the database terminates.

Console message job log

Local DDMSG file in the database job

Console

Messages – daemon

Parameter Type Use Possible Values Default
Daemon Group

Indicates where messages are written for daemons.

The DDMSG file should be defined as fixed records of length 133, with an appropriate blocksize. It is possible that operating system factors (such as blocking, caching) may cause messages not to be seen until the database terminates.

Console message job log

Local DDMSG file in the daemon job

Console

System Type

Parameter Type Use Possible Values Default
Daemon Group

Type of coordination to be performed by the daemon group

Possible values are:

  • Single: A single system is to be coordinated.

  • Multi - XCF: Multiple systems are to be coordinated with no dynamic transaction routing support across the systems. XCF is used for cross-system communications.

  • Multi - Net-Work: Multiple systems are to be coordinated with no dynamic transaction routing support across the systems. Entire Net-Work is used for cross-system communications.

  • Sysplex: Multiple systems are to be coordinated with dynamic transaction routing support across the systems.

Single
Multi-XCF
Multi-Net-Work
Sysplex

none

Continuous Operation

Parameter Type Use Possible Values Default
Daemon

Setting this to Y causes the daemon to intercept failures, react by automatically terminating and restarting the appropriate component(s) and then continuing.

Setting this to N causes the daemon to react to a failure by terminating.

Y | N N

Daemon latency/activity services

Parameter Type Use Possible Values Default
Daemon

Shared and local memory limits for holding activity display and latent session information and optional dataspace name.

Note that the daemon only uses local memory for latent session information. If you want to enable "single-seat" display of client job activities, you must define a shared memory maximum size. Shared memory minimum size and dataspace name are optional.

0 - 2097151

Valid dataspace name

none

Unified trace settings

Parameter Type Use Possible Values Default
Daemon Daemon and database trace options:

Size of in-memory trace buffer

0 - 32 0

Whether to use a trace file

N | Y N

Whether to go back to the beginning of the trace file when it fills

N | Y N

Debug settings

Parameter Type Use Possible Values Default
Daemon CORDUMP for transient situations…Some internal communications (for example) may suffer intermittent, transient failure. System Coordinator automatically tolerates and recovers from these issues without problem. However, sometimes Software AG may ask that diagnostics are taken when investigating a problem by requiring this setting to be Y. N | Y N
Number of outputs…when diagnostics are being taken it is possible (and wise) to limit the number of times diagnostics are taken using this number. 0-65535 0

Daemon pool settings for BS2000

Parameter Type Use Possible Values Default
Daemon Specify the virtual address and size of the daemon common memory pool. Required on BS2000.

Name

16 character pool name None

The fixed address will be used by both the System Coordinator daemon and all the jobs in this UTM service.

Hexadecimal address None

Size(mb)

Pool size in megabytes None

Top of page