ISPFSTATS

Use the ISPFSTATS (or STATS) statement to generate, modify, or remove the ISPF statistics of selected or all members of a partitioned library.

Syntax

Read syntax diagramSkip visual syntax diagramlabel ISPFSTATS OUTDD= DDnameOUTDSN=DSname( DSname,SHROLD),REPLACEREPLREMOVECLEAR,STANDARDSTDEXTENDEDEXT,USERIDUID=UserId*,MODLEVELMODLEV=Vr.MdVr,INITNUM= InitNum,MODNUM= ModNum,CREDATE=Year/Mo/DaYe/Mo/Da*,MODDATE=Year/Mo/DaYe/Mo/Da*,MODTIME=Ho:Mi:SeHo:Mi*,LIST=YESNOALLONLY

Parameters

OUTDD=DDname
Specifies the DDname of the target partitioned data set.
OUTDSN={DSname|(DSname,SHR)|(DSname,OLD)}
Specifies the DSname of the cataloged target partitioned data set. {SHR|OLD} specifies the disposition of the dynamically allocated data set. When this parameter is omitted, the default from the "OUTDISP=" EXEC PARM field applies. When both are omitted, SHR is used.
REPLACE|REPL
The ISPF statistic of all selected members must be generated or updated in their corresponding directory entries.
CLEAR|REMOVE
The ISPF statistic of all selected members must be removed from their corresponding directory entries.
STANDARD|STD
The ISPF statistic must be contained in a 30-byte long "Standard ISPF Statistics" structure. This is the default for newly created ISPF Statistics when the EXTENDED option is not present.
EXTENDED|EXT
The ISPF statistic must be contained in a 40-byte long "Extended ISPF Statistics" structure.
LIST={YES|NO}
Specifies whether the names of the updated members are to be listed in the SYSPRINT data set. When this parameter is omitted, the default from the EXEC PARM field applies.
LIST=ALL
Same as LIST=YES with additional member pre-filtering related messages.
LIST=ONLY
Same as LIST=YES.
{USERID|UID}={UserId|*}
An 8-character string to be stored in the ISPF statistics "User Id" field.
UserId
An up to 8 characters string.
*
The current "Job User Id". This is the default if USERID= is omitted for newly created ISPF Statistics.
MODLEVEL={Vr.Md|Vr}
A Modification Level number, in a VV.MM format, stored as 2 1-byte binary integers.
Vr
A 2 decimal digits Version number between 00 and 99.
Md
A 2 decimal digits Modification number between 00 and 99.
INITNUM=InitNum
Initial number of lines between 0 and 99999999, stored as a 2-byte binary integer in a STANDARD structure and as a 4-byte binary integer in an EXTENDED structure.
If omitted for newly created statistics, INITNUM is set to Current Number of Lines.
MODNUM=ModNum
Modified number of lines between 0 and 99999999, stored as a 2-byte binary integer in a STANDARD structure and as a 4-byte binary integer in an EXTENDED structure.
CREDATE={Year/Mo/Da|Ye/Mo/Da|*}
Creation date 10-character string in a YYYY/MM/DD format or an 8-character string in a YY/MM/DD format, stored as a 4-byte packed decimal Julian date.
Year
4 digits year number
Ye
2 digits year number
Mo
2 digits month number of a year
Da
2 digits day number of a month
*
The current date
MODDATE={Year/Mo/Da|Ye/Mo/Da|*}
Modification date 10-character string in a YYYY/MM/DD format or an 8-character string in a YY/MM/DD format, stored as a 4-byte packed decimal Julian date.
MODTIME={Ho:Mi:Se|Ho:Mi|*}
Modification time 8-character string in an HH:MM:SS format or a 5-character string in an HH:MM format, stored as 3 1-byte packed decimal numbers.
Ho
2 digits hour number between 00 and 23
Mi
2 digits minute number between 00 and 59
Se
2 digits second number between 00 and 59
*
Current time of day

Usage notes

  • The target members may be selected by a group of SELECT and EXCLUDE statements, following the ISPFSTATS statement. Note that at least one SELECT or EXCLUDE statement is mandatory.
  • When the ISPF statistics are newly created or converted from one structure to another, the Current Number of Lines value is updated with the current number of records found in the member.
  • When the REPLACE, REMOVE, or CLEAR keywords are not present here and not in the EXEC PARM string, only selected members without any ISPF statistics get their new statistics.