Online Processing › Executing Statements Stored in Modules (OCFX)

Executing Statements Stored in Modules (OCFX)

You can use the OCFX statement to execute statements contained in modules with the language OCF. The following are the two methods for execution:

• Execution at the system prompt
• Execution as part of a system command list (CLIST)

This section describes both methods and provides a table that lists and describes OCFX status codes.

Executing at the System Prompt

To execute OCF-language modules at the system prompt, you enter the OCFX statement after the prompt.

Example:

ENTER NEXT TASK CODE: OCFX ddlmod01 version 3 Enter

Syntax

OCFX statement

►►─── OCFX module-name ──┬──────────────────────────┬─┬──────────┬───────────►◄
                         └─ Version version-number ─┘ ├─ Echo ◄──┤
                                                      └─ Noecho ─┘

Parameters

OCFX

Executes the statements in a command facility source module, produces output, and returns control to the system (the ENTER NEXT TASK CODE prompt returns).

module-name

Specifies a specific command facility source module which contains statements you want to execute. The module must have a LANGUAGE attribute of OCF.

Note: For more information about the LANGUAGE parameter of the MODULE statement, see the CA IDMS IDD DDDL Reference Guide.

Version version-number

Specifies a specific version for a load module to be used in an input session. The default version number is 1.

Echo

Specifies that the input statements are to be displayed on the screen before the output is displayed.

Noecho

Specifies that the named module's input statements are not to be displayed. If you use this parameter and also use SET OPTIONS STATUS OFF (see Using SET OPTIONS to Select Options) as the first statement in the module's source code, then the screen displays only non-zero status messages.

Usage

OCFX produces output and then returns control to the system. If output appears on more than one screen, a message in the following format appears at the bottom of each screen:

PAGE nnn— NEXT PAGE:

Nnn is a variable representing the number of the current screen. You can page forward and backward through the screens as follows:

• Press Enter or PA1 to page to the following screen.
• Press PA2 to page to the previous screen.
• Type a page number after the NEXT PAGE prompt to select a specific screen, then press Enter to page to that screen.

Executing as Part of a Command List

To execute OCF-language modules as part of a system command list (CLIST), you need to do the following:

1. Include the OCFX statement as one of the statements in the command list.
2. Execute the command list.

Note: For more information about CLIST processing, see the CA IDMS System Tasks and Operator Commands Guide.