LMMREN—rename a data set member

The LMMREN service updates the directory to rename a member of a partitioned data set. You can use this service with an ISPF library or an MVS™ partitioned data set.The LMINIT service with either ENQ(SHRW) or ENQ(EXCLU) and the LMOPEN service with OPTION(OUTPUT) must be completed before you can use the LMMREN service.

Command invocation format


>>-ISPEXEC--LMMREN--DATAID(data-id)--MEMBER(old-member-name)---->

>--NEWNAME(new-member-name)--+-------+-------------------------><
                             '-NOENQ-'

Call invocation format


>>-CALL--ISPLINK('LMMRENbb'--,data-id--,old-member-name--------->

>--,new-member-name)--,-+-'NOENQ'-+-);-------------------------><
                        '-'b'-----'


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

Parameters

data-id: The data ID associated with the data set that contains the member being renamed. The data ID has been generated by the LMINIT service. The maximum length of this parameter is 8 characters.
old-member-name: The present name of the member. The maximum length of this parameter is 8 characters.
Where the data-id refers to a partitioned data set load library (RECFM=U), and old-member-name is the name of an existing primary member, the user data component of any associated alias names will be updated to refer to the renamed primary name.
new-member-name: The new member name, which must follow TSO data set naming conventions. The maximum length of this parameter is 8 characters.
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. ISPF by default 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.

4

Directory already contains the specified new name.

8

Member 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 LMMREN service to rename member MYPROG in the data set associated with the data ID in variable DDVAR to MYPROGA.

Command invocation

ISPEXEC LMMREN DATAID(&DDVAR)      +
               MEMBER(MYPROG) NEWNAME(MYPROGA)
               [NOENQ]

Call invocation

CALL ISPLINK('LMMREN  ',DDVAR,'MYPROG ','MYPROGA ')
                       ,['NOENQ']);

OR

Set the program variable BUFFER to contain:

BUFFER = 'LMMREN DATAID(&DDVAR)
                MEMBER(MYPROG) NEWNAME(MYPROGA)';

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

CALL ISPEXEC (BUFLEN, BUFFER);