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 |