LMRENAME—rename an ISPF library

The LMRENAME service renames an ISPF library or an MVS™ data set with a three-level qualified data set name. The data set name used must be the cataloged name, not an alias data set name.

Command invocation format


>>-ISPEXEC--LMRENAME--PROJECT(project)--GROUP(group)------------>

>--TYPE(type)--+-NEWPROJ(new-project)-+------------------------><
               +-NEWGROUP(new-group)--+   
               '-NEWTYPE(new-type)----'

Call invocation format


>>-CALL--ISPLINK('LMRENAME'--,project--,group--,type------------>

>--,-+-new-project-+--,-+-new-group-+--,-+-new-type-+--);------><
     '-'b'---------'    '-'b'-------'    '-'b'------'


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

Parameters

project: The highest-level qualifier in the specification of an ISPF library or MVS data set with a three-level qualified data set name. The maximum length of this parameter is 8 characters.
group: The second-level qualifier in the specification of an ISPF library or MVS data set with a three-level qualified data set name. The maximum length of this parameter is 8 characters.
type: The third-level qualifier in the specification of an ISPF library or MVS data set with a three-level qualified data set name. The maximum length of this parameter is 8 characters.
new-project: The new highest-level qualifier. If this parameter is not specified, the project parameter value is used. The maximum length of this parameter is 8 characters.
new-group: The new second-level qualifier. If this parameter is not specified, the group parameter value is used. The maximum length of this parameter is 8 characters.
new-type: The new third-level qualifier. If this parameter is not specified, the type parameter value is used. The maximum length of this parameter is 8 characters.
Note: You must specify either new-project, new-group, or new-type.
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

New name already exists.

8

One of these:

Specified data set does not exist.
Rename or catalog failed.
Data set name is an alias.

12

The parameter value is invalid.

20

Severe error; unable to continue.

Example

This example invokes the LMRENAME service to rename a data set with the name DEPT877.PRIVATE.ASSEMBLE to DEPT877.MINE.ASSEMBLE.

Command invocation

ISPEXEC LMRENAME PROJECT(DEPT877)     +
                 GROUP(PRIVATE)       +
                 TYPE(ASSEMBLE)       +
                 NEWGROUP(MINE)

Call invocation

CALL ISPLINK('LMRENAME','DEPT877 ',
                        'PRIVATE ',
                        'ASSEMBLE',' ',
                        'MINE ');

OR

Set the program variable BUFFER to contain:

BUFFER = 'LMRENAME PROJECT(DEPT877)
                  GROUP(PRIVATE)
                  TYPE(ASSEMBLE)
                  NEWGROUP(MINE)';

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

CALL ISPEXEC (BUFLEN, BUFFER);