galasa

Close menu
Open menu

zOS MF Manager

BETA - This Manager is feature complete but may contain known or unknown bugs.

Overview

This Manager provides Galasa tests with access to a zOS/MF server. Use the z/OS MF Manager to simplify areas of z/OS system management. The z/OS MF Manager can be called from a test or from other Managers. For example, the z/OS Manager calls the z/OS MF Manager to implement z/OS file, console and batch functions via the relevant interface.

Annotations

The following annotations are available with the zOS MF Manager

z/OS MF
Annotation: z/OS MF
Name: @Zosmf
Description: The @Zosmf annotation requests the z/OSMF Manager to provide a z/OSMF instance associated with a z/OS image. The test can request multiple z/OSMF instances, with the default being associated with the primary zOS image.
Attribute: imageTag The tag of the zOS Image this variable is to be populated with
Syntax: @ZosImage(imageTag="A")
public IZosImage zosImageA;
@Zosmf(imageTag="A")
public IZosmf zosmfA;
Notes: The IZosmf interface has a number of methods to issue requests to the zOSMF REST API. See Zosmf and IZosmf to find out more.

Configuration Properties

The following are properties used to configure the zOS MF Manager.

zOSMF Server port is https
Property: zOSMF Server port is https
Name: zosmf.server.[imageid].https
Description: Use https (SSL) for zOSMF server
Required: No
Default value: True
Valid values: $validValues
Examples: zosmf.server.https=true
zosmf.server.SYSA.https=true
zOSMF Image Servers
Property: zOSMF Image Servers
Name: zosmf.image.IMAGEID.servers
Description: The zOSMF servers for use with z/OS Image, the zOS/MF do not need to be running the actual z/OS Image
Required: No
Default value: None
Valid values: Comma separated zOS/MF server IDs
Examples: zosmf.image.MV2C.servers=MFSYSA,MFSYSB
zOSMF Server retry request
Property: zOSMF Server retry request
Name: zosmf.server.[SERVERID].request.retry
Description: The number of times to retry when zOSMF request fails
Required: No
Default value: 3
Valid values: numerical value > 0
Examples: zosmf.server.request.retry=5
zosmf.server.MFSYSA.request.retry=5
zOSMF Server Credentials
Property: zOSMF Server Credentials
Name: zosmf.server.[SERVERID].credentials
Description: The z/OS credentials to use when accessing the zOS/MF server
Required: No
Default value: None, however the zOS/MF Manager will use the default z/OS image credentials
Valid values: Valid credential ID
Examples: zosmf.server.MFSYSA.credentials=ZOS
zOSMF Server Image
Property: zOSMF Server Image
Name: zosmf.server.SERVERID.image
Description: The z/OS image ID this zOS/MF server lives on
Required: No
Default value: The SERVERID value is used as the z/OS image ID
Valid values: z/OS image IDs
Examples: zosmf.server.MFSYSA.image=SYSA
zOSMF Server port
Property: zOSMF Server port
Name: zosmf.server.[imageid].port
Description: The port number of the zOS/MF server
Required: No
Default value: 443
Valid values: A valid IP port number
Examples: zosmf.server.port=443
zosmf.server.MFSYSA.port=443
zOSMF Sysplex Servers
Property: zOSMF Sysplex Servers
Name: zosmf.sysplex.[SYSPLEXID].default.servers
Description: The zOSMF servers active on the supplied sysplex
Required: No
Default value: None
Valid values: Comma separated zOS/MF server IDs
Examples: zosmf.sysplex.default.servers=MFSYSA,MFSYSB
zosmf.sysplex.PLEXA.default.servers=MFSYSA,MFSYSB