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


LMMSTATS—set and store, or delete ISPF statistics

z/OS ISPF Services Guide
SC19-3626-00

The LMMSTATS service sets and stores, or deletes ISPF statistics for members of a partitioned data set. This service can be used with ISPF libraries or an MVS™ partitioned data set. Any and all statistics can be set, or all statistics can be deleted. If no statistics exist, then LMMSTATS will calculate those not specified by keyword. Only fixed- and variable-record format data sets are supported. Completion of the LMINIT service is required before you invoke LMMSTATS. The data set must not be opened for output.

Command invocation format

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

>--+-------------------------+--+---------------------+--------->
   '-VERSION(version-number)-'  '-MODLEVEL(mod-level)-'   

>--+----------------------+--+-----------------------------+---->
   '-CREATED(create-date)-'  '-MODDATE(last-modified-date)-'   

>--+-----------------------------+--+-----------------------+--->
   '-MODTIME(last-modified-time)-'  '-CURSIZE(current-size)-'   

>--+------------------------+--+---------------------------+---->
   '-INITSIZE(initial-size)-'  '-MODRECS(records-modified)-'   

>--+---------------+--+--------+-------------------------------->
   '-USER(user-id)-'  '-DELETE-'   

>--+-----------------------------------+------------------------>
   '-CREATED4(4-char-year-create-date)-'   

>--+------------------------------------------+----------------->
   '-MODDATE4(4-char-year-last-modified-date)-'   

>--+------------------+--+-------+--+----------------+---------><
   |       .-Off--.   |  '-NOLLA-'  |      .-NO--.   |   
   '-SCLM(-+-On---+-)-'             '-EXT(-+-YES-+-)-'   
           '-Asis-'                                      

Call invocation format

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

>--,-+-version-number-+--,-+-mod-level-+--,-+-create-date-+----->
     '-'b'------------'    '-'b'-------'    '-'b'---------'   

>--,-+-last-modified-date-+--,-+-last-modified-time-+----------->
     '-'b'----------------'    '-'b'----------------'   

>--,-+-current-size-+--,-+-initial-size-+----------------------->
     '-'b'----------'    '-'b'----------'   

>--,-+-records-modified-+--,-+-user-id-+--,-+-'DELETEbb'-+------>
     '-'b'--------------'    '-'b'-----'    '-'b'--------'   

>--,-+-4-char-year-create-date-+-------------------------------->
     '-'b'---------------------'   

                                           .-Off--.   
>--,-+-4-char-year-last-modified-date-+--,-+-'b'--+------------->
     '-'b'----------------------------'    +-On---+   
                                           '-Asis-'   

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

Parameters

data-id
The data ID associated with the data set containing the members whose statistics are being modified or deleted. The data ID has been generated by the LMINIT service. The maximum length of this parameter is 8 characters.
member-name
Member name, or pattern representing the members whose statistics are to be modified or deleted. A pattern may be specified to indicate a subset of members or all members. The maximum length of this parameter is 8 characters. Specify a single asterisk as a member pattern to have the statistics for all members processed.
version-number
The number to be assigned as the version number. This parameter must be an integer between 1 and 99, inclusive.
mod-level
The number of modifications or changes to the member. This parameter must be an integer between 0 and 99, inclusive.
create-date
The date the member was created. The format of the date is dependent on the language in which ISPF is installed. The English format is YY/MM/DD.
last-modified-date
The date the member was last modified. The format of this parameter is the same as the create-date parameter.
last-modified-time
The time the member was last modified. This parameter should be specified as a character field and must be specified with 5 characters (for example - hh:mm). This parameter may also be specified as an 8-character field in the format hh:mm:ss. If the 6th character is not a colon, of if the 7th and 8th characters (ss) are not in the range '00' to '59', only the hour and minute specifications are used.
current-size
The current number of data records in the member. This parameter must be an integer between 0 and 65 535, inclusive.
initial-size
The original number of data records in the member when it was created. This parameter must be an integer between 0 and 65 535, inclusive.
records-modified
The number of data records modified in a member since it was created. This parameter must be an integer between 0 and 65 535, inclusive.
user-id
The user ID of the user that last modified the data. The maximum length of this parameter is 7 characters.
DELETE
PDF statistics are removed for the specified members.
4-char-year-create-date
The date that the member was created, in 4-character year format. The format of the date depends on the language in which ISPF and ISPF/PDF are invoked. The English format is YYYY/MM/DD.
4-char-year-last-modified-date
The date that the member was last changed, in 4-character year format. The format of the date depends on the language in which ISPF and ISPF/PDF are invoked. The English format is YYYY/MM/DD.
SCLM
The SCLM setting is a bit that ISPF uses to determine what type of edit the file last had performed upon it.
On
The last edit of this file was under SCLM control.
Off
The last edit of this file was under control of something other than SCLM.
Asis
This LMMSTATS operation is transferring the current setting of this file as it already is.
NOLLA
If LLA is used to manage a cached directory entry, specify this keyword to ensure that the cached entry is not used.
EXT
When sets to YES, instructs ISPF to store statistics in extended format. This also removes the upperbound check on the current-size, initial-size, and records-modified parameters.
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 procedure.

Return codes

These return codes are possible:
 0
Normal completion.
 4
Either:
  • Data set is empty.
  • No members matched the pattern.
 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:
  • Invalid parameter value.
  • Data set is not partitioned.
  • Data ID represents a concatenation of data sets.
  • Data set is opened for output.
20
Severe error; unable to continue.

Example

This example invokes LMMSTATS to set to 20 the version number of member MYPROG in the data set associated with the data ID stored in DDVAR.

Command invocation

ISPEXEC LMMSTATS DATAID(&DDVAR) MEMBER(MYPROG) VERSION(20)

Call invocation

CALL ISPLINK ('LMMSTATS',DDVAR,'MYPROG ',20);

OR
 
Set the program variable BUFFER to contain:
BUFFER = 'LMMSTATS DATAID(&DDVAR) MEMBER(MYPROG) VERSION(20)';
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