Adabas System Coordinator operation is controlled by the following types of parameters:
Runtime controls are used to control the operation of the jobs managed by Adabas System Coordinator
Daemon group parameters are used to define the Adabas System Coordinator daemon environment.
Adabas System Coordinator parameters can be maintained using Adabas System Coordinator Online Services, function Maintenance.
This section provides a description of each Adabas System Coordinator parameter:
This section describes the client runtime control parameters.
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 |
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 |
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 |
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:
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: |
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 |
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 |
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. |
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 |
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 |
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 |
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 |
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: 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. |
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. |
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. |
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 |
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 |
Console |
Parameter Type | Use | Possible Values | Default |
---|---|---|---|
Client Runtime Control |
Allows automatic retry of Adabas commands that receive the specified response codes. You can also
|
None |
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 |
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:
|
0 - 32 | None |
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 |
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 |
This section describes the daemon parameters.
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 |
Parameter Type | Use | Default |
---|---|---|
Daemon Group |
The identifier for a daemon group. In a sysplex environment, this is the XCF group name. |
none |
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 |
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 |
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 |
Parameter Type | Use | Possible Values | Default |
---|---|---|---|
Daemon Group |
Type of coordination to be performed by the daemon group Possible values are:
|
Single |
none |
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 |
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 |
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 |
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 |
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 |