DTRHELP.HLB  —  Functions  FN$DCL
       Allows you to spawn directly from your main DEC DATATRIEVE
       process to execute a specified DCL command.

1  –  Input

       Type FN$DCL at the DEC DATATRIEVE prompt. On the same line,
       specify the DCL command argument you want to spawn to, such as
       the DCL print command. The DCL command argument can be any DCL
       command and must be placed inside quotation marks (unless you use
       variables previously declared), and enclosed in parentheses.

2  –  Output

       Your DEC DATATRIEVE process is suspended and the terminal is
       attached to the subprocess. The DCL command is executed.

3  –  Examples

       DTR> FN$DCL ("PRINT REPORTACCOUNTS.RPT")
       Job REPORTACCOUNTS (queue SYSTEMPRINT$QUEUE, entry 148)
       started on PRINTER$LPA0
       DTR>

       In the above example the message appears indicating that the
       job has been added to the print queue. After the command has
       completed or you have exited from the program initiated by the
       command, you see the DTR> prompt. This shows that control has
       been returned to the original process in DEC DATATRIEVE.

       The following example shows how you can use variables with
       FN$DCL:

       DTR> DECLARE ALP PIC X(30).
       DTR> ALP = "DIR/COL=1"
       DTR> FN$DCL (ALP)

       Directory MY$DISK:[DALFY]

       TEST.OBJ;1
       ZTEST.FOR;3

       Note that the FN$DCL process inherits attributes from the caller
       (that is, the main DEC DATATRIEVE process from which it spawned).
       Refer to the OpenVMS documentation on OpenVMS Run-Time Library
       routines for more information.
Close Help