Online Sessions

An online DDDL session begins when the user signs on to the compiler and ends when the user signs off or terminates the session. The user can also suspend a session and transfer to another online CA IDMS software component.

idmscu19

The following considerations about online sessions are discussed in the following subsections:

Beginning a Session

To begin an online session:

Sign on to the host teleprocessing (TP) monitor, according to site-standard procedures.

Enter one of the following:

Site-standard task code that invokes the online DDDL compiler; the installation default is IDD.

Site-standard task code that invokes the online DDDL compiler under the transfer control facility (TCF); the installation default is IDDT. For a complete description about using online IDD under TCF, refer to the CA IDMS Common Administrating section
manual.

Optionally, enter the SIGNON command on the first line of the screen I/O area. If the SET OPTIONS statement specifies SECURITY FOR IDD SIGNON IS ON, SIGNON must be the first command issued in the session; see SIGNON Statement for additional information.

Optionally, enter a SET OPTIONS statement to establish session- or dictionary-specific processing options; see SET OPTIONS Statement for additional information.

You can also initiate an online DDDL compiler session from another online component by using the transfer control facility; for additional information, refer to the CA IDMS Common Administrating section
manual.

Conducting an Online Session

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

Topic	Guidance
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 section, 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 section, and the transfer control facility Selection screen. (refer to the CA IDMS Common Administrating section 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.

The syntax for the HELP DC command follows, 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 the CA IDMS Messages documentation.

Terminating a Session

To end an online session, choose one of the following options:

Enter SIGNOFF, LOGOFF, or BYE on the first line of the screen I/O area and press ENTER.

This terminates the full-screen text editor, deletes the contents of the work file, clears the default processing options established for the session, and displays the session transaction summary. After reviewing the transaction summary, press CLEAR.

Enter END in the command area and press ENTER.

This terminates the session and clears the contents of the work file; the transaction summary is not displayed. Control is returned directly to the host TP monitor.

Recovering a Session

Consider the termination situations shown in the following table when you recover a DDDL compiler session.

Termination situation	Effect
The DDDL compiler, central version, or DC/UCF system terminates abnormally during an online DDDL compiler session.	All updates made to the dictionary during the session remain intact. The contents of the work file and the default session options are lost.
The DDDL compiler terminates abnormally.	You can resume after recovering the session using the compiler task code. The session resumes at the point before which the last command was entered; text changes made to the last screen are applied to the work file.

Online DDDL Compiler

CA IDMS Reference 19.0

Online Sessions