SYSLVERS Utility

The SYSLVERS utility is used to list objects which have been cataloged within a selected Natural version range.

The following topics are covered:

SYSLVERS in Interactive Mode
SYSLVERS in Batch Mode
Object List
Statistics

SYSLVERS in Interactive Mode

Start of instruction set To invoke SYSLVERS

To invoke SYSLVERS, issue the following system command or select it in the NaturalONE Tools and Utilities:

SYSLVERS

The SYSLVERS menu appears. In this page you can specify a version range, a library range and a Natural system file. All objects in the given library range on the selected Natural system file are processed. The objects which have been cataloged within the selected version range are listed in the Object List page. The Statistics page shows how many libraries and objects have been scanned and how many objects have been found within the selected version range. If desired, you can write the resulting data to a work file in text format or as CSV.

You can make the following specifications in the SYSLVERS menu:

Property	Value	Description
`Library from`		The library in which the processing starts. If the field is empty, the processing starts from the very first library. If `Library to` is empty and the `Library from` value is followed by an asterisk (), all libraries beginning with this value are processed (wildcard notation). Enter a single asterisk () if you want to process all libraries of the selected system file. The `Library from` value is initialized with the name of the current library.
`Library to`		The library in which the processing ends. If the field is empty, the processing ends at the very last library unless the wildcard notation is used for `Library from`. In this case the processing ends at the value specified with the wildcard. If an equal sign (=) is specified in this field, `Library to` uses the same value as `Library from`. The `Library to` value is initialized with the name of the current library.
`System file`		The Natural system file to be processed. Default: Blank
	Blank	The Natural system file to be used depends on the value specified in the `Library from` property. If the value starts with `SYS`, but is not equal to `SYSTEM`, the `FNAT` system file is used. Otherwise the `FUSER` system file applies.
	U	The `FUSER` system file is used.
	N	The `FNAT` system file is used.
`Version from`	`vv.rr`	The (inclusive) beginning of the Natural version range, where `vv` is the major version, and `rr` is the minor version. Default: If the field is empty, the first version is used. If the minor version is not specified, the first minor version is taken.
`Version to`	`vv.rr`	The (inclusive) end of the Natural version range, where `vv` is the major version, and `rr` is the minor version. Default: If the field is empty, the last version is used. If the minor version is not specified, the last minor version is taken.
`Export`		Specifies whether the resulting data is written to work file 7 and in which format. Default: N
	N	No data is written to work file 7.
	T	Writes the object list and statistics in free text format.
	C	Writes the object list in CSV format with a comma (,) separator.
	S	Writes the object list in CSV format with a semicolon (;) separator.

If you press ENTER, the selected libraries are scanned and the found objects are displayed in the Object List page.

If Export is set to T, C or S, the resulting data is written to work file 7.

To leave the SYSLVERS menu, press PF3 or enter END in the Command field.

PF Keys and Commands

The following PF keys and commands are available in interactive mode:

PF Key	Name	Command	Page	Function
PF1	Help	`?`	General	Displays help information.
PF3	Exit	`END` `.`	General	Exits the current menu.
PF5	Stats	`STATISTICS`	Object List	Displays the Statistics page.
PF5	Obj	`OBJECT`	Statistics	Displays the Object List page.
PF6	-	`TOP`	Object List	Scrolls to the beginning of the list.
PF7	--	`PREV`	Object List	Scrolls one page up.
PF8 ENTR	+	`NEXT`	Object List	Scrolls one page down.
PF9	++	`BOTTOM`	Object List	Scrolls to the end of the list.
PF12	Canc	`CANCEL`	General	Exits the `SYSLVERS` command.
		`TRACE value`	General	Start or stop the internal trace. See `SYSLVERS` in Batch Mode for the allowed values. If you enter the TRACE command without a value, the current state of the trace is displayed.

The name of the PF key can also be used as a command. For example, enter the command "++" to scroll to the end of the list.

SYSLVERS in Batch Mode

Start of instruction set To invoke SYSLVERS

To invoke SYSLVERS, enter the following system command into the primary command input data set CMSYNIN:

SYSLVERS

SYSLVERS in batch mode reads keywords from the batch input file CMSYNIN or CMOBJIN until it reaches the END keyword or a dot (.).

SYSLVERS uses the following syntax format for the input lines:

Keyword[=value]

The following rules apply:

Lines starting with an asterisk (*) are ignored.
A keyword may be specified without the equal sign and value. The value is set to blank in this case.
Blanks can be added before or after the keyword or value.
Keywords and values can be specified in upper or lower case.
The maximum input line length is 78 characters.

The following keywords are available:

