All SDF-P commands supply return codes which provide the user with information on the command execution. This command return code is comparable to the return code on the program level. The command return code allows users to respond to specifoc error situations.
The command return code consists of three parts:
subcode1, which assigns the error situation to an error class indicating how serious the error is. The value of subcode 1 is output in decimal.
subcode2, which can contain supplementary information on the error class.
maincode, which corresponds to a message code and supplies specific error information. This message code can be used to output the appropriate error message via the predefined MESSAGE() function or using the SDF command HELP-MSG-INFORMATION.
The command return code can be requested with the predefined functions SUBCODE1( ), SUBCODE2( ) and MAINCODE( ).
There are separate return codes for each command. In addition to the special return codes for specific commands, there are some general return codes, which are listed below.
The general return codes (i.e. the return codes which can occur for any command) are:
(SC2) | SC1 | Maincode | Meaning1 |
0 | CMD0001 | No error |
1If the table also contains guaranteed messages, then "/ guaranteed messages" is added to the meaning column.
For all commands, statements and records in which expression replacement is carried out, the following return codes may appear if errors occur during replacement:
(SC2) | SC1 | Maincode | Meaning |
1 | SDP0140 | Syntax error during replacement |
The following return code may appear for all data lines in a false context::
(SC2) | SC1 | Maincode | Meaning |
64 | SDP0091 | Semantic error |
The following return code may appear for all statements in a false context
(SC2) | SC1 | Maincode | Meaning |
64 | SDP0091 | Semantic error |
Guaranteed message
The entry “guaranteed message” in the table of return codes indicates the following:
The message code and the inserts (numbering and assignment of contents) are guaranteed to appear for certain messages.
If guaranteed messages exist for a particular return code, the number of the message will follow the text which briefly describes the code.