Micro Focus Visual COBOL 2.3 Update 2 for Eclipse (Windows) > Programming > Compatibility > Compatibility with RM/COBOL > RM/Panels > Writing Programs > Standard Runtime Functions > SET FIELD ATTRIBUTE

SET FIELD ATTRIBUTE

Execution

PERFORM RMP--SFA-PANELNAME

Description

This standard runtime function alters the enabled attribute code assigned to a field/control through the Panel Editor. The attribute value remains altered until the panel is removed. This standard runtime function allows a field/control to be displayed with different attributes based on its value or other runtime system conditions.

Required Parameters

The program must set the name of the field/control to be changed in RMP--FIELD-NAME. If the field/control occurs more than once, the occurrence number must be specified in RMP--FIELD-OCCUR. The occurrence numbers are equivalent to COBOL subscripts and begin at 1.

RMP--ATTRIBUTE must be set to space or to a value in the range A through P to indicate the new attribute for the field/control. A value of space restores the default attribute value.

Additional Usage Notes

Before this standard runtime function can be executed, the panel must be displayed.
This standard runtime function displays the field/control with the new attribute. However, if it is a repeating field/control, it displays only the specified occurrence. Setting RMP--FIELD-OCCUR to 0 displays all occurrences of a repeating field/control.

RMP--STATUS Values

Status value	Description
0	The function executed successfully.
1	The field/control name is invalid.
2	The occurrence number is invalid.
4	The attribute is invalid.
5	The panel is not in this library
6	The library does not exist.
10	The panel is not displayed.
14	A COBOL input/output error was encountered on the panel library during execution of this function. To determine the exact nature of the I/O error, use the C$RERR subprogram.