SYSEDT Utility - Editor Buffer Pool Administration

The SYSEDT utility provides administration functions for the editor buffer pool, which is a data container for the Software AG editor. The SYSEDT utility can be used for the following:

Displaying parameters and runtime information of the editor buffer pool.
Modifying parameters that control and initialize the editor buffer pool and its work file.
Deleting logical work files and recovery files.

The SYSEDT Utility - Editor Buffer Pool Administration documentation is associated with the following documentation:

Operations: Operating the Software AG Editor
Parameter Reference: EDBP - Software AG Editor Buffer Pool Definitions

This documentation is organized under the following headings:

Defining a Natural Security Library Profile
Invoking SYSEDT and Executing a Function
General Information
Generation Parameters
Users
Logical Files
Recovery Files
Administration Facilities
Help on Direct Commands and Menu Functions

Defining a Natural Security Library Profile

If you have Natural Security installed, you must create a library security profile for the SYSEDT utility.

For details, see Library Maintenance described in the Natural Security documentation.

Invoking SYSEDT and Executing a Function

This section provides instructions for invoking the SYSEDT utility and executing a SYSEDT utility function.

To invoke the SYSEDT utility

Issue the following Natural system command:

SYSEDT

A SYSEDT Main Menu similar to the example below appears:

 15:47:50             ***** NATURAL SYSEDT UTILITY *****             2009-01-29
 User MMO                       - Main Menu -                    TID 1     33  
                                                                               
                                                                               
                                                                               
                    Code   Function                                            
                                                                               
                      G    General Information                                 
                      P    Generation Parameters                               
                      U    Users                                               
                      F    Logical Files                                       
                      R    Recovery Files                                      
                      A    Administration Facilities                           
                      .    Exit                                                
                                                                               
             Code ..                                                           
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Cont  Help  Menu  Exit        Admin Files Users Recov       GInfo Parms Canc

The functions available in the menu are explained in the following sections.

To execute a SYSEDT function

In the Code field of the SYSEDT Main Menu, enter the one-character code that corresponds to the function you want to execute and press ENTER. For example:
```
G
```
Executes the General Information function.

Or:
In the SYSEDT Main Menu, press the PF key that corresponds to the function you want to execute. For example:

PF10 (GInfo)

Executes the General Information function.

Or:
Issue the SYSEDT system command followed by any function code available in the SYSEDT Main Menu. For example:
```
SYSEDT G
```
Executes the General Information function.

For a list of all SYSERR direct commands available, use the help function described in Help on Direct Commands and Menu Functions.

General Information

This function invokes the General Information screen which provides an overview of the current status of the editor buffer pool. The fields contained on the screen are described in the following table. For detailed information on these fields, see Editor Work File and Editor Buffer Pool in the Operations documentation.

Field		Explanation
Usage Statistics		The currently available total number, the currently used number, and the currently used percentage of the available number of the items that follow.
Buffer Pool Blocks		The number of blocks in the editor buffer pool. See also Obtaining Free Blocks.*
Work File Records		The number of records in the editor work file. See also Editor Work File.*
Control		The number of control records, which is always one. See also Control Record.*
Work		The number of work records. See also Work Record .*
Recovery		The number of recovery records. See also Recovery Records.*
Logical Files		The number of logical files.
Requests		The total number of read and write requests, the number of read and write requests for buffer pool blocks (Pool column), and the number of read and write requests for work or recovery files (File column). The Copy column shows read requests, which (in contrast to locked read requests) result in the deletion of the corresponding buffer pool block.
Read Work		The number of read requests for logical file records. A logical file record can be found in the buffer pool (Pool column) or on the work file (File column). It can be read by a locked or by a copy request: locked means that the record is kept in the buffer pool for some time; copy means that it is deleted from the buffer pool after having been read.
Write Work		The number of write requests for logical file records. A record can be either written to the buffer pool (Pool) or moved to the work file (File) if there are no free blocks available.
Read Recovery		The number of read requests for recovery records in the editor work file.
Write Recovery		The number of write requests for recovery records in the editor work file.
Timeout Values in Seconds		Items with timeout values specified in seconds. These timeout values can be modified after pressing PF5 (Updat) and dynamically set after pressing PF5 (Save) again. The modified values are not kept during a restart of the buffer pool. The values from the work file control record are used instead. See also Obtaining Free Blocks.*
Logical Files		The time after which a logical file is deleted if it has not been accessed during this time.
Files Delete Check		The time after which all logical files are checked periodically whether they can be deleted.
Changed Blocks		The time after which blocks that have been modified can be freed by writing them to the work file.
Unchanged Blocks		The time after which blocks that have not been modified can be freed by writing them to the work file.
Locked Blocks		The time after which blocks that have been read with locked can be freed by writing them to the work file.

* described in the Operations documentation

Generation Parameters

This function invokes the Generation Parameters screen where you can view and change the current parameter settings of the editor buffer pool:

Parameter	Explanation
`DDNAME`	The name of the editor work file for the JCL definition.
`DSNAME`	The name of the work file data set (file). This parameter is not displayed in a Com-plete or z/VSE batch environment.
`RECNUM`	The total number of work file records.
`LRECL`	The work file record length.
`PWORK`	The percentage of work file records used as work records.
`RWORK`	The percentage of work records for regular logical files.
`MAXLF`	The maximum number of logical files in the editor buffer pool.
`FTOUT`	The timeout value (in seconds) for a logical file, which has not been accessed, to be deleted.
`DTOUT`	The period of time (in seconds) for logical files to be checked for deletion.
`CTOUT`	The timeout value (in seconds) for changed buffer pool blocks.
`UTOUT`	The timeout value (in seconds) for unchanged buffer pool blocks.
`LTOUT`	The timeout value (seconds) for locked buffer pool blocks.
`ITOUT`	The timeout value (in seconds) for the buffer pool initialization.

The parameters above are keyword subparameters of the EDBP profile parameter (or corresponding NTEDBP macro), which is used to define the initial editor buffer pool settings. For detailed information on EDBP and all keyword subparameters available, see EDBP - Software AG Editor Buffer Pool Definitions in the Parameter Reference documentation.

The Start column on the Generation Parameters screen refers to the buffer pool restart (see also Initializing the Editor Buffer Pool in the Operations documentation). The following start values can be displayed for the parameters:

Value	Explanation
`L`	The value for the corresponding parameter is taken from either the editor parameter module or the work file definition.
`C`	A modification of the corresponding parameter value forces a buffer pool cold start. Recovery records are lost.
`W`	A modification of the corresponding parameter value results in a buffer pool warm start. Recovery records are kept.

To modify parameter values

On the Generation Parameters screen, press PF5 (Updat).

The write-protected fields next to the parameters change to input fields.
Replace the parameter value(s) required and press PF5 (Save) to save the new values in the control record of the editor work file. They will be activated when the editor buffer pool is started again.

If you change the value of PWORK, a window prompts you to confirm the cold start of the editor work file. Enter YES to confirm the new parameter value and to execute a buffer pool cold start for the work file initialization. (Any other entry or no entry resets the parameter to its previous value.)

Users

This function invokes the Users screen which provides the following information:

Column	Explanation
User ID	The Natural user ID.
Logical Files	The number of logical files defined per user.
Pool Blocks	The number of buffer pool blocks per user.
Work Records	The number of work records per user.
Recovery Files	The number of recovery files per user.
Recovery Records	The number of recovery records per user.

For each user listed, you can execute one of the following line commands. You enter a line command in the C column, next to the user required.

Line Command	Explanation
`?` or `*`	Opens a window with a list of all valid line commands and corresponding PF keys, if available.
`.`	Exits the current screen and returns to the previous screen.
`/` or `P`	Positions the line to the top of the screen.
`F`	Selects the logical files of this user.
`R`	Selects the recovery files of this user.
`D`	Deletes all logical files and/or recovery files for this user.

Logical Files

This function invokes the Logical Files screen which provides the following information:

Column	Explanation
File No.	The logical file number.
User ID	The Natural user ID.
Type	The logical file type.
Pool Blks	The number of buffer pool blocks currently used per logical file.
File Recs	The number of work file records currently allocated per logical file.
Last Access	The date and time of the last read or write request per logical file.

For each logical file listed, you can execute one of the following line commands. You enter a line command in the C column, next to the user required.

Line Command	Explanation
`?` or `*`	Opens a window with a list of all valid line commands and corresponding PF keys, if available.
`.`	Exits the current screen and returns to the previous screen.
`/` or `P`	Positions the line to the top of the screen.
`S`	Selects the logical files of this user.
`D`	Deletes the logical file.

Recovery Files

This function invokes the Recovery Files screen which provides the following information:

Column	Explanation
User ID	The Natural user ID.
Member	The library member name.
Library	The library name.
Type	The library type.
Recs	The number of recovery records per recovery file.
Creation Date	The creation date of the recovery file.
Creation Time	The creation time of the recovery file.

For each recovery file listed, you can execute one of the following line commands. You enter a line command in the C column, next to the user required.

Line Command	Explanation
`?` or `*`	Opens a window with a list of all valid line commands and corresponding PF keys, if available.
`.`	Exits the current screen and returns to the previous screen.
`/` or `P`	Positions the line to the top of the screen.
`S`	Selects the recovery files of this user.
`D`	Deletes the recovery file.

Administration Facilities

This function invokes the Administration Facilities screen which can be used to terminate the editor buffer pool or the SYSEDT utility, or display the editor buffer pool in dump (hexadecimal) format for problem diagnosis.

To use the Administration Facilities screen

Terminate the editor buffer pool, by entering function code T.

A window prompts you for confirmation:
- If you enter YES, an additional window opens, asking you whether or not you want the editor buffer pool to be immediately restarted.
  
  If you enter YES again, the buffer pool is immediately restarted, which gives you the possibility to immediately activate modified generation parameters.
  
  If you enter NO, you leave SYSEDT and can perform actions outside your TP environment, for example, change the size of your editor work file.
Or:
Display the storage dump of the editor buffer pool, by entering function code D.

The offsets and addresses of the editor buffer pool are displayed on the screen.

If required, press PF10 (RelO) to position offset 00000000 to the top of the screen. PF1 (Help) invokes a list of all PF keys available.

Or:
Return to the SYSEDT Main Menu by entering a period (.).

Help on Direct Commands and Menu Functions

You can obtain online help information on all SYSEDT direct commands available or on the function currently used.

To view all SYSEDT direct commands

In the command line of any SYSEDT utility screen, enter one of the following characters:
```
?
```
or
```
*
```
All direct commands available within the SYSEDT utility are listed in alphabetical order.

To view help on a specific SYSEDT function

In the command line of a SYSEDT utility screen invoked by a SYSEDT utility function, enter the following:
```
H
```
Or:
Press PF1 (Help).

Help information on the fields and columns contained on the current SYSEDT utility screen is displayed.