Syntax
$RMDBAPI |
SERVICE=SET
[TRUNCATE={YES|NO}]
CLASS=01
SYSNAME=system-name
VERSION=version
[field-name-1=field value-1]
[field-name-2=field value-2]
.
.
.
[field-name-n=field value-n]
|
Use
Use this call to change field values in a system image definition. The SET function is not available to other definitions in the knowledge base.
Operands
|
Operand |
Description |
|---|---|
|
SERVICE=SET |
Indicates that changes are to be made in the specified system image definition. |
|
TRUNCATE={YES|NO} |
Specifies whether a field value should be truncated if it is longer than the field length.
|
|
CLASS=01 |
Indicates that a system image definition is to be changed. |
|
SYSNAME=system-name |
Specifies the name of the system image definition to be changed. |
|
VERSION=version |
Specifies the version of the system image definition. |
|
field-name-n=field-value-n |
Specifies the values of the fields to be changed in the definition. You cannot delete a field value. |
Returned Variable
|
Variable |
Description |
|---|---|
|
&SYSMSG |
Contains the message returned by $RMDBAPI. |
Return Codes
The following return codes indicate the success or failure of the change processing:
|
&RETCODE |
Meaning |
|---|---|
|
0 |
Processing was successful. |
|
4 |
Processing was successful, but truncation has occurred. |
|
8 |
Processing failed. |
|
16 |
Error occurred in call syntax. |
Example
The following example changes the value of the fourth line of the Long Description field in the EASTPRD1 version 2 system image definition (class 1), with truncation allowed:
&LDESC4=&STR (Upgrade in progress)
&CALL PROC=$RMDBAPI + PARMS=(SERVICE=SET,+ CLASS=01,+ SYSNAME=EASTPRD1,+ VERSION=0002,+ LDESC4=&LDESC4)