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:
To 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.
_ 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.
To terminate SYSEXV
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.
In any screen, press PF12 or enter Canc in the command
line.
To 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.
To 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.
To 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.
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.
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.
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:
|
? |
Display the SYSEXV help screens. |
. |
Exit the current menu. |
Each example is assigned to one or more categories. By default, the Category Selection screen displays all categories.
16:09:14 ***** NATURAL SYSEXV UTILITY ***** 2026-08-12
User LHU - Category Selection - Library SYSEXV
_ Array
_ Database
_ Date and Time
_ Debug and Test
_ 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:10:30 ***** NATURAL SYSEXV UTILITY ***** 2026-08-12
User LHU - Category: Statement Enhancement - Library SYSEXV
_ Arithmetic expressions in FOR statement V82FOR
_ Arrays for replacements(n:m) in EXAMINE statement V82EXAM2
_ Comparators in READ and HISTOGRAM statement V4-COMP
_ Direction and position clause in EXAMINE statement V82EXAM1
_ Enhanced COMPRESS with spacer element V925CMPR
_ Enhanced MOVE EDITED with wildcard character V925MVED
_ ESCAPE MODULE for inline subroutines V4-ESC
_ Extended precision of results for arithmetic operations V82EXPRE
_ MARK option with CV variable in REINPUT statement V82REINP
_ Option REPOSITION in READ and ESCAPE TOP REPOSITION V4-REPO
_ STARTING FROM and REMAINDER POSITION in SEPARATE statement V823SEPA
_ SUBSTRING clause in DECIDE ON statement V82DECON
_ SUBSTRING clause in MOVE ALL statement V82MOVAL
_ Unicode (step 7) MOVE ENCODED V42UENC
_ Unicode (step 8) MOVE NORMALIZED V42UNORM
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.
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:11:34 ***** NATURAL SYSEXV UTILITY ***** 2026-08-12
User LHU - Version Selection - Library SYSEXV
_ Natural Version 9.2.5
_ Natural Version 9.2.4
_ Natural Version 9.2.1
_ Natural Version 9.1.1
_ Natural Version 8.2.4
_ Natural Version 8.2.3
_ Natural Version 8.2
_ Natural Version 4.2.6
_ Natural Version 4.2
_ Natural Version 4.1
_ Natural Version 3.1
_ Natural Version 2.3
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.2.5:
16:12:43 ***** NATURAL SYSEXV UTILITY ***** 2026-08-12
User LHU - Natural Version 9.2.5 - Library SYSEXV
_ Enhanced COMPRESS with spacer element V925CMPR
_ Enhanced hexadecimal constants V925HXNW
_ Enhanced MOVE EDITED with wildcard character V925MVED
_ System variable *CPU-TIMEX V925CPUX
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.
The Member Selection screen displays a list of example programs in alphabetical order by member names.
14:58:57 ***** NATURAL SYSEXV UTILITY ***** 2026-08-12
User LHU - Member Selection - Library SYSEXV
_ V2-CMPMI Option (PM=I) in COMPRESS and MOVE statement
_ V2-CMPR1 COMPRESS option FULL
_ V2-CMPR2 COMPRESS option NUMERIC
_ V2-CMPR3 COMPRESS option ALL
_ V2-CMPR4 COMPRESS option SUBSTRING
_ V2-ERR Error information with API USR2006N
_ V2-MASK Character '/' in MASK option
_ V2-MOVE MOVE option RIGHT JUSTIFIED
_ V2-RDESC READ option DESCENDING
_ V2-RISN READ option STARTING WITH ISN
_ V2-RVAR READ option VARIABLE SEQUENCE
_ V2-VAR Environment and date related system variables
_ V2-WRITE Time variables in WRITE or DISPLAY statement
_ V2-YDF Year 2000, MOVE with field parameter DF
_ V2-YDFOU Year 2000, INPUT with session parameter DFOUT
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.
