NDC comm CompuFax User Manual

Page 115

Advertising
background image

9 1

The user condition handler may force the command processor to exit by modifying the severity of the first
status value in the signal array to be SEVERE and calling FAX_CMD_FORCE_EXIT before it returns.

Calling Sequence:
FAX_CMD_SET_HAN DLE [handler_address]

Arguments
name: handler_address
type: entry mask
access: call
mechanism: by reference

This is the address of the user condition handler. If this is zero or if this routine is never called, then all
signals are handled internally in FAX_CMD_PROC. The default handler displays messages using the
currently defined output procedure. If a user handler is established, then messages will only be displayed if the
user handler displays them.

10.2.1.3 FAX_CMD_SET_INPUT

This procedure is used to establish an input routine that will be called by FAX_CMD_PROC to obtain input.
Use of this procedure is optional, a default procedure is provided which will prompt SYS$INPUT for input.

Note that the CompuFax @filename command is processed by this input routine, so if you substitute an
input routine it must be capable of processing .@. if you want this feature. Note that in order for the
@filename FAX command to work properly, the default input procedure should be used.

Calling Sequence:
FAX_CMD_SET_IN PUT [input_proc], [parm_input_proc]

Arguments
name: input_proc
type: entry mask
access: call
mechanism: by reference

This is the address of the entry mask for a procedure that is to be used for command input. The calling
sequence for this procedure should be the same as that of LIB$GET_INPUT. If this parameter is not passed
or is passed as 0 the default input is restored.
name: parm_input_proc
type: entry mask
access: call
mechanism: by reference

This procedure is used to input required parameters that are not part of the command. If this parameter is not
passed or is passed as 0 and a user input procedure has been established, the user input procedure is also used
for parameter input. If no user input procedure is in effect and this procedure is not passed, the default
parameter input is restored. The calling sequence for this procedure should be the same as that of
LIB$GET_INPUT.

10.2.1.4 FAX_CMD_SET_OUTPUT

This procedure sets the output routine to be used with FAX_CMD_PROC. Use of this procedure is optional.
If it is not used the default output routine will display output at SYS$OUTPUT. In order for the FAX
LOG_OUTPUT command to work properly the default output procedure should be used.

Advertising