Maintenance and Job History

This service is used to define the Adabas Fastpath optimization parameters.


Maintenance Menu

Selecting option code 1 from the main menu or entering the command 1 on the command line displays the Maintenance menu.

18:21:37 ***** A D A B A S  FASTPATH SERVICES 8.2.2 *****         2018-05-19
                 -  Parameter Maintenance  -                       F11000M1
 

               Code   Service
               ----   -----------------
                1     Buffer Parameters
                2     File Parameters
                3     Client Runtime Controls
                .     Exit
               ----   -----------------
       Code ..: _



  Command ==>
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
       Help        Exit                                                  Menu
Parameter Maintenance

Select an option code to invoke the corresponding menu for the type of parameters to be defined/modified:

Note:
Before proceeding, you may wish to review the section Adabas Fastpath Parameters which provides a complete list and description of each parameter type.

Buffer Parameters

Selecting option code 1 from the Parameter Maintenance menu or entering 1.1 on a command line displays the Maintain Buffer Parameters screen.

The currently defined Adabas Fastpath buffers are listed.

For an existing buffer, you can enter any of the option codes described below.

You can use PF10 to add a new buffer definition as described in section Adding a New Buffer.

12:36:27 ***** A D A B A S  FASTPATH SERVICES 8.2.2 *****          2018-05-19
                 -  Maintain Buffer Parameters  -                   F11100M1


    <----- Buffer ----->  Coordinator   Size    Direct   Read-
 C   Name     SVC   DBID     Group      (k)     Access   ahead   Comments

 _  AFPDAEF   255  11001    AFPGROUP    4096      ON      ON
 _  AFPDA2F   255  11002    AFPGROUP    4096      ON      ON
 _  AFPDA3F   255  11003    AFPGROUP    4096      ON      ON
 _  V811ME01  244   8111    V811GR01    8192      ON      ON
 _  V811ME02  244   8112    V811GR01    4096      ON      ON



 Mark with M(odify),P(urge),R(ename),C(opy),F(iles)

End of List
 Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
      Help        Exit  Refr                                Add         Menu
Maintain Buffer Parameters

The following information is provided:

C Option code (M: modify buffer parameters, P: purge buffer, R: rename buffer, C: copy buffer, F: file parameters). For more information on the Modify function, see Modifying Buffer Parameters.
Name SVC DBID The buffer name, the Adabas SVC used by this buffer, and the database used by this buffer.
Coordinator Group The name of the Adabas System Coordinator group to which this buffer belongs.
Size The memory size for this buffer.
Direct Access Indicates whether or not direct access optimization is to be used for this buffer.
Read Ahead Indicates whether or not read-ahead optimization is to be used for this buffer.

Adding a New Buffer

To add a new buffer, press PF10 on the Buffer Parameter Maintenance screen. The following screen appears:

  13:18:36               2018-07-13 
            Add Buffer   F11110MB   
                                    
       Size(k):          4096__     
                                    
   System Coordinator               
     Group Name:         ________   
     Daemon Name:        ________   
   (Leave empty to select)          
                                    
   Buffer Memory                    
   Dataspace Name:       ________   
                                    
                                    
                                    
                                    
  Command ==>                       
    PF1 Help   PF3 Exit   PF5 Add
Add Buffer

You must provide values for the following fields:

Size The size of the buffer to be added.
Group Name The name of the Adabas System Coordinator group in which this buffer is to be a member. Adabas Fastpath buffers operate as members of an Adabas System Coordinator group. The group must have already been defined using Adabas System Coordinator Online Services.
Daemon Name The daemon name is the job name of the Adabas System Coordinator daemon under which this buffer is to operate. The daemon name may have already been defined. If not you will be prompted to define it by entering the unique Node ID by which this daemon is to be identified.
Dataspace Name A dataspace name may optionally be specified if the Fastpath buffer is to be allocated as a dataspace. For information, refer to the Adabas Fastpath Buffer parameter Dataspace Name.

Modifying Buffer Parameters

Buffers are added with default parameters. After a buffer has been added, you can view/modify all the default settings by using the d or m option code on the Maintain Buffer Parameters screen. The following sample screen lists the general parameters for buffer A8P17004.

13:26:09     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-04
                             -  Buffer A8P17004  -                   F11120MA  
                                                                               
      System Coordinator Group Name: RPEGRP1_   Daemon Name: A8P17004          
                                                                               
      Adabas SVC Number:   254        Designated DBID:            17004        
                                                                               
      Last Modified:       2018-03-04 By User ID:                 UKRPE        
      Last Buffer Address: 1587F400   Length: 001FFC00   Session: 821          
                                                                               
 ----------------------------- General Parameters -----------------------------
                                                                               
      Size(k):             2048       Minimum Buffer Size(k):     0            
      Maximum Jobs:        12         Set ID Length Limit:        1024         
      RB Length Limit:     1024       Message Level(Hex):         00           
      Dataspace Name:      ________                                            
      Additional encodings: All                   _ (mark to alter)            
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd                     More  File        Menu      

