Statements and parameters for SMFPRMxx

BUFSIZMAX values areas are defined with nnnnM for megabytes or 1 G for one gigabyte. For example, to request 1 gigabyte, specify BUFSIZMAX(1G) or BUFSIZMAX(1024M). To request 128 megabytes, specify BUFSIZMAX(128M).

The BUFSIZMAX value can be specified during an IPL in parmlib member SMFPRMxx and the value can be set higher or lower using the T SMF or SETSMF command.

The D SMF,O command displays the current BUFSIZMAX value.

• SMF maintains a single buffer area for all data recording.
• The parameter option value specifies the overall buffer warning level percentage when SMF starts to issue warning message IEE986E. When the amount of in-use buffer percentage falls below the BUFUSEWARN value minus 5 (the default is 20%), message IEE986E is deleted. When SMF is using this percentage of buffer space, message IEE986E is issued. As each additional or incremental SMF buffer (8M) is used to buffer SMF record data, SMF issues an updated instance of message IEE986E that indicates the new buffer storage percentage in use. As in-use SMF buffers are no longer needed, the buffers are removed from the in-use chain. After eligible buffers are removed, an updated instance of message IEE986E is issued that indicates the changed (reduced) buffer storage percentage in-use. When the overall SMF buffer in-use percentage drops to 5 percent below the BUFUSEWARN value, SMF performs a delete-operator-message (DOM) for message IEE986E.

The BUFUSEWARN value can be specified during an IPL in parmlib member SMFPRMxx, and you can set the value higher or lower using the T SMF or SETSMF commands. The D SMF,O command displays the current BUFUSEWARN value.

NOBUFFS(MSG)
BUFUSEWARN(25)
DEFAULTLSNAME(ifasmf.default)
LSNAME(ifasmf.important,NOBUFFS(HALT),BUFUSEWARN(30))

DEFAULTLSNAME(IFASMF.DEFAULT)
LSNAME(IFASMF.PERF,TYPE(30,89))
RECORDING(LOGSTREAM)

DEFAULTLSNAME(logstreamname
              [,NOBUFFS(HALT|MSG)]
              [,BUFUSEWARN(nn)]
              [,DSPSIZMAX(nnnnM|nG)]
              [,NOCOMPRESS|COMPRESS[(PERMFIX(nnnnM))]]
              [,NORECSIGN|RECSIGN(HASH(SHA1|SHA256|SHA384|SHA512),
                                  SIGNATURE(RSA|ECDSA),
                                  TOKENNAME(tokenname))]
              [,NOARECSIGN|ARECSIGN(HASH(SHA512),
                                  SIGNATURE(L12),
                                  TOKENNAME(tokenname))])

When the following subparameters are not specified and the log stream is already connected, SMF does not use the default values or change the subparameters. SMF continues to use previous SET or SETSMF values. However, if the log stream is disconnected and then reconnected, and if the subparameters are not specified on the last SET or SETSMF command affecting the log stream, SMF uses the default values.

You can specify the following subparameters for DEFAULTLSNAME:

logstreamname

The name of the log stream. Follow the log stream naming guidelines that are specified for the LSNAME parameter.

BUFUSEWARN(nn)

BUFUSEWARN specifies the overall buffer warning level percentage (nn) when SMF starts to issue warning message IFA785E for the log stream specified on this DEFAULTLSNAME parameter. This option can also be specified as a global option setting that applies to all log streams defined by the LSNAME and DEFAULTLSNAME keywords. This option overrides the globally specified BUFUSEWARN option for the log stream specified on this DEFAULTLSNAME parameter only. For a detailed description of this parameter, see the parameter option description for the global specification of BUFUSEWARN.

Default: The option that is specified on the global BUFUSEWARN parameter. Also, see Table 1, which lists the default values for the DEFAULTLSNAME subparameters in both SET SMF and SETSMF processing.

NOCOMPRESS | COMPRESS[(PERMFIX(nnnnM))]

COMPRESS is an optional parameter. When specified with an zEDC Express® feature available, SMF compresses SMF records before writing to the log stream. This option allows for greater throughput of SMF records.

If an zEDC Express feature fails or none are available for use, message IFA730E is issued and SMF continues writing non-compressed records to the log stream.

To restart a failed zEDC session, issue either of the following commands:

• SETSMF RECORDING=LOGSTREAM
• SET SMF=xx where xx is the SMFPRMxx member that specifies LSNAME with the COMPRESS option.

To turn off an zEDC session once it has successfully started:

• Specify NOCOMPRESS either as a global setting or on the LSNAME, as appropriate. Note that once COMPRESS is activated for a log stream, the default of NOCOMPRESS is not instated in the absence of the COMPRESS parameter.
• Issue SET SMF=xx or SETSMF to activate the changed setting.

Once SMF can successfully write compressed data, SMF issues message IFA731I.

Default: (If an zEDC session has not started) NOCOMPRESS (Also see Table 1, which lists the default values for the DEFAULTLSNAME subparameters in both SET SMF and SETSMF processing.)

PERMFIX(nnnnM)

