SMFD Control Statement Reference › SOURCE

SOURCE

This control statement lets you redefine the normal source of the data that CA SMF Director uses in its processing. It has three forms:

• SOURCE DUMP lets you read in a data set containing SMF data from a single SID as though it were a MAN file or a logstream and feed the data into CA SMF Director.
• SOURCE HISTORY lets you run an extract directly from a specified CA SMF Director history file instead of retrieving it through the SCDS. This form causes the DYNAM option to be disabled.
• SOURCE ALTERNATE tells CA SMF Director to use the alternate index for all subsequent EXTRACT and PRINT requests in the same execution.

You may specify SOURCE only once per run. The control statements can appear anywhere in the statement input stream.

Statement Format:

SOURCE

►►─ SOURCE ─┬───────────────────────────────┬─────────────────────────────────►
            ├─ DUMP(ddname) ─┬────────────┬─┤
            │                └─ SID(sid) ─┘ │
            ├─ HISTORY(ddname) ─────────────┤
            └─ ALTERNATE ───────────────────┘

 ►─┬─────────────────────────────────────────┬─ . ────────────────────────────►◄
   └─ LSNAME(logstream name) ─┬────────────┬─┘
                              └─ SID(sid) ─┘ 

Operands and Descriptions:

DUMP(ddname)

Specifies a file "(ddname)" to be used as input to the dump process. The normal system SMF data sets are not read, and only data from this file is processed. The file "(ddname)" cannot begin with "HIST."

When using a "SOURCE DUMP(ddname)" statement, SMF record types 2 and 3 will be ignored. If these records were to be processed, they would cause the SMF data to appear out of sequence. They are header and trailer records generated by the IBM SMFDUMP program and written to the dumped file.

HISTORY(ddname)

Specifies input file "(ddname)" for EXTRACT and PRINT requests, bypassing automatic retrieval of data from the history data sets.

"(ddname)" must be a 1 to 8-character name that corresponds to a DD statement in the execution JCL for this run.

ALTERNATE

Specifies that the alternate index is to be accessed for files needed to satisfy any EXTRACT or PRINT requests.

LSNAME(logstream name)

Specifies which logstreams are to be processed during a dump from an archive. If SID is specified, the logstreams must be within the SID.

SID(SID)

Specifies the SMF ID of records that are to be processed during a dump from a source file. This operand is primarily intended to be used when you are source dumping archival data from SMF logstreams because an SMF logstream can contain records from more than one system when the logstreams are backed by a list structure in a coupling facility.

The default SID is the SMF ID of the first record in the source SMF file. This operand is valid only when the DUMP and LSNAME operands are present.

Sample SOURCE Statement:

SOURCE ALTERNATE.

SOURCE statement output:

 CA                                              AUDIT TRAIL REPORT                          SMFD       PAGE     1
 CA SMF Director     12.6                                                            SYSA      27 JUL yyyy  11:45:24
 
  SOURCE ALTERNATE.
 
 CAF2800I  SOURCE OPTION SET
 
  PRINT SID(XE44) FROM(041698 131500)  TO(041698 132000) COUNT(5) .
 CAF1010I  REQUEST ACCEPTED
 
 
 CAF3200I  SMF RECORD TYPE 21 BUFFER DATE 04/16/2008 ( 98/106) TIME 13:16:44
          0000    1E150048 F1980098 106FE7C5 F4F40036   F3F0F5F0 F9F00752 78048081 00000033    *....1.....XE44..305090..........*
          0020    00000000 00000000 00000000 00000000   00000000 00000100 00000000 00000000    *................................*
          0040    00000000                                                                     *....                            *
 
 CAF3200I  SMF RECORD TYPE 21 BUFFER DATE 04/16/2008 ( 98/106) TIME 13:16:56
          0000    1E150048 F6700098 106FE7C5 F4F40036   F3F0F3F3 F0F2074D 78048081 00000049    *....6.....XE44..303302..........*
          0020    00000000 00000000 00000000 00000000   00000000 00037800 00000000 00000000    *................................*
          0040    00000000                                                                     *....                            *
 CAF3100I  2 RECORDS WRITTEN TO SYSPRINT FILE
 
 CAF2900I  RUN COMPLETE