SYSEXV Utility

The SYSEXV utility provides example programs that demonstrate the use of Natural features introduced in the current or a previous version of Natural.

This section describes the character user interface of SYSEXV. For information on the rich GUI interface of SYSEXV, refer to NaturalONE > Using NaturalONE > Using Natural Tools and Utilities > Rich GUI Interface of SYSEXV.

All example programs are available as source objects. You can obtain detailed descriptions of the functionality by executing the programs.

This document covers the following topics:


Invoking and Terminating SYSEXV

Start of instruction setTo invoke SYSEXV

  • Enter the following system command:

    SYSEXV

    The SYSEXV main menu is displayed:

     16:08:04             ***** NATURAL SYSEXV UTILITY *****              2026-08-12
     User LHU           - Show Features of Natural Versions -       Library SYSEXV  
                    
                    
     The SYSEXV utility provides example programs that demonstrate the use of       
     Natural features introduced in the current or previous versions of Natural.
     Examples for dialog features are also included.
                    
                    
                    
      _  Category selection                                                         
      _  Version selection                                                          
      _  Member selection                                                           
      _  Help                                                                       
      _  Exit                                                                       
                    
                    
                    
                    
                    
     Search: ___________________________                                            
                    
     Command ===>                                                                   
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  Categ Vers                          Membr       Canc   

The example programs can be grouped by Category or Version, or listed alphabetically by Member names.

Start of instruction setTo terminate SYSEXV

  1. In the SYSEXV main menu, mark the Exit line.

    Or:
    Press PF3 or enter Exit or a period (.) in the command line.

    Or:
    Enter a period (.) as line command.

  2. In any screen, press PF12 or enter Canc in the command line.

Invoking and Terminating Sub-menus and Example Programs

Start of instruction setTo invoke a sub-menu or example program

  • Mark the corresponding line with any character. Do not use a character with a special meaning as listed in the SYSEXV Line Commands section.

    If multiple lines are marked, they are processed one after the other.

    If no line is marked and the cursor is on an entry line, the corresponding entry is processed.

Start of instruction setTo exit a sub-menu

  • Press PF3 or enter Exit or a period (.) in the command line.

    Or:
    Enter a period (.) as line command.

    The previous screen is displayed. If multiple entries had been marked on that screen, the next entry is processed.

Start of instruction setTo exit an example program

  • Press PF3.

    Exits the current screen and returns to the previous screen. If multiple entries have been marked on that screen, the next entry is processed.

Start of instruction setTo exit an example dialog

  • Click OK or close the window.

    Exits the dialog and returns to the SYSEXV main menu.

Search Field

You can specify a search string in the Search field on each selection (Main menu, Category, Version, Member selection) so that only the example programs containing the string in the member’s name, version, category, or description are displayed.

SYSEXV PF Keys

You can use the following PF keys:

PF Key Name Function
PF1 Help Display the SYSEXV help information.
PF2 Menu Clear all selection fields and return to the Main menu.
PF3 Exit Exit the current menu or example program.
PF4 Categ Display the Category selection.
PF5 Vers Display the Version selection.
PF6 -- Scroll to the beginning of the list.
PF7 - Scroll one page up.
PF8 + Scroll one page down.
PF9 ++ Scroll to the end of the list.
PF10 Membr Display the Member selection.
PF12 Canc Cancel the SYSEXV utility.

If the name of a PF key is entered in the command line, the corresponding function is performed.

SYSEXV Line Commands

The following line commands are available:

Line Command Function
Any (none of the others) Invoke a sub-menu or start an example program.
I

The following information about the example is displayed:

  • the example member name,
  • the version in which the corresponding functionality was introduced,
  • a short description of the functionality,
  • the categories to which the example member belongs.
? Display the SYSEXV help screens.
. Exit the current menu.

Category Selection

Each example is assigned to one or more categories. By default, the Category Selection screen displays all categories.

 16:33:15             ***** NATURAL SYSEXV UTILITY *****              2026-08-14
 User LHU                   - Category Selection -              Library SYSEXV  
        
  _  Array                                                                      
  _  Database                                                                   
  _  Date and Time                                                              
  _  Dialog Feature                                                             
  _  Edit Mask                                                                  
  _  Error                                                                      
  _  Function and Subprogram                                                    
  _  Input and Output                                                           
  _  Internet and XML                                                           
  _  Server                                                                     
  _  Session Parameter                                                          
  _  Statement Enhancement                                                      
  _  String Handling                                                            
  _  System Function                                                            
  _  System Variable                                                            
        
 Search: ___________________________                                            
        
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit  Categ Vers  --    -     +     ++    Membr       Canc   

