Previous Topic: Process Command LanguageNext Topic: System-supplied Data Fields

Process Command Language › Overview

Overview

Application Development System process commands are entered using the IDD DDDL compiler and are stored as process modules. A process module can be used in both online and batch dialogs. Some commands, such as DISPLAY, can be executed only in the online environment, while others, such as WRITE TRANSACTION, can be executed only in the batch environment.

A module can contain online- only and batch- only commands; however, at runtime, if a command in the wrong environment is to be executed, the application aborts. An exception is made for the Attributes and MODIFY MAP commands; if these commands are encountered in the batch environment at runtime, they are ignored.

Conditional Processing

Process modules can perform conditional processing based on the runtime environment, as shown below:

IF $ONLINE
    DISPLAY.
  ELSE
    WRITE TRANSACTION.

CA ADS Process Command Language

The following table summarizes the data fields, built-in functions, status conditions, and process commands that make up the Application Development System process command language, with notes on special usage and restrictions.

Several commands have MESSAGE parameters that send messages to the user's terminal in the online environment. In the batch environment, the messages are sent to the log file and/or the operator's console.

Category

Command or command variable

Comments

System-supplied data fields

$PAGE

CURSOR-ROW

CURSOR-COLUMN

Online only

 

$ERROR-COUNT

$INPUT-COUNT

$OUTPUT-COUNT

Batch only

 

All other fields

No restrictions

Built-in functions

Date functions

No restrictions

 

All functions

No restrictions

Arithmetic and assignment commands

All commands

No restrictions

Conditional commands

All commands

No restrictions

 

Cursor position condition

Online only

 

Map field status condition

CHANGED and ERASED parameters are online only.

In batch, the test applies to the dialog's input file map.

Fields specified for a batch test refer to data fields in variable storage, not to fields in the input file record.

 

Environment status conditions

No restrictions

 

Map paging status conditions

Online only

 

Batch control event status conditions

Batch only

 

All other status conditions

No restrictions

Subroutine control commands

All commands

No restrictions

Control commands

CONTINUE

EXECUTE NEXT

FUNCTION

INVOKE

TRANSFER

LEAVE APPLICATION NEXT TASK

RETURN

No restrictions

 

DISPLAY

Online only

 

LEAVE ADS NEXT TASK

Online only

 

LEAVE ADS CONDITION CODE

Batch only

 

READ TRANSACTION

Batch only

 

WRITE TRANSACTION

Batch only

 

All other commands

No restrictions

Database commands

COMMIT

In an CA ADS Batch application, a COMMIT command issued when files are open results in no action, a warning message, or an abend, as specified at system generation and/or at runtime. The default action is abend.

 

KEEP LONGTERM

Online only

 

All other commands

No restrictions

Logical record commands

All commands

No restrictions

Map commands

Attributes

Online only

Occurrence in the batch environment at runtime is ignored.

 

CLOSE FILE MAPS

Batch only

 

MODIFY MAP

The following parameters are online only:

  • CURSOR AT
  • WCC
  • BACKSCAN/NO- BACKSCAN
  • REQUIRED/ OPTIONAL
  • RIGHT/LEFT JUSTIFY
  • PAD
  • ATTRIBUTES

In batch, the MODIFY MAP command applies to the input file map.

Fields specified for a batch MODIFY MAP command refer to data fields in variable storage, not to fields in the input file record.

Occurrence of an invalid parameter in the batch environment at run time is ignored.

Pageable map commands

All commands

Online only

Scratch management commands

All commands

Online only

Queue management commands

All commands

Allowed in batch only if the application is running central version

Utility commands

ACCEPT

RUN PARAMETERS parameter - batch only

The following parameters are online only:

  • TASK CODE
  • TASK ID
  • LTERM ID
  • PTERM ID
  • SYSVERSION
  • SCREEN SIZE

ACCEPT USER ID moves the user id specified in the USER (REQUESTOR) control statement into variable storage.

 

WRITE TO LOG/OPERATOR

LOG parameter— no restrictions

OPERATOR parameter— batch only

 

SNAP

No restrictions

 

WRITE PRINTER

Allowed in batch only if the application is running central version.

SCREEN CONTENTS parameter— online only.

CLASS or DESTINATION must be specified, unless a default is provided using the application compiler or at runtime in a control statement.

This chapter provides the following information about the CA ADS Batch specific process command language: