Stopping the BCM Web API server

Business Continuity Manager Web API Reference Guide

Version
9.9.1
Audience
anonymous
Part Number
MK-96HC137-03

Request line

Stop the BCM Web API server.

After you stop the BCM Web API server, if you want to restart it, first stop and then restart the TSO/E address space.

PUT https://IP-address-of-the-z/OSMF-server/zosmf/tsoApp/app/servletKey/YKAPI

Item

Description

servletKey

Specify the value of the servletKey key that was returned when the TSO/E address space was started.

Request body

{ "action":"exit" }

Key

Description

action

Specify exit.

Response body

If no CLI commands are running

After the response is returned, the BCM Web API server will stop.

{"servletKey":"servletKey",
"ver":"structure-version",
 "tsoData":[
   {"TSO MESSAGE":
     {"VERSION":"JSON-version",
      "DATA":" YK7399I BCM Web API server ended.rc=0"}
   }],
 "reused":false, "timeout":false
}
If a CLI command is running
If you try to stop the BCM Web API server while a CLI command is running, true will be returned for the timeout key. For this reason, wait for CLI execution to finish before stopping the BCM Web API server.
{"servletKey":"servletKey",
"ver":"structure-version",
 "reused":false, "timeout":true
}
If an error occurs in the sending of the response
Follow the instructions in the error message that is output.
{"servletKey":"servletKey",
"ver":"structure-version",
 "tsoData":[
   {"TSO MESSAGE":
     {"VERSION":"JSON-version",
      "DATA":"error-bcmMsg"}
   }],
 "reused":false, "timeout":false
}

Key

Format

Description

servletKey

string

The value of the servletKey key specified in the request line

ver

string

The version of the REST API for z/OSMF TSO/E address space services
tsoData

object

Error message output from TSO/E Messages.

This key is output if an error occurs in the sending of the response.

reused

boolean

reused attribute

For details, see the IBM manual z/OS Management Facility Programming Guide.

timeout boolean
  • false: This is output if the BCM Web API server has stopped.
  • true: This is output if the BCM Web API server does not end within the time limit.