SYSINFO

Provides the means to create a report on various aspects of Reality. It optionally outputs the report to either the screen, a print job, or an item (which can be directed to tape).

The following default information is reported when no options are specified:

• Basic system information, OS type, frame size, and so on.
• Reality version and a list of installed updates.
• Reality feature keys.
• Currently active custom options.
• The frame available free space.
• The TCL stack configuration.
• The raw log header if resilience is active.

SYSINFO is useful as a source of information which can be included in a support call to Northgate.

Syntax

SYSINFO {(options}

Options

The following options select information that is not included in the defaults:

E Includes native environment variables.

W Includes WHERE and native process information.

C Includes the database configuration file.

L Includes daemon log (on UNIX, you need to be root).

N Includes network logs, session and event logs.

A Includes all of the above.

The following options provide additional control:

M Minimal report that includes only what has been selected by the options above (that is, excluding the default information).

T Sends the report to a tape drive (you are prompted for the specific unit). The report is output to tape as a T-DUMP.

P Prints the report to the currently-selected formqueue.

H Displays help information about this command.

The T and P options cannot be used together.

Prompts

• When used with the T option, the command prompts for the specific tape unit:

  Enter tape unit desired:

  Enter the unitNumber of the desired tape unit.

• When used with any option except P and H, the command prompts for a destination for the report.

  In response to the TO: prompt, you can:

  • Press return to display the report on the screen (this is not allowed with the T option).
  • Specify a simple item-id, in which case the report is written to that item in the SYSDATA file.
  • Specify a file and item by using the (file-specifier item-id syntax.

Restrictions

Made available in the SYSMAN and SYSPROG accounts, but may be copied to user accounts.

Comments

Sometimes additional information may be useful, such as DataBasic object details using PRINT-CATALOG, or ANALYZE information for another port. The CAPTURE command can be used to append this information to the report. The T (for tape) option can be supplied to the final CAPTURE to T-DUMP the complete report to a tape device.

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 (EWC
TO:110209
Add System Configuration
Add Reality Build and Fixes
Add Feature Keys
Add Custom Options
Add POVF
Add TCL Stacker Configuration
Add Host Environment
Add WHERE (SC
Add Host Processes List
Add Database Configuration

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.