System Tasks › CLIST System Task › CLIST System Task Usage

CLIST System Task Usage

Defining a command list module

To use the CLIST task, you must first define a command list module in the data dictionary by using the IDD MODULE statement.

To define the command list module

1. Begin the module by specifying the module name and language (DC) as follows:

   add module command-list-module-name
   language is dc
   

   Note: Ensure that the module language is specified as DC.

2. Code the module by specifying system and user task statements. The following rules apply to command list modules:
   • A command list module can contain any number of valid DC/UCF task statements, including another CLIST statement.
   • Command lists can be chained but not nested.
   • A CLIST command within a command list must be the last task statement in the module.

Invalid task statements

If an invalid task statement is encountered in the command list module at runtime, subsequent task statements are not executed.

Signon CLIST

To make the command list module a signon CLIST for a user, name the module as the value of the CLIST attribute in a user profile associated with the user.

The following sample CLIST task invokes the command list module named SETUP-LR1:

Vnnn ENTER NEXT TASK CODE:       CA IDMS release nn.n tape volser node nodename:
  clist setup-lrl1

The following is an example of the command list module, SETUP-LRL1:

add module name is setup-lrl1
language is dc
module source follows
dcuf set dictname devdict
dcmt v d p dudxc1m qua .
dcmt v d p cudx12mk qua .
dcmt v d p cudxlimk pli qua .
dcmt v d p cutest qua .
dcmt v d t deptbye inv xxxdc5st inp .
msend.

Invoking command list modules from programs

For more information about invoking command list modules from application programs, see the Callable Services Guide.

More Information

For more information about creating and storing command list modules, see the IDD DDDL Reference Guide.