Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Configuring Global Parameters


The BMC Global Parmlib member (CWGL) exists to provide common parameters across multiple BMC AMI products. This member must be available in BMC PARMLIB version 2 (PARMLIB V2). A sample member is located in hlq.SLCXCNTL(CWGL00). The following parameters are contained in the BMC Global Parameter member (CWGLxxxx). 


Parameter

Description

ZADVISER

Controls where zAdviser records are to be written (zAdviser, SMF, or both). Values of YES and ONLY will enable zAdviser streaming support in the CMSC, where records are automatically sent to zAdviser.

Values:  

YES | NO | ONLY | ON_PREM

YES writes records to both zAdviser and SMF

NO writes records to SMF

ONLY writes records to only zAdviser

ON_PREM writes records to both zAdviser ON_PREM and SMF

Default:  YES

Required: NO

SMF

This parameter allows the user to specify whether or not SMF records should be written by the CMSC zAdviser API.

Values:

YES | NO

YES writes records to SMF

NO prevents writing records to SMF

Default:  YES

Required: NO

For more information and examples on the usage of SMF parameter, see zAdviser-parameters.

ZADVISER_QUEUE_ENTRIES

Specifies the maximum number of buffers that are used prior to sending zAdviser data. This specification determines the frequency in which records are sent to zAdviser.

ValuesA decimal number between 5 and 250.

Default:  20 (recommended)

Required: NO

ZADVISER_SMF_VERSION


A version number that identifies a BMC-global setting for the version of SMF records that ALL BMC AMI products will write. For current zAdviser support this parameter must be set to 17.02.07 once all BMC AMI products are current and with all maintenance. This value must otherwise be set to 17.00.00.

Values: 17.00.00 | 17.02.07

Default:  17.02.07

Required: NO

ZADVISER_SMF_BUFF_INT

Is the time interval, in minutes, of the maximum time a BMC AMI product will wait before sending records to the zAdviser service.

Values: 1 to 1440 minutes

Default:  NONE

Required: NO

ZADVISER_SMF_ID


The value specified on the ZADVISER_SMF_ID operand defines the SMF Record ID number to be used on all SMF records written by the CMSC Direct ZADVISER API.  The ZADVISER_SMF_ID must be a three-digit number in the range of 128 through 255.

Default:  241

Required: NO

The record ID specified by the ZADVISER_SMF_ID parameter must be recorded by SMF. Your zOS systems programmer must specify the ZADVISER_SMF_ID on the SYS option in the SMFPRMxx SYS1.PARMLIB member. If ZADVISER_SMF_ID is not being recorded then SMF recording will not take place, however, the CMSC will still stream data to zADVISER if the ZADVISER=YES global parameter is specified.

In the example below, the values allowed for zAdviser, SMF record IDs 128 through 255, are included in the value range 100:255 on the SYS option, and therefore are eligible to be written by zAdviser.

SYS(TYPE(0:18,20:68,100:255),EXITS(IEFUSI,IEFU84,IEFUJV,IEFACTRT,IEFU83,IEFUJI,IEFUTL,IEFU29,IEFU85),INTERVAL(SMF,SYNC),DETAIL)

If the value specified on the ZADVISER_SMF_ID Global parameter is not specified on the SYS option in SMFPRMxx, the following warning message is displayed by CMSC during initialization:

MSCSC4444W SMF record nnn is not being recorded by SMF. Verify in SMFPRMxx

Where, nnn is the SMF_ID.

ZADVISER_DEST

Indicates the zAdviser destination choice.

Values: DFLT | GOVT

DFLT uses the endpoint https://zadviser.api.bmc.com:443/inbound and GOVT uses zAdviser's Government Cloud with endpoint https://gov.zadviser.api.bmc.com:443/inbound

Default:  DFLT

Required: No

ZADVISER_TENANT_ID

Indicates the zAdviser Tenant ID. You can specify this parameter instead of using customer ID.

Values: 1 to 256 alphanumeric characters

Default:  None

Required: No

ZADVISER__PROXY

Indicates the hostname of zAdviser proxy server. URL is not validated. It overrides the destination table URL with proxy URL.

Values: 1 to 70 alphanumeric characters

Default:  None

Required: No

ZADVISER_PROXY_IP

Indicates the zAdviser proxy server IP address. IP is validated and overrides the destination table IP with proxy IP.

Values: 1 to 21 alphanumeric characters

Default:  None

Required: No

ZADVISER_PROXY_PORT

Indicates the zAdviser proxy port number.

Values: 1 to 65535

Default:  None

Required: No

ZADVISER_ONPREM_IP

Indicates the zAdviser OnPrem server IP address. IP is validated and overrides the default zAdviser destination.

Values: 1 to 21 alphanumeric characters 

Default: None

Required: No

ZADVISER_ONPREM_PORT

Indicates the zAdviser OnPrem port number. 

Values: 1 to 65535 

Default: None 

Required: No

 

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