Previous Topic: The SMFDLS Program

Next Topic: PARM Options for SMFDLS

PARM Options for SMFD

Specify these options using the standard JCL PARM parameter on the EXEC statement for SMFD. If multiple options are needed, specify them within quotes separated by a comma, like this:

PARM=”READ,PERMIT”
BACKUP

causes this product to copy the contents of the SCDS file to a sequential file, for a subsequent restore of the contents of the SCDS file.

DUMP

indicates that the contents of one or more SMF files are to be written to tape or DASD. (This option performs the same function as the DUMP command.)

FORCE

avoids the CAF1232E message and user ABEND 3001 if records with SIDs other than the SID being dumped are encountered in a MAN file, just like the IGNORE parameter. Unlike the IGNORE parameter, FORCE causes the records to be written to the history file anyway.

When the FORCE option is in effect, the location of all nonconforming SMF records is unknown to CA SMF Director and must be tracked manually.

Note: FORCE and IGNORE are mutually exclusive parameters. If both are specified, CA SMF Director issues error message CAF0011T and terminates with return code 12.

IGNORE

avoids the CAF1232E message and user ABEND 3001 if records with SIDs other than the SID being dumped are encountered in a MAN file. If this parameter is specified, CA SMF Director continues dumping, but all the records with a different SID are ignored.

Note: This parameter is not recommended, because it may cause a data loss. Use it only as a workaround solution when a MAN file accidentally contains records from multiple systems.

Note: FORCE and IGNORE are mutually exclusive parameters. If both are specified, CA SMF Director issues error message CAF0011T and terminates with return code 12.

INIT

causes this product to reinitialize the SCDS file, that is, to erase all Configuration definitions, all data set indexes, etc., from the SCDS file. (Obviously, this option must be used with extreme caution.)

NODUPS

This PARM can be used with PRINT/EXTRACT processing when overlapping SMF data has been detected. If overlapping index entries are detected, message CAF2411E is issued and processing ends with a return code of 8. If it is determined that there is duplicate data, use the NODUPS option to skip data in the overlap condition. Specifying PARM NODUPS causes CA SMF Director to continue processing data in overlapping index entries, while writing out records that will not be in the overlap condition.

NOSTAE

prevents this product from establishing a recovery environment when it starts up. That is, the diagnostic facilities of the system are turned off so that an OS dump is taken if CA SMF Director abends. (This option may be requested by CA Technical Support to aid in solving a problem.)

PERMIT

allows this product to PRINT/EXTRACT SMF data from history files even for SMF files that may overlap each other by date and time. If overlapping index entries are detected and the PERMIT or NODUPS PARM has not been specified, message CAF2411E is issued and processing stops with a return code of 8. If it is determined, upon examination of the data, that there are no duplicate records, the PERMIT option should be used to create the output containing all of the input data.

Note: Specifying this parameter may result in duplicate SMF data in the output data set when an overlap condition is detected.

READ

causes this product to access the SCDS file in read-only mode.

RESTORE

causes this product to perform a restore of the SCDS file from a previously-taken backup file.