DLTSBSD (Delete Subsystem Description)

DLTSBSD Command syntax diagram

 

Purpose

The Delete Subsystem Description (DLTSBSD) command deletes the specified subsystem descriptions (including any work entries or routing entries that were added to them) from the system. Job queues assigned to this subsystem by the Add Job Queue Entry (ADDJOBQE) command are not deleted. The associated subsystem must be inactive before it can be deleted.

 

Restrictions

1. This command cannot be run if an active subsystem is associated with this subsystem description.
2. The user must have object operational and object existence authority for the subsystem description being deleted, and read authority for the libraries.

 

Required Parameters

SBSD

Specifies the name of the subsystem descriptions being deleted. A specific subsystem description or a generic subsystem description can be specified. Either type can be qualified by a library name. Depending on the library qualifier that is specified or assumed, the following libraries are searched for the subsystem descriptions being deleted:

The name of the subsystem description 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.

subsystem-description-name: Specify the name of the subsystem description being deleted.

generic*-subsystem-description-name: Specify the generic name of the subsystem description 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.

Example for DLTSBSD

DLTSBSD  SBSD(LIB1/BAKER)

This command deletes the inactive subsystem description called BAKER from library LIB1.

Error messages for DLTSBSD

*ESCAPE Messages

CPF2105

Object &1 in &2 type *&3 not found.

CPF2110

Library &1 not found.

CPF2110

Library &1 not found.

CPF2114

Cannot allocate object &1 in &2 type *&3.

CPF2117

&4 objects type *&3 deleted. &5 objects not deleted.

CPF2160

Object type *&1 not eligible for requested function.

CPF2176

Library &1 damaged.

CPF2182

Not authorized to library &1.

CPF2189

Not authorized to object &1 in &2 type *&3.

CPF5702

File either not DDM file or not found.