Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

@DELETE (format 3) - Delete files and library elements

&pagelevel(3)&pagelevel

This format of the @DELETE statement can be used to delete files or elements in a library.

Operation

Operands

F mode, L mode

@DELETE

{ LIBRARY=path1 ([ELEMENT=] elname [(vers)][,eltype])
  | ELEMENT=elname [(vers)] [,eltype]
  | FILE = path2
  | POSIX-FILE = xpath }

LIBRARY=

path1

elname

vers

A library element is to be deleted.

Name of the library.

Name of the element.

Version of the element that is to be deleted (see the LMS User Guide [14]).
If vers is not specified or if *STD is specified then the highest available
version of the element is deleted.

eltype

Type of element. Permitted type specifications are S, M, P, J, D, X, R, C, H, L,
U, F, *STD and freely selectable type names having one of these types as
basic type. If eltype is not specified then the default type specified with
@PAR ELEMENT-TYPE is used. The permitted element types and their
meanings are described in section “File processing”.

ELEMENT=

The library element to be deleted is defined by means of its name without
any library name specification. The default library specified with @PAR
LIBRARY is used implicitly (provided that @PAR LIBRARY has been
specified – otherwise the error message EDT5181 is output).
The operands elname, vers and eltype have the same meaning as when
a library is specified explicitly (see above).

FILE=

path2

A BS2000 file is to be deleted.

The fully qualified file name of a BS2000 file that you want to delete.

POSIX-FILE=

A POSIX file is to be deleted.

xpath

Path name of the POSIX file that you want to delete.

The xpath operand can also be specified via a string variable. It must be
specified via a string variable if it contains special characters which have a
special meaning in EDT syntax (e.g. blanks or semicolons in F mode).

If the specified file does not exist or cannot be accessed as required then the statement is rejected with a corresponding error message.

Example

@DELETE LIBRARY=PROGLIB(ELEMENT=TESTOLD(VER2))

Version VER2 of the library element TESTOLD in the library PROGLIB and with element type S is deleted.