You can use this screen to review and, if necessary, modify any of these buffer parameters.

Refer to section Adabas Fastpath Parameters for a description of each of these parameters.

By pressing PF9 (above), you can display the detail parameters for this buffer:

16:00:13  ***** A D A B A S   FASTPATH SERVICES 8.2.2      *****  2018-09-11
                     Buffer V811ME01                                F11120MB


      Adabas SVC Number:   244        Designated DBID:            8111

      Last Modified:       2018-05-19 By User ID:                 UKSJU
      Last Buffer Address: 00000000   Length: 00000000   Session: 0
 ------------------------- Detailed Parameters --------------------------------
      Fast cache attempts: 32         Fast set create attempts:   25
      Coherence Limit (per sec): 32   Suspension Period (mins):   3 
      Default pacing rate: 10         Set Concurrency:            2 
      Freespace Index:     512        Average Item Size:          256 
                                      Async coherence messages:   Y       

 ------------------------  Operational Control --------------------------------
      Log every n Minutes: 60         Keep for n Days:            30
      Restart every n Hrs: 0          Restart Time:               17:30 
      Direct Access:       ON         Read-ahead:                 ON
      Find       Sx/L1:    ON         READ LOGICAL  L3:           ON 
      READ PHYSICAL L2:    ON         HISTOGRAM     L9:           ON    


 
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
      Help        Exit        Upd                     More  File        Menu

You can use this screen to review and, if necessary, modify any of these buffer parameters.

Refer to section Adabas Fastpath Parameters for a description of each of these parameters.

By pressing PF9 (above), you can display the debug settings for this buffer:

14:58:02    ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-08-30
                              Buffer A8P17004                        F11120MD  
                                                                               
      Adabas SVC Number:   254         Designated DBID:            17004       
                                                                               
      Last Modified:       2018-08-30  By User ID:                 UKRPE       
      Last Buffer Address: 00001000    Length: 000FFC00   Session: 2586        
                                                                               
 -----Debug Event Control (use when recommended by Software AG)--------------
                                                                               
                                            Full Partial  Start  Shut          
      Event List                            snap   snap   again  down          
      ------------------------------        ----   ----   ----   ----          
      Database terminates abnormally           N      N      N      N         
      Set error code:  2A                      Y      N      N      N          
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd                     More  File        Menu   

You can use this screen to set buffer debug event controls. These can be set when recommended by Software AG to produce diagnostic information. For more information, please refer to Buffer Debug Event Controls.

By pressing PF9 (above), you can return to the general buffer parameter display.

File Parameters

For each Adabas Fastpath buffer, file parameters can be defined which indicate for exactly which databases/files optimization is to be performed. You can access the File Parameters maintenance function:

  • from the Parameter Maintenance screen after specifying a previously defined buffer; or

  • from any Buffer Maintenance screen.

By pressing PF10 on either of these buffer modify screens, you can access the File Optimization Parameters screen.

