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.

9 1

Page 115
Image 115
NDC comm CompuFax user manual Faxcmdsethan DLE handleraddress, Faxcmdsetin PUT inputproc, parminputproc