Mark a category to list the example programs belonging to the category, for example the Statement Enhancement category:

 16:01:28             ***** NATURAL SYSEXV UTILITY *****              2026-08-14
 User LHU            - Category: Statement Enhancement -        Library SYSEXV  
        
  _  Arrays for replacements in EXAMINE statement                   V6-EXAM2    
  _  Direction and position clause in EXAMINE statement             V6-EXAM1    
  _  Enhanced COMPRESS with spacer element                          V934CMPR    
  _  Enhanced MOVE EDITED with wildcard character                   V934MVED    
  _  Unicode EMU edit mask, display parameters ICU, LCU and TCU     V62UPARM    
        
        
        
        
        
        
        
        
        
        
        
 Search: ___________________________                                            
        
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---   

Select a line to execute the corresponding example program.

Version Selection

Each example program belongs to the version in which the functionality was introduced. By default, the Version Selection screen displays all versions, with the newest version listed first.

 16:02:36             ***** NATURAL SYSEXV UTILITY *****              2026-08-14
 User LHU                   - Version Selection -               Library SYSEXV  
        
  _  Natural Version 9.3.4                                                      
  _  Natural Version 9.3.3                                                      
  _  Natural Version 9.3.1                                                      
  _  Natural Version 9.1.1                                                      
  _  Natural Version 8.4.1                                                      
  _  Natural Version 6.3.7                                                      
  _  Natural Version 6.2                                                        
  _  Natural Version 6.1                                                        
  _  Natural Version 5.1                                                        
  _  Natural Version 4.1                                                        
  _  Natural Version 3.1                                                        
        
        
        
        
        
 Search: ___________________________                                            
        
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit  Categ Vers  --    -     +     ++    Membr       Canc   

Mark a version to list the example programs belonging to the version, for example Natural Version 9.3.4:

 16:03:23             ***** NATURAL SYSEXV UTILITY *****              2026-08-14
 User LHU                 - Natural Version 9.3.4 -             Library SYSEXV  
        
  _  Enhanced COMPRESS with spacer element                          V934CMPR    
  _  Enhanced hexadecimal constants                                 V934HXNW    
  _  Enhanced MOVE EDITED with wildcard character                   V934MVED    
  _  System variable *CPU-TIMEX                                     V934CPUX    
        
        
        
        
        
        
        
        
        
        
        
        
 Search: ___________________________                                            
        
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit  Categ Vers  --    -     +     ++    Membr       Canc   

Select a line to execute the corresponding example program.

Member Selection

The Member Selection screen displays a list of example programs in alphabetical order by member names.

 16:36:01             ***** NATURAL SYSEXV UTILITY *****              2026-08-14
 User LHU                    - Member Selection -               Library SYSEXV  
        
  _  SYSWIZDW   Start dialog wizard...                                          
  _  V3-CMPMI   Option (PM=I) in COMPRESS and MOVE statement                    
  _  V3-CMPR1   COMPRESS option FULL                                            
  _  V3-CMPR2   COMPRESS option NUMERIC                                         
  _  V3-CMPR3   COMPRESS option ALL                                             
  _  V3-CMPR4   COMPRESS option SUBSTRING                                       
  _  V3-ERR     Error information with API USR2006N                             
  _  V3-MASK    Character / in MASK option                                      
  _  V3-MOVE    MOVE option RIGHT JUSTIFIED                                     
  _  V3-RDESC   READ option DESCENDING                                          
  _  V3-RISN    READ option STARTING WITH ISN                                   
  _  V3-RVAR    READ option VARIABLE SEQUENCE                                   
  _  V3-VAR     System variables *SCREEN-IO, *SERVER-TYPE, *NET-USER            
  _  V3-WRITE   Time variables in WRITE or DISPLAY statement                    
  _  V3-YDF     Year 2000, MOVE with field parameter DF                         
        
 Search: ___________________________                                            
        
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit  Categ Vers  --    -     +     ++    Membr       Canc  

Select a line to execute the corresponding example program or dialog.