Museum

PRF_$SET_OPTION                   Domain/OS                    PRF_$SET_OPTION


NAME
     prf_$set_option - set an option in a print request

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

     void prf_$set_option(
          char *option,
          short &option_length,
          num_var_t &string_value,
          char *p_str,
          short &string_length,
          boolean &string_encoding,
          status_$t *status)

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

     procedure prf_$set_option(
          in option: univ string;
          in option_length: integer;
          in number_value:  num_var_t;
          in string_value: univ string;
          in string_length: integer;
          in string_encoding: boolean;
          out status: status_$t);

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

           integer*2 opt_len
           parameter (opt_len = 120)

           integer*2 option_length, string_length
           integer*4 number_value, status
           character option*(opt_len), string_value*256
           logical string_encoding

           call prf_$set_option(option, option_length, number_value, string_value,
          &                     string_length, string_encoding, status)

DESCRIPTION
     This call sets the print option specified by option in the current print
     data structure.

     option
          The name of the option to set.

     option_length
          The number of bytes in option.

     number_value
          The numeric value to set option to.

     string_value
          The string value to set option to.

     string_length
          The number of bytes in string_value.

     string_encoding
          A Boolean argument indicating whether the value of option is encoded
          as a string or number.  If string_encoding is true, the value of
          option is set from string_value.  If false, the value of option is
          set from number_value.

     status
          The completion status.

SEE ALSO
     prf_$config_file, prf_$inq_option.