-
1. Re: Control-M : is there any automation API to get the details in the documentation tab of a job?
Adriano Gomes Nov 8, 2019 1:17 PM (in response to sairam puvalla)2 of 2 people found this helpfulHi sairam puvalla
Actually there is no way to get documentation from current CTM API service calls.
There are two suggestions that you can follow:
The Documentation usually points to a path/filename on agent file system or an URL somewhere else accessible by http call.
So, you can :
1) add a "[type] or [cat] DocPath/\DocFile" as POST_CMD on each job you desire to have access to documentation instructions
2) or as an option for Documentation TYPE URL, Add a curl call as POST_CMD to render the URL provided.
Once it is done, you will have the documentation file rendered to job sysout, then you can use "
ctm run job:output::get <jobId> [runNo] "
Cons: Some job types do not support POST_CMDs, usually CM/Application add-ons.
My Best
A>Gomes
-
2. Re: Control-M : is there any automation API to get the details in the documentation tab of a job?
MunKeong Lee Nov 8, 2019 8:07 PM (in response to sairam puvalla)2 of 2 people found this helpfulHi Sairam
From your screenshot, your documentation is defined using documentation type "File". This makes retrieval difficult because it's located on the agent. If the documentation type is "URL" instead, you can make use of "deploy jobs::get" service to get all the jobs in the folder. In the response, you then parse the data to get the value of DocumetationUrl of the job. Using this value, you can then obtain the associated documentation.
Regards,
MK
-
3. Re: Control-M : is there any automation API to get the details in the documentation tab of a job?
sairam puvalla Nov 11, 2019 5:43 AM (in response to MunKeong Lee)Thanks MunKeong Lee and Adriano Gomes for your response and suggestions .
ok so, is there any possibility to fetch the "File Path" details from the "General" field of the jobs via an API or any other method?
"File Path" highlighted in Yellow
Thanks & Regards,
Sai.
-
4. Re: Control-M : is there any automation API to get the details in the documentation tab of a job?
Adriano Gomes Nov 11, 2019 7:42 AM (in response to sairam puvalla)1 of 1 people found this helpfulHi sairam puvalla
As explained by MunKeong Lee , you can have the ^path^ and ^filename^ data only with CTM A API service call (
ctm deploy jobs::get json -s "ctm=<your ctm name>&folder=<your folder name>"
) in json format by querying Job Definitions at TABLE/Folder level, then you can parse the json output and get the ^path^ and ^filename^ data for the specific job, not the File content, but only the names of both ^path^ and ^filename^.The reason is:
- There is no way to get the documentation file content using CTM AAPI service call.
- The job documentation resides on local agent file system probably on a different host where your CTMAPI Code/Service call is being performed.
If you wish to read the documentation File content as it seems, then :
- As suggested, you can adjust your documentation file type to "URL" and from your code you could perform the http call to render the url file.
- Lastly, you can make the CTM Agent read the documentation file to job sysout and get it with a "
ctm run job:output::get <jobId> [runNo] " api call.
I hope it is a bit more clear.
My Best
A>Gomes