New features in Reality V15.6
Reality V15.6 contains enhancements to a number of features since the release of V15.5.
If you find any errors or have any suggestions for improvements in this documentation, please contact your NEC help desk.
Note
The online documentation includes all the updates till fix version V15.1.0.0457.
LIST-DBASE-INDEXES
This command runs within the SYSMAN account and displays all indexes present across the database.
Syntax
LIST-DBASE-INDEXES
Example 1
The following example illustrates the output of using the command when there are no indexes in the database:
: LIST-DBASE-INDEXES NO INDEXES EXIST
Example 2
The following example illustrates the output of using the command when there are multiple indexes in the database:
: LIST-DBASE-INDEXES Indexes in'/TEST' Page 1 File Data Section Index name Status Definition TT TT INDEX1 ok Explicit index, BY A1 BY A2 INDEX2 ok Explicit index, BY A1 BY A2 INDEX3 ok Explicit index, BY A1 BY A2 [2100] 3 indexes, no errors.
RCEDIT
RCEDIT simplifies the realityrc file configuration management. Using RCEDIT brings up a user-friendly input screen prompting for display, add/update, and removal of configurable settings in the $REALROOT/files/realityrc file.
Syntax
RCEDIT
Example
:RCEDIT When prompted for the editor type (SE/ED), enter your choice. ED will drop into the Reality line editor whilst SE will use the Reality Screen editor Enter editor type (SE/ED) ?ED
Information may be added, updated or deleted using the SE or ED editor.
For details on editor functionality, please refer to the Reality Editors section in the online documentation.
Note
To ensure the changes take effect, a killreal or realstart should be issued otherwise only the new connections will use any amended settings.
RSZ.AUTO
Incorrectly sized files can lead to performance bottlenecks, instability, or system inefficiencies within the Reality environment.
RSZ.AUTO does not resize files but it updates all the file sizing parameters that will be applied on the next restore.
Syntax
RSZ.AUTO
Prompt
4 prompts appear when using RSZ.AUTO.
AUTO FILE RESIZER ~~~~~~~~~~~~~~~ U)pdate Run or (R)eport Only? R Minimum Percentage to Resize Undersize Files? (1-100) :10 Port No. of Last File-Save? 401 Account Name to Resize or 'ALL' ALL
Prompt 1 should be U or R. Using R causes a report to be added to the spooler while using U also creates a report but file dictionary items (attribute 13) will be updated with parameters to be applied on the next restore.
Prompt 2 should be a number 1 – 100. This is the additional space that is to be added to a file to allow growth.
Prompt 3 should be the port number of a recent F-S or ALL-FILE-STATS, as the program will make use of STATFILE, PORTXXX.
Prompt 4 should be ALL or a single account name.
.
Example
RSZ.AUTO with report only.
:RSZ.AUTO AUTO FILE RESIZER ~~~~~~~~~~~~~~~ (U)pdate Run or (R)eport Only? R Minimum Percentage to Resize Undersize Files? (1-100) :20 Port No. of Last File-Save? 401 Account Name to Resize or 'ALL' ALL Selecting SYSTEM Auto File Resizer Update Report is now available in Spooler :
Following is the result at spooler:
09:24:50 25 Jun 2025 16 Print Jobs Page 2/ 2 Job-Id Queue Name Port Status User Job Created CP OP Size Prtd 12 STANDARD 401 Queued realman 02 Jun 15:16 1 1 0 13 STANDARD 401 Queued realman 02 Jun 15:16 1 1 0 14 STANDARD 401 Queued realman 03 Jun 14:43 1 6 0 15 STANDARD 401 Queued realman 03 Jun 14:45 1 1 0 16 STANDARD 401 Queued realman 25 Jun 09:23 1 6 0 Job list - >16 Print Job Id - 16 Top .P Select STAT-FILE,PORT401 WITH *A1 = "BASIC.CONVERSION*]" 9 Items selected. /BASIC.CONVERSION/MD 57 53 /BASIC.CONVERSION/PRIOR.PF,PRIOR.PF 51 53 /BASIC.CONVERSION/PRIOR.OBJ,PRIOR.OBJ 51 53 /BASIC.CONVERSION/CONVERTER.LOG,XLATE 7 3 Select STAT-FILE,PORT401 WITH *A1 = "DENAT*]" 7 Items selected. /DENAT/MD 11 53 /DENAT/BP,BP 11 1 /DENAT/ENGLISH,ENGLISH 5 13 /DENAT/UTILITY.MSGS,UTILITY.MSGS 7 5 Select STAT-FILE,PORT401 WITH *A1 = "ENGLISH-TUTORIAL*]" 1 Items selected. /ENGLISH-TUTORIAL/MD 29 53 Select STAT-FILE,PORT401 WITH *A1 = "GLOBAL.MD*]" 1 Items selected. /GLOBAL.MD/MD 101 53 EOI
DLOG
DLOG is a cross-platform utility designed to help the users easily view the contents of the daemon.log file from their Reality environment, without needing to use Unix-style commands.
The utility displays the most recent 200 lines of the log for the active instance, using a paging mechanism that shows 20 lines at a time with a prompt to press Enter to continue.
If fewer than 200 lines are found in the current log, DLOG will automatically read from older log files to complete the view. The utility works seamlessly across all supported operating systems.
Syntax
DLOG
Example
:DLOG
Result:
Total lines in file: 2994 Reading the last 200 lines starting from line 2795 -------------------------------- Jun 23 19:46:26 #7284 realdr DEBUG: Async:6596 Message code 0404 Jun 23 19:46:26 #7424 realcd DEBUG: kill pid 1624, signal 0 Jun 23 19:46:26 #21980 realdd[0] DEBUG: Async:1624 Message code 0404 Jun 23 19:46:26 #7424 realcd DEBUG: Async:7428 Message code 0407 Jun 23 19:46:28 #7284 realdr DEBUG: RnwsAccept failed 32020 Jun 23 19:46:28 #7284 realdr DEBUG: Waiting for connection on port 1210 Jun 23 19:46:33 #7284 realdr DEBUG: RnwsAccept failed 32020 Jun 23 19:46:33 #7284 realdr DEBUG: Waiting for connection on port 1210 Jun 23 19:46:38 #7284 realdr DEBUG: RnwsAccept failed 32020 Jun 23 19:46:38 #7284 realdr DEBUG: Waiting for connection on port 1210 Jun 23 19:46:39 #21980 realdd[0] DEBUG: Vectoring mod 1 fun 8 Jun 23 19:46:39 #7424 realcd DEBUG: Async:7428 Message code 0406 Jun 23 19:46:39 #21980 realdd[0] DEBUG: Async:1624 Message code 0407 Jun 23 19:46:39 #7424 realcd DEBUG: Vectoring mod 1 fun 13 Jun 23 19:46:43 #7284 realdr DEBUG: RnwsAccept failed 32020 Jun 23 19:46:43 #7284 realdr DEBUG: Waiting for connection on port 1210 Jun 23 19:46:43 #7424 realcd DEBUG: Vectoring mod 1 fun 8 Jun 23 19:46:43 #7424 realcd DEBUG: kill pid 6596, signal 0 Jun 23 19:46:43 #7284 realdr DEBUG: Async:6596 Message code 0404 Jun 23 19:46:43 #7424 realcd DEBUG: kill pid 1624, signal 0 Press Enter to continue...
EDITDBCONFIG
EDITDBCONFIG simplifies the database config file configuration and management. Using EDITDBCONFIG displays a user-friendly input or display screen which enables the use of the Reality line editor or the Reality screen editor for amendment of the database config file.
Syntax
EDITDBCONFIG
Example
:EDITDBCONFIG
Enter your choice.
Enter (D to display config file) or (E to edit config file): ?E
Enter your choice for editor type (SE or ED):
Enter editor type (SE/ED): ?ED
Note
To ensure the changes take effect, a killreal/realstart or realserv –e/realserv -s is essential.
PFSEARCH
PFSEARCH prompts you to enter a fragment of the file name (for example, AUDIT).
It generates an active list and display all matching files containing the input string, such as TEST.AUDIT or AUDIT.TEST, regardless of the position of the phrase within the filename.
Note
The partial filename is always converted to uppercase for fetching the matching file names, so entering Eng does not locate files with mixed case names such as Eng.file.
Syntax
PFSEARCH
Example
:PFSEARCH Enter partial file name to Search: ?Eng File definition items in account: DENAT Page 1 File name Type Ftype Mod Details Just Len ENGLISH DL B2 1 1 L 10 ENGLISH DL B3 5 1 L 10
LISTDB
Using the listdb command displays the list of databases sorted first by Instance Name, followed by Database Name. It provides a structured and intuitive output, grouped by instance for better clarity and management.
Syntax
listdb -a
Example
The following example illustrates that using this command lists all the databases.
# listdb -a ace|/export/home/dbases/ace|V15.1.0.0446|1|NA;N;Standalone|realman|notlocked| delaccnew|/export/home/dbases/delaccnew|T15.1.0.0446|1|NA;N;Standalone|realman|notlocked| train|/export/home/dbases/train|V15.1.0.0446|1|NA;N;Standalone|realman|notlocked| clone3|/export/home/dbases/clone3|V15.1.0.0446|1|NA;N;Standalone|realman|notlocked| delacc1|/realman/delacc1|V15.1.0.0446|1|NA;N;Standalone|realman|owner|/usr/realman/15.1 clone1|/export/home/dbases/clone1|V15.1.0.0446|1|;N;Standalone|realman|notlocked|/usr/realman/15.1_1 clone2|/export/home/dbases/clone2|V15.1.0.0446|1|;N;Standalone|realman|notlocked|/usr/realman/15.1_2 clone4|/export/home/dbases/clone4|V15.1.0.0446|1|;N;Standalone|realman|notlocked|/usr/realman/15.1_4 clone5|/export/home/dbases/clone5|V15.1.0.0446|1|;N;Standalone|realman|notlocked|/usr/realman/15.1_5 clone6|/export/home/dbases/clone6|V15.1.0.0446|1|;N;Standalone|realman|notlocked|/usr/realman/15.1_6
SYSINFO
To improve support and diagnostics, realityrc information is now included in the SYSINFO output. This provides deeper insight into the system configuration that will aid in resolving any issues more effectively.
Example
In the following example, the default SYSINFO report is augmented with information about environment variables, Reality processes and the database configuration file, and the result written to item 110209 in SYSDATA.
:SYSINFOSTART SYSINFO
WARNING - You are not root and access may be limited
TO:110209
Add System Configuration
Add Reality Build and Fixes
Add Feature Keys
Add Custom Options
Add POVF
Add realityrc
Add TCL Stacker Configuration
Add plog -h (raw log header)
The report has been saved to 110209 in SYSDATA.
If the problem was in DataBasic please use something like:
CAPTURE PRINT-CATALOG [FILE] [PROGRAM]
TO:(SYSDATA 110209
to append DataBasic details to this report. Include the T
for tape option to T-DUMP the final item to a tape device.
realstart
The realstart utility is amended to improve instance verification on Unix or Linux systems by ensuring that the correct Reality instances are initiated during start up.
It will include details of the Rawlog if it has been configured.
Example 1
In the following example, the details of the Rawlog is included as it has been configured.
root@sundev:~# realstart realstart, version 45.1 The Install_SN script has been installed The Install_Key script has been installed The show_key script has been installed The /etc/init.d/reality script has been installed The /etc/init.d/shadow script has been installed The realityrc script has been installed The realcshrc script has been installed runrealcd: Reality daemon 23090 writing to /usr/realman/15.1/files/daemon.log The base, 15.1 central daemon has been started Current RawLog Status: Status LIVE, Initialised 14:05:03 Jun 25, Last updated 14:05:03 Jun 25 Reality instance 15.1 central daemon pid: 23090 root@sundev:~#
Example 2
In the following example, the details of the Rawlog is included as it has not been configured.
[root@RLTY-DEV-RHL85 ~]# realstart realstart, version 45.1 The Install_SN script has been installed The Install_Key script has been installed The show_key script has been installed The /etc/init.d/reality script has been installed The /etc/init.d/shadow script has been installed The realityrc script has been installed The realcshrc script has been installed runrealcd: Reality daemon 2132676 writing to /usr/realman/15.1/files/daemon.log The base, 15.1 central daemon has been started Raw log not setup for Reality instance 15.1 Reality instance 15.1 central daemon pid: 2132676 [root@RLTY-DEV-RHL85 ~]#