Version 7.4.4
 —  Getting Started  —

Main Menu Functions

Start of instruction setTo enter Adabas Online System

  1. Log on to the Natural application SYSAOS and enter MENU at the NEXT prompt, if one appears.

    08:10:40         *****  A D A B A S  ONLINE  SYSTEM  *****         2005-11-23
                                    -  Main Menu  -                     PMAIN02
    
    
                 Code  Basic Services                Code  Other Services
                 ----  ----------------------        ----  -------------------
                  A    Session monitoring             1    Cache Services
                  C    Checkpoint maintenance         2    Delta Save Facility
                  F    File maintenance               3    Trigger Maintenance
                  M    Database maintenance           4    AOS Security
                  O    Session opercoms               5    Transaction Manager
                  R    Database report                6    Adabas Statistics
                  S    Space calculation              7    Vista
                  ?    Help                           8    Fastpath
                  .    Exit                           9    SAF Security
                 ----  ----------------------        ----  -------------------
     Code ....... _
     Database ... 105     (RD-105)
    
    
    Command ==>
    PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
    Help               Exit
  2. From the main menu, you can access Basic Services or any Other Service that is installed on your system. Such services are highlighted on the menu.

    The Adabas Online System Main Menu indicates the main DBA tasks within Basic Services:

    Code Function Section
    A Session monitoring functions display nucleus parameters, session statistics, buffer sizes for queues and areas, and maintenance levels Session Monitoring
    C Checkpoint maintenance lists and deletes checkpoint information. Checkpoint Maintenance
    F File maintenance controls Adabas fields (increase or add a field, release a descriptor) and files (define a new file; delete a file; refresh, rename, or renumber a file; allocate file space; change file parameters). It also controls ISN / storage block reuse. File Maintenance
    M Database maintenance controls Adabas database (ASSO/DATA) file and space allocation, DIB blocks, and lets you recover space unused by ABENDed utilities. Database Maintenance
    O Session opercoms control extended error recovery, lock/unlock of files, stop user(s), session termination, and management of online utilities System Operator Command Functions
    R Database report displays tables of "critical" extents, a file's FDT, general and specific file information, VOLSER, and general database information. Database Report
    S Space calculation provides an aid to calculating database ASSO, DATA, sort, temp, and WORK space. Space Calculation

Subsequent sections in this document describe the major Basic Services functions and menu/screen structures in the order that they appear on the Main Menu.


Specifying the Basic Services Database

The database on which Basic Services is installed becomes the default database for Basic Services functions. However, you can specify the database of any active Adabas nucleus session. Subsequent Basic Services functions refer to that database until you specify another database or exit Basic Services.

Top of page

Using Program Function (PF) Keys

Available PF keys and their functions are listed at the bottom of each Basic Services screen. The following program function (PF) keys appear on all Basic Services screens; other navigation keys appear on some screens:

PF1 Help
PF3 Exit to previous screen
PF12 Return to the Adabas Online System main menu

Top of page

Invoking Basic Services Functions

Selecting a Menu Option

Start of instruction setTo select a function or option

  1. Enter the option code in the Code field.

    Selecting a Main Menu function displays a menu of choices for that function.

Entering Commands Directly

Most Basic Services functions can be invoked using direct commands from the command line. The only exceptions are Adabas Online System Security functions.

Each direct command corresponds to a function on a Basic Services menu. You can issue a direct command for a function on a different menu from the one currently displayed. You do not have to leave the current menu to perform a function that is not displayed.

More information about the direct commands is included in the Basic Services Direct Commands, where the direct command equivalent to each menu function is described.

Top of page

Getting Help

Two direct commands that can be issued from any Basic Services menu are ? and help.

Top of page

Basic Services Messages

Basic Services issues a message confirming each completed function. If an error occurs, a message appears containing a reference number and describing the error.

Before analyzing an error

Response code 22 is returned if the Adabas session is terminated and restarted while Basic Services is active. In this case, the application should be stopped and restarted.

Top of page

AOS Demo

In this section a demonstration is shown how AOS is used.

This screen displays the Main Menu. Space calculation as well as Trigger maintenance are not available.

12:53:58          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13
	 
	         Replicator                     -  Main Menu  -                      PMAIN02     

                                                                            

              Code  Basic Services              Code  Other Services 
              ----  ----------------------      ----  ---------------------       
               A    Session monitoring           1    Adabas Cache Facility       
               C    Checkpoint maintenance       2    Delta Save Facility           
               F    File maintenance             *    Trigger Maintenance           
               M    Database maintenance         4    AOS Security                  
               O    Session opercoms             5    Transaction Manager           
               R    Database report              6    Adabas Statistics             
               ?    Help                         8    Fastpath                      
               .    Exit                         9    SAF Security                  
              ----  ----------------------      ----  ---------------------         
                                                                                  
