The HB.js extension requires a VS Code Workspace for full functionality. To associate a folder with a workspace, open a folder in the Explorer view.

To add a new host connection, select the + (plus) icon in the HB.JS: HOSTS view and enter the following information:

1. The HB.js Host URL, including the port number, and press Enter. For example: http://example.com:9000

The CICS systems programmer responsible for the CICS regions can provide the host URL, including the port number.

2. A Host Name and a Region Name to identify the connection in the HB.JS: HOSTS view. These names are labels only, so they can be anything; the URL specifies the connection information.
3. A Default User ID, which is a user ID that is already defined in CICS on the host. When you connect to the host, you are prompted to enter the password for this user ID.
4. Select Add Host.

In the HB.JS HOSTS view, select a host and a region, right-click the chosen region, and select Set Default Repository.

1. Navigate to the HBJS Terminal panel, which shows HB.js command output and messages.
2. To open a file in the HB.JS: HOSTS view, right-click the file and select Get or double-click a Host file.
3. Right-click in the editor and select HB.js Commands > (Make|Put|Run).

To access the Application Explorer, perform the following steps:

1. Select the Application Explorer icon for the region where you want to run the Application Explorer.
2. In the App Explorer tab, enter the CICS transaction ID for the initial transaction to analyze, and then press Enter.

For information about using the Application Explorer, see Analyze Applications in the HB.js documentation.

To access the settings for the Application Explorer, perform the following steps:

1. Select the Application Explorer Settings icon for a region.
2. Enter your values and then select Submit to save your settings for the selected region.

For information about the Application Explorer settings, see Use the Application Explorer in the HB.js documentation.

1. In the Application Explorer, navigate to an active terminal session.
2. Close the App Explorer tab and select Save in the pop-up window.
3. The saved session is stored in the Explorer view under your workspace as App Explorer Playback > [today's date] > filename.json.

1. In the Explorer view, navigate to the saved JSON file.

Note: If you do not have a saved JSON file, see the preceding section, Save an Application Explorer Session to a JSON File. 2. Right-click on the file and select HB.js Commands > Application Explorer Playback. An Application Explorer Playback tab opens. 3. You can access screens directly in the playback by selecting the screen icons.

To progress through the screens sequentially, use the Page Up and Page Down keys.

For information about the Application Explorer settings, see Save an Application Explorer Session in the HB.js documentation.

1. Right-click on a COBOL file in the editor or explorer view and select HB.js Commands > Generate JS Object.

Note: You can select either COBOL field names to use COBOL-style field names or JavaScript field names to use JavaScript-style field names in the generated file.

The generated HB.js JavaScript object is opened in the editor and is saved to the workspace folder using a filename similar to filename_(COBOL|JavaScript)_JSOBJ.hbx.

- filename is the name of the original COBOL file
- (COBOL | JavaScript) indicates whether the HB.js function is created using COBOL-style or JavaScript-style field names for the object.

2. Select HB.js Commands > Make to store the file in the utility repository on the connected mainframe region.
3. Add the following code to your HB.js scripts to access the newly created JavaScript object.

Note: Be sure to replace filename and utility repository in the require statement with actual values.

//COBOL Copybook Utilities
var copybookFactory = require('[filename_(COBOL|JavaScript)_JSOBJ]', '[utility repository]');

var demoCopybook = new copybookFactory.commareaBuffer();
var pgm = new CommareaProgram();

//Initialize
demoCopybook.initialize();
pgm.program = 'TRADERBL';

//Commands 
demoCopybook.get()
demoCopybook.set()
pgm.run(demoCopybook.buffer);

1. In the editor, right-click on an OpenAPI JSON file and select HB.js Commands > Generate JS Object from OpenAPI.

Note: Not all formats are supported at this time. Any unsupported formats are flagged as failed tests.

The generated HB.js JavaScript object is opened in the editor and is saved to the workspace folder using a filename similar to filename_OpenAPI_JSOBJ.hbx.

filename is the name of the original OpenAPI JSON file.

2. Right-click on the file and select HB.js Commands > Make to store the file in the utility repository on the connected mainframe region.
3. Add the following code to your HB.js scripts to access the newly created JavaScript object.

Note: Be sure to replace filename and utility repository in the require statement with actual values.

//OpenAPI Utility
var openAPIUtil = require('filename_OpenAPI_JSOBJ', '[utility repository]');

//Retrieve the required schema from your utility file 
var openAPIDefinition = new openAPIUtil.filename();
var openAPISchema = openAPIDefinition.['your files dot notation'].schema;

//Set your object or array of objects that you want to validate against your schema
var sampleData = "your object or array of objects here"; 

//Call the validate function from your generated JS Object 
//This example will write out the output 
writeln (JSON.stringify(openAPIUtil.validate(sampleData, openAPISchema)));

//Sample Output 
  //Pass
  {
    "pass": {
      "type": {
        "message": {
          "expected": "string",
          "found": "string"
        }
      }
    },
    "fail": {},
    "summary": "1 validations have passed, 0 failed"
  }
  //Fail
  {
    "pass": {},
    "fail": {
      "type": {
        "message": {
          "expected": "string",
          "found": "object"
        }
      }
    },
    "summary": "0 validations have passed, 1 failed"
  }