LMMDEL—delete members from a data set

The LMMDEL service removes members matching the specified pattern from an ISPF library or MVS™ partitioned data set. All directory information associated with the member is deleted. The LMINIT and LMOPEN services must be completed before you use the LMMDEL service. The LMINIT must be done with either the ENQ(SHRW) or ENQ(EXCLU) option, and the LMOPEN must have been done for OUTPUT. An LMINIT with ENQ(EXCLU) is required when MEMBER(*) is specified.

Command invocation format


>>-ISPEXEC--LMMDEL--DATAID(data-id)--MEMBER(member-name)-------->

>--+-------+---------------------------------------------------><
   '-NOENQ-'

Call invocation format


>>-CALL--ISPLINK('LMMDELbb'--,data-id--,member-name)------------>

>--,-+-'NOENQ'-+-);--------------------------------------------><
     '-'b'-----'


>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><

Parameters

data-id

The data ID associated with the data set from which a member is to be deleted. The data ID has been generated by the LMINIT service. The maximum length of this parameter is 8 characters.

member-name

The member name or pattern of the members to be deleted. An asterisk (*) indicates that all members are to be deleted. The maximum length of this parameter is 8 characters.

Where member-name is the name of a primary member, the primary name and all associated alias names are deleted. Where member-name is an alias member, only the alias name and its directory entry are deleted.

Where a member pattern has been specified for the LMMDEL service, these rules apply:

All primary members whose name matches the member pattern are deleted.
All aliases that are associated with a primary member whose name matches the member pattern are deleted, even if the alias name itself does not match the member pattern.
All aliases whose name matches the member pattern are deleted, even if the alias is associated with a primary member whose name does not match the member pattern.

NOENQ

An optional parameter that specifies that ISPF should not issue its standard ENQ during the processing of this service. This standard ENQ consists of a major name of SPFEDIT and a minor name of the data set name and member. By default, ISPF will issue the ENQ unless NOENQ is specified.

buf-len

A fullword fixed binary integer containing the length of the buffer parameter.

buffer

A buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC invocation for a command invocation.

Return codes

These return codes are possible:

0

Normal completion.

8

The member was not found.

10

No data set is associated with the given data ID; that is, LMINIT has not been completed.

12

One of these:

The data set is not open or is not open for output.
The parameter value is invalid.
The data set organization is invalid.

20

Severe error; unable to continue.

Example

This example invokes the LMMDEL service to delete member MYPROG from the data set associated with the data ID in variable DDVAR.

Command invocation

ISPEXEC LMMDEL DATAID(&DDVAR) MEMBER(MYPROG)

Call invocation

CALL ISPLINK('LMMDEL  ',DDVAR,'MYPROG ');
OR

Set the program variable BUFFER to contain:

BUFFER = 'LMMDEL DATAID(&DDVAR) MEMBER(MYPROG)';

Set the program variable BUFLEN to the length of the variable BUFFER. Issue the following command:

CALL ISPEXEC (BUFLEN, BUFFER);