Code ....... _                                                                    
Database ... 1954    (WIS1954)                                                 
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit

This screen displays Session monitoring. You can only select "display parameters", "display installed products" and "display queues".

12:56:58          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                     -  Session Monitoring  -                 PAC0002
												 
												 
Code   Service                         Code   Service                         
----   --------------------------      ----   ----------------------------    
  *     Display cluster members          *     Refresh nucleus statistics      
  *     Maintain user profiles           *     Current resource statistics     
  D     Display parameters               *     Maintain TCP/IP URL             
  I     Display installed products       U     Display resource utilization    
  *     Modify parameters                *     Replicator Management           
  Q     Display queues                   Z     Display maintenance levels      
  ?     Help                                                                   
  .     Exit                                                                   
----   --------------------------      ----   ----------------------------    
                                                                        
Code ......... _                                                     
Database ID .. 1954    (WIS1954)                                       
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Queue Displays. You can only select "Display Hold Queue".

12:59:14          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                       -  Queue Displays  -                   PACQ002
													
													
Code    Service                                         
----    ---------------------------                      
 *      Display User Queue Elements                      
 *      Display Command Queue                            
 H      Display Hold Queue                               
 ?      Help                                             
 .      Exit                                             
----    ---------------------------                      

Code ............... _                                                       
Max No. Elements ... 100                                                     
Last Activity ...... 0         (elapsed time in seconds)                     
Selection Criteria                                                           
ET-ID (User-ID) .. ________     User Type ... ___                             
Job Name ......... ________                                                
Terminal ID ...... ________                                                
Database ID ........ 1954      (WIS1954)                      0              
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit      Clear UID                            Menu

This screen shows Resource Utilization. You can only select "System status" and "Thread usage".

13:05:39          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                    -  Resource Utilization  -                PACU002
												
												
Code  Service                           Code  Service                              
----  -------------------------------   ----  -------------------------------      
 *    Command usage                      S    System status                        
 *    File usage                         T    Thread usage                         
 *    High water marks (pools/queues)    *    WORK status                          
 *    Workpool (LWP) usage               *    Cluster usage                        
 *    Nucleus File Status                *    Display PPT table                    
 *    PLOG status                                                                  
 ?    Help                                                                         
 .    Exit                                                                         
----  -------------------------------   ----  -------------------------------      
                                             
Code ......... _                                                           
File Number .. 0                                                           
Database ID .. 1954   (WIS1954)                                            
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Checkpoint maintenance. You can only select "List checkpoints".

13:10:23          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                    -  Checkpoint Maintenance  -               PCP0002
												

Code    Service                                      
----    -----------------------                       
 C      List checkpoints                              
 *      Delete checkpoints                            
 ?      Help                                          
 .      Exit                                          
----    -----------------------                       
                                                                              
Code ............. _                                                    
Date(YYYY-MM-DD) . 0000-00-00                                           
Ext. CP-list ..... N                                                    
Checkpoint Name .. ALL                                                  
Database ID ...... 1954   (WIS1954)
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows File Maintenance. You can only select "Define/modify FDT".

13:16:44          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                 -  File Maintenance  -                  PFL0002
												
Code    Service                                              
----    ------------------------------                       
 C      Define/modify FDT                                    
 *      Release descriptor                                   
 *      Delete existing file                                 
 *      Define new file                                      
 *      Modify file parameters                               
 *      Reorder file online                                  
 *      Refresh file to empty status                         
 *      Allocate/deallocate file space                       
 *      Maintain expanded files                              
 ?      Help                                                 
 .      Exit                                                 
----    ------------------------------                       

Code ......... _                                                           
File No ...... 0      Descriptor Name .. __                                
Database ID .. 1954   (WIS1954)
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows FDT/SDT Definition / Modification. You can only select "Define new FDT".

13:25:44          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                              -  FDT/SDT Definition / Modification  -          PFLC002
										

Code    Service                                                
----    -----------------------                                
 *      Add new field(s)                                       
 *      Change field parameters                                
 D      Define new FDT                                         
 *      Online invert                                          
 *      Define/add SDT                                         
 ?      Help                                                   
 .      Exit                                                   
----    -----------------------                                

Code ......... _                                                             
File No. ..... 1                                                             
Field Name ... __                                                            
Database ID .. 1954   (WIS1954)
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Database Maintenance, and only shows a list of items available when there is a licensed product installed, no items available in Demo mode.

13:36:07          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                -  Database Maintenance  -                PDM0002


Code    Service                                                
----    ----------------------------                           
 *      Add new dataset to ASSO/DATA                           
 *      Increase/decrease ASSO/DATA                            
 *      List/reset DIB block entries                           
 *      Recover unused space                                   
 *      Uncouple two ADABAS files                              
 ?      Help                                                   
 .      Exit                                                   
