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.

:SYSINFO
START 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 ~]#