Log stream parameters

Mainframe Analytics Recorder User Guide

Version
10.1.x
Audience
anonymous
Part Number
MK-92HC226-08
ft:lastEdition
2026-01-30
This subsection describes the parameters that are specified when the IXCMIAPU utility is used to define a log stream.

For details about parameters, see the IBM manual MVS Setting Up a Sysplex.

NAME(log_stream_name)

The log stream name is CCENTRAL.LOG.system-name. For a system-name, specify the system name of the system symbol (&SYSNAME). If a system name starts with a number, MAR extracts the last five characters of the system name and adds prefixed YKS to them to form the log stream name. If a system name starts with a number, the last five characters used for the log stream name must be unique within the sysplex.

The following shows examples of how a system name starting with a number is converted to the system name in a log stream name.

  • For the system name 1SYS starting with a number and consisting of less than five characters:

    YKS is added to the system name to create YKS1SYS.

  • For the system name 1SYSTEM starting with a number and consisting of more than five characters:

    YKS is added to the last five characters YSTEM to create YKSYSTEM.

  • For the system names 1SYSTEM and 2SYSTEM, both of which start with numbers and consist of more than five characters:

    YKS is added to the last five characters YSTEM to create YKSYSTEM, which results in two identical system names. In this case, the system name (&SYSNAME) specified for the IEASYSxx parmlib member must be changed.

For details about system names, see the IBM manual MVS Initialization and Tuning Reference.

DASDONLY(YES)

Specify YES to make the log stream a DASD-only log stream.

MAXBUFSIZE(maxbufsize)

Maximum block size of a log. Specify 64000 (bytes).

STG_SIZE(stg_size)

Specify the size of the staging dataset. Specify a value in the range from 100 (400KB) to 1000 (4MB).

Do not specify this parameter when using an SMS definition.

STG_DATACLAS(stg_dataclas)

Specify the name of the SMS data class used for allocating the DASD staging dataset for this log stream. Specify this parameter when using an SMS definition.

STG_MGMTCLAS(stg_mgmtclas)

Specify the name of the SMS management class used for allocating the DASD staging dataset for this log stream. Specify this parameter when using an SMS definition.

STG_STORCLAS(stg_storclas)

Specify the name of the SMS storage class used for allocating the DASD staging dataset for this log stream. Specify this parameter when using an SMS definition.

LS_SIZE(ls_size)

Specify the size of the DASD log dataset. Specify any size.

The required size depends on the frequency of the output of event logs from the log stream to a dataset and how event logs are deleted. Specify an appropriate value to prevent the dataset from becoming full.

Do not specify this parameter when using an SMS definition.

LS_DATACLAS(ls_dataclas)

Specify the name of the SMS data class used for allocating a log dataset. Specify this parameter when using an SMS definition.

LS_MGMTCLAS(ls_mgmtclas)

Specify the name of the SMS management class used for allocating a log dataset. Specify this parameter when using an SMS definition.

LS_STORCLAS(ls_storclas)

Specify the name of the SMS storage class used for allocating a log dataset. Specify this parameter when using an SMS definition.

AUTODELETE(YES)

Specify this parameter when automatically deleting event logs.

RETPD(retpd)

Specify this parameter when automatically deleting event logs. Specify the number of days to retain event logs in the log stream.

HLQ(CCENTRAL)

This parameter specifies that CCENTRAL is the high level qualifier used as a part of the log dataset name. If this parameter is not specified, the default high level qualifier IXGLOGR will be a part of the log dataset name.

The specification of the following parameters is optional.

  • HIGHOFFLOAD

  • LOWOFFLOAD

  • LIKE

  • MODEL

  • DIAG