System Description › SMF Logstream Dump Processing › Overview

Overview

SMF logstream dump processing can be initiated in the following ways using CA SMF Director:

• By the computer operator, who can issue the z/OS START CASFDUML command from the console.
• Through a batch job that either invokes the CASFDUML procedure, or executes SMFDLS. This can be started either by a user or by an automated scheduling product such as CA-7.
• Automatically by CA Common Services for z/OS CAIRIM whenever a SWITCH SMF (I SMF) command is issued

To allow CA SMF Director to automatically dump a logstream, add a modified version of the CAIRIM control statement in the CASFPARM data set member CARIMPRM to the CAIRIMPRM member used by the CAS9 procedure that executed CAIRIM. The modification needed to set up automatic logstream dumping is made by changing the value of ENABLE to ENABLELS. CAIRIM dynamically installs a module that receives control in a similar way to the SMF exit IEFU29L. To deactivate this facility, modify the CAIRIM control statement by changing the ENABLELS keyword to DISABLE and then rerun the CAS9 procedure.

Note: ENABLELS will establish active exit intercepts for both the IEFU29 and IEFU29L SMF exits. This is because z/OS will switch back to recording SMF data to MAN files if there is a catastrophic failure of the logstreams. To learn more about how automatic dumping of MAN files is done, see the previous section in this chapter entitled SMF MAN file Dump Processing.

If you want a procedure name other than CASFDUML, we provide a user exit. This user exit allows you to change the name of the automated dump procedure. In addition, the exit can also be used to suppress a dump for one or more logstreams if multiple logstreams are in use. If the exit is not coded, the default command issued is:

S CASFDUML,LS=logstream.name

The logstream name is then passed to CASFDUML so that SMFDLS can process the logstream and archive the data. This command is issued once for each active SMF logstream unless the exit suppresses the command.