Retrieve z/OSMF information

You can use this operation to retrieve information about z/OSMF on a particular z/OS system.

HTTP method and URI path

GET /zosmf/info

where zosmf/info identifies the z/OSMF information retrieval service.

Standard headers

Use the following standard HTTP header with this request:

Content-Type: application/json

Custom headers


Request content


Content type used for HTTP response data

The JSON content type ("Content-Type: application/json") is used for response data. The following JSON object is received as output from the request.
Realm associated with the system on which z/OSMF is installed. Usually, this is the sysplex name.
Port number for SSL encrypted traffic for the active instance of z/OSMF on the z/OS system.
Indicates the z/OSMF version, further qualified by a service level.
Array of zero, one, or more elements that contain information about each of the installed z/OSMF plug-ins. If no plug-ins are installed, this area is empty.
Each element contains the following attributes:
Indicates the plug-in version (FMID) and build level.
Indicates the status of the plug-in. The status is reported for IBM-supplied plug-ins only. For an external application, the status is blank.
The following values are valid:
The plug-in is running.
The plug-in is installed, but not running.
The plug-in was installed in a previous z/OSMF configuration, but is not installed in the current configuration. This status can result when a plug-in is removed from z/OSMF.

After a plug-in is started, its status remains as ACTIVE, even if the plug-in is later stopped.

Indicates the plug-in name.
Version of the z/OSMF information retrieval service and the JSON object structure used for this request. The version sequence starts at 1, and is incremented if the service or the JSON structure changes.
Indicates the z/OS operating system level. The following values are valid:
Indicates that the z/OS level is V2R1.
Indicates that the z/OS level is V2R2.
Indicates that the z/OS level is V2R3.
Indicates the z/OSMF level. The following values are valid:
Indicates that the z/OSMF level is V2R1.
Indicates that the z/OSMF level is V2R2.
Indicates that the z/OSMF level is V2R3.
Indicates the hostname or IP address of the z/OS system on which z/OSMF is installed

Usage considerations

See Usage considerations for the z/OSMF REST services.

Required authorizations


Expected response

On completion, the service returns an HTTP response, which includes a status code indicating whether your request completed. Status code 200 indicates success. A status code of 4nn or 5nn indicates that an error has occurred. For more details, see Error handling.

The response also includes a JSON object that contains the retrieved data. For details, see Content type used for HTTP response data.

Example request

In the following example, the GET method is used to retrieve information about z/OSMF.
Figure 1. Sample request to retrieve z/OSMF information
GET /zosmf/info HTTP/1.1

Example response

For a successful request, the HTTP response includes a JSON document containing the requested information.
HTTP/1.1 200 OK
Date: Wed, 06 Mar 2013 06:39:28 +0000GMT
Content-Type: text/plain
Connection: close

	"pluginDefaultName":"Import Manager"},
	"pluginDefaultName":"IBM SDSF"},
	"pluginDefaultName":"Capacity Provisioning"},
	"pluginDefaultName":"Software Deployment"},