NDC comm CompuFax user manual Faxcmdsetoutput outputproc, Faxcmdsetuser username, Faxcmdforceexit

Models: CompuFax

1 133
Download 133 pages 2.7 Kb
Page 116
Image 116

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

9 2

Page 116
Image 116
NDC comm CompuFax user manual Faxcmdsetoutput outputproc, Faxcmdsetuser username, Faxcmdforceexit