The MODIFY-STMT statement is used to modify the definition of a statement in the open syntax file. The statement must be the current object. Afterwards, the first operand for this statement is the current object. The MODIFY-STMT statement is very similar to the ADD-STMT statement.
The default value for all operands for MODIFY-STMT is *UNCHANGED, i.e. only those parts of a statement definition that are explicitly specified are modified. In guided dialog the operand form displays the current operand assignment rather than *UNCHANGED. When a value other than *UNCHANGED is specified for a MODIFY-STMT operand, the old specifications in the statement definition to be modified are replaced by the new ones. This also applies if a list is possible, i.e. the specified value is not added to the value list but replaces it.
There is a special rule for STANDARD-NAME. When the statement to be modified is defined in an assigned reference file (see OPEN-SYNTAX-FILE), the old entries for STANDARD-NAME are retained, and the name specified with MODIFY-STMT is added to them. All names given to the statement must be unique with respect to the set of statements pertaining to the program.
Definitions of the operands and operand values pertaining to the statement are modified by means of the MODIFY-OPERAND and MODIFY-VALUE statements, rather than by means of MODIFY-STMT.
NAME = *UNCHANGED / <structured-name 1..30>
(External) statement name, to be specified when the statement is entered. The user can abbreviate this name on input, in contrast to the STANDARD-NAME and ALIAS-NAME.
STANDARD-NAME = *UNCHANGED / *NO / list-poss(2000): *NAME / <structured-name 1..30>
Additional external statement name, which can be alternatively used when entering the statement. It must not be abbreviated when entered. In contrast to an ALIAS-NAME, a STANDARD-NAME must not be deleted. It is reserved for Fujitsu Software Development and is therefore not described here.
ALIAS-NAME = *UNCHANGED / *NO / list-poss(2000): <structured-name 1..30>
Additional external statement name, which can be alternatively used when entering the statement. It must not be abbreviated when entered. In contrast to a STANDARD-NAME, an ALIAS-NAME may be deleted.
MINIMAL-ABBREVIATION = *NO / <structured-name 1..30>
Additional external statement name which defines the shortest permissible abbreviation for the statement. Any shorter abbreviation will not be accepted, even if it is unambiguous with respect to other statements.
The following should be noted:
Checking against the minimum abbreviation is carried out only after SDF has checked the input for ambiguity. It may thus happen that SDF selects the correct statement but then rejects it because the abbreviation entered is shorter than the specified minimum abbreviation.
The minimum abbreviation must be derived from the statement name (NAME).
The ALIAS-NAMEs and STANDARD-NAMEs of the statement must not be shorter than the minimum abbreviation if they are an abbreviation of the statement name.
The minimum abbreviation may only be shortened - not lengthened - within a syntax file hierarchy.
HELP =
Specifies whether there are help texts for the statement, and if so, what those texts are.
HELP = *UNCHANGED
No change with regard to help texts.
HELP = *NO
There are no help texts.
HELP = list-poss(2000): <name 1..1>(...)
There are help texts in the specified languages (E = English, D = German). SDF uses the language specified for message output.
TEXT = *UNCHANGED / <c-string 1..500 with-low>
Help text. UNCHANGED is permissible only if a help text has already been defined for the language key.
The help text can contain the special character string “\n” for line breaks.
MAX-STRUC-OPERAND = *UNCHANGED / *STD / <integer 1..3000>
Number of operand positions to be reserved at the highest level in structured transfer. When STD is specified, the size of the operand array corresponds to requirements. However, the array may also be made larger to accommodate planned expansions.
REMOVE-POSSIBLE = *UNCHANGED / *YES / *NO
Specifies whether the statement may be deleted (see REMOVE). This operand cannot be changed for the standard statements.
DIALOG-ALLOWED = *UNCHANGED / *YES / *NO
Specifies whether the statement is allowed in interactive mode. This operand cannot be changed for the standard statements.
DIALOG-PROC-ALLOWED = *UNCHANGED / *YES / *NO
Specifies whether the statement is allowed in interactive mode within a procedure. This operand cannot be changed for the standard statements.
GUIDED-ALLOWED = *UNCHANGED / *YES / *NO
Specifies whether the statement is allowed in guided dialog. This operand cannot be changed for the standard statements.
BATCH-ALLOWED = *UNCHANGED / *YES / *NO
Specifies whether the statement is allowed in batch mode. This operand cannot be changed for the standard statements.
BATCH-PROC-ALLOWED = *UNCHANGED / *YES / *NO
Specifies whether the statement is allowed in batch mode within a procedure. This operand cannot be changed for the standard statements.
NEXT-INPUT =
Specifies what type of input is expected following the statement. SDF needs this specification in order to conduct the guided dialog.
NEXT-INPUT = *UNCHANGED
No change with regard to the subsequent input expected.
NEXT-INPUT = *STMT
A statement is expected as the next entry. SDF interprets input in the NEXT field of the guided dialog as a statement.
NEXT-INPUT = *DATA
Data is expected as the next entry. SDF interprets input in the NEXT field of the guided dialog as data.
NEXT-INPUT = *ANY
It is not possible to predict what kind of input will follow.
PRIVILEGE = *UNCHANGED / *ALL / *EXCEPT(...) / *ADD(...) / *REMOVE(...) /list-poss(64):
<structured-name 1..30>
Specifies the privileges assigned to the statement.
PRIVILEGE = *ALL
All privileges currently defined and all subsequently defined privileges are assigned to the statement.
PRIVILEGE = *EXCEPT(...)
With the exception of those defined with *EXCEPT(...), all privileges currently defined and all subsequently defined privileges are assigned to the statement.
EXCEPT-PRIVILEGE = list-poss(64): <structured-name 1..30>
Specifies the privileges that are not assigned to the statement.
PRIVILEGE = *ADD(...)
The privileges specified with *ADD(...) are assigned to the command in addition to the privileges already assigned to it.
ADD-PRIVILEGE = list-poss(64): <structured-name 1..30>
Specifies which additional privileges are to be assigned to the command.
PRIVILEGE = *REMOVE(...)
The privileges specified with *REMOVE(...) are removed from the command.
REMOVE-PRIVILEGE = list-poss(64): <structured-name 1..30>
Specifies which privileges are to be removed from the command.
PRIVILEGE = list-poss(64): <structured-name 1..30>
Only the privileges specified in this list are assigned to the statement.
STMT-VERSION = *UNCHANGED / *NONE / <integer 1..999>
Version of the statement. The value is transferred in the standardized transfer area.
*NONE means that a zero value can be entered in the standardized transfer area.STMT-VERSION is ignored if the program which the statement belongs to is not working with the new CMDRST and CMDTST macros or is using the old format of the standardized transfer area. More information on the format of the standardized transfer area and the SDF macros can be found in section “Format of the standardized transfer area” and "SDF macros"