Profound.js programs running on Profound.js Spaces can be called using the NODERUN CL command or program. The program to run is identified by the Profound.js Spaces workspace owner and workspace name. The workspace's start program is executed, parameters can be passed back/forth, and the program can access IBM i data and objects. Access tokens can be used to run workspaces that don't allow public access. Profound.js Connector APis, such as DB2/i access, program/procedure call, etc. are available to the Profound.js Spaces program when called in this way, and access to IBM i objects runs in the same job as the NODERUN command. The program may either present an interactive user interface or just perform back-end business logic, in which case control is immediately passed back to IBM i after the Profound.js Spaces program finishes executing. Calling an interactive program is only allowed within a Profound UI / Genie session.
NODERUN Command
The NODERUN command takes the following parameters:
- Workspace owner - Specifies the profile handle that owns the workspace to run.
- Workspace - Specifies the name of the workspace to run. The name can be given in either the descriptive format, or in the format used in the workspace URL.
- Access token - Specifies an optional Profound.js Spaces access token, for running workspaces without public "run" permission.
- Parameters - One or more parameters can be specified to pass to the Profound.js Spaces program. Note: Unlike the CALL command, NODERUN command does not modify the data in CL variables that are passed as parameters.
See the command help panels for more information on using the NODERUN command.
NODERUN Program
The NODERUN program performs the same functions the NODERUN command, except that parameter values changed by the Profound.js Spaces program are returned to the caller.
| NODERUN Parameter List | |||
|---|---|---|---|
| Parameter | Usage | Type/Length | |
| 1 | Workspace owner Profile handle that owns workspace to be called. | Input | Char(51) |
| 2 | Workspace Workspace name in either descriptive format or | Input | Char(75) |
| 3 | Access token Pass '*NONE' to run a public workspace. | Input | Char(75) |
| 4 | Parameter (optional) Parameter to pass to the Profound.js Spaces program. | Input/Output | Variable |
Security / Access Control
For security purposes, both the NODERUN command and program use an access control list to determine what workspaces can be called. The access control list is stored in database table NODERUNACL in the Profound.js Connector installation library. The table has one column, for the workspace owner profile handle. The NODERUN command and program will only call workspaces belonging to owners listed in the NODERUNACL table. By default, the access control list only allows workspaces published by Profound Logic. Insert additional rows in the table to allow calling workspaces published by other owners.