PERMFIX is an optional parameter when COMPRESS is specified. PERMFIX specifies the default amount of storage that SMF can keep permanently fixed for purposes of communicating with the zEDC Express feature. Storage that is used by the zEDC Express feature must be page fixed; however, fixed pages are a constrained resource. Increasing this number can improve performance of SMF, but decreases the fixed storage available to the other applications. Decreasing this number can increase the fixed storage available to other applications, but might degrade SMF performance. PERMFIX can range from a minimum of 1M to a maximum of 2 GB. Due to processing needs, even if this value is NOPERMFIX, SMF can use up to 2 MB of fixed storage for zEDC usage.

Default: If specified, this value overrides the global PERMFIX value. Also, see Table 1, which lists the default values for the DEFAULTLSNAME subparameters in both SET SMF and SETSMF processing.

DSPSIZMAX(nnnnM|nG)

The DSPSIZMAX subparameter specifies the amount of storage this log stream is to use for buffers.

Default: 2G. Also, see Table 1.

NOBUFFS(HALT|MSG)

NOBUFFS specifies the system action when the log stream specified on this DEFAULTLSNAME parameter buffer area is full. This option can also be specified as a global option setting. This option overrides the globally specified NOBUFFS option for the log stream that is specified on this DEFAULTLSNAME parameter only. See the parameter option description for the global specification of NOBUFFS for a detailed description of this parameter.

Default: The option that is specified on the global NOBUFFS parameter. Also, see Table 1, which lists the default values for the DEFAULTLSNAME subparameters in both SET SMF and SETSMF processing.

NORECSIGN | RECSIGN(HASH(SHA1|SHA256|SHA384|SHA512), SIGNATURE(RSA|ECDSA),TOKENNAME(tokenname))

Specifies whether SMF is to digitally sign the records that are being recorded for the log stream specified by this DEFAULTLSNAME parameter. If NORECSIGN is specified, SMF will not sign records for this log stream. If RECSIGN is specified, the HASH, TOKENNAME, and SIGNATURE keywords must also be specified. This specification overrides any global RECSIGN specification.

Default: None

HASH(SHA1|SHA256|SHA384|SHA512)

The HASH keyword specifies the hash-technique that ICSF will use to calculate the hash value for the digital signature. Valid values are SHA1, SHA256, SHA384, and SHA512.

Default: None

SIGNATURE(RSA|ECDSA)

The SIGNATURE keyword specifies the signature type to be used in conjunction with the key specified above. If the signature type and token name are incompatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF command is issued to rectify the discrepancy. The valid values are RSA and ECDSA.

Default: None

TOKENNAME(tokenname)

The TOKENNAME keyword specifies the token name to be used with the specified hashing technique. It must be 32 characters in length and must be a valid token. See z/OS Cryptographic Services System SSL Programming for more information. If the token name and signature are not compatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF are issued to rectify the issue.

Default: None

For more information, see Signing and validating SMF records in z/OS MVS System Management Facilities (SMF).

NOARECSIGN | ARECSIGN(HASH(SHA512), SIGNATURE(LI2),TOKENNAME(tokenname))

Specifies whether SMF is to digitally sign the records that are being recorded for the log stream using an alternate signature method specified by this DEFAULTLSNAME parameter. If NOARECSIGN is specified, SMF will not sign records using an alternate signature for this log stream. If ARECSIGN is specified, the HASH, TOKENNAME, and SIGNATURE keywords must also be specified. This specification overrides any global ARECSIGN specification.

When using an alternate signature method, a primary signature method is also required. The primary signature method can be specified using the global RECSIGN specification or a RECSIGN specification on the DEFAULTLSNAME parameter.

Default: None

HASH(SHA512)

The HASH keyword specifies the hash-technique that ICSF will use to calculate the hash value for the digital signature. The only valid value is SHA512.

Default: None

SIGNATURE(L12)

The SIGNATURE keyword specifies the signature type to be used in conjunction with the key specified above. If the signature type and token name are incompatible, IFA740E is issued and SMF will not sign records using an alternate signature until a SET SMF or SETSMF command is issued to rectify the discrepancy. The only valid value is L12 (Dilithium). Cryptographic Support for z/OS® V2R2 - V2R4 (HCR77D1) and IBM® z15™™ are required for Dilithium signature support.

Default: None

TOKENNAME(tokenname)

The TOKENNAME keyword specifies the token name to be used with the specified hashing technique. It must be 32 characters in length and must be a valid token. See z/OS Cryptographic Services System SSL Programming for more information. If the token name and signature are not compatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF are issued to rectify the issue.

Default: None

For more information, see Signing and validating SMF records in z/OS MVS System Management Facilities (SMF).

• DDNAME
• Device class
• Unit type
• Channel address
• Unit address

Long-running jobs might take a long time to end in this case, because of the building of the SMF type 30 records for a long-running job.

DDCONS(NO) requests that this consolidation function be bypassed, which results in a reduction in the amount of processing required to build the records, and thus a reduction in the amount of time that is required to complete the job.

The maximum length of the data set name is 44 characters, and must follow standard MVS™ data set naming conventions.

