Customization Considerations

System Description › Customization Considerations

Customization Considerations

CA SMF Director has been designed to provide flexibility in managing SMF data. This is accomplished by customizing various processing options. This product saves the information from these processing options on the SCDS. When DUMP processing is performed, these options are retrieved and then used to tailor how this product will manage the SMF data.

Three major categories of processing options can be customized:

Logstream and substream configuration options are set by one or more STREAMOPTIONS control statements. The STREAMOPTIONS statements appear within a BEGIN/END block and are coded similar to the DUMPOPTIONS, which cover the entire system. Not all of the operands on the STREAMOPTIONS statement need to be coded. The values that are not coded are set on the DUMPOPTIONS statement, or, if not indicated on DUMPOPTIONS, on the global OPTIONS statement.
System configuration options are set by the BEGIN, DUMPOPTIONS, DUMPTAPES, and END Control Statements. During DUMP processing, this product determines which options are in effect by matching the SMF SYSID within the SMF data to be dumped with the system configuration definition stored on the SCDS. Not all of the operands on the DUMPOPTIONS statement need to be coded. Defaults values are picked up from either the OPTIONS statement or the DUMPOPTIONS statement. The default values for both statements' operands are described in the User Guide.
Complex-wide configuration options are set by the OPTIONS Control Statement. These options control product features and are not specific to any system generating SMF data.

The following table summarizes the functions, their related keywords, and Control Statements:

Note: Each configuration can have a setting for the maximum files on a single tape volume on the DUMPOPTIONS statement, but a default value for all configurations can also be set on the OPTIONS statement.

Function	Keyword	Control Statement
Dynamically allocate history files to reduce JCL complexity and/or dependency	DYNAM *	OPTIONS DUMPOPTIONS
Automatically delete expired SMF history file index entries	AUTODEL	OPTIONS
Define what storage media to use for SMF history files by: specifying esoteric device name specifying IBM DFSMS storage class name	PDEVN, ADEVN PSTORC, ASTORC	OPTIONS DUMPOPTIONS STREAMOPTIONS
Set the time when a logical day begins for SMF data extraction	SDAY	OPTIONS DUMPOPTIONS STREAMOPTIONS
Set the maximum number of lines per page for the audit trail	MAXLINES	OPTIONS
Report on events that require attention, either immediately or in the near future	SERVICEDESK, SDURL, SDUSERID, SDPASSWORD, SDHIGHSEVERITY, SDLOWSEVERITY, NOSERVICEDESK	OPTIONS
Limit the number of data sets on a single tape volume	MAXFILESONVOL	OPTIONS DUMPOPTIONS STREAMOPTIONS
Control which magnetic tape volumes to use: Using a specific pool of Tape volume serials Using any volume serial in Tape Library Remove volume serials from a pool of volume serials	ADD, NOSCRATCH SCRATCH * DELETE	DUMPTAPES DUMPOPTIONS OPTIONS DUMPOPTIONS DUMPTAPES
Provide a duplicate set of SMF data (duplexing)	COPIES	OPTIONS DUMPOPTIONS STREAMOPTIONS
Set how long to retain SMF data	RETPD, EXPDT	OPTIONS DUMPOPTIONS STREAMOPTIONS
Specify how long to retain duplicated SMF data	ARETPD, AEXPDT	OPTIONS DUMPOPTIONS STREAMOPTIONS
Set a high-level qualifier for history file data set names	PREFIX, APREFIX	OPTIONS DUMPOPTIONS STREAMOPTIONS
Catalog SMF history files also in the System Catalog	CATLG, NOCATLG	OPTIONS DUMPOPTIONS STREAMOPTIONS
Specify recording technique on dynamically allocated tapes	TRTCH, ATRTCH	OPTIONS DUMPOPTIONS STREAMOPTIONS
Indicate which logstreams or substreams are to be managed	LSNAME, SUBNAME	DUMPOPTIONS STREAMOPTIONS

* These keywords must be present and active for SMF logstream or substream processing.

Note: Two special expiration dates are supported:

099000 indicates that the data set will not expire as long as it remains in the system catalog. It must be deleted manually.
099366 indicates that the data set will never expire.

If you installed CA SMF Director by upgrading from Unicenter CA-JARS SMF Utility, you must specify the following new options to be in effect:

DYNAM
AUTODEL
PDEVN
ADEVN
PSTORC
ASTORC
SERVICEDESK
TRTCH
ATRTCH

If you are recording SMF data to logstreams, the SCRATCH and DYNAM options must be set in the DUMPOPTIONS and OPTIONS control statements respectively.

Tell Technical Publications how we can improve this information