Conducting an Online Session

Online DDDL Compiler › Online Sessions › Conducting an Online Session

Conducting an Online Session

The following table provides guidelines for conducting an online IDD session.

Guideline for:	Description
Types of statements	Enter ADD, MODIFY, REPLACE, DELETE, DISPLAY/PUNCH, and INCLUDE statements in the screen I/O area.
Cursor movement	Use the TAB, BACK TAB, and CURSOR keys to move the cursor around the screen I/O area and to position the cursor in the command area.
Text-editing commands	Use online text-editing commands, discussed in Line Commands later in this chapter, to manipulate the contents of the work file.
End-of-file indicator	:i1.end-of-file indicator Specify a logical end-of-file indicator to establish the point at which input from the work file to the DDDL compiler is to end. A default end-of-file indicator of /* is established during IDD installation. The user can change this indicator on a dictionary or session basis by using the SET OPTIONS statement EOF clause.
Suspending IDD	Transfer from online IDD to another online CA IDMS component, then resume the original IDD session, using the transfer control facility. The user moves from one online session to another by means of the top-line SWITCH command, described later in this chapter, and the transfer control facility Selection screen. (refer to the CA IDMS Common Facilities Guide manual.)

Input and Output Are Displayed

The online compiler displays each input statement, followed by the requested output. For example:

display first 2 records.
*+      display record name is cust-rec version is 1.
*+      display record name is cust-rec version is 2.

Error Handling

The online DDDL compiler responds to errors encountered in source input statements by:

Indicating the total number of E-level errors from the most recent compiler execution in the message area of the screen.
Listing error messages on the line immediately following the line in error. Each message is preceded by *+, which indicates that the text is commentary only; if the screen is resubmitted, the message text is ignored by the DDDL compiler.

Using HELP DC to Debug

To aid the debugging process, you can issue a HELP DC command to obtain a detailed online description of any error or warning message produced in a DDDL compiler run. The user must type the HELP DC command in the screen I/O area.

Syntax for the HELP DC command is as shown below, where message-id must be the 6-digit identifier associated with the error or warning message.

►►─── HELp ─┬──────┬─ message-id ─────────────────────────────────────────────►◄
            └─ DC ─┘

For example, to display information about message 601034, enter:

help 601034

or enter:

help dc601034

The online DDDL compiler responds with the ID, severity, text, and explanation associated with the message, as follows:

*+  E   DC601034  INVALID VERSION
*+
*+  An invalid version specification has been
*+  encountered. The version number is too
*+  long or contains nonnumeric characters.
*+  Supply a valid version number according
*+  to the syntax rules.

More information: For descriptions of all DDDL compiler messages, refer to CA IDMS Messages and Codes Guide.