z/OS ISPF Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


LMMREP—replace a member of a data set

z/OS ISPF Services Guide
SC19-3626-00

The LMMREP service updates the directory to replace a member of a partitioned data set. The specified member is added if it does not currently exist. This service can be used with an ISPF library or an MVS™ partitioned data set. The LMINIT service with either ENQ(SHRW) or ENQ(EXCLU), the LMOPEN service with OPTION(OUTPUT), and the LMPUT service must be completed before you can use the LMMREP service.

Command invocation format

Read syntax diagramSkip visual syntax diagram
>>-ISPEXEC--LMMREP--DATAID(data-id)--MEMBER(member-name)-------->

>--+------------------+--+-------+--+----------------+---------><
   |        .-NO--.   |  '-NOENQ-'  |      .-NO--.   |   
   '-STATS(-+-YES-+-)-'             '-EXT(-+-YES-+-)-'   

Call invocation format

Read syntax diagramSkip visual syntax diagram
>>-CALL--ISPLINK('LMMREPbb'--,data-id--,member-name------------->

     .-'NObbbbbb'-.                          
>--,-+-'b'--------+-)--,-+-'NOENQbbb'-+-);---------------------><
     '-'YESbbbbb'-'      '-'b'--------'      

or

Read syntax diagramSkip visual syntax diagram
>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><

Parameters

data-id
The data ID associated with the data set that contains a member that is being replaced. The data ID has been generated by the LMINIT service. The maximum length of this parameter is 8 characters.
member-name
The name of the member to be replaced. The maximum length of this parameter is 8 characters.

Where member-name is the name of an existing primary member, the primary name and all associated alias names are updated. Where member-name is the name of an existing alias member, the alias name is updated to be a primary member and any association with the original primary member name is lost.

YES|NO
Whether the user data area in the directory should be updated so that the statistics of the member are stored in the same format used by Edit.

If you type YES and the data set specified is partitioned and the records are not unformatted (RECFM=U), the directory is updated with the member statistics. At least a valid creation date (ZLCDATE) and the date of the most recent change (ZLMDATE) must be provided in the member statistics.

If you specify NO, the default value, the statistics are not updated.

These dialog variables are used to pass statistical information from the dialog invoking the LMMREP service:
ZLVERS
Version number; a number from 1 to 99.
ZLMOD
Change level; a number from 0 to 99.
ZLCDATE
Creation date; a character value shown in your national format.
ZLMDATE
Last change date; a character value shown in your national format.
ZLMTIME
Last change time; a character value in the format hh:mm. ZLMTIME can also be specified as an 8-character field in the format hh:mm:ss. If the 6th character is not a colon, or if the 7th and 8th characters (ss) are not in the range '00' to '59', only the hour and minute specifications are used. The seconds value is set to the current time.
ZLMSEC
Seconds value of the last change time. This is a 2-character field.
Note: If the ZLMTIME variable does not contain a seconds value and ZLMSEC is not set, the seconds value is set to 00. If both ZLMTIME and ZLMSEC specify a seconds value, the value in ZLMSEC is used.
ZLCNORC
Current number of records; a number from 0 to 65 535.
ZLINORC
Beginning number of records; a number from 0 to 65 535.
ZLMNORC
Number of changed records; a number from 0 to 65 535.
ZLUSER
User ID of the last user to change the given member; the user ID can have a maximum length of 7 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. By default, ISPF will issue the ENQ unless NOENQ is specified.
EXT
When sets to YES, instructs ISPF to store statistics in extended format.
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
Member is added; it did not previously exist.
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.
  • Some member statistics have invalid values.
14
No record has been written for the member to be replaced.
16
Truncation or translation error in accessing dialog variables.
20
Severe error; unable to continue.

Example

This example invokes the LMMREP service to update the directory of the data set associated with the data ID in variable DDVAR to replace member MYPROG.

Command invocation

ISPEXEC LMMREP DATAID(&DDVAR) MEMBER(MYPROG)

Call invocation

CALL ISPLINK('LMMREP  ',DDVAR,'MYPROG ');
OR
 
Set the program variable BUFFER to contain:
BUFFER = 'LMMREP DATAID(&DDVAR) MEMBER(MYPROG)';
Set the program variable BUFLEN to the length of the variable BUFFER. Issue the command:
CALL ISPEXEC (BUFLEN, BUFFER);

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014