SORTOPTS statement

The SORTOPTS statement controls how 

BMC AMI Log Master

 dynamically allocates the memory and data sets that are related to sort actions (including sort routine memory and sort work data sets).

The keywords of this statement correspond to installation options described in Installation-option-descriptions.

The following figure shows the SORTOPTS syntax.

GUID-F9FDB444-A045-4544-8243-FAEC540DF3A1-low.png

Option

Description

SMCORE

Specifies the maximum amount of memory that BMC AMI Log Master requests when it uses the sort routine. To specify this keyword, enter both of the following values.

Value

Description

mainSize

Specifies the total amount of memory that BMC AMI Log Master sort actions can use (both above and below the 16-MB line).

vscoret

Specifies the amount of memory that BMC AMI Log Master sort actions can use below the 16-MB line.

See also SMCORE=0M,0K.

RESINV memValue

Specifies the amount of memory (below the 16-MB line) that BMC AMI Log Master instructs the sort routine to reserve for processing other than sort processing. Specify the memValue amount as bytes, kilobytes (use the suffix K), or megabytes (use the suffix M).

See also RESINV=0K.

PARMOPTS

Specifies how BMC AMI Log Master dynamically allocates data sets other than sort work data sets.

Value

Description

 STORCLAS (storageClass)

Specifies the storage class that BMC AMI Log Master uses for storage of other dynamically allocated data sets. Use this keyword only with DFSMS. Do not specify a value of VIO.

See also PARMSTOR=.

 UNIT (unitName)

Specifies the storage device (or group of devices) where BMC AMI Log Master requests space for other dynamically allocated data sets. Enter any valid unit name or a generic unit name where you can allocate temporary data sets. Do not use this keyword with DFSMS.

See also PARMUNIT=.

SORTDYN

Determines whether BMC AMI Log Master uses the sort routine’s dynamic sort allocation rules or accepts your allocation attributes.

Value

Description

SYSTEM

Directs BMC AMI Log Master to use the sort routine’s rules.

USE

(default) Enables you to enter allocation attributes.

See also SORTDYN=USE.

Sort file size parameters

Specifies the estimated size of the data that BMC AMI Log Master must sort during a given job. You can also specify the size of the data to be sorted during an individual log scan. These parameters specify the estimated size of the data to be sorted or a technique that BMC AMI Log Master uses to calculate the estimate.

For more information, see Sort file size parameters.

HISTORY

Determines whether BMC AMI Log Master stores information in the Repository about the current job’s sort actions. The information includes the number of log records that were sorted and the average size of the records. If historical information is stored in the Repository from previous runs of the current work ID, BMC AMI Log Master can use that information to estimate the size of the data to be sorted during the current run. For more information, see FILSZ. BMC AMI Log Master passes the estimated size to the sort routine in your environment.

BMC AMI Log Master stores and retrieves historical information by using the work ID of the job. If you run a BMC AMI Log Master job repeatedly, you can use this keyword (and the related USE HISTORY value) to optimize the sort actions of your job.

Value

Description

WRITE

(Default) Specifies that BMC AMI Log Master writes information about the current job’s sort actions in the Repository.

NOWRITE

Specifies that BMC AMI Log Master does not write information in the Repository.

 WORKOPTS

Specifies how BMC AMI Log Master dynamically allocates sort work data sets.

Value

Description

 NUM (numOfFiles)

Specifies how many sort work data sets BMC AMI Log Master allocates for each sort action. You can specify any number from 1 to 255. The default value is 0.

See also WORKNUM=0.

 STORCLAS (storageClass)

Specifies which storage class BMC AMI Log Master uses for storage of sort work data sets. Use this keyword only if you want DFSMS to manage the sort work data sets.

See also WKSTOR=.

 UNIT (unitName)

Specifies the storage device (or group of devices) where BMC AMI Log Master requests space for sort work data sets. Enter any valid unit name or a generic unit name where you can allocate temporary data sets. Do not use this keyword if you want DFSMS to manage the sort work data sets.

See also WKUNIT=.

Sort file size parameters

The Sort file size parameters syntax occurs in both the SORTOPTS and LOGSCAN statements.

Use this syntax to improve the performance of BMC AMI Log Master sort actions as follows:

  • When these parameters are included in a SORTOPTS statement, they affect the sort actions of the entire job.
  • When these parameters are included in a LOGSCAN statement, they affect only the individual log scan.

Sort file size parameters syntax diagram

image-2024-5-27_14-16-41.png

You can also use the following methods to affect the performance of sort actions:

  • You can control how much memory BMC AMI Log Master allocates for each invocation of the sort routine (for more information, see SMCORE=0M,0K).
  • You can control how the sort routine allocates sort work data sets (for more information, see Defining-sort-work-data-sets).

Option

Description

 FILSZ

Specifies the estimated size of the data that BMC AMI Log Master must sort during a given job or log scan. The value of this keyword determines the estimated size or the technique that BMC AMI Log Master uses to calculate an estimated size. BMC AMI Log Master passes the estimated size to the sort routine in your environment. The sort routine uses the estimated size value to efficiently allocate sort memory or sort work data sets.

Value

Description

NONE

Directs BMC AMI Log Master not to pass any file size estimate to the sort routine. When this value is NONE, the sort routine in your environment uses its own default settings to allocate memory and sort work data sets.

For compatibility with earlier versions of BMC AMI Log Master, this is the default value.

USE HISTORY

Directs BMC AMI Log Master to calculate a file size estimate based on historical information about the current work ID. To use this value, you must have previously directed BMC AMI Log Master to write the historical information in the Repository (using the related HISTORY keyword of the SORTOPTS statement). The historical information describes the sort actions of previous runs of the current work ID (including the number of log records sorted and the average size of the records).

BMC AMI Log Master calculates the estimate based on a weighted average of previous runs, giving greater weight to more recent runs. If you run a BMC AMI Log Master job repeatedly, you can employ the USE HISTORY value (and the related HISTORY keyword) to optimize the sort actions of your job. For more information, see HISTORY.

Variable

Description

numOfRuns

Determines how many runs BMC AMI Log Master includes in its calculation of the file size estimate. The minimum value for numOfRuns is 1, the default value is 5, and the maximum value is 20.

LOGBYTES

Directs BMC AMI Log Master to calculate a file size estimate based on the total volume of the log records that the current work ID processes. BMC AMI Log Master examines the total volume of the log records (expressed as a number of bytes), not the number of log records.

Use the following keyword to give BMC AMI Log Master additional information that it can use to calculate a more precise file size estimate.

Variable

Description

USE HISTORY

To calculate a file size estimate, BMC AMI Log Master uses the total volume of log records and historical information stored in the Repository about previous runs of the current work ID. The historical information includes the number of log records and the average length of the log records for previous runs. This is the default value.

ESTnumOfRecs

Directs BMC AMI Log Master to use the value that you enter for numOfRecs as an estimate of the number of log records to be sorted. BMC AMI Log Master passes the estimated value to the sort routine in your environment.

Variable

Description

AVGRECLEN lenValue

Specifies the average record length of the log records to be sorted. Use this keyword to pass a more precise file size estimates to the sort routine in your environment.

If you specify a FILSZ estimate, BMC AMI Log Master determines the default SMCORE values by using the minimum storage required by BMCSORT when all of the following conditions exist:

  • You accept the default values of 0 for the SMCORE installation option.
  • You specify a value for the FILSZ keyword in the SORTOPTS statement.
  • You do not specify SMCORE values in the SORTOPTS statement.


 

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