pjs.setDataArea()



This API sets data into an IBM i data area.

Parameters

This API can accept an optional database connection definition object to select between multiple database connections. To select the database connection, call pjs.getDB() and pass the result as the first parameter, followed by the parameters documented below. If a database connection definition object is not passed, the default database connection is used.

  1. Field - Reference to a field that is declared with the 'dataArea' configuration option 

  2. Remain locked (Boolean, optional) - default value is false

Exception Handling

If there is a problem retrieving the data, an Error will be thrown with the following properties:

  • message - The IBM i message text.

  • error - The message id.

  • help - The message help text.

Examples



pjs.define("DAT", { type: 'char', length: 12, dataArea: 'DAT' }); pjs.define("C", { type: 'char', length: 12 });   C = 'DIFFERENCE'; DAT = C; pjs.setDataArea(DAT); pjs.unlockDataArea(DAT);



RPG Equivalent

OUT



Requirements

This API requires the Profound.js Connector module.