Buffer Operation and Reporting (AFPCMD)

The AFPCMD tool provides operation and reporting functions for the Adabas Fastpath buffer. AFPCMD can be invoked online using Adabas Fastpath Online Services or it can be invoked using Natural in batch mode.

• Using AFPCMD in Batch Mode

• Using AFPCMD in Online Mode

• Commands

• Objects

• Keywords

• LIST Command

• DISPLAY Command

• STOP/START/RESTART Commands

• PARMS Command

• AFPCMD Summary

Using AFPCMD in Batch Mode

In a batch Natural environment

• use AFPCMD as the program name;

• define the Natural printer CMPRT01; and

• execute the utility from the required SYSMWvrs library.

The syntax of the AFPCMD service commands is as follows:

Each line of input to the Natural batch program must contain at least a command and object.

Keywords may or may not be required depending on the particular command/object combination. The required and permissible combinations are defined later in this section.

The commands, objects, and keywords may be entered in any order. Extra, unnecessary keywords are listed with a warning but are ignored. Missing keywords are listed and the command is not executed.

Using AFPCMD in Online Mode

In online mode, AFPCMD can be invoked by:

• selecting option 4 from the Online Services Main Menu, or

• by entering the command 4 on any screen command line, or

• by entering AFPCMD on any screen command line.

The Online Printing Facility screen will appear:

11:14:31     ***** A D A B A S   FASTPATH SERVICES 8.1.1 *****      2006-05-19
                     -  On-Line Printing Facility  -                 F14000MA

 Please enter the following to specify the required report:

  Command: __________  DISPLAY, LIST, PARMS

  Objects: __________  BUFFER, JOB, AFPLOOK, TRACE, DATABASE, FILE, SUMMARY, SET
                       or ALL

 Keywords: _____________________________________________________________________
            (Press Enter to be prompted for the appropriate keywords)

  Printer: ________
  PC          for download via NATURAL CONNECTION to a PC printer or file.
  SOURCE      for output to the NATURAL source area.
  CONNECT     for output into a CON-NECT folder.
  Valid Name  known to COMPLETE, NAF or any spooling system



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

Online Printing Facility

You must enter a valid command, object, keywords and printer.

You can either enter the keywords or repeatedly press the Enter key to be prompted for keywords one at a time. When all keywords are valid, the function is executed and control is returned to this screen.

Commands

The following commands can be used to:

• communicate with the Adabas Fastpath buffer:

  STOP	Stop optimization for the selected object.
  START	Restart optimization for an object.
  RESTART	Stop and restart the Adabas Fastpath buffer.

• print information from the current Adabas Fastpath buffer:

  LIST	List a single line for each object.
  DISPLAY	Print full details for each object.

• print parameter information from the configuration file:

  PARMS

  Print full parameter details from the Adabas Fastpath configuration file.

Objects

The following objects are listed for selection:

Keywords

The following keywords are available:

LIST Command

The LIST command is used to obtain (from either the buffer identified by NODE or the currently accessible buffer) summary information (only) for the particular objects selected. Depending upon the object, keywords may be used to specifically identify or restrict the information to be listed.

DISPLAY Command

DISPLAY AFPLOOK requires the database number in DBID=. This is the only situation where ALL is not permitted.

STOP/START/RESTART Commands

The STOP and RESTART/START commands issue a request to the Adabas Fastpath buffer manager. All stop/start processing occurs in an orderly manner without affecting the status of the object in Adabas.

Once the STOP BUFFER command is accepted, 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.

RESTART BUFFER initiates the stop process. After successful completion of the stop process, buffer initialization is started.

ALL may be entered for any parameters. ALL should be used with caution since this may stop optimization for any number of objects.

PARMS Command

The PARMS command can be used to display the Adabas Fastpath parameters for the object selected.

AFPCMD Summary

The following table lists all AFPCMD command, options, and keyword combinations, together with the Natural program that performs the function.

Natural Security can be applied as required.