Updating the BMC AMI Cloud agent configuration files

JAVA_HOME

(Required) 64-bit Java home path

None

TIME_ZONE

(Required) Java time zone, for example, America/New_York

None

TCPIP_NAME

TCP/IP stack used by the agent¹

TCPIP

AGENT_MEMORY

Allocated Java heap space for the agent. 1 GB is the minimum value.

1 GB

LIFE_CYCLE_MEMORY

Allocated Java heap space for life cycle management. 256 MB is the minimum value.

256 MB

SAPI_MEMORY

Allocated Java heap space for the server API (M9SAPI). 56 MB is the minimum value.

56 MB

SAPI_NETWORK_DEBUG

Enable network level debug for server API (M9SAPI).

Valid values are true and false.

false

SAPI_KEYRING_NAME

The SAF keyring name to be used as a truststore during server API certificate validation.

If specified, the keyring is searched at &SYSUID/keyRingName

None

port

Agent’s listening port for server HTTPS communication

9999

keystore

Agent keystore in JKS format, which contains only one key entry to be used by the agent for incoming HTTPS requests.

For more information, see Enabling-trust-between-the-agent-and-the-object-storage.

agent.jks

keystore_password

Provided keystore password

agent

truststore

Agent truststore in JKS format, which the agent will use to trust incoming HTTPS requests.

For more information, Enabling-trust-between-the-agent-and-the-object-storage.

keystore value

truststore_password

Provided truststore password

keystore_password value

objstore.endpoint.url

(Required) URL of the object storage

The URL should start with http:// or https://

Default: none

objstore.endpoint.userid

(Required) Access key to object storage

Default: none

objstore.endpoint.password

(Required) Secret key to object storage

Default: none

objstore.endpoint.password_encrypted

Determines whether the object storage password is obfuscated

Default: false

objstore.resources.container.name

(Required) Container or bucket name

Default: model9-data

objstore.endpoint.api.id

Object storage API name

Default: s3

Amazon AWS: aws-s3

Microsoft Azure: azureblob

objstore.endpoint.api.s3.v4signatures

When using object storage that uses V4 signatures, set this parameter to true, in addition to api.id: s3

Default: false

Cohesity: true

HCP-CS: true

objstore.endpoint.no.verify.ssl

When using the HTTPS protocol, set to true to avoid SSL certificate verifications¹

Default: true

objstore.endpoint.tier

Object storage tier to use for created blobs (only when using AWS S3 or Azure Blob)

Valid values are as follows:

• none—(default) does not request a specific tier for blobs, leaving the tier selection up to the object storage
• standard—maps to AWS S3 Standard tier and Azure Blob's hot tier
• infrequent—maps to AWS S3 Infrequent Access tier and Azure Blob's cool tier

objstore.endpoint.api.s3.calculatemd5

Enables MD5 checksum calculation to be included in putObject requests.

This parameter is required for Object Lock enabled buckets.

Valid values: true|false

Default: false

objstore.endpoint.shared.archive.volume

Archived volume serial name

M9ARCH

objstore.functionality.backup.threadpool.size

Number of parallel threads for backup and archive runs. Increasing this parameter requires verifying that sufficient Java heap space is defined for the agent

20

load.balancing.group.name

&SYSPLEX

restore.progress.interval.percentage

Progress interval by percentage

10

restore.progress.minimum.size.mb

Minimum size (in MB) of a backup or archive action at which point the agent starts reporting recall and restore progress

1048576

objstore.resources.complex.id

Defines the resources that the agent can process

group- &SYSPLEX

lifecycle.deleteExpired.gdg.minimumDays

Minimum number of days that a data set is kept after being archived

After the number of minimum days has passed, the data is checked to determine whether it is eligible for deletion.

7

lifecycle.deleteExpired.gdg.intervalDays

Interval (in days) at which the data set is checked to determine whether it is eligible for deletion

4

lifecycle.deleteExpired.cds.catalogExpiration.minimumDays

Minimum number of days for which a catalog-controlled cloud data set is kept in storage

7

cli.functionality.backup.compression

Compression type used for CLI backup execution

gzip

cli.functionality.archive.compression

Compression type used for CLI archive execution

gzip

import.allocate_use_expdt_98000

Determines whether to add the EXPDT(98000) to the tape allocations

For CA-1 import support, change to true.

false

import.allocate_label_type

Determines which label type the tape allocation should use

For CA-1 import support, change to blp.

sl

dcollect.output.unit

DCOLLECT UNIT

VIO

dfdss.input_primary_cyl

DFDSS SYSIN primary size

1

dfdss.input_secondary_cyl

DFDSS SYSIN secondary size

10

dfdss.input_lrecl

DFDSS SYSIN LRECL

80

dfdss.input_block_size

DFDSS SYSIN block size

80

dfdss.input_bufno

DFDSS SYSIN BUFNO

1

dfdss.input_unit

DFDSS SYSIN UNIT

VIO

dfdss.output_primary_cyl

DFDSS SYSPRINT primary size

1

dfdss.output_secondary_cyl

DFDSS SYSPRINT secondary size

10

dfdss.output_lrecl

DFDSS SYSPRINT LRECL

134

dfdss.output_block_size

DFDSS SYSPRINT block size

1340

dfdss.output_bufno

DFDSS SYSPRINT BUFNO

1

dfdss.output_unit

DFDSS SYSPRINT UNIT

VIO

dfdss.optimize

Set the DFDSS OPTIMIZE value for data set backup and archive

3

The message level used for resource level discovery failures while fetching properties.

Valid values are as follows:

• SEVERE
• WARNING
• INFO

WARNING

idcams.temp.unit

IDCAMS temporary unit

VIO

xcf.functionality.enabled

Controls the agent's XCF listener, which enables the auto-recall and CDS functionality

true

volumeBackup_dfdss_warn_to_ok_msg_codes

Controls which DFDSS warning messages will not affect the return code of the DFDSS operation

ADR411W ADR333W

model9.dfdss.statements.backup.forcecp.enabled

Enables the use of FORCECP for data set level backup (CLI & Policy).

Valid values are as follows:

• true
• false

true

model9.dfdss.statements.backup.forcecp.days

FORCECP parameter days value.

Valid values: 0-255

0

cloud_datasets.supported_read_utility_name_pattern

Determines the enabled applications for cloud data set read usage

(IEBGENR)|(IEBGENER)|(DSNUTILB)|(IEBCOPY)|(IDCAMS)

cloud_datasets.supported_write_utility_name_pattern

Determines the enabled applications for cloud data set write usage

(IEBGENR)|(IEBGENER)|(DSNUTILB)|(IEBCOPY)|(IDCAMS)