You can use system symbols and the &SID symbol in SMF data set names. The resolved substitution text for the &SID system symbol is the system identifier that is specified on the SID parameter in SMFPRMxx. &SID can be used only to name resources in SMFPRMxx; you cannot specify &SID in other parmlib members.

This is the global specification of the DSPSIZMAX value, and its value takes effort for log streams where DSPSIZMAX was not specified.

RETRY

Specifies that the SMF dump program attempts to recover from abends and continue processing.

NORETRY

Specifies that the SMF dump program terminates when an abend occurs.

NOSUPPRESS

Specifies that the system generates an empty SMF type 30 record EXCP section for each SMS candidate volume in the storage group that is not allocated to the DD statement. By default, empty EXCP sections are also generated for non-dataset allocations like DD DUMMY or spool file allocations.

SUPPRESS

specifies that the system suppresses the creation of empty EXCP sections for non-allocated candidate volumes in the SMS storage group. With this option, empty EXCP sections that are generated for non-dataset allocations like DD DUMMY or spool file allocations are also suppressed.

For a description of SMF flood policies, see the topic on FLOOD and FLOODPOL — Specifying SMF record flood options in z/OS MVS System Management Facilities (SMF).

ACTION(MSG|DROP)

Specifies the action to be taken when a flood state is entered.

DROP

Issue message IFA782A at the start of the flood state and also begin dropping records. Any attempts to write a record through the SMFEWTM or SMFWTM macro results in a return code 52. At the end of the flood state, message IFA783I is issued that indicates the number of records that have been dropped.

For more information about SMFEWTM and SMFWTM, see SMFEWTM - Writing SMF records and SMFWTM — Writing SMF records in z/OS MVS System Management Facilities (SMF).

MSG

Issue warning message IFA780A at the start of the flood state. Message IFA781I is issued when the flooding has stopped.

Default: None

ENDINTVL(ssss)

Specifies the amount of time, in tenths of a second, that must elapse before SMF determines that a flood has ended. Once a flood state has begun, if less than the RECTHRESH records are generated in at least ENDINTVL amount of time, the flood will end. SMF only checks for ending a flood as records are generated, as opposed to checking at the specified ENDINTVL amount of time.

Value range: 1-9999

Default: None

INTVLTIME(ssss)

Specifies a flood interval time value, which is given in tenths of seconds. A flood rate is defined by the RECTHRESH number of records that are generated within INTVLTIM time. Flood policies are decided first on how many records are generated and then on how long it takes to generate them, rather than being based only on an interval basis.

Value range: 1-9999

Default: None

MAXHIGHINTS(xxxx)

Specifies the number of intervals, defined by INTVLTIME, that must occur at or above the flood rate before action is taken. When the THRESHRECS number of records are generated within the INTVLTIME time period (interval) for the MAXHIGHINTS consecutive number of intervals, SMF enters into a flood state for the designated record type.

Value range: 1-9999

Default: None

RECTHRESH(xxxx)

Specifies the number of records in an interval for this filter.

Value range: 1-9999

Default: None

TYPE{(aa,bb)|(aa,bb:zz)|(aa,bb:zz,…)}

Specifies the records for this filter.

Value range: 0-2047 (SMF record types).

Default: None

FLOOD(ON)

FLOODPOL(TYPE(4,5),RECTHRESH(1000),INTVLTIME(50),MAXHIGHINTS(15),ENDINTVL(120),ACTION(MSG))
FLOODPOL(TYPE(102),RECTHRESH(5000),INTVLTIME(10),MAXHIGHINTS(15),ENDINTVL(100),ACTION(MSG))
FLOODPOL(TYPE(102),RECTHRESH(5000),INTVLTIME(10),MAXHIGHINTS(15),ENDINTVL(50),ACTION(DROP))

In this example, two filters are set up. The first filter sets up a monitor for both record types 4 and 5. This filter detects when 1000 records are generated within 5 seconds and, if records continue to be generated at this rate for more than 15 consecutive 5-second intervals, message IFA780A is issued. The flood state ends, for each record type, when fewer than 1000 records are generated in at least 12 seconds. Message IFA781I is issued when the flood state ends.

The second filter for record type 102 is a two-part filter. The first part that issues the warning message, IFA780A, is triggered when 5000 records are generated in less than 1 second, and records continue to be generated at that rate for more than 15 consecutive 1-second intervals. The flood state ends when fewer than 5000 records are generated in at least 10 seconds. Message IFA781I is issued when the flood ends. If the flood state persists, the DROP filter becomes active so that if 5000 type-102 records are generated within 1 second over more than 15 consecutive 1-second intervals, message IFA782A is issued and records are dropped. Records stop being dropped once fewer than 5000 type 102 records are generated in at least 5 seconds. Message IFA783I is issued when the flood state for dropping records ends.

When the NOWIC parameter is specified or allowed to default, the

The supported values are 5, 10, 15, 20, 30, and 60 seconds. For instance, HFTSINTVL(20) indicates that SMF type 98 records are to be written every 20 seconds. IBM suggests a HFTSINTVL value of 5 seconds.

When you specify any HFTSINTVL value, SMF type 98 records are collected every five seconds for one minute each hour, at 0, 15, 30, and 45 minutes past each hour. For all other minutes during each hour, SMF type 98 records are written at the interval specified by the HFTSINTVL parameter.