8:21:37 ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****           2018-05-19
      - File Optimization Parameters for: Global AFP311A -           F11200MA

                                                                    Reposition
                             Start  End        Update               DBID: _____
    C   DBID   File   SVC    Time   Time       Sensitivity          File: _____
    _     11      7   254                      Record
    _     12      7   254                      Record
    _     13      7   254                      Record
    _     14      7   254                      Record
    _     71      7   254                      Record
    _    111     66   254    12:00  16:00      Record
    _    193      1                            Record
    _    193      2                            Record
    _    193      3                            Record
    _    193      4                            Record
    _    193      5                            Record
    _    193      7   254                      Record

  Mark with M(odify),P(urge),C(opy


 Top of List
  Command ==>
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
       Help        Exit  Refr                    Fwd   Bot   Add         Menu
File Parameter Selection

This screen lists, for the specified Adabas Fastpath buffer, all databases and files curently defined for Adabas Fastpath optimization.

Note:
You can use the Reposition function to position to a specific database/file in the list.

Field Description
C Option code (M: modify file parameters, P: purge file parameters, C: copy file parameters).
DBID Adabas Database ID.
File Adabas File Number.
SVC Adabas SVC.
Time The specific time period during which Adabas Fastpath optimization is to be in effect. See parameter Start Time.
Update Sensitivity Controls how Adabas update commands are to be processed. See parameter Update Sensitivity.

Adding File Parameters

In the File Optimization Parameters screen, use PF10 to add a new file parameter. The following screen will appear:

12:30:07                      2018-05-19
                               F11210M1

  Add File Optimization Parameter
 
   Buffer Name:   V811ME01
          File:    0  
                  (0 = DB default)
          in DBID:    _____
          using SVC:  _____  (Optional)
                      
   Optional Time Window
   Start(HH:MM): _____ End: _____
   (Leave empty for 24 hours)
 
                       
 Command ==>            
   PF1 Help   PF3 Exit   PF5 Add 
Add File Parameter
File The Adabas file number for which Adabas Fastpath optimization is to be defined.

Note:
By not specifying a file number, you can define a default parameter set for all files in a database (in this case only read-ahead optimization but not direct access optimization can be applied). Individual file parameters override a database default parameter.

in DBID The Adabas database in which the file to be optimized is located.
using SVC The Adabas SVC number.

Note:
Normally, the SVC parameter is only used at z/OS, MSP, and VSE/ESA sites where multiple Adabas SVCs are required; otherwise, it need not be used. If multiple SVCs are in use, all databases defined for optimization in the same buffer must use the same SVC as the buffer (and the Adabas System Coordinator hosting the buffer).

Time Window Optimization is only to be in effect within the specified time window. See parameter Start Time.

After a file parameter is added, the File Parameters Maintenance screen can be used to define further optimization parameters which are to be in effect for the file. This is described in the following section.

Maintaining File Parameters

The File Parameters Maintenance function can be invoked by/from:

  • automatically from the Add File Parameters function

  • by using option code m on the File Parameter Selection screen

  • from an AFPLOOK File Display screen or from the File Set Summary List screen by pressing PF5 . Similarly, hot keys on this screen can be used to access AFPLOOK and File Set Summary.

  • by entering 1.2 on a command line anywhere in the system, provided that a database and file number have previously been established using this screen or one of the other functions in the hot key chain.

The following screen appears:

 10:50:57  ***** A D A B A S   FASTPATH SERVICES 8.2.2 (I002) *****  2018-07-22
             -  File Optimization Parameters for: R81ABM81  -        F11220MA  
                                                                               
 File: 9     DBID: 198   SVC: 254        Last Modified: 2018-07-22 by: UKRPE   
 Start Time (HH:MM):  _____ End Time: _____   Update Sensitivity: R Record     
 Initial Status:      ON        Set Limit (k):   0                             
 Set Id Length Limit: 0         RB Length Limit: 0         Set Concurrency: 0  
 Expanded File:       N         Cache secure file:  N      Pacing: 0           
 Password for secure file DA-caching (not recommended):                        
 Additional encodings: Default               _ (mark to alter)                 
 ---- Direct-access -------- Optimization Summary ----- Read-ahead ------------
 L1 Get/Read by ISN  ON               ¦   L1 Read by ISN        ON             
 L3 Read Logical     OFF Over-rides   ¦   L2 Read Physical      ON             
 L9 Histogram        OFF              ¦   L3 Read Logical      OFF Over-rides  
 S1 Find Records     ON  Over-rides   ¦   L9 Histogram         OFF             
 S2 Find Sorted      ON               ¦   S1 Find Records       ON Over-rides  
                                      ¦   S2 Find Sorted        ON             
                                      ¦   S8 Process ISN List   ON             
                                      ¦   S9 Sort ISN List      ON             
 PF10 to Modify Direct Access         +   PF11 to Modify Read-ahead            
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd   Look              FILE  DA    RA    Menu
File Optimization Parameters

The following parameters can be maintained using this screen:

Parameter Description
Start Time, End Time

Optimization is only to be in effect within the specified time window. See parameter Start Time.

Note:
You can enable optimization for a different time window by creating a different parameter set for this file.

Update Sensitivity Indicates how Adabas Fastpath is to process commands which result in database updating. The following values are permitted:

N (none). Ignore all update commands.
R (record level). Remove data by identifying single records.
F (file). Remove all data for the file held in the Adabas Fastpath buffer.
D (distributed record level). Use only on advice from Software AG support.

Initial Status By setting this field to OFF, you can indicate that the file parameters being defined are not to be activated until this field is changed to ON.
Set Limit Adabas Fastpath creates sets of direct access command models. This parameter limits the size (in k) of data items within a set.

Set ID Length Limit
RB Length Limit
Set Concurrency

These parameters can be used to decrease (but not increase) the values of the equivalent buffer parameters. These parameters are described in section Adabas Fastpath Parameters.
Expanded File This field must be set to Y if the file is defined to Adabas as an expanded file. If so, direct access optimization cannot be defined for L3/L9 commands.
Cache secure file If the file is password protected, but direct access caching is still required, then set this parameter as ‘Y’. Use of secure file caching is not recommended.
Password for secure file D-A caching If the file is password protected and direct access caching is still required, and the cache secure file parameter is set to ‘Y’, then the password needs to be given here. Use of this parameter is not recommended.
Additional Encodings

The setting for direct-access optimization for data of a different character encoding from that used by Adabas to store the data internally. Settings:

  • Default: Inherit the buffer-level setting.

  • None: Only data for Adabas internal encodings.

  • All: All the possible encodings allowed by Fastpath.

  • Single byte ascii: This additional character encoding.

  • Single byte ebcdic: This additional character encoding.

  • Double byte ascii: This additional character encoding.

  • Double byte ebcdic: This additional character encoding.

Pacing: Controls the rate at which housekeeping is performed for this file.
Optimization Summary

The current direct access and read-ahead optimization settings for each Adabas command used for this file.

Optimization can be defined for the following commands:

  • direct access: L1,L3,L9,S1,S2

  • read-ahead: L1,L2,L3,L9,S1,S2,S8,S9

Note:
Sx commands are generally followed by L1 commands in order to retrieve subsequent records. Although it is the subsequent L1 commands that benefit from read-ahead optimization, control is through the initiating Sx command.

Use PF5 to commit all changes. Use PF3 to exit without applying any changes.

Use PF10 and PF11 to modify the direct access and read-ahead optimization parameters as described in the following sections:

Direct Access Optimization Parameters

The following screen is displayed when you press PF10 from the File Optimization Parameters screen:

 10:48:40  ***** A D A B A S   FASTPATH SERVICES 8.2.2 (I002) *****  2018-07-22
             -  File Optimization Parameters for: R81ABM81  -        F11220MB  
                                                                               
 File: 9     DBID: 198   SVC: 254        Last Modified: 2018-07-22 By: UKRPE   
                                                                               
 Start Time (HH:MM):  _____ End Time: _____   Update Sensitivity: R Record     
 Initial Status:      ON        Set Limit (k):   0                             
 Set Id Length Limit: 0         RB Length Limit: 0         Set Concurrency: 0  
 Expanded File:       N         Cache secure file:  N      Pacing: 0           
 Password for secure file DA-caching (not recommended):                        
 --------------------- Direct Access Optimization -----------------------------
                    On/Off  Except for:   Field level overrides                
 L1 Get/Read by ISN  ON                                                        
 L3 Read Logical     OFF                  AA  AB  __  __  __  __  __           
 L9 Histogram        OFF                  __  __  __  __  __  __  __           
 S1 Find Records     ON                   BB  __  __  __  __  __  __           
 S2 Find Sorted      ON                   __  __  __  __  __  __  __           
                                Mark to use lower-case Field names _           
                                                                               
 PF11 to Modify Read-ahead                                                     
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd   Look              FILE  Back  RA    Menu
Field Description
Command Adabas read or query command (L1/L3/L9/S1/S2).
On/Off Indicates whether or not optimization is to be in effect for the command. In the screen example, L1 commands (all fields), L3 commands (for fields AA nd AB only) and S1 commands (excluding S1 commands in which field BB is used as the primary descriptor) are to be optimized. The default is OFF.
Except for The comments Now Optimizes and Now Excludes are displayed when the Enter key is pressed to illustrate the effect of field level overrides.
Field level overrides

Used to include/exclude certain fields from optimization. In the screen example, L1 commands (all fields), L3 commands (fields AA and AB only) and S1 commands (excluding field BB) are to be optimized.

If any field name contains lower-case characters, enter any non-blank character against "Mark to use lower-case Field names".

Note:
Your terminal must be defined appropriately to the TP system to allow lower-case input.

Use PF5 to commit all changes. Use PF3 to exit without applying any changes.

Read-Ahead Optimization Parameters

The following screen is displayed when you press PF11 from the File Optimization Parameters screen:

 10:50:23  ***** A D A B A S   FASTPATH SERVICES 8.2.2 (I002) *****  2018-07-22
             -  File Optimization Parameters for: R81ABM81  -        F11220MC  
                                                                               
 File: 9     DBID: 198   SVC: 254        Last Modified: 2018-07-22 by: UKRPE   
                                                                               
 Start Time (HH:MM):  _____ End Time: _____                                    
 Initial Status:      ON                                                       
 Expanded File:       N                                                        
 --------------------- Read-ahead Optimization --------------------------------
                     On/Off  Except for:   Field level overrides               
 L1 Read by ISN       ON                                                       
 L2 Read Physical     ON                                                       
 L3 Read Logical      OFF  Now Optimizes   AA  __  __  __  __  __  __          
 L9 Histogram         OFF                  __  __  __  __  __  __  __          
 S1 Find Records      ON   Now Excludes    CC  __  __  __  __  __  __          
 S2 Find Sorted       ON                   __  __  __  __  __  __  __          
 S8 Process ISN List  ON                                                       
 S9 Sort ISN List     ON                                                       
                                 Mark to use lower-case Field names _          
 PF10 to Modify Direct Access                                                  
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd   Look              FILE  DA    Back  Menu
Read-Ahead Optimization Parameters
Field Description
Command Adabas read or query command (L1/L2/L3/L9/S1/S2/S8/S9).
On/Off Indicates whether or not Adabas Fastpath optimization is to be in effect for the command. In the screen example, L1 commands, L2 commands, L3 commands (only when field AA is used as the primary descriptor) and S1 commands (excluding S1 commands in which field CC is used as the primary descriptor) are to be optimized. The default is OFF.
Except for The comments Now Optimizes and Now Excludes are displayed when the Enter key is pressed to illustrate the effect of field level overrides.
Field level overrides

Used to include/exclude certain fields from optimization. Field overrides are not applicable for L1/L2 commands. In the screen example, L1 commands, L2 commands, L3 commands (only when field AA is used as the primary descriptor) and S1 commands (excluding S1 commands in which field CC is used as the primary descriptor) are to be optimized.

If any field name contains lower-case characters, enter any non-blank character against "Mark to use lower-case Field names".

Note:
Your terminal must be defined appropriately to the TP system to allow lower-case input.

Use PF5 to commit all changes. Use PF3 to exit without applying any changes.

Client Runtime Controls

Runtime controls determine the operational behavior of Adabas Fastpath in the job. You can adjust this behavior on a case-by-case basis by specifying overrides to tailor operation for a particular transaction code (TP systems), stepname (batch jobs) or login id.

List Client Runtime Controls

Selecting option 3 from the Parameter Maintenance screen or entering 1.3 on a command line lists the existing Client Runtime control definitions:

13:12:32     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-17
                       -  Client Runtime Controls (AFP)  -            U11300M1     
                                                 Reposition to Type: ________  
                                                               Name: ________  
                              Client Controls                                  
 C Type         Name       AFP   AVI   ATM   COR       Comments                
 _ CICS (DTR)   CICSPROD                      Y                                
 _              CICTDTR     Y                 Y                                
 _              CICTDT1     Y                 Y                                
 _ Misc.DTR     UKRPE       Y     Y     Y     Y        Overrides               
 _ Batch        RPE*****    Y           Y     Y        Overrides               
 _              NATPBAT                       Y                                
 _              RPEAWG      Y                 Y                                
 _              UKRPECMD    Y                 Y                                
 _ COM-PLETE    DAEFCODE    Y                 Y                                
 _ CICS         CICSRPE     Y                 Y                                
 _              CICSTST1    Y                 Y        Overrides               
 _              CICST1      Y                 Y        Overrides
               
 Mark with Jobs,Modify,Purge,Rename,Copy,Overrides,Information,History
                                                             
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit  Refr                    Fwd   Bot   Add   Prods Menu   
   

The following information is provided:

Field Description
C Option code (modify, purge, rename, copy, overrides, information, history, jobs). For more information on the Modify function, see Maintaining Client Runtime Controls.
Type The job type.
Name The control name. For non-DTR or API type, this will be the same as the job name.

AFP
AVI
ATM
COR

Shows which products have Client Runtime controls defined.
Comments Highlights existence of Session Overrides or Site Information (Info).

Add Client Runtime Controls

To add a new definition press PF10 from the Client Runtime Controls list.

The following screen will be displayed:

11:45:54     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-06-09
                      -  Add Client Runtime Control  -               U11310M1  
                                                                               
                                                                               
 Select (mark one) :                                                           
                          _ Batch                                              
                          _ COM-PLETE                                          
                          _ CICS (DTR - Dynamic transaction routing)           
                          _ CICS (Standard)                                    
                          _ IMS (DTR)                                          
                          _ UTM (DTR)                                          
                          _ TSO                                                
                          _ CMS                                                
                          _ TIAM                                               
                          _ more choices for type or                           
                                                                               
                          _ API controlled                                     
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit                                                  Menu   

Select Job Type

Name The control name.

Note:
For non-DTR and API types, the control name will be the same as the job name.

Note:
A control name can include one or more asterisks (*) to indicate a wild card. For example, the client runtime control for a type of BATCH with the name UK**E is found by any job with the name UK in positions 1-2 and E in position 5, no matter what the characters are in positions 3-4. If an asterisk (*) is the last character in a control name, the remainder of positions in the name through the eighth are padded with asterisks. Wildcards are not permitted for DTR or API types.

Type The job type. Each different job type has a different characteristic so it is important to select the correct type.

Note:
If you are using CICS/MRO with dynamic transaction routing, or CICSplex, you must select the job type (DTR - Dynamic transaction routing). The standard CICS job type is used for CICS/MRO without dynamic transaction routing or for other CICS environments.

Note:
If you mark the selection None of the above, another selection window appears with additional job types. If you need to use a job type from the second selection window, contact Software AG for advice.

Once you select a job type, a screen will ask for the job name. In this example, controls for a TSO type job are being defined.

10:44:09     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-12-16
                      -  Add Client Runtime Control  -               U11310M3  
                                                                               
                                                                               
         Type: TSO                                                             
         Name: ________ (* for default controls for this type)                 
                                                                               
                                                                               
 This is a standard type of runtime.                                           
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Add                                       Menu   

Adabas System Coordinator runtime controls will then be required (see the Adabas System Coordinator documentation for further details).

10:45:32     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-12-16
                  -  System Coordinator Runtime Controls  -          U11310M5  
                                         Operation mode (mark one):            
 Type: TSO                                    Use normal autodetect approach: X
 Name: UKRRRR__                               Enable COR even if no products: _
                                          Disable all products including COR: _
 General Settings                                                              
     Statistics externally viewed using group: ________                        
     Refresh statistics every: _______ commands or _____ seconds               
     API runtime overrides....: N (Y/N)                                        
     Use additional exits.....: N (Y/N)                                        
     Maximum idle time (sec)..: __________                                     
                                                                               
     Runtime messages         : Y Console message job log (default)            
                                _ Local (DDMSG) file                           
                                _ Forward to the Daemon (DDMSG) file           
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Add                                       Menu 

Refer to the Adabas System Coordinator documentation for more information.

The group name will then be required.

 11:42:09     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-12-07
                  -  System Coordinator Runtime Controls  -          U11310M5  
                                                                               
 Type: TSO          Name: UKRRRR__                                             
   Operation: Normal autodetect: X Enable without products: _ Disable all: _   
   API runtime overrides....: N (Y/N)                                          
   Use additional exits.....: N (Y/N)                                          
   Maximum idle time (sec)..: __________                                       
                                                                               
   Runtime messages.........: Y Default _ Local (DDMSG) file _ Daemon (DDMSG)  
   Activity pulse every.....: _______ commands or _____ seconds                
     Display (mark one).....: _ Daemon shared memory                           
                              _ Daemon memory                                  
     Latency (mark one).....: X Local                                          
                              _ Group latency disk file                        
                              _ Daemon shared memory                           
                              _ Daemon memory                                  
     Group name.............: ________ (required if group/daemon services used)
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Add                                       Menu   
   

Normally, the absence of client runtime controls for a job implies that optimization is not applied. Thus, you can implement optimization gradually by defining only specific jobs to receive optimization.

Alternatively, this can be reversed. Client runtime controls can be defined for default jobs so that optimization is applied to all jobs of a specific category. Then, you can specify only the jobs that are not to be optimized and those that differ from the default.

Note:
A specific job definition overrides any wild card job definitions or any default definition.

Maintain Client Runtime Controls

To maintain client runtime controls, on the client runtime controls screen, enter the option code m next to the job for which parameters are to be maintained. In the sample screen shown below, the job parameters for batch job KM27WD are displayed.

Modify Client Runtime Controls

To modify client runtime controls, on the client runtime controls screen, enter the option code "M" next to the job for which parameters are to be maintained. In the sample screen shown below, the job parameters for batch job KM27WD are displayed.

The following screen will be displayed:

11:36:32     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-01
                    -  Adabas Fastpath Runtime Controls  -           U1132FM1  
                                                                               
     Name: KM27WD                                     Last Modified: 2018-03-01
     Type: Batch                                          by Userid: UKRPE     
                                                                               
 System Coordinator (Buffer) Group Name.: RPEGRP1                              
                                                                               
 Fastpath ON/OFF........: ON         Read-ahead Optimization Control: BAT      
 Direct Access..........: ON         Read-ahead Memory Limit(k).....: 0        
 Tracing................: N          Maximum read-ahead unit size(k): 32       
 Command Time (Hex).....: 00000000   Maximum read-ahead rate........: 4096     
 End-of-job statistics..: X None                                               
                          _ Daemon messages                                    
                          _ File history with maximum records.......: 0        
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd                                       Menu

Detailed Client Runtime Controls

Parameter Description
FASTPATH ON/OFF If OFF is specified, Adabas Fastpath optimization will be not be performed for this job.
Job End Statistics If Y is specified, Adabas Fastpath performance information will be sent to the operator console when a job ends.
Direct Access If OFF is specified, no direct access optimization will be performed for the job, without regard to other parameters.
Read-Ahead Optimization Control If OFF is specified, no read-ahead optimization will be performed. In addition, you can choose between the read-ahead factor algorithms for TP monitors (TP) or for batch (BAT). While both algorithms accelerate the factor as the sequence length increases, the batch algorithm accelerator is faster than the one for TP monitors. Normally, the default setting is the most efficient.
Read-Ahead Memory Limit Used to restrict the memory allocated to the job for read-ahead optimization.
Maximum read-ahead unit size (k) Used to restrict the memory allocated for a single read-ahead operation.
Maximum read-ahead rate Used to restrict the number of records processed in a single read-ahead operation.
End-of-job Statistics

One of the following options may be selected:

  • None: No information will be displayed or saved.

  • Daemon messages: Fastpath performance information will be sent to the operator console.

  • File history: Statistics will be saved in the configuration file.

Note:
File History is only an option for wholly named jobs (it is not an option offered for *default jobs or jobs that use a wildcard).

Maximum Records The number of records (up to 16) to be kept on file for end-of-job statistics.

Maintain Client Runtime Control Overrides

Overrides to the base-level client runtime controls may be specified. This provides the possibility for a greater granularity of control, allowing controls to relate specifically to particular logins, job steps or transactions.

Enter "O" next to a job which already has AFP client controls in the Client Runtime Controls screen.

Note:
Not all job types will support overrides.

Then enter PF10 to add some client runtime control overrides.

The following screen will be displayed:

15:54:06     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-10-21
                   -  Add Client Runtime Control Override  -          U11381M1  
                                                                                
  Type: Batch        Name: BLAH1                                                
                                                                                
  Select the override type ....: _ Login id                                     
  (mark one)                     X Stepname                                     
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
  and specify the override name: AFPTEST1                                       
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
  Command ==>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help        Exit        Add                                       Menu   

In the example an overrides to a job of type batch is being created, for a specific step.

The following screen will be displayed:

15:55:56     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-10-21
                -  Client Runtime Controls Override Summary  -       U11380M1  
                                                                               
 Type: Batch        Name: BLAH1                                                
                                 Overrides                                     
 C Type         Name       AFP   AVI   ATM   COR       Comments                
 _ Stepname     AFPTEST1                               *Added (empty)          
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Mark with Modify,Purge,Rename,Copy,Information                                                            
                                                                               
 Command ==>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit  Refr                                Add         Menu   

Select M to modify the override client runtime controls.

The following screen will be displayed:

11:38:13     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-01
                    -  Adabas Fastpath Runtime Controls  -           U1138FM1  
                                                                               
 Control Type : Batch        Name: KM27WD             Last Modified: 2018-03-01
 Override Type: Stepname     Name: AFPTEST1               by Userid: UKRPE     
                                                                               
 System Coordinator (Buffer) Group Name.: RPEGRP1                              
                                                                               
 Fastpath ON/OFF........: ON         Read-ahead Optimization Control: BAT      
 Direct Access..........: ON         Read-ahead Memory Limit(k).....: 0        
 Tracing................: N          Maximum read-ahead unit size(k): 32       
 Command Time (Hex).....: 00000000   Maximum read-ahead rate........: 4096     
 End-of-job Statistics..: X None                                               
                          _ Daemon messages                                    
                          _ File history with maximum records.......: 0        
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd                                       Menu   

These runtime controls may be modified and saved using PF5.

In the Client Runtime Controls screen ‘Overrides’ will appear in the comments.

These overrides will now apply in preference to the base-level controls for the specific login, job step or transaction.

Dynamic Client Runtime Configuration

Please refer to the Adabas System Coordinator documentation and the section on Dynamic Client Runtime Configuration for Experts.

Job History

Save Job History

That Job history information be kept may be specified in the Client Runtime Controls.

The end-of-job statistics control may be set to save the Adabas Fastpath end-of-job statistics to the configuration file.

11:39:15     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-01
                    -  Adabas Fastpath Runtime Controls  -           U1132FM1  
                                                                               
     Name: RPEAWG                                     Last Modified: 2018-03-01
     Type: Batch                                          by Userid: UKRPE     
                                                                               
 System Coordinator (Buffer) Group Name.: RPEGRP1                              
                                                                               
 Fastpath ON/OFF........: ON         Read-ahead Optimization Control: BAT      
 Direct Access..........: ON         Read-ahead Memory Limit(k).....: 0        
 Tracing................: N          Maximum read-ahead unit size(k): 64       
 Command Time (Hex).....: 12345678   Maximum read-ahead rate........: 4096     
 End-of-job statistics..: _ None                                               
                          _ Daemon messages                                    
                          X File history with maximum records.......: 4        
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Upd                                       Menu   

A maximum of 16 history records may be specified.

Note:
History is not supported for wildcard job names.

Display Job History

To display saved Job History information enter "H" on the Client Runtime controls screen next to a job which has AFP client controls.

13:12:32     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-17
                        -  Client Runtime Controls  -                U11300M1  
                                                 Reposition to Type: ________  
                                                               Name: ________  
                              Client Controls                                  
 C Type         Name       AFP   AVI   ATM   COR       Comments                
 _ CICS (DTR)   CICSPROD                      Y                                
 _              CICTDTR     Y                 Y                                
 _              CICTDT1     Y                 Y                                
 _ Misc.DTR     UKRPE       Y     Y     Y     Y        Overrides               
 _ Batch        RPE*****    Y           Y     Y        Overrides               
 _              NATPBAT                       Y                                
 H              RPEAWG      Y                 Y                                
 _              UKRPECMD    Y                 Y                                
 _ COM-PLETE    DAEFCODE    Y                 Y                                
 _ CICS         CICSRPE     Y                 Y                                
 _              CICSTST1    Y                 Y        Overrides               
 _              CICST1      Y                 Y        Overrides               
 Mark with Display,Expand,Modify,Purge,Rename,Copy,Overrides,Information       
           History                                                             
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit  Refr                    Fwd   Bot   Add   Prods Menu   
   

If history has been saved for the job then the following screen will be displayed:

13:26:07     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-17
                      -  Adabas Fastpath Job History  -              U113B0M1  
                                                                               
     Name: RPEAWG                                                              
     Type: Batch                                                               
 C   Date         Time                  C   Date         Time                  
 _   2018-03-03   17:33:21              _   2018-03-03   12:56:46              
 _   2018-03-03   15:58:31              _   2018-03-03   15:58:32              
 _   2018-03-03   15:58:32              _   2018-03-03   15:58:33              
 _   2018-03-03   15:58:34              _   2018-03-03   17:31:18              
 _   2018-03-03   17:33:18              _   2018-03-03   17:33:19              
 _   2018-03-03   17:33:19              _   2018-03-03   17:33:20              
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Mark to display history information                                           
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit                                                  Menu   
   

In the example a job of type batch has 12 history items.

An individual history item can be selected and the following screen will be displayed:

13:27:41     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-17
                      -  Adabas Fastpath Job History  -              U113B0MB  
                                                                               
 Job:   RPEAWG Type: Batch        Number: B45852     Started: 2018-03-03  15:58
                                                                               
 ---------------------------- Optimization Summary ----------------------------
    Access Type               Attempts  (58%)    <----------Successes  (61%)   
                                                                               
    Read-ahead:                          (0%)                           (0%)   
    Direct:                          9  (40%)                       4  (44%)   
    RCs:                             4  (18%)                       4  (44%)   
    Others:                          9  (42%)                                  
                                                                               
    Total:                          22 (100%)                       8  (36%)   
 ------------------------------------------------------------------------------
                                                Over-reads:                    
                                                                               
   Status: 00 00 00 00    System ID:    BATCH                                  
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                  Exit              Excl                                Menu   

This information is provided in the same format as that provided by the Current Activity Displays at the Buffer level (see section Buffer Information).

Then enter PF6 to see the exclusions.

11:39:48     ***** A D A B A S   FASTPATH SERVICES 8.2.2 *****      2018-03-01
                      -  Adabas Fastpath Job History  -              U113B0MD  
 Job:   RPEAWG Type: Batch        Number: B43793     Started: 2018-03-01  10:59
                                                                               
     Statistics for commands that have optimization potential but were         
     unable to be optimized:                                                   
                                                                               
     C     Description                                          Count          
     _     Unsuitable command type:                                 0          
     _     Disqualified:                                            0          
     _     Optimization was disabled:                               0          
     _     Multi-fetch was already set:                             0          
     _     Command details exceed Set-id limit:                     0          
     _     Record Buffer exceeds the limit:                         0          
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Command ==>                                                                   
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                  Exit                    Gen                           Menu   

The information is provided is in the same format as that provided by the Current Activity Displays at the buffer level (see section Buffer Information).