Keyword	Value	Description
`LIBRARY-FROM`		The library in which the processing starts. If the value is empty, the processing starts from the very first library. If `LIBRARY-TO` is empty and the `LIBRARY-FROM` value is followed by an asterisk (), all libraries beginning with this value are processed (wildcard notation). Enter a single asterisk () if you want to process all libraries of the selected system file. Default: Asterisk (*)
`LIBRARY-TO`		The library in which the processing ends. If the value is empty, the processing ends at the very last library unless the wildcard notation is used for `LIBRARY-FROM`. In this case the processing ends at the value specified with the wildcard. If an equal sign (=) is specified in this field, `LIBRARY-TO` uses the same value as `LIBRARY-FROM`. Default: Blank
`SYSTEM-FILE`		The Natural system file to be processed. Default: Blank
	Blank	The Natural system file to be used depends on the value specified in the `LIBRARY-FROM` keyword. If the value starts with `SYS`, but is not equal to `SYSTEM`, the `FNAT` system file is used. Otherwise the `FUSER` system file applies.
	`FUSER`	The `FUSER` system file is used.
	`FNAT`	The `FNAT` system file is used.
`VERSION-FROM`	`vv.rr`	The (inclusive) beginning of the Natural version range, where `vv` is the major version, and `rr` is the minor version. If the field is empty, the first version is used. If the minor version is not specified, the first minor version is used. Default: Blank
`VERSION-TO`	`vv.rr`	The (inclusive) end of the Natural version range, where `vv` is the major version, and `rr` is the minor version. If the field is empty, the last version is used. If the minor version is not specified, the last minor version is taken. Default: Blank
`EXPORT`		Specifies whether the resulting data is written to work file 7 and in which format. Default: `NO`
	`NO`	No data is written to work file 7.
	`TEXT`	Writes the object list and statistics in free text format.
	`COMMA`	Writes the object list in CSV format with a comma (,) separator.
	`SEMICOLON`	Writes the object list in CSV format with a semicolon (;) separator.
`TRACE`		Set the level of internal trace of the `SYSLVERS` command. The internal trace is written to the standard output (CMPRINT data set). In general, a higher trace level also contains the information of the lower trace levels. Default: `OFF`
	`0-99`	Trace level.
	`OFF`	No trace is written. Corresponds to trace level 0.
	`ON`	Activates the internal trace. Corresponds to trace level 99.
	`ERROR`	If an error occurs at the reading of a library or an object, a message is printed. Corresponds to trace level 1.
	`WARNING`	If a warning occurs at the reading of a library or object, a message is printed. Corresponds to trace level 2.
	`TIME`	Activates the performance measurement. The result is provided in the Statistics page. Available in batch mode only. Corresponds to trace level 3.
	`DETAIL`	Returns a more detailed error message. Corresponds to trace level 8.
	`REJECT`	Lists rejected objects (those outside the version range) in the Object List and writes them to the standard output (`CMPRINT` data set). Available in batch mode only. Corresponds to trace level 80.
`END` .		The keyword END or a period (.) indicates the end of the `SYSLVERS` input.

Example

The following SYSLVERS execution in batch lists all objects on the FUSER system file which have been cataloged with a Natural version prior to version 5. The command writes the result to the Batch Output File CMPRINT and additionally to work file 7 in CSV format with a semicolon (;) separator.

SYSLVERS 
*
* List all objects on FUSER with catalog version < 5
*
LIBRARY-FROM = *
LIBRARY-TO   = 
SYSTEM       = FUSER
VERSION-FROM =
VERSION-TO   = 4
EXPORT       = SEMICOLON
END

Object List

For the specified library range the Object List page displays all objects which have been cataloged within the selected version range. The following information is listed:

Count – Counter of the objects found
Library – Object library
Object – Object name
Type – Type of the object like "Program"
User ID – ID of the user who has cataloged the object
Catalog Date – Date when the object was cataloged
Version – Natural version used to catalog the object

The following information is additionally available if the Object List is written to a work file:

Size – Size of the cataloged object
Mode - Programming mode of the object like "Structured"

If you press PF5 or enter STATISTICS in the Command field in the interactive mode, the Statistics page is displayed.

To leave the Object List page, press PF3 or enter END in the Command field.

Note:
If you are using Natural Security (NSC), only those libraries are scanned which you can access. If you have only restricted access to a library, the library is skipped. In this case you may activate the SYSLVERS trace to retrieve further information.

Statistics

The Statistics page displays the selected input values and the following statistical information:

Libraries scanned – Number of libraries processed
Objects scanned – Number of objects processed
Objects found – Number of objects which satisfied the selected criteria

In batch mode, if trace level 3 or higher is selected, the following information is displayed additionally:

Date – The date when the processing started
Start time – The time when the processing started
End time – The time when the processing ended
Elapsed time – The elapsed time needed to process the SYSLVERS command

If you press PF5 or enter OBJECT in the Command field in the interactive mode, the Object List page is displayed.

To leave the Statistics page, press PF3 or enter END in the Command field.