NDC comm CompuFax - Manual (Page 116)

9 2
Calling Sequence:
FAX_CMD_SET_OUTPUT [output_proc]
Arguments
name: output_proc
type: entry mask
access: call
mechanism: by reference
This routine will be established as the output procedure for FAX_CMD_OUTPUT. All output will be
displayed via this procedure. The calling sequence of this procedure should be the same as
LIB$PUT_OUTPUT. If this parameter is not passed or is passed as zero, the default output procedure will
be used which displays its output on SYS$OUTPUT.
10.2.1.5 FAX_CMD_SET_USER
This procedure is used to establish a different user name to be used as the user name associated with
commands issued. File access checking is performed in the context of this user name.
A process must have SYSPRV privilege to use this procedure. The privilege checking is done against process
privileges, not image privileges so installing an image with SYSPRV will not suffice.
Calling Sequence:
FAX_CMD_SET_USER [user_name]
Arguments
name: user_name
type: charactercoded text string
access: read only
mechanism: by descriptor.fixed length string descriptor
This is the username to use in subsequent calls to FAX_CMD_PROC. If this is not passed or is a NULL
string, the username is cleared and subsequent calls to FAX_CMD_PROC will use the current process
username.
Return Value:
SS$_N ORMAL If the name was successfully changed
SS$_N OPRIV If SYSPRV is not present
10.2.1.6 FAX_CMD_FORCE_EXIT
This would normally be called from a user condition handler to cause FAX_CMD_PROC to return on
completion of the current command. This is useful if FAX_CMD_PROC was called with no command. In
this case, FAX_CMD_PROC normally does not return until the user issues an EXIT command or presses
^Y.
A user condition handler that was established with FAX_CMD_SET_HANDLE could use this procedure to
cause FAX_CMD_PROC to return after processing the current command (presumably the one that resulted
in the error).
Calling Sequence:
FAX_CMD_FORCE_EXIT