Entry to COMIS

The three routines described in this section can be used for this purpose:

CALL CSPAUS (ENTRY_PROMPT)
where ENTRY_PROMPT is a character string. In this case COMIS types the ENTRY_PROMPT and the dialogue is started.

CALL CSTEXT (ENTRY_PROMPT,TEXT)
where input parameters ENTRY_PROMPT and TEXT are characters strings. In this case COMIS interprets the string ``TEXT'', types ENTRY_PROMPT and starts the dialogue.

CALL CSEXEC (TEXT,IERR*)
where input parameter TEXT is a character string. In this case COMIS interprets the given string ``TEXT'' only and control is returned to the calling routine. The output parameter IERR is zero when no errors are encountered, non-zero otherwise. During the dialogue session COMIS gives the standard prompt ``CS>'' and the user can:

• enter the system directives( see Chapter 4);
• enter the function or the subroutine definition;
• enter the COMIS main program.

All system directives are executed immediately and the prompt ``CS>'' is displayed again. If the FUNCTION or the SUBROUTINE statement is entered, COMIS changes his prompt to ``FSD>'' until the END statement completes the routine definition. An intermediate code is stored in the internal buffer and COMIS gives the prompt ``CS>''. During the main program definition COMIS uses the prompt ``MND>''. The COMIS linker is invoked automatically if the compilation was error-free. The linker tries to resolve references in the order: COMIS routines; user's routines. After this stage the main program executes and COMIS types the entry prompt and gives the standard prompt ``CS>''. A COMIS built-in editor (see Chapter 5) is automatically invoked when a syntax error is detected. The command ``E'' of the editor causes the recompilation of the text edited and then the dialogue is continued. The command ``Q'' of the editor causes the current routine definition to be skipped and COMIS gives the prompt ``CS>''. The exit from the COMIS dialogue session is performed by the RETURN statement in the main program or by an ``empty'' (END or # ) main program definition. For exiting from any COMIS routine to an application program the QUIT statement can be used.