IDMS REST API URL error "The service can not find the requested resource."

Products

• IDMS

Issue/Introduction

When I go to access my IDMS REST API using the defined web address, https://<your-hostname>:<port-number>/api/v1/caidms/systems
It results in the following errors: 

{"messages":[{"messageType":"ERROR","messageNumber":"ZWEAS404","messageContent":"The service can not find the requested resource.","messageKey":"org.zowe.commons.rest.notFound","messageInstanceId":"0a9e565f-d6d1-40b3-98d2-9ad9b6721d1c","messageComponent":"org.zowe.commons.spring.CustomRestExceptionHandler","messageSource":"hostname.lvn.broadcom.net:37200:caidms"}]}

 

Environment

Release : 19.0

Component : IDMS/DB

Cause

The service can not find the requested resource message is a result of not specifying the JOBNAME for the IDMS CV STARTUP.

Resolution

The general rules to follow are:  

(1). For any endpoint not performance monitor related you use a datasource name as a path variable in the URL.
(2). For performance monitor endpoints you use the jobname, so in this case its IDMSTST because that is what /systems shows as running on the LPAR

So in this case we are using a Performance Monitor endpoint, so the URL is constructed with the JOB name of the IDMS CV Start up JCL.

For example: 

- <CV jobname> is the JOBNAME for the IDMS CV Startup JCL, so the URL is constructed as shown below: 

https://<your-hostname>:<port-number>/api/v1/caidms/systems/<CV jobname>

Results: 
{
  "jobName": "<CV jobname>",
  "jobId": "JOB#####",
  "userId": "#######",
  "programName": "RHDCOMVS",
  "ascbAddress": "F07880",
  "eseAddress": "2AD4BE50",
  "csaAddress": "2DDB0",
  "svcNumber": 172,
  "cvNumber": 222,
  "pcToken": "",
  "eseStatus": 216,
  "systemFlag": 64,
  "tapeVersion": "GJJ04I",
  "asid": 770,
  "storageKey": 64,
  "versionId": 1900,
  "releaseNumber": "19.00.03"
}
Response headers
 cache-control: no-cache, no-store, max-age=0, must-revalidate 
 connection: keep-alive 
 content-type: application/json 
 date: Wed, 22 Jun 2022 20:11:29 GMT 
 expires: 0 
 keep-alive: timeout=60 
 pragma: no-cache 
 transfer-encoding: chunked 
 x-content-type-options: nosniff 
 x-frame-options: DENY 
 x-xss-protection: 1; mode=block 
Responses
Code Description
200 
OK
Example Value
Model
{
  "ascbAddress": 16230656,
  "asid": 118,
  "csaAddress": 873890,
  "cvNumber": 60,
  "eseAddress": 9433200,
  "eseStatus": 216,
  "jobId": "JOB#####",
  "jobName": "<CV jobname>',
  "pcToken": 1,
  "programName": "RHDCOMVS",
  "releaseNumber": "19.0.00",
  "storageKey": 4,
  "svcNumber": 176,
  "systemFlag": 96,
  "tapeVersion": "GJJ04I",
  "userId": "#######",
  "versionId": 600
}

Additional Information

IDMS 19.0 - Connectivity - REST API