Change Device Domain Data (QYASCHGDDD) API


  Required Parameter Group:

1 Data variable Input Char(*)
2 Length of data variable Input Binary(4)
3 Format name Input Char(8)
4 Data handle Input Char(32)
5 Error code I/O Char(*)

  Default Public Authority: *EXCLUDE

  Threadsafe: Yes

The Change Device Domain Data (QYASCHGDDD) API does the initial setting or changes the contents of data set by a previous use of this API for the same data handle. The data could have been set by the same node or a different node that is in the same device domain of the same cluster. The structure and content of the data is completely up to the discretion of the user of the QYASCHGDDD API. The QYASCHGDDD API only ensures that the data is the same on all nodes within the device domain.

The data can be retrieved by use of the Retrieve Device Domain Data (QYASRTVDDD) API.

Authorities and Locks

No authority is required beyond *USE authority to the API program, QYASCHGDDD.


Required Parameter Group

Data variable
INPUT; CHAR(*)

The storage area that contains the data.

Length of data variable
INPUT; BINARY(4)

The length of the data variable.

Format name
INPUT; CHAR(8)

The format of the data. The possible values are:

YASC0100 This is a generic format. The actual data content is up to the discretion of the user of the API. The content and its structure must be consistent with use of the Retrieve Device Domain Data (QYASRTVDDD) API.

Data handle
INPUT; CHAR(32)

An identifier assigned by the creator of the data. The identifier is treated as hexadecimal data. Products should include their product identifier in the data handle to help avoid conflicts with other products.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Format Descriptions

YASC0100 Format

The following shows the information sent for the YASC0100 format. For detailed descriptions of the fields in the table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(*) Data


Field Descriptions

Data. The new data. The data is treated as hexadecimal data.


Error Messages

Message ID Error Message Text
CPF9821 E Not authorized to program &1 in library &2.
CPF3C21 E Format name &1 not valid.
CPFBA4B E Data length not valid.
CPF3CF1 E Error code parameter not valid.
CPFB71B E Not all nodes processed device domain data.


API introduced: V6R1

[ Back to top | Configuration APIs | APIs by category ]