Session Manager and Measurement Parameters


Detailed descriptions and default values for the various session manager and measurement parameters are provided below.

SVC=67

Description: Specifies the Strobe SVC. The SVC number can be any unused value between 0 and 255, and must be type 2, 3, 4, or 5. The session manager does not accept SVC numbers in use by operating system SVCs.

Default: 67

XCFGROUP=

Description: Identifies the XCF group that this instance of Strobe will join when operating in a multisystem environment. If a group name is not specified, Strobe operates in local mode and the SYSTEM field will not appear on any of the Strobe ISPF panels. The group name can be up to eight characters. Valid characters are A-Z, 0-9, $, #, and @. Members of an XCF group must be of the same Strobe release level. If you change the XCF group name between Strobe releases, additional migration steps must be run. See Migrating Datasets Across Different Environments.
Do not begin the group name with the letters A through I, SYS, or UNDESIG because these characters may be used for IBM XCF group names by system programmers.

Default: blank for Local mode. 

Warning

For consistent results, be sure to assign the same MAXREQ, RETAINC, RETAINQ values to all members of a Strobe XCF group. Strobe uses the value from the first member to join the group, applying this value to all other members as they join.

Description: Specifies the maximum number of requests (active, queued, completed, or AutoStrobe) that can be present in a system at any given time. Valid values are 10 to 9999.MAXREQ=200

Default: 200

Warning

If you are using Global Monitoring, AutoStrobe, or Strobe XCF groups in a multisystem environment, increase the value to 400. In a multisystem environment, this parameter reflects all the requests in the Strobe XCF group.

MAXACT=20

Description: Specifies the maximum number of measurement requests that can be concurrently active. Valid values are 1 to 1000 and cannot exceed MAXREQ (defined above). Any value specified that is greater than MAXREQ will be superseded by the value in MAXREQ, as it has precedence.

Default: 20

BASELIN=2

Description: Specifies the minimum percentage of execution samples required for Strobe to gather control section data for load modules. You can override the specified value with the BASELINE operand on the ADD and CHANGE commands. Valid values are 0 to 100.

Default: 2

BINDER_API=

Description: This parameter has been deprecated. Strobe will use only the FASTPATH API.

Default: None

BPXBATCH=YES

Description: Specifies whether to enable the measurement of z/OS UNIX System Services programs executed under batch (via BPXBATCH or AOPBATCH). Valid values are YES and NO.

Default: YES

DATE=MMDDYYYY

Description: Specifies the date format you want for the Strobe/ISPF panels and the Performance Profile. Valid values are:

  • MMDDYY
  • DDMMYY
  • YYMMDD
  • MMDDYYY
  • DDMMYYYY
  • YYYYMMDD.

Default: MMDDYYYY

DATESEP=’/’

Description: Specifies the character you want to use to separate date values. These characters must be enclosed in single quote marks such as '-'. Valid values are slash ‘/’, period ‘.’, and hyphen ‘-’.

Default: ‘/’

EXCLUDEAQ
EXCLUDE_PROGRAM=
END

Description: Specifies a list of excluded programs for which an Add Queued measurement request may not be initiated. Repeat the EXCLUDE_PROGRAM= subparameter on a separate line for each program to be excluded from an Add Queued measurement.

Default: None

HEALTH_CHECKS=YES

Description: Specifies whether Strobe adds product Health Checks to execute under the IBM Health Checker for z/OS. Valid values are YES and NO. See Configuring-Strobe-Health-Checks for more detailed information.

Default: YES

JSTCB=ALLOW

Description: Specifies whether Strobe will measure job steps that have multiple job step tasks. Valid values are ALLOW, ALWAYS, and NEVER. ALLOW permits measurement of such job steps when the user specifies the operand OPTIONS=NOQUIT when adding a measurement request. ALWAYS causes Strobe to measure such job steps by forcing the NOQUIT option, regardless of whether it is specified when adding a measurement request. NEVER prohibits measurement of all job steps that attach job step tasks. For more information, see Programs That Attach Tasks as Job Step Tasks.

