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

• SYSLVERS Object List

• SYSLVERS Statistics

---

SYSLVERS in Interactive Mode

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.
	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

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

SYSLVERS 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.

SYSLVERS 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.