DLTPAGSEG (Delete Page Segment)

DLTPAGSEG Command syntax diagram

 

Purpose

The Delete Page Segment (DLTPAGSEG) command deletes a specified page segment. If the page segment is found, it is deleted. If the page segment is not found, a message is sent to the user stating that it cannot be found.

 

Required Parameters

PAGSEG

Specifies the qualified name of the page segment being deleted.

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

*LIBL: All libraries in the job's library list are searched until the first match is found.

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

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

*ALLUSR Libraries

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

page-segment-name: Specify the name of the page segment being deleted.

generic*-page-segment-name: Specify the generic name of the page segment being deleted. 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 deleted only if *ALL or *ALLUSR library values can be specified for the name. For more information on the use of generic names, refer to generic names.

Examples for DLTPAGSEG

Example 1: Deleting a Page Segment in the Library List

DLTPAGSEG  PAGSEG(*LIBL/PAGSEG1)

This command deletes the page segment named PAGSEG1 if it is in the library list. Only the first occurrence is deleted if there is more than one library containing PAGSEG1 in the library list.

Example 2: Deleting a Page Segment in All Libraries

DLTPAGSEG  PAGSEG(*ALL/PAGSEG1)

This command deletes all the page segments named PAGSEG1, including any IBM supplied page segments with that name.

Example 3: Deleting Page Segments in Current Library

DLTPAGSEG  PAGSEG(*CURLIB/PG*)

This command deletes all the page segments whose names begin with PG that are in the job's current library.

Error messages for DLTPAGSEG

None