WRKOVL (Work with Overlays)

WRKOVL Command syntax diagram

 

Purpose

The Work with Overlays (WRKOVL) command allows you to display and work with all of the overlays from the system or user libraries (or both).

 

Optional Parameters

OVL

Specifies the qualified name of the overlay.

The name of the overlay can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched. All objects in these libraries with the specified object name are shown.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

*USRLIBL: Only the libraries in the user portion of the job's library list are searched.

*ALLUSR Libraries

*ALL: All libraries in the system, including QSYS, are searched.

library-name: Specify the name of the library to be searched.

*ALL: All overlays in the libraries identified in the library qualifier are shown. Only those overlays for which the user has some authority are shown.

generic*-overlay-name: Specify the generic name of the overlay. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. If the complete object name is specified, and multiple libraries are searched, multiple objects can be worked with only if *ALL or *ALLUSR library values can be specified for the name. See generic names for additional information.

overlay-name: Specify the name of the overlay to be listed.

Example of WRKOVL

WRKOVL  OVL(*LIBL/OV*)

This command searches the library list to find the overlays whose names begin with OV. All overlay objects with names beginning with OV are shown on the display. If no overlay objects beginning with OV exist in the library list, the WRKOVL display is shown with a message indicating that an object matching the specified name cannot be found.

Error messages for WRKOVL

*ESCAPE Messages

CPF9809

Library &1 cannot be accessed.