Update the sample BCM GUI configuration file (bcmgui.ini) according to the execution environment and usage conditions. The sample BCM GUI configuration file is provided on the installation CD-ROM.
The following table explains the content of the BCM GUI configuration file:
|
Section name |
Variable name |
Variable description |
Specification format of variable values |
Default value when omitted |
|---|---|---|---|---|
|
zosmf |
hostaddr |
Specifies the IP address of the z/OSMF server. |
n. n. n. n n: A number between 0 and 255 |
This variable cannot be omitted. |
|
userid |
Specifies the user ID of the z/OS user who will run the BCM Web API when user authentication is to be performed by using a user ID and password. |
1 to 8 alphanumeric characters |
This variable cannot be omitted when the cert variable is omitted. |
|
|
cert |
Specifies the file name of the client certificate (PEM format) for the z/OS user who will run the BCM Web API when user authentication is to be performed by using a client certificate. If this value is specified, the value of the userid variable is ignored. |
Path name |
User authentication is performed by using a user ID and password. |
|
|
key |
Specifies the file name of the private key (PEM format) corresponding to the client certificate for the z/OS user who will run the BCM Web API when user authentication is to be performed by using a client certificate. |
Path name |
The private key is assumed to be included in the file specified for the cert variable. |
|
|
startTsoPrm |
proc |
Specifies the logon procedure name of the TSO/E address space to be started by the BCM Web API server. |
numeric characters |
IKJACCNT |
|
rsize |
Specifies the region size of the TSO/E address space to be started by the BCM Web API server. |
numeric characters |
50000 |
|
|
acct |
Specifies the account number of the TSO/E address space to be started by the BCM Web API server. |
symbolic name |
DEFAULT |
|
|
bcmapi |
verbose |
|
True or False |
False |
|
clist |
Specifies the member name of the CLIST that starts the BCM Web API server. |
symbolic name |
YKAPIPRC |
|
|
logfile |
Specifies the path name of the file that outputs the sending and receiving logs of z/OSMF REST API and BCM Web API. The directory specified by the path name must exist. |
Path name |
bcmapi.log |
|
|
gui |
cgid |
Specifies the ID of the copy group to be monitored. Specify a character string of 1 to 9 copy group IDs concatenated with spaces. |
PREFIX string of 25 or fewer characters[△PREFIX string of 25 or fewer characters]... |
This variable cannot be omitted. |
|
interval |
Specifies the intervals for getting copy group monitor information in seconds. |
10 to 86400 |
300 |
|
|
macrodir |
Specifies the path name of the directory that contains the CLI macro file. The directory specified for the path name must exist. Up to 100 macro files can be displayed in the menu. |
Path name |
NULL |