FDREPORT DEFAULT Statement
DEFAULT statement
The DEFAULT statement changes FDREPORT’s default values for various options used when generating a report. Most of the operands on the DEFAULT statement are also operands of the PRINT statement, and can be specified there. The DEFAULT statement can be used when more than one report (more than one PRINT statement) is to be generated in one FDREPORT run; the DEFAULT statement avoids having to specify options used in more than one report more than once. Only the operands that are unique to the DEFAULT statement are described below; the other operands are described in FDREPORT-PRINT-Statement.
The DEFAULT statement may also be used to permanently update default values of most of the operands of DEFAULT in the ABR program library so that all subsequent executions of FDREPORT use the new values without having to specify them. The underlined defaults shown above (and in the PRINT statement) are the distributed defaults; your installation may have changed them. The defaults are permanently changed when the CHANGE=PERM or CHANGE=RESET operand is specified; this requires that a SYSLIB DD Statement be included in the FDREPORT JCL pointing to the ABR program library. The current defaults may be displayed by the ENABLE=DISPLAY operand; this display also shows which values are eligible for permanent change by CHANGE=PERM, which can only be changed in the FDR Global Options, and cannot be changed.
DEFAULT statement syntax
DEFAULT | |
|---|---|
ABRINDEX=cccccccc | |
,AGE=nnn | |
,AGEACCUM=nn | |
,AGEINC=nnn | |
,ALIASLEVEL=n | |
,ALTDATADDNAME=ddn | |
,ARCDSNAME=dsn | |
,ARCLIMIT=nnnnn | |
,BCDSCLUSTER=dsn | |
,BCDSDDNAME=ddn | |
,BININTERVAL=nn | |
,BYTEFORMAT=BYTES|KILOBYTES|MEGABYTES|GIGABYTES|TERABYTES|REALBYTES | |
,CANDSPACE=cccccccccc | |
,CATALOGSEARCH=RELATED|STANDARD | |
,CA1TMC=dsn | |
,CA1XDDNAME=ddn | |
,CA1XPREFIX=pfx | |
,CHANGE=PERM|RESET|TEMP | |
,CHKONLRESERVE=BYPASS|RETRY|WAIT | |
,COPY=BOTH|EITHER|1|2 | |
,CRYDSNAME=dsn | |
,CSVDDNAME=ddn | |
,DATADDNAME=ddn | |
,DATATYPE=ARCHIVE|BCDS|CATALOG|CATARCH|CATVTOC|ENCRYPT|EXTRACT|MCDS| RMMDSN|RMMVOL|SCRATCH|TVTOC|VOLDATA|VTOC | |
,DATEFORMAT=DDMMYY|DDMMYYYY|MMDDYY|MMDDYYYY|YYDDD|YYDDMM|YYMMDD| YYYYDDD|YYYYDDMM|YYYYMMDD | |
,DDCNT=nnn | |
,DIAGPCHDDNAME=ddn | |
,DISABLE=(options) | |
,DSKIP=n | |
,ENABLE=(options) | |
,ERRCODE=nnn | |
,EXTRACTDSNAME=dsn | |
,EXTRACTMEMBER=mem | |
,FDRLIB=ddn | |
,FIELDPREFIX=c | |
,FIELDSUFFIX=c | |
,FORMAT=CRT|DEVICE|PRINT|TSO | |
,GDATSEPCHAR=c | |
,GMSORTLEN=nnn | |
,ICF=IGNORE|YES | |
,ICFSOURCE=LOCATE|VVDS | |
,IFKEYWORDERROR=BYPASS|PROCESS | |
,IFNOVERSION=cccc | |
,IFSELECTERROR=BYPASS|PROCESS | |
,INDEXNUM=nn | |
,JDATSEPCHAR=c | |
,LBPZERO=INVALID|VALID | |
,LINECNT=nnn | |
,LOWEXPDATE=yyyyddd | |
,MAXBKUPARRAY=nn | |
,MAXCOPY=n | |
,MAXEXECUTE=nnnnn | |
,MAXGDG=nnn | |
,MAXICF=nnnnn | |
,MAXONLINE=nnnn | |
,MAXSELCORE=nnnnnnn | |
,MAXSEPARATE=n…n | |
,MAXTAPE=nnnnn | |
,MCDSCLUSTER=dsn | |
,MCDSDDNAME=ddn | |
,MIHINTERVAL=n | |
,MINSEPARATE=nn | |
,OCDSCLUSTER=dsn | |
,OCDSDDNAME=ddn | |
,OLDBACKUP=ALL|CUR|(nn[,nn[,…]]) | |
,PAGEWIDTH=nnn | |
,PCHDATEFORMAT=DDMMYY|DDMMYYYY|MMDDYY|MMDDYYYY|YYMMDD|YYYYMMDD| YYDDMM|YYYYDDMM|YYDDD|YYYYDDD | |
,PCHDDNAME=ddn | |
,PCHDEFCATALOG=catn | |
,PCHSEPCHAR=c | |
,POFREESPACE=DIR|IFREAD|LBP | |
,PRTLENGTH=nnnnn | |
,RECORDSUMMARY=CLUST|COMPON|NONE | |
,REGIONSIZE=nnnnnnnnn | |
,RESETMASKAFTER=nnnnn | |
,RESFAILRTNCD=nn | |
,RESWAITIME=nn | |
,RETRYLOOPS=nn | |
,RMMXDDNAME=ddn | |
.RMMXPREFIX=pfx | |
,RPTDDNAME=ddn | |
,RPTSPFC=nn | |
,RPTSPFI=nn | |
,RPTYPE=ABRVTOC|ARCHIVE|COMPDATA|CSV|DATA|GENERATE|HEX|NONE|OSVTOC| SELPCH|TABLE|XREF | |
,RUNDATE=yyyyddd | |
,SKIP=n | |
,SORT=COMBINE|NO|YES | |
,SORTALLOC=NO|CYL|SORTLIB|SORTMSG|SORTWORK|TRK|YES | |
,SORTCORE=nnnnnnn | |
,SORTLIB=dsn | |
,SORTMSG=AC|AP|CC|CP|NO|PC | |
,SORTMSGDDNAME=ddn | |
,SORTPFX=cccc | |
,SPFC=nn | |
,SPFI=nn | |
,SSPKLINECNT=n | |
,STARTCATALOG=catn | |
,SUMBYTEFORMAT=BYTES|KILOBYTES|MEGABYTES|GIGABYTES|TERABYTES| REALBYTES | |
,SUMDDNAME=ddn | |
,SUMDEVICE=BASE|UNIQUE | |
,SUMLEVEL=INDEX|NONE|REPORT|YES | |
,SYSLIB=ddn | |
,SYSUTSPACE=nnnnn | |
,SYSUTSTORCLAS=storclas | |
,SYSUTUNIT=unit | |
,TITLE=CENTER|LEFT|RIGHT | |
,UNITPREFIX=n | |
,VOLPREFIX=n | |
,VOLSUMMARY=CTLSERNO|DEVTYPE|MFRCODE|NOBREAK|NONE|SSID|STORGRP| UNITPREFIX|VOLPREFIX | |
,VTOCPAD=nn | |
,VTOCREAD=CYL|TRK | |
,WORKDDNAMES=n | |
,WORKSPACE=nnnnn | |
,WORKSTORCLAS=storclas | |
,WORKUNIT=unit | |
ABRINDEX=
cccccccc
Specifies a character string from 1 to 8 bytes in length that ABR is to use as the first level qualifier for the ABR model DSCBs and for all backup and archive data sets created by FDRABR.
Default: The default is the ABRINDEX value in the FDR Global Options and is usually “FDRABR”.
ARCDSNAME=
dsn
Specifies the data set name of the Archive Control File to be used as input if DATATYPE=ARCHIVE or DATATYPE=CATARCH is also specified and no ARCHIVE DD Statement is present.
Default: The default is the Archive Control File name in the FDR Global Options and is usually “FDRABR.ARCHIVE”.
BCDSCLUSTER=
dsn
Specifies the cluster name of the DFSMShsm BCDS data set. The BCDS cluster is dynamically allocated if DATATYPE=BCDS is used.
If the BCDS is defined to DFSMShsm as a multi-cluster file, specify all the cluster names, in parenthesis (up to 4), for example,
BCDSCLUSTER=(cluster1,cluster2,cluster3,cluster4).
If these parameters are not specified, FDREPORT expects that the JCL contains a BCDSDD DD statement (for DATATYPE=BCDS).
BCDSDDNAME=
ddn
Specifies the ddname to be used when reading the DFHSM or DFSMShsm BCDS data set if DATATYPE=BCDS is used.
Default: BCDSDD.
dsn
Specifies the data set name of the CA 1 Tape Management Catalog (TMC) to be used when extracting data from product CA 1. This value is required when performing an EXTRACT command for PRODUCT=CA1.
CA1XDDNAME=
ddn
Specifies the ddname used when retrieving CA 1 extracted data created by the EXTRACT command using PRODUCT=CA1.
Default: CA1XTR
CA1XPREFIX=
pfx
Specifies the 1 to 8 character prefix to be used when naming the newly created extract field using the EXTRACT command with PRODUCT=CA1.
Default: Use the prefix of the user creating the file.
CHANGE=
Allows the default values used by FDREPORT for other operands on the DEFAULT statement to be permanently changed. The available options are:
Permanently change the default values for many other operands specified on the DEFAULT statement, as described above.
Reset all defaults back to the original values distributed with FDREPORT.
Operands on the DEFAULT statement affect this execution of FDREPORT only.
PERM or RESET requires that a SYSLIB DD Statement pointing to the ABR program library be included in the FDREPORT JCL; you must have UPDATE authority to this library.
Default: TEMP.
dsn
Specifies the data set name of the encryption file.
DDCNT=
nnn
Specifies the maximum number of user-specified DISKxxxx DD Statements that can be processed in any execution of FDREPORT, from 5 to 400.
Default: 100.
ENABLE=DISPLAY
Specification of ENABLE=DISPLAY on a DEFAULT statement causes it to display all of the FDREPORT operands that are stored in the FDREPORT option table and their current default values. Disabled by default. See CHANGE= for information on permanently changing the defaults.
ERRCODE=
nnn
Specifies the return code to be issued by FDREPORT when error conditions are encountered. The number can be any value from 5 to 255. FDREPORT reports the highest return code from any service routine at the end of processing.
Default: Taken from the last value specified for ABRCC when updating the ABR option table, FDROPT, and is usually 12.
FDRLIB=
ddn
Specifies the FDRLIB DD Statement name to be used for reading FDREPORT control statements by the EXECUTE statement or punch mask definitions by the PUNCH statement. Can also be specified on those statements.
Default: FDRLIB.
FIELDPREFIX=
c
Specifies the character that marks the beginning of a field name in a punch mask or TITLE statement. Valid characters are <|&$*%_>:#@ but the default of “<” should not be overridden unless you need to use that character as data in the mask.
Default: <.
FIELDSUFFIX=
c
Specifies the character that marks the end of a field name in a punch mask or TITLE statement. Valid characters are <|&$*%_>:#@ plus a blank but the default of “>” should not be overridden unless you need to use that character as data in the mask.
Default: >.
c
Specifies the separating character to be used when formatting dates using Gregorian format. Valid characters are:
Default: /
GMSORTLEN=
nnnn
Specifies the number of bytes to be obtained for the generated SORT control statement when sorting is required. The number may be from 200 to 5000.
Default: Calculated based on the number of fields eligible for sorting.
c
Specifies the separating character to be used when formatting dates using Julian format. Valid characters are:
Default: .
Specifies the date to be used as a lower limit when validating the EXPDATE= operand. The date may range from 0 to 2155.365.
The date is specified as a Julian date (year plus day number) that may be in the form yyyyddd or yyddd. For readability, a period may be inserted between the year and day.
MAXEXECUTE=
nnnnn
Specifies the number of control statements that can be present in any single predefined report. The number may be a value from 10 to 32766.
MAXICF=
nnnnn
Specifies the maximum number of ICF VSAM clusters whose description can be retained in storage for any one report, from 100 to 10000. It is used only with DATATYPE=ARCHIVE or CATARCH.
Default: 400 clusters.
MAXSELCORE=
nnnnnnn
Specifies the amount of main memory, in bytes, to be GETMAIN’d for the storage of user related selection and/or exclusion criteria. The number may be a value from 4000 to 4000000.
Default: 12228 bytes of main memory is GETMAIN’d for selection and/or exclusion processing.
MAXTAPE=
nnnnn
Specifies the maximum number of tapes that are tabled for a given DASD volume during the execution of a report that includes backup information. The number may be from 10 to 32000.
Default: 100.
MCDSCLUSTER=
dsn
Specifies the cluster name of the DFSMShsm MCDS data set. The MCDS cluster is allocated if DATATYPE=MCDS is used.
If the MCDS is defined to DFSMShsm as a multi-cluster file, specify all the cluster names, in parenthesis (up to 4), for example,
MCDSCLUSTER=(cluster1,cluster2,cluster3,cluster4).
If these parameters are not specified, FDREPORT expects that the JCL contains a MCDSDD DD statement (for DATATYPE=MCDS).
MCDSDDNAME=
ddn
Specifies the ddname to be used when reading the DFHSM or DFSMShsm MCDS data set if DATATYPE=MCDS is used.
Default: MCDSDD.
OCDSCLUSTER=
dsn
Specifies the cluster name of the DFSMShsm OCDS data set.
OCDSDDNAME=
ddn
Specifies the ddname to be used when reading the DFHSM or DFSMShsm OCDS data set.
Default: OCDSDD.
PCHDEFCATALOG=
catn
Specifies the name of a user catalog to use when creating DEFINE ALIAS control statements with the PUNCHDEFINE function.
Default: All aliases for all catalogs are included in the PUNCHDEFINE.
RMMXDDNAME=
ddn
Specifies the ddname used when retrieving DFSMSrmm extracted data created by the EXTRACT command using PRODUCT=RMM.
Default: RMMXTR.
RMMXPREFIX=
pfx
Specifies the 1 to 8 character prefix to be used when naming the newly created extract field using the EXTRACT command with PRODUCT=RMM.
Default: Use the prefix of the user creating the file.
Specifies the date to be used to simulate an IPL at other than today’s date. The date may range from the current date to 2155.365.
The date is specified as a Julian date that may be in the form yyyyddd or yyddd. For readability, a period may be inserted between the year and day.
Default: Obtain the date from the system via the TIME SVC.
STARTCATALOG=
catn
Specifies the name of a user or alternate master catalog to search when a DATATYPE= of CATALOG, CATARCH, or CATVTOC is specified.
Default: The master catalog.
ddn
Specifies the ddname to be used when reading or rewriting the module F$REPOPT if the CHANGE= operand specifies either PERM or RESET.
Default: SYSLIB.