Special Services

#### Search Results

Search

# Special Services

This section describes the special services functions provided by Online Services.

- Special Services Menu

- Asynchronous Buffer Services

- Database Component Services

- Local Services

- Fix Display

## Special Services Menu

Selecting option code `5` from the Online Services main menu or entering the command 5 on the command line displays the Special Services menu.

    10:45:13     ***** A D A B A S   FASTPATH SERVICES v.r.s *****      2025-10-25
                               -  Special Services  -                    F15000M1

                      Code    Service
                      ----    ----------------------------
                       1      Asynchronous Buffer Services
                       2      Database Component Services
                       3      Local SYSAFP Services
                       4      Fix Display
                       .      Exit
                      ----    ----------------------------
              Code ..: _

     Command ==>

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                                Recon             Menu

The following services are available, and can be invoked using the appropriate option code.

Code | Service | Provides communication facilities for the...
--- | --- | ---
1 | Asynchronous Buffer Services | selected active Adabas Fastpath buffer.
2 | Database Component Services | database(s) for which Adabas Fastpath has been installed.
3 | Local SYSAFP Services | job (a TP monitor, for example) in use when executing the functions.
4 | Fix Display | display of applied fixes for all Adabas Fastpath components.

## Asynchronous Buffer Services

Selecting option code `1` from the Special Services menu or entering the command 5.1 on any command line displays the following window:

    10:45:53              2025-10-25
                          F15100MA
            Special Services
    for ABM Node Id: 17004 A8P17004
          Status Active

            R Restart..(Stop/Start)
            S Stop.....(Terminate)
            N Newcopy..(and Restart)
            P Snap
            L Log
            I ABM Information
            . Exit
    Code..: _

    Command ==>
          PF1 Help   PF3 Exit

Asynchronous Buffer Services communicates with the buffer indicated at the top of the window. If the job is connected to a buffer, that buffer is shown when the window opens. You can override the default buffer by changing the database number to the one defined for the required buffer. All actions are a request to the Asynchronous Buffer Manager (AFPABM) to perform the function.

Option Code | Description
--- | ---
R: Restart | Stop the buffer in an orderly fashion, and then restart it again. Both primary and alternate configuration files (if used) must be available for this operation. (See note 1)
S: Stop | The Fastpath cache management service within the System Coordinator daemon is stopped. The configuration file and alternate (if used) must both be available for this operation. Note This operation is not reversible without a complete recycle of the daemon.
N: Newcopy | Reload the Adabas Fastpath modules for the buffer and every other component connected to the buffer. AFPABM also performs a buffer restart. Both primary and alternate configuration files (if used) must be available for this operation. (See note 1)
P: Snap | Produce a snap dump of the buffer.
L: Log | Write a statistical log to the Adabas Fastpath configuration file.
I: ABM Information | Display general diagnostic information for the Adabas Fastpath buffer job.

Notes:

1. Multi-task clients (such as RPC and NDV servers) are not compatible with the dynamic Restart or Newcopy. Such jobs should be stopped before issuing the Fastpath operator command and restarted after the action has completed.

## Database Component Services

Selecting option code `2` from the Special Services menu or entering the command 5.2 on any command line displays the following window:

    10:46:24               2025-10-25
                           F15200MA

         Special Services for:-
            DBID: 0____
      SysCo Node: 17004

            I Connection Information
            . Exit
    Code..: _

    Command ==>
     PF1 Help   PF3 Exit   PF5 Action

The following fields are provided:

Field | Description
--- | ---
DBID | Database Component Services provides services for the database indicated at the top of the window. This can be any active database for which Adabas Fastpath has been installed. If the function is invoked from the System Job Summary screen as in the above example, the database for which communication is required is already established and is shown on the screen. Otherwise, the database number must be entered.
SysCo Node | The Adabas System Coordinator Node ID. This is only required for clustered databases: If the Node ID is known, a screen follows showing a cluster map for the database. If the Node ID is not known, you must enter it in this field.
Option Code | The following option code may be used: I: Connection Information. Displays connection information between the selected database and the Adabas Fastpath buffer to which the database is connected. See the Connection Information screen as described in the next section.

## Local Services

Selecting option code `3` from the Special Services menu or entering the command 5.3 on any command line displays the following window.

Local Services provides service request communication for a local job with the TP monitor in use.

    10:47:10              2025-10-25
                          F15300MA

          Special Services for:
            Local Job UKRPE

            I Connection Information
            S Job Statistics
            C ReConnect
            D Disconnect from Buffer
            N Newcopy
            . Exit
    Code..: _

    Command ==>
          PF1 Help    PF3 Exit

The following fields are available:

Field | Description
--- | ---
Local Job | The local job for which the request is to be made.
Code | The following option codes may be used: I: Connection Information. Displays connection information for the job. S: Job Statistics. Displays statistics for the local job when it is not connected to a buffer because read-ahead optimization may be taking place even when the buffer is not active. C: Reconnect. Attempts to connect the local job to a buffer. D: Disconnect. Disconnects the local job from the buffer. N: Newcopy. Temporarily disconnects the local job from the local buffer before reloading the Adabas Fastpath modules. We do not recommend using Newcopy from Local SYSAFP Services. The preferred method is to use Newcopy from Asynchronous Buffer Services.

### Connection Information

The Connection Status screen, which can be accessed from any of the Service options, displays connection status information:

    10:47:50     ***** A D A B A S   FASTPATH SERVICES v.r.s *****      2025-10-25
     Run-mode: 17004            -  Connection Status Information  -      F1CNXSMA

     ***** Information Request *****
     Status Indicators: 00 1E 00 20             Owner: 0000000000000000
     Jobname: UKRPE     No: U12954   Type: 29   Amode: 00

         Address List: 2633C1D8          Initialization Code: ok       RC:
         Linker Stub:  263E3960                  Retry Count: 1000  Limit: 1000
         Connection-0: 2642F420                   Linker SVC: 254
         Connection-1: 263EDDA0                        Event:
         Connection-X: 263E75A0            System File:  SVC: 254      DB: 17003
         AFPKRN        A6457F78                                       FNR: 34
                                                Buffer:  SVC: 254      DB: 17004
                                                    Poolname:
         Anchor:       16BAE400                 Pool Address: 00000000
         Session:      16BBB3B8          User Exit 4 Routine:
         Reserved:     0000000000000000               CLOGIO: 00

     This Information Screen may be useful to technical support

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                      Exit                                CodeI

#### Connection Information Screen

Although this screen is primarily intended for Company internal use to assist in identifying connection problems, some of the following information may be helpful to users.

Field | Description
--- | ---
Linker Stub | Load address of the Adabas Fastpath module that was linked with the Adabas link routine.
AFPKRN / AFPDEP / AFPCFG | Load addresses of the Adabas Fastpath modules. A zero address indicates that the module could not be found.
Anchor | Address of the Adabas Fastpath buffer pool, if it could be located. This address is usually zero if connection could not be made.
Session | Address of the job area (BSA) within the Adabas Fastpath buffer.
Initialization Code | "ok" indicates connection was successful. If connection was unsuccessful an error code relating to job initialization is shown.
RC | If there is an error when reading the Adabas Fastpath configuration file, this field shows the Adabas response code received.

### Job Statistics

The Local Job Statistics screen can be invoked by selecting option code `S` from the Special Services for Local Job window:

    18:08:29  ***** A D A B A S   FASTPATH SERVICES v.r.s *****  2025-11-13
                                -  Local Job Statistics  -               F15310MA

     Job:    UKRPE Type: TSO       Number: U58757        Started: Nov 13,2025 17:45

     ---------------------------- Optimization Summary ----------------------------
        Access Type               Attempts  (27%)    <----------Successes  (62%)

        Read-ahead:                  2,749  (27%)                   1,719  (62%)
        Direct:                              (0%)                           (0%)
        RCs:                                 (0%)                           (0%)
        Others:                      7,228  (73%)

        Total:                       9,977 (100%)                   1,719  (17%)
     ------------------------------------------------------------------------------
      Memory(k):             RA Memory:              Over-reads:

       Status: 00 1C 02 00    System Id:      TSO     Area Address: 271A4000

     Command ==>

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Refr                                            Menu

This screen is useful when the local job is not connected to the local buffer to show the read-ahead optimization, which can continue even when the buffer is not connected.

The information provided is in the same format as that described in the section Detailed Job Information.

## Fix Display

To display the applied fixes

- Select option 4 from Special Services menu.

      08:36:03      ***** A D A B A S   FASTPATH SERVICES v.r.s *****      2025-04-23
                    -  Fix Display: AFP 8.2.1 Patch: 0000 06/22/09  -      U1FIX0M1
                      Local client job running this current session

        C  Patch Reference Type Description
        _  0000  AW821001  EXE  For example only

       Mark with any character for detail

       Command ==>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                        Exit  Other                                     Prods Menu

  Initially the screen will list all fixes applied to the Adabas Fastpath kernel in the local client environment.

  You can select other display perspectives (e.g. Coordinator daemon or Adabas database) by using PF4. You can also directly list the applied fixes for Adabas System Coordinator, Adabas Vista, and Adabas Transaction Manager by using PF11 to first select the appropriate product.

### On this page

- Special Services
- Special Services Menu
- Asynchronous Buffer Services
- Database Component Services
- Local Services
- Fix Display