This section describes the special services functions provided by Online Services.
Selecting option code 5 from the Online
Services main menu or entering the command 5 on the command line displays the Special
Services menu.
11:15:24 ***** A D A B A S FASTPATH SERVICES 7.4.1 ***** 2002-09-05
- Special Services - F15000M1
Code Service
---- ----------------------------
1 Asynchronous Buffer Services
2 Database Component Services
3 Local SYSAFP Services
. 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. |
Selecting option code 1 from the Special
Services menu or entering the command 5.1 on any command line displays the following
window:
11:15:55 2002-09-05
F15100MA
Special Services for
ABM Node Id: 33 SYSCO33
Status Active
R Restart...(Stop/Start)
S Stop......(Terminate)
N Newcopy...(and Restart)
P Snap
L Log
I ABM Information
Z Zap 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. |
| S: Stop | Terminate the buffer in an orderly fashion. |
| N: Newcopy | Reload the Adabas Fastpath modules for the buffer and every other component connected to the buffer. AFPABM also performs a buffer restart. |
| 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. |
| Z: ZAP Information | Display the numbers of ZAPs that have been applied to the Adabas Fastpath nucleus being used by the Adabas Fastpath buffer job. |
Selecting option code 2 from the Special
Services menu or entering the command 5.2 on any command line displays the following
window:
17:52:34 2002-10-30
F15200MA
Special Services for:
DBID: 0
SysCo Node: _____
Z Zap Information
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:
|
| Option Codes | The following option codes may be used:
Z : Zap Information. Displays the ZAPs applied to the Adabas
Fastpath nucleus used by the selected database component. See the Zap
Information screen as described in the next section. |
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.
11:16:44 2002-09-05
F15300MA
Special Services for:
Local Job DAEFCODE
Z Zap Information
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. |
| Option Codes | The following option codes may be used:
Z: Zap Information. Displays the numbers of ZAPs that have
been applied to the Adabas Fastpath nucleus being accessed from the local job.
|
The following screen is an example of the ZAP information that can be retrieved from any of the Service options:
11:17:32 ***** A D A B A S FASTPATH SERVICES 7.4.1 ***** 2002-09-05
- Display ZAP IDs (AFPIDnnn) from DAEFCODE - F1ZAPDM1
Version: AFP 7.2 Last Assembly Date: 08/02/01
--- 002 --- 004 --- --- 007 --- --- --- --- 012 --- --- --- ---
--- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
--- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
Enter ZAP number for details: ___
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Exit Comm Menu |
This information is useful for checking the ZAPs that have been applied to the Adabas Fastpath modules, as used by the selected service option.
By entering a ZAP number, you can see the ZAP details that have been applied, but only the part relevant to the AFPZAP module.
PF9 can be used to display the ZAPs applied to the modules common to all Adabas options.
The Connection Status screen, which can be accessed from any of the Service options, displays connection status information:
11:18:48 ***** A D A B A S FASTPATH SERVICES 7.4.1 ***** 2002-09-05
- Connection Status Information - F1CNXSMA
***** Information Request *****
Status Indicators: 00 1E 00 A0 Owner: 0000000000000000
Jobname: DAEFCODE No: C30694 Type: 21 Amode: 80
Address List: 1018ADB8 Initialization Error: RC:
Linker Stub: 1098DEE8 Retry Count: 1000 Limit: 1000
Connection-0: 10996664 Linker SVC: 254
Connection-1: 003E8D00 Event:
Connection-X: 003E54E0 Configuration File: SVC: 240 DB: 198
AFPKRN 90B29BB0 FNR: 19
AFPDEP 00399578 Buffer: SVC: 240 DB: 33
AFPCFG 00311218 Poolname:
Anchor: 099D3000 Pool Address: 00000000
Session: 099E28C8 User Exit 4 Routine:
Reserved: 0000000000000000 CLOGIO: 00
This Information Screen may be useful to Software AG Technical Support
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Exit CodeI |
Although this screen is primarily intended for Software AG 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 Error | Error code relating to job initialization. Code 10 indicates that a parameter was corrected by the system and should be ignored. Other codes are related to errors detected when reading the Adabas Fastpath configuration file. RC shows the Adabas response code received. |
The Local Job Statistics screen can be invoked by selecting option code
S from the Special Services for Local Job
window:
11:19:30 ***** A D A B A S FASTPATH SERVICES 7.4.1 ***** 2002-09-05
- Local Job Statistics - F15310MA
Job: DAEFCODE Type: COM-PLETE Number: C30694 Started: Sep 5,2002 10:02
---------------------------- Optimization Summary --------------------------
Access Type Attempts (100%) <----------Successes (85%)
Read-ahead: 896 (100%) 765 (85%)
Direct: (0%) (0%)
RCs: (0%) (0%)
Excluded: (0%)
Total: 896 (100%) 765 (85%)
------------------------------------------------------------------------------
Memory(k): 368 RA Memory: Over-reads:
Status: 00 1E 00 A0 System Id: DAEFCODE Area Address: 10996664
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12
Help Exit Refr Menu |
This screen is useful when the job is not connected to a 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.