----    ----------------------------                           
                                                                                     
Code .......... _                                                             
File No. ...... 1                                                             
Coupled File .. 0                                                             
Database ID ... 1954   (WIS1954)
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Session Opercoms. You can only select "Extended Error Recovery".

13:43:29          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                 -  Session Opercoms  -                 PACI002


Code  Service                           Code  Service                                 
----  ------------------------------    ----  ------------------------------          
 E    Extended Error Recovery            S    Stop user(s)                            
 *    Force CLOG or PLOG switch          T    Termination Commands                    
 L    Lock or unlock files               *    Manage Online Utilities                 
 *    Reset ONLINE-DUMP-Status           *    User Table Maintenance                  
 ?    Help                                                                            
 .    Exit                                                                            
----  ------------------------------    ----  ------------------------------          
                                                                                       
Code ........... _                                                              
Userid(ETID) ... ________                                                       
CLOG/PLOG Ind .. _                                                              
Database ID .... 1954   (WIS1954)
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Extended Error Recovery. You can only select "Add/Delete PIN modules" and "Display/modify PIN routines".

13:50:56          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13
                                  
											-  Extended Error Recovery  -             PACIE02
											 
Code    Service 
----    ----------------------------------
 *      Display message buffer                                   
 *      Display/modify environment                               
 *      Display/modify Exit routines                             
 M      Add/Delete PIN modules                                   
 P      Display/modify PIN routines                              
 *      Refresh threshold and alert exits                        
 *      SNAP a nucleus dump
 ?      Help                                                     
 .      Exit
----    ----------------------------------

Code ........... _                                                               
Start Address .. ________   End Address ... ________
Database ID .... 1954   (WIS1954)
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Lock / Unlock Files. You can only select "Display locked files".

13:50:56          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                -  Lock / Unlock Files  -                 PACIL02

Code    Service
----    ----------------------------------                       
 D      Display locked files                                     
 *      Lock file for all users                                  
 *      Advance lock file                                        
 *      Lock file except for UTI/EXF users                       
 *      Unlock file from general lock                            
 *      Release an advance lock                                  
 *      Unlock file from UTI/EXF lock                            
 ?      Help                                                     
 .      Exit
----    -----------------------------------
 
Code ......... _ 
File Number .. 1
UTI/EXF Ind .. U 
Database ID .. 1954   (WIS1954)
Command ==>

PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Stop Users. Nothing selectable, just shows what is available with a licensed product.

13:58:03          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                   -  Stop Users  -                     PACIS02
                                                                                    
Code  Service                                                    
----  -----------------------                                    
 *    Stop users using file                                      
 *    Stop inactive users                                        
 *    Stop users by jobname                                      
 *    Stop a selected user                                       
 ?    Help                                                       
 .    Exit                                                       
----  -----------------------                                    

Code ............. _                                                               
File Number ...... 1____                                                           
Last Activity .... ________  (elapsed time in seconds)
Job Name ......... ________
Purge UQE(s) ..... N
Selected Userid ..

Database ID ...... 1954     (WIS1954)
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

This screen shows Session Termination. Only Normal session termination available.

14:06:27          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                -  Session Termination  -                PACT002

Code    Service                                                 
----    -----------------------------------                     
 A      Normal session termination (ADAEND)                     
 *      Cancel session immediately (CANCEL)                     
 *      Stop session               (HALT)                       
 ?      Help                                                    
 .      Exit                                                    
----    -----------------------------------                     

Code ......... _                                                              
Database ID .. 1954   (WIS1954)
Current nr. of users in User Queue ... 1
Nr. of users with open transactions .. 0

This screen shows Database Report. You can only select "Display files" {only will show "system" files, i.e., Checkpoint }, and "General database layout".

14:06:27          ***** A D A B A S  BASIC  SERVICES *****          2006-03-13

                                -  Database Report  -                  PDR0002
									  
Code    Service                                               
----    -------------------------------------                 
 *      List files with crit. no. of extents                  
 *      Display field description table (FDT)                 
 F      Display file(s)                                       
 G      General database layout                               
 *      List VOLSER distribution of database                  
 *      Display ASSO/DATA block (RABN)                        
 *      Display unused storage                                
 ?      Help                                                  
 .      Exit                                                  
----    -------------------------------------                 

Code ......... _                                                            
File No ...... 1_____ Password ..                                           
Database ID .. 1954   (WIS1954)                                             
VOLSER ....... ______                            
Command ==>
PF1----- PF2------ PF3------ PF4------ PF6----- PF7----- PF8----- PF12-----
Help               Exit                                           Menu

Note:
Option F will display system files only.

Top of page