Using the build toolkit to generate artifacts from the Swagger file

Run the build toolkit command line interface (CLI) to generate artifacts for the API requester.

1. Create a local directory called buildToolkit under the /u/{userid} directory.
2. Copy the build toolkit compressed file, zconbt.zip as a binary file, from the product installation directory and extract the zconbt.zip file to the buildToolkit directory.

   You can use the java jar command to extract zip files.

3. Create directories and data sets for the artifacts to be generated.
   1. Create a directory called apiReqScenario under the /u/{userid} directory to store the phonebook.json file.
   2. Create a directory called archives under the apiReqScenario directory to store the generated API requester archive and summary report.
   3. Create a directory called logs under the apiReqScenario directory to store the generated log file for each operation defined in the API.
   4. Create a data set on MVS to store the generated API information file and data structures, for example, TEST.PHBK.COBOL.
4. Upload the phonebook.json file, as a binary file, to the apiReqScenario directory.
5. Create a local properties file named phonebook.properties and enter the directory or data set names and other attribute values:

   
   apiDescriptionFile=../apiReqScenario/phonebook.json
   dataStructuresLocation=TEST.PHBK.COBOL
   apiInfoFileLocation=TEST.PHBK.COBOL
   connectionRef=RemoteAPIconn
   logFileDirectory=../apiReqScenario/logs
   language=COBOL
   requesterPrefix=PHB

   The default prefix is API. For this example, we specify PHB.
6. Upload the phonebook.properties file, as a binary file, to the apiReqScenario directory.
7. Enter the buildToolkit directory and enter the zconbt.zos command:

   
   ./bin/zconbt.zos --properties ../apiReqScenario/phonebook.properties --file ../apiReqScenario/archives/phonebook.ara
       

8. When processing of the command is completed, a message is returned, indicating whether the artifacts were built successfully. If any errors occur, make the necessary corrections and repeat the procedure.