SYSLVERS Utility

#### Search Results

Search

# 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

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

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.

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

### On this page

- SYSLVERS in Interactive Mode
- SYSLVERS in Batch Mode
- SYSLVERS Object List
- SYSLVERS Statistics