Default: ALLOW

LPALIB=NO

Description: Specifies whether Strobe accesses Link Pack Area (LPA) libraries to obtain module mapping data. Valid values are YES and NO.

For VSAM modules that reside in the LPA library, you may need to set the LPALIB parameter to YES to obtain section mapping for them, or use the MAPPROGRAM and the STRBLIB parameters as described in the Using-Strobe-to-measure-online-applications-and-batch-programs.

|In addition, you should make sure the application being measured has READ authority to the LPA library that contains the modules to be mapped.

Default: NO

MAINTP1=00000000
MAINTP2=00000000

Description: Specify the four-byte diagnostic parameter fields that represent flag bytes to be supplied by BMC Support to activate, deactivate, or change product functions. 

Warning

Modify the default values only under direction of BMC Support.

MSASPROCNAME=STRMSASDefault:00000000.

Description: Specifies the name of the Measurement Services Address Space (MSAS) startup procedure.

Default: STRMSAS

RETAINC=7

Description: Specifies the number of additional days Strobe keeps a completed request on the queue. Day 1 starts at 00:00:00 hours of the day after the request is added. Valid values are 0 to 999.
A value of 0 causes the queued request to be deleted at 23:59:59 hours on the day the request was created. A value of 999 indicates the request is kept indefinitely.
For consistent results, be sure to assign the same RETAINC value to all members of a Strobe XCF group. Strobe uses the value from the first member to join the group, applying this value to all other members as they join.

Default: 7

RETAINQ=7

Description: Specifies the number of additional days Strobe keeps a request on the queue before it completes. Day 1 starts at 00:00:00 hours of the day after the request was added. Valid values are 0 to 999.
A value of 0 causes the queued request to be deleted at 23:59:59 hours on the day the request was created. A value of 999 indicates the request is kept indefinitely.
For consistent results, be sure to assign the same RETAINQ value to all members of a Strobe XCF group. Strobe uses the value from the first member to join the group, applying this value to all other members as they join.

Default: 7

STRG_24_SP0=128

Description: Specifies the required amount of available storage that Strobe checks for in the 24-bit subpool 0 address space before implanting. This value is displayed at startup and can also be displayed with the SHOW DEFAULTS command. Strobe produces a message if this storage requirement is not met. Valid values are from 128 to 384.

Default: 128

STRG_24_SP229=256

Description: Specifies the required amount of available storage that Strobe checks for in the 24-bit subpool 229 address space before implanting. This value is displayed at startup and can also be displayed with the SHOW DEFAULTS command. Strobe produces a message if this storage requirement is not met. Valid values are from 128 to 384.

Default: 256

STRG_31_SP0=2048

Description: Specifies the required amount of available storage that Strobe checks for in the 31-bit subpool 0 address space before implanting. This value is displayed at startup and can also be displayed with the SHOW DEFAULTS command. Strobe will produces a message if this storage requirement is not met. Valid values are from 1536 to 20480.

Default: 2048

STRG_31_SP229=3072

Description: Specifies the required amount of available storage that Strobe checks for in the 31-bit subpool 229 address space before implanting. This value is displayed at startup and can also be displayed with the SHOW DEFAULTS command. Strobe will produce a message if this storage requirement is not met. Valid values are from 2048 to 8192.

Default: 3072

TIME=HHMMSS

Description: Specifies the time format you want for the Strobe/ISPF panels and the Performance Profile. Valid values are:

  • HHMMSS: 24-hour format
  • ZHMMSS: 24-hour format with leading zero suppressed
  • APMMSS: 12-hour format with AM/PM indicator
  • ZPMMSS: 12-hour format with AM/PM indicator, leading zero suppressed.

Default: HHMMSS

TIMESEP=:

Description: Specifies the character you want to use to separate time values. Valid values are:

  • colon
  • , comma
  • period

Default: : colon

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*