Museum

PAD_$DM_CMD                       Domain/OS                        PAD_$DM_CMD


NAME
     pad_$dm_cmd - execute a Display Manager command

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pad.h>

     void pad_$dm_cmd(
          ios_$id_t &stream_id,
          char *dm_command,
          short &command_length,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pad.ins.pas';

     procedure pad_$dm_cmd(
          in stream_id: ios_$id_t;
          in dm_command: univ pad_$string_t;
          in command_length: integer;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pad.ins.ftn'

           integer*4 status
           integer*2 stream_id, command_length
           character dm_command*256

           call pad_$dm_cmd(stream_id, dm_command, command_length, status)

DESCRIPTION
     Pad_$dm_cmd executes the Display Manager command specified by dm_command.
     Use pad_$dm_cmd with caution because it executes the command as if it was
     typed at the keyboard.  The result will depend on the current position of
     the cursor, the current environment of the Display Manager, and other
     factors that are not obvious or necessarily under the program's control.

     stream_id
          The ID of the pad to use when executing the command.

     dm_command
          The Display Manager command to execute.

     command_length
          The number of bytes in dm_command.

     status
          The completion status.

NOTES
     pad_$dm_cmd will fail with the status pad_$insuff_rights unless the cal-
     ling process has the same user ID as the DM.

SEE ALSO
     pad_$def_pfk, pad_$inq_kbd.