The NOHFTSINTVL parameter disables the HFTS interval and prevents the collection of SMF type 98 records. This is the default value.

SMF collects type 98 records only when both the HFTSINTVL parameter and the TYPE(98) parameter are specified. Specifying NOHFTSINTVL along with TYPE(98) allows you to disable the collection of type 98 records without changing the TYPE setting.

Consider writing SMF type 98 records to a separate log stream because SMF type 98 records are written more frequently than traditional SMF records.

When the WIC parameter is specified, the HFTSINTVL value is ignored.

When you specify the WIC parameter, the HFTSINTVL parameter is ignored, and SMF type 98 subtype 1 records are generated every 5 seconds.

When you specify the NOWIC parameter, IBM z/OS Workload Interaction Correlator (WIC) is disabled on the system. The IFAWIC REQUEST=REGISTER service will fail for applications that call it. IFAWIC exploiters that are already registered for instrumentation will no longer have their exit routines called. When NOWIC is specified, HFTSINTVL is honored.

 
INMEM(rname,RESSIZMAX({nnnnM|nG}),{TYPE({aa,bb|aa,bb:zz|aa,bb:zz,…})|
                                   NOTYPE({aa,bb|aa,bb:zz|aa,bb:zz,…})}
 

You must specify the following subparameters for INMEM:

rname

Name of the in-memory resource. The resource name must begin with IFASMF. and can be up to 26 characters long. The resource name must be unique across resource names on other INMEM statements and log stream names on LSNAME statements.

You must also define a SAF resource in the FACILITY class to protect the in-memory resource. The SAF resource profile name must start with the IFA. high-level qualifier, followed by the same name that you specify for rname.

Note: You must define the SAF resources before you attempt to activate the SMFPRMxx member; otherwise, SMF will reject the entire SMFPRMxx member.

For more information, see z/OS MVS System Management Facilities (SMF).

Default: None.

RESSIZMAX({nnnnM|nG})

Specifies the size of the buffer available for this in-memory resource, in megabytes or gigabytes.

The in-memory resource acts as a wrap-around buffer. When the buffer is full, older records are discarded as newer records are written. When planning the RESSIZMAX value, select a value that can be accommodated by the system's real and auxiliary storage, assuming that the entire amount will be used at all times.

Default: 2 GB

Value range: 128 MB - 2 GB

TYPE({aa,bb|aa,bb:zz|aa,bb:zz,…})

NOTYPE({aa,bb|aa,bb:zz|aa,bb:zz,…})

TYPE specifies the SMF record types that are to be recorded to this in-memory resource. The aa, bb, and zz values are the decimal notations for each SMF record type. You cannot specify subtypes on the TYPE subparameter for INMEM. A colon (:) indicates a range of SMF record types (bb through zz) to be recorded.

NOTYPE specifies that SMF is to collect all SMF record types except those specified. The aa, bb, and zz values are the decimal notations for each SMF record type. You cannot specify subtypes on the NOTYPE subparameter for INMEM. A colon indicates the range of SMF record types (bb through zz) that are not to be recorded.

The record types to be recorded to an in-memory resource do not also have to be recorded to a log stream.

Note: Record types that you specify on an INMEM parameter are not written to the default log stream, if any, defined by the DEFAULTLSNAME parameter. If you want certain record types to be written to both an in-memory resource and a log stream, specify those record types on both an INMEM parameter and an LSNAME parameter.

Note: An active connection prevents the SET SMF=xx command from changing the in-memory resource definition, such as changes to the TYPE or RESSIZMAX parameters.

Default: None.

Value range: 0 - 2047 (SMF record types)

Choose a two-digit global interval value, mm, that divides evenly into 60 (01, 02, 03, 04, 05, 06, 10, 12, 15, 20, 30, and 60). Otherwise, the system can synchronize only the first interval.

• Data set name
• Data set status
  • Active
  • Alternative
  • Close pending
  • Error
  • Dump required
• Data set size (in number of VSAM control-interval-sized blocks)
• Percentage full

DEFAULTLSNAME(IFASMF.DEFAULT)
LSNAME(IFASMF.PERF,TYPE(30,89))
LSNAME(IFASMF.JOB,TYPE(30))
RECORDING(log stream)

This allows you to collect job-related SMF data in the JOB log stream, and performance-related SMF data in the PERF log stream. Record type 30 fits into both categories, so you can specify that it is written to both log streams. Note that this arrangement can result in duplicate records being recorded.

LSNAME(log streamname,TYPE{(aa,bb)|(aa,bb:zz)|(aa,bb:zz,…)}
       [,NOBUFFS(HALT|MSG)]
       [,BUFUSEWARN(nn)]
       [,DSPSIZMAX(nnnnM|nG)]
       [,NOCOMPRESS|COMPRESS[(PERMFIX(nnnnM))]]
       [,NORECSIGN|RECSIGN(HASH(SHA1|SHA256|SHA384|SHA512),
                           SIGNATURE(RSA|ECDSA),
                           TOKENNAME(tokenname))]  
       [,NOARECSIGN|ARECSIGN(HASH(SHA512),
                           SIGNATURE(L12), 
                           TOKENNAME(tokenname))])

When the following subparameters are not specified and the log stream is already connected, SMF does not use the default values or make changes to the subparameters. SMF continues to use previous SET or SETSMF values. However, if the log stream is disconnected and then reconnected, and if the subparameters are not specified on the last SET or SETSMF against the log stream, SMF uses the default values.

You can specify the following subparameters for LSNAME:

log streamname

The name of the log stream. The log stream name must be composed as follows:

• The first seven characters must be: IFASMF.
• It must have a minimum of 8 characters.
• It must have a maximum of 26 characters.
• It must conform to other log stream naming conventions as documented in IXGINVNT – Managing the LOGR inventory couple data set in z/OS MVS Programming: Assembler Services Reference IAR-XCT.
• It must be unique across log stream names on other LSNAME statements and in-memory resource names on INMEM statements.

You can use system symbols and the &SID symbol in SMF log stream names. The resolved substitution text for the &SID system symbol is the system identifier that is specified on the SID parameter in SMFPRMxx. &SID can only be used to name resources in SMFPRMxx; you cannot specify &SID in other parmlib members.

Table 4 shows examples of log stream names that use the &SYSNAME system symbol and the &SID symbol. The table shows the substitution texts for &SYSNAME and &SID, the data set names that specify the symbols, and the resolved texts for the log stream names.

Table 4. Examples of log stream names that use system symbols

Substitution text		Log stream name	Resolved log stream name
&SID	&SYSNAME
WRR1	-	IFASMF.SYS1.&SID..DATA	IFASMF.SYS1.WRR1DATA
WRR1	-	IFASMF.SYS1.SID&SID..DATA	IFASMF.SYS1.SIDWRR1.DATA
WRR1	SP52	IFASMF.SYS1.&SYSNAME;&SID..DATA	IFASMF.SYS1.SP52WRR1.DATA
-	SP52	IFASMF.SYS1.&SYSNAME	IFASMF.SYS1.SP52

If you specify an incorrect log stream name, the system issues message IFA700I.

BUFUSEWARN(nn)

BUFUSEWARN specifies the overall buffer warning level percentage (nn) when SMF starts to issue warning message IFA785E for the log stream that is specified on this LSNAME parameter. This option can also be specified as a global option setting that applies to all log streams defined by the LSNAME and DEFAULTLSNAME keywords. This option overrides the globally specified BUFUSEWARN option for the log stream that is specified on this LSNAME parameter only. For a detailed description of this parameter, see the parameter option description for the global specification of BUFUSEWARN.

Default: The option that is specified on the global BUFUSEWARN parameter. Also, see Table 3, which lists the default values for the LSNAME subparameters in both SET SMF and SETSMF processing.

NOCOMPRESS | COMPRESS[(PERMFIX(nnnnM))]

COMPRESS is an optional parameter. When specified with an zEDC Express feature available, SMF compresses SMF records before writing to the log stream.

Default: (If an zEDC session has not started) NOCOMPRESS (Also see Table 3, which lists the default values for the LSNAME subparameters in both SET SMF and SETSMF processing.)

If all zEDC Express features fail or none are available for use, message IFA730I is issued and SMF continues writing non-compressed records to the log stream.

To restart a failed zEDC session, issue a SETSMF RECORDING=log stream to retry compression or alter other SMF parameters using the SET or the SETSMF command. Message IFA731I is issued when compression is successfully enabled.

To turn off an zEDC session once it has successfully started:

• Specify NOCOMPRESS either as a global setting or on the LSNAME, as appropriate. Note that once COMPRESS is activated for a log stream, the default of NOCOMPRESS is not instated in the absence of the COMPRESS parameter.
• Issue SET SMF=xx or SETSMF to activate the changed setting.

Once SMF can successfully write compressed data, SMF will issue message IFA731I.

PERMFIX(nnnnM)

PERMFIX is an optional parameter when COMPRESS is specified. PERMFIX specifies the default amount of storage that SMF can keep permanently fixed for purposes of communicating with the zEDC Express feature. Storage that is used by the zEDC Express feature has to be page fixed; however, fixed pages are a constrained resource. Increasing this number can improve performance of SMF, but decreases the fixed storage available to the other applications. Decreasing this number can increase the fixed storage available to other applications, but might degrade SMF performance. PERMFIX can range from a minimum of 1M to a maximum of 2 GB. Due to processing needs, even if this value is NOPERMFIX, SMF can use up to 2 MB of fixed storage for zEDC usage.

If specified, this value overrides the global PERMFIX value.

NOBUFFS(HALT|MSG)

NOBUFFS specifies the system action when the log stream specified on this LSNAME parameter buffer area is full. This option can also be specified as a global option setting. This option overrides the globally specified NOBUFFS option for the log stream that is specified on this LSNAME parameter only. For a detailed description of this parameter, see the parameter option description for the global specification of NOBUFFS.

Default: The option that is specified on the global NOBUFFS parameter. Also, see Table 3, which lists the default values for the LSNAME subparameters in both SET SMF and SETSMF processing.

TYPE{(aa,bb)|(aa,bb:zz)|(aa,bb:zz,…)}

TYPE specifies the SMF record types that SMF is to collect to the specified log stream on the LSNAME parameter. aa, bb, and zz are the decimal notations for each SMF record type. You cannot specify subtypes on the TYPE subparameter for LSNAME. A colon indicates the range of SMF record types (bb through zz) to be recorded.

Note:

• A specified value of 126 is ignored by the system.
• The specified TYPE or NOTYPE parameter values must resolve to at least one non 126 type value.
• TYPE or NOTYPE parameter options that are specified after the first TYPE or NOTYPE are ignored.

Default: None.

Value range:

0-2047 (SMF record types)

Value range:

When any globally specified record types are rendered without an LSNAME home, the configuration is rejected with message IFA702I stating that no log streams were specified for record type nnn nnn. When all record types have a home, but LSNAME was specified without the TYPE parameter, the LSNAME parameter is accept but ignored. No record types are written to an LSNAME without the TYPE parameter.

NORECSIGN | RECSIGN (HASH(SHA1|SHA256|SHA384|SHA512), SIGNATURE(RSA|ECDSA), TOKENNAME(tokenname))

Specifies whether SMF is to digitally sign the records that are being recorded for the log stream specified by this LSNAME parameter. If NORECSIGN is specified, SMF will not sign records for this log stream. If RECSIGN is specified, the HASH, TOKENNAME, and SIGNATURE keyword must also be specified. This specification overrides any global RECSIGN specification.

Default: None

HASH(SHA1|SHA256|SHA384|SHA512)

The HASH keyword specifies the hash-technique that ICSF will use to calculate the hash value for the digital signature. Valid values are SHA1, SHA256, SHA384, SHA512.

Default: None

SIGNATURE(RSA|ECDSA)

The SIGNATURE keyword specifies the signature type to be used in conjunction with the key specified above. If the signature type and token name are incompatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF command is issued to rectify the discrepancy. The valid values are RSA and ECDSA.

Default: None

TOKENNAME(tokenname)

The TOKENNAME keyword specifies the token name to be used with the specified hashing technique. It must be 32 characters in length, and must be a valid token. See z/OS Cryptographic Services System SSL Programming for more information. If the token name and signature are incompatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF are issued to rectify the issue.

Default: None

For more information, see Signing and validating SMF records in z/OS MVS System Management Facilities (SMF).

NOARECSIGN | ARECSIGN(HASH(SHA512), SIGNATURE(LI2),TOKENNAME(tokenname))

Specifies whether SMF is to digitally sign the records that are being recorded for the log stream using an alternate signature specified by this LSNAME parameter. If NOARECSIGN is specified, SMF will not sign records using an alternate signature for this log stream. If ARECSIGN is specified, the HASH, TOKENNAME, and SIGNATURE keywords must also be specified. This specification overrides any global ARECSIGN specification.

When using an alternate signature method, a primary signature method is also required. The primary signature method can be specified using the global RECSIGN specification or a RECSIGN specification on the DEFAULTLSNAME parameter.

Default: None

HASH(SHA512)

The HASH keyword specifies the hash-technique that ICSF will use to calculate the hash value for the digital signature. The only valid value is SHA512.

Default: None

SIGNATURE(LI2)

The SIGNATURE keyword specifies the signature type to be used in conjunction with the key specified above. If the signature type and token name are incompatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF command is issued to rectify the discrepancy. The only valid value is LI2 (Dilithium). Cryptographic Support for z/OS V2R2 - V2R4 (HCR77D1) and IBM z15™ are required for Dilithium signature support.

Default: None

TOKENNAME(tokenname)

The TOKENNAME keyword specifies the token name to be used with the specified hashing technique. It must be 32 characters in length, and must be a valid token. See z/OS Cryptographic Services System SSL Programming for more information. If the token name and signature are not compatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF are issued to rectify the issue.

Default: None

For more information, see Signing and validating SMF records in z/OS MVS System Management Facilities (SMF).

MAXDORM specifies the amount of real time that SMF allows data to remain in an SMF buffer before it is written to a recording data set or a log stream, where mm is real time in minutes and ss is seconds. NOMAXDORM specifies that the data remains in the buffer until the buffer is full. The size of the non-full buffer written out when the MAXDORM reached is one control interval (CI).

The system detects a change in processor speed when an ENF 41 is signaled, along with a change in processor capacity data.

nn

Specifies the maximum number of these additional event driven interval records that are allowed during a single interval. When the number of processor capacity changes during a single interval exceeds the value that is specified by nn, no additional type 30 or 89 event driven interval records are generated for the interval, and data for the following, regularly scheduled interval is relevant to the most recent processor capacity change.

The default value of zero for this option results in only regularly scheduled interval records to be generated for each interval. A value greater than zero allows up to that many extra sets of type 30 and 89 records to be collected within one interval as the processor capacity is changed. If precise capacity measurements are needed for billing, the value of nn should match the number of processor capacity changes expected in a single interval.

MEMLIMIT values are defined with nnnnnM for megabytes, nnnnnG for gigabytes, nnnnnT for terabytes, or nnnnnP for petabytes. For example, to request 1275 gigabytes, specify MEMLIMIT(1275G), or to request 15 petabytes, specify MEMLIMIT(15P). The DISPLAY SMF,O command displays the current MEMLIMIT.

If MEMLIMIT is not specified in SMFPRMxx, the default value for this system default is 2G.

For a complete description of MEMLIMIT, and the ways to define it, see z/OS MVS Programming: Extended Addressability Guide.

• For data set recording environments, specifies the system action when the SMF address space has run out of buffer space.

  MSG

  Specifies that the system is to issue a message and continue processing; SMF data is lost until buffer storage is again available.

  HALT

  Specifies that the system is to enter a restartable wait state. HALT means that no SMF data is lost.

  Default: MSG
• For log stream recording environments, specifies the system action when any one of the defined SMF log stream buffer areas run out of space. A separate buffer area is maintained for each SMF log stream and the option that is specified for this parameter applies to all log streams defined for SMF data collection. The specified option can be overridden for a particular log stream buffer if NOBUFFS is also specified as a subparameter on the LSNAME or DEFAULTLSNAME SMFPRMxx parameter options.

  MSG

  Specifies that the system is to issue message IFA786W and continue processing. Note that when the log stream buffer is full, data that is designated to be written to that log stream only will be lost until the log stream buffer storage becomes available.

  HALT

  Specifies that the system is to enter a restartable wait state when the log stream buffer is full. Specifying HALT prevents data loss when the log stream buffer is full.

  Default: MSG

This is the global PERMFIX option and can be overridden by the PERMFIX subparameter of the LSNAME or DEFAULTLSNAME parameters.

IPLR

The operator is to supply a reason for the IPL.

LIST

The operator is prompted for possible modifications to the SMF parameters.

ALL

The operator is prompted for the IPL reason and can modify the SMF parameters.

NOPROMPT specifies that the parameters are not listed and the operator is not prompted unless there is a syntax error in the parmlib member.

HASH(SHA1|SHA256|SHA384|SHA512)

The HASH keyword specifies the hash-technique that ICSF will use to calculate the hash value for the digital signature. Valid values are SHA1, SHA256, SHA384, and SHA512.

Default: None

SIGNATURE(RSA|ECDSA)

The SIGNATURE keyword specifies the signature type to be used in conjunction with the key specified above. If the signature type and token name are incompatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF command is issued to rectify the discrepancy. The valid values are RSA and ECDSA.

Default: None

TOKENNAME(tokenname)

The TOKENNAME keyword specifies the token name to be used with the specified hashing technique. It must be 32 characters in length and must be a valid token. See z/OS Cryptographic Services System SSL Programming for more information. If the token name and signature are not compatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF are issued to rectify the issue.

Default: None

For more information, see Signing and validating SMF records in z/OS MVS System Management Facilities (SMF).

When the global ARECSIGN parameter is specified,the global RECSIGN parameter must also be specified.

HASH(SHA512)

The HASH keyword specifies the hash-technique that ICSF will use to calculate the hash value for the digital signature. The only valid value is SHA512.

Default: None

SIGNATURE(L12)

The SIGNATURE keyword specifies the signature type to be used in conjunction with the key specified above. If the signature type and token name are incompatible, IFA740E is issued and SMF will not sign records using an alternate signature until a SET SMF or SETSMF command is issued to rectify the discrepancy. The only valid value is LI2 (Dilithium). Cryptographic Support for z/OS V2R2 - V2R4 (HCR77D1) and IBM z15™ are required for Dilithium signature support.

Default: None

TOKENNAME(tokenname)

The TOKENNAME keyword specifies the token name to be used with the specified hashing technique. It must be 32 characters in length and must be a valid token. See z/OS Cryptographic Services System SSL Programming for more information. If the token name and signature are not compatible, IFA740E is issued and SMF will not sign records until a SET SMF or SETSMF are issued to rectify the issue.

Default: None

For more information, see Signing and validating SMF records in z/OS MVS System Management Facilities (SMF).

You can specify the SID value directly, or you can have the system select from several SID values, using the processor serial numbers or the SYSNAME value.

 SID(AAAA,012303)
 SID(BBBB,012304)

When running on processor 012303, the system selects an SID value of AAAA. When running on processor 012304, the system selects an SID value of BBBB.

 SID(AAAA,SYSNAME(PRODSYS))
 SID(BBBB,SYSNAME(TESTSYS))

 SYSNAME(TESTSYS)

In this case, the system selects BBBB as the SID value, because the name TESTSYS matches the name that is specified in IEASYSxx or IEASYMxx.

When defining the system identifier, you can use:

• System symbols and substrings of system symbols (the resolved substitution texts for the system symbols must contain 1-4 characters).

  The system substitutes text for system symbols before it validates the syntax of the SID parameter. If errors occur in system symbol notation, the system prompts the operator to respecify the SID parameter. See What are system symbols? for information about the syntax of system symbols.

• The system name that is specified in IEASYSxx or IEASYMxx.
• Processor serial numbers that are used at IPL.
• Combinations of processor serial numbers that are used at IPL.

The preferred way to define the system identifier is to assign the identifier to a system symbol.

   SID(SYSA)
   SID(SYSB,006204,106204)
   SID(SYSC,SYSNAME(SYS0001))
   SID(&SYSNAME(1:4))
   SID(SYSE,COMBIN(006204,106204,206204))

As the default, if the SID parameter is not specified, and no other SID specification is available, the system uses the four-digit processor model number.

It is possible for more than one SID specification to apply to one system. For example, if a SMFPRMxx member includes two SID specifications, SID(AAAA) and SID(BBBB,SYSNAME(SYSBBBB)) and the system is IPLed with a system name of SYSBBBB, both SID specifications apply. In this case, the precedence rules that are listed in Table 5 apply.

The lower the number, the higher the priority. For syntax with similar priority numbers, the first occurrence in the SMFPRMxx parmlib member of a matching SID specification becomes the system identifier.

 If SMFPRMAA specified at IPL  SID value   Option Display (D SMF,0)
    contains:   
     SID(SYSA)                   SYSA      SID(SYSA)

 If SMFPRMBB specified at IPL
    contains:
     SID(SYSB,006204,106204)     SYSB      SID(SYSB,006204,106204)

 If SMFPRMCC specified at IPL
    contains:
     SID(SYSC,SYSNAME(SYSSYSD))  SYSC      SID(SYSC,SYSNAME(SYSSYSD))

 If SMFPRMDD specified at IPL
    contains:
     SID(&SYSNAME(4:4))          SYSD      SID(SYSD)

 If SMFPRMEE specified at IPL
    contains:
     SID(SYSE,COMBIN(006204,     SYSE      SID(SYSE,006204,106204)
                106204,206204))

SMF type 30 instruction counts may include instructions from z/OS events that are not attributable to the job. The instruction counts from these z/OS events can significantly impact the SMF type 30 instruction counts.

This parameter applies to SMF data set recording only; it does not apply to SMF log stream recording. If you are using SMF log stream recording, LASTDS(HALT) is ignored. When you specify data sets in SMFPRMxx, SMF issues messages that pertain to LASTDS(MSG) depending on the status of the data sets during SMF initialization.

MSG

Specifies that the system is to issue a message and continue processing; SMF data is buffered until an SMF data set is available. If SMF runs out of buffers, there might be a loss of data.

HALT

Specifies that the system is to enter a restartable wait state.

MULCFUNC indicates that users of the IFAUSAGE service that registered specifying SCOPE=FUNCTION must use IFAUSAGE with the REQUEST=FUNCTIONxxx parameters. SMF is to set the CVTMULFN indicator OFF.

NOMULCFUNC indicates that users of the IFAUSAGE service that registered specifying SCOPE=FUNCTION do not need to use IFAUSAGE with the REQUEST=FUNCTIONxxx parameters. SMF is to set the CVTMULFN indicator ON. Any measured usage program using SCOPE=FUNCTION, such as DB2®, can record only its registration data only and omit recording the usage data.

name

Represents the one to four character name of a subsystem. The first character must be alphabetic or national (#, @, or $), and the remaining characters can be either alphanumeric or national characters.

options

Represents the valid options for SUBSYS. The options are as follows:

TYPE

SMF record types and subtypes to be collected.

Note:

• A specified value of 126 is ignored by the system.
• The specified TYPE or NOTYPE parameter values must resolve to at least one non 126 type value.
• TYPE or NOTYPE parameter options that are specified after the first TYPE or NOTYPE are ignored.

INTERVAL

Time intervals between recording

EXITS

Exits that are to receive control at various points in SMF processing

DETAIL

The level of SMF data collection for TSO users and started tasks

These options are the same as those you can specify for the SYS parameter. When you specify SUBSYS, any option you omit from the SUBSYS parameter defaults to the value specified for that option on the SYS parameter. If you omit SUBSYS, SMF uses the values for all of the options on the corresponding SYS parameter. For the EXIT option, if you omit SUBSYS an exit point name is created for any exit that is specified on the SYS parameter.

If the specified time limit expires, the system passes control to the SMF time limit exit, IEFUTL (if active). IEFUTL either extends the wait time or allows the system to end the job or TSO/E user address space abnormally.

If the specified time limit expires, the system passes control to the SMF time limit exit, IEFUTL (if active). IEFUTL either extends the wait time or allows the system to end started task address space abnormally.

If the specified time limit expires, the system passes control to the SMF time limit exit, IEFUTL (if active). IEFUTL either extends the wait time or allows the system to end the TSO/E user address space abnormally.

When you specify the SYNCVAL parameter for interval synchronization, specify the global interval value with the INTVAL parameter (unless you accept the default for INTVAL).

TYPE

SMF record types and subtypes to be collected.

Note:

• A specified value of 126 is ignored by the system.
• The specified TYPE or NOTYPE parameter values must resolve to at least one non 126 type value.
• TYPE or NOTYPE parameter options that are specified after the first TYPE or NOTYPE are ignored.

INTERVAL

Time intervals between recording.

EXITS

Exits that are to receive control at various points in SMF processing.

DETAIL

The level of SMF data collection for TSO users and started tasks.