DEFSMF - syncsort_simulate_2000 - Latest

The DEFSMF statement defines an SMF record used in the rules language. During rules and procedure processing, the SET and ISSUE action statements use the WRITESMF parameter to actually write the SMF record. The DEFDMYU and DEFDMYV statements also use the WRITESMF parameter to invoke SMF record processing.

The DEFSMF statement can build the record with the use of literal strings and symbolic substitution. The text field must start with a single (‘) or double quote (“), and terminate with the same type of quote. Both character and numeric symbolic fields can be placed in the record. For more information, examine “Symbolic Fields” on page 3-10.

SMF records cannot be continued onto the next card. Add a plus (+) sign after the end of the text field, and start another quoted text field on the next control card. Record length after substitution is limited to 1024 bytes. For more information, examine “Continuation”.

DEFSMF name ”text”

FILTERRULE ( rulename ) LEVEL( level )

SMFRID( num )

name

Function: This is a required parameter. The name parameter is used by

the WRITESMF parameter on other ACC rule statements: DEFDMYU DEFDMYV, and DEFRULE. The name defines the link between the statement that wants a record written and the DEFSMF statement.

The DEFSMF statement can use a special statement name to establish parameter defaults. When $DEFAULT is specified, the rule compiler uses the specified parameters to modify the parameter defaults for later DEFSMF statements. For more information, examine “Using $DEFAULT onStatement Definitions” on page 3-42.

Default: None

Format: Specify a name 1 to 20 characters long.

”text”

Function: This is a required parameter. The text parameter is used to

define the record being written to SMF. This parameter can use both literal strings and symbolic substitution to build a record. The text field must start with a single (‘) or double quote (“), and terminate with the same type of quote. Text that requires the internal use of a quote should use the opposite type for the text delimiters.

Records cannot be continued onto the next card. Add a plus (+) sign after the end of the terminating quote, and start another quoted text field on the next control card. Record length after substitution is limited to 1024 bytes.

Default: None

Format: “text” or ‘text’

FILTERRULE ( rulename )

Function: This is an optional parameter. The FILTERRULE keyword can

be used to determine whether the current statement is honored by the rule processor. If the rule member requested by FILTERRULE sets the symbolic field RULE_SKIP = YES, then the current rule statement will be skipped. For more information, examine “FilterRules for Rule Statements” on page

3-19.

Default: None

Format: Specify the name of a rule member found in the SCC rule library:

DTS.R71.RULELIB.

LEVEL( level )

Function: The LEVEL parameter on the DEFSMF statement can be used to

assign a level to the SMF record. If no LEVEL is specified and WRITESMF is requested, the product will bypass SMF record level processing and the record will always be written.

Assigning an SMF record level - SMF records defined by the DEFSMF statement can be assigned levels of Information, Warning, Action, Error, or Catastrophic.

Default: None

Format: I, W, A, E or C

SMF record level processing - When the product writes an SMF record, the SMFLEVEL parameters on the DEFPROD, DEFENV and DEFPOOL

statements determine whether a record gets written. Only SMF records that have the same importance or higher will be written. For example, since the DEFPROD statement defaults to SMFLEVEL(A), only records assigned a level of Action, Error, or Catastrophic will be displayed.

Any SMFLEVEL parameters on the DEFENV and DEFPOOL statements have precedence over the level assigned by DEFPROD. Likewise, any SMFLEVEL on the device pool assigned to the DD statement sets the record level.

The SMFLEVEL parameters on the DEFPROD and DEFENV statements control record processing for allocation requests that are not associated with an ACC controlled allocation request or an SRS recovery request - no rule has selected a device pool for the DD statement.

SMFRID( num )

Function: This is a required parameter. The SMFRID parameter must be

used to set the SMF record identifier.

Default: None

Format: Specify a numeric value between 128-255.