VMS Help RTL Routines, SMG$, SMG$EXECUTE_COMMAND  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Execute Command in a Subprocess routine executes the
    specified command in the subprocess created with the SMG$CREATE_
    SUBPROCESS routine.

    Format

      SMG$EXECUTE_COMMAND  display-id ,command-desc [,flags]

                           [,ret-status]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 display-id

    OpenVMS usage:identifier
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Display identifier of the virtual display with which the
    subprocess is associated. The display-id argument is the address
    of an unsigned longword containing this identifier.

 command-desc

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Command string. The command-desc argument is the address of a
    descriptor pointing to the command string.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Optional bit mask that specifies optional behavior. The flags
    argument is the address of an unsigned longword that contains the
    flag. The valid values for flags are as follows:

    SMG$M_DATA_FOLLOWS   Input data follows. The next call to
                         SMG$EXECUTE_COMMAND contains input data
                         for the currently executing command. Do not
                         specify this value if this is the last input
                         data item. If you do specify this value,
                         ret-status is not returned.
    SMG$M_SEND_EOF       Send end-of-file marker. The end-of-file
                         marker is sent to the subprocess.

 ret-status

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Optional status of the executed command, provided that the
    commands are not being buffered. The ret-status argument is the
    address of an unsigned longword containing this status.