Common FAXSR System Management Commands
The contents of this appendix are intended to assist users of atrievePurchasing products that offer direct o tfax output. This document does not supercede the Omtool FaxSR documentation (Appendix AR). In the event this document contradicts Omtool documentation, the Omtool documentation is to be considered correct.
Summary Of Operation
Step 1 Entry
Enter a document such as a purchase order and select the direct to fax option when asked how to print. The atrieve product formats and sends the document to a print queue. The print queue is typically called 'FAXSR_PRINT' or 'FAXSR$PRINT'. The print queue status is always 'Stopped'. Once the direct to fax module has passed the document on to the 'FAXSR_PRINT' queue, the responsibility for the document lies totally with the Omtool FaxSR product.
Step 2 Recognition
The document resides in the 'FAXSR_PRINT' queue until the faxing software scans the queue and recognizes that there is a document ready for faxing. By default Omtool's faxing software scans the 'FAXSR_PRINT' queue every 2 minutes.
To view the list of jobs waiting to be found in the 'FAXSR_PRINT' queue, enter the following command:
$ SHOW QUEUE FAXSR_PRINT/ALL
Step 3 Merge
Once a document has been recognized in the 'FAXSR_PRINT' queue it is picked up for processing by the FaxSR software. At this stage the data produced by the atrieve software products is merged with the layout and signature files. Once the merge information has taken place the FaxSR product sends the completed document to its destination.
FaxSR typically broadcasts a message to the sending users screen stating the job successful. This may take some time as the FaxSR product is configured to attempt to fax a document 5 times.
Example of the message Omtool presents to the sending users screen.
%FAXSR Successful, Entry:0.0.6, Phone 8269675, RecipientId 604 8269675
OMTOOL FAXSR – BASICS
Omtool FaxSR is an independent product; as such you may wish to become more familiar with its capabilities and commands. The following section summarizes some of the basics that will let you get by. (The following steps outline the basics to allow to familiarize you with the Omtool FaxSR product.)
Enter the FaxSR environment by entering the following command at the $.
$ FAXSR
1. To view a listing of all jobs sent and their result status of 'OK' or 'Failed' enter:
FAXSR>SHOW HISTORY/ALL
Eg.,
0.0.5 " MATRIX::BASLITE | 1-OCT-YYYY | 09:48 Sent OK |
0.0.4 " MATRIX::TEST | 1-OCT-YYYY | 09:25 Sent OK |
0.0.3 " MATRIX::TEST | 1-OCT-YYYY | 09:18 Sent OK |
0.0.2 " MATRIX::TEST | 1-OCT-YYYY | 09:08 Sent OK |
0.0.1 " MATRIX::TEST | 1-OCT-YYYY | 08:49 Sent OK |
2. To view a listing of all jobs in the process of and/or waiting to be sent, enter:
FAXSR>SHOW QUEUE/ALL
This example demonstrates a document waiting to be merged.
0.0.6 " MATRIX::STEVE | 4-OCT-YYYY | 10:27 Convert Pending |
This example demonstrates a document in the process of being merged and translated into a format that a fax machine can accept.
0.0.6 " MATRIX::STEVE | 4-OCT-YYYY | 10:29 Converting |
This example demonstrates a document in the process of being sent. If this fails the document is placed into a 'pending or waiting' state. The Omtool product is set to attempt a send 5 times at 3 minute intervals.
0.0.6 " MATRIX::STEVE | 4-OCT-YYYY | 10:32 Sending |
This example demonstrates a document waiting to be sent.
0.0.6 " MATRIX::STEVE | 4-OCT-YYYY | 10:35 Pending |
3. To resend a fax enter:
FAXSR>SHOW HISTORY/ALL (Provides a list of available faxes)
Eg.,
0.0.5 " MATRIX::BASLITE | 1-OCT-YYYY | 09:48 Sent OK |
0.0.4 " MATRIX::TEST | 1-OCT-YYYY | 09:25 Sent OK |
0.0.3 " MATRIX::TEST | 1-OCT-YYYY | 09:18 Sent OK |
0.0.2 " MATRIX::TEST | 1-OCT-YYYY | 09:08 Sent OK |
0.0.1 " MATRIX::TEST | 1-OCT-YYYY | 08:49 Sent OK |
FAXSR>SHOW ENTRY/FULL
An alternative method to resend a fax is to go in to the change module of the atrieve product you sent the fax from and accept it again. This method has the advantage of allowing you to change the phone number of the recipient.
When trying to resend a fax and the information displayed with the 'SHOW HISTORY/ALL' command does not provide enough information, enter the following command:
FAXSR>SHOW ENTRY/FULL
In the example shown below look for the line item 'filename'. This line tells you the 6 character filename provided produced by the direct To fax option.
0.0.6 MATRIX::STEVE "
Submitted 4-OCT-YYYY 10:27
Action performed: 4-OCT-YYYY 10:37
Filename: DKA100:[USERS.STEVE]1ØGHØ1.FAX;5
Temporary text filename: FAXSR$FAXES:STEVE_0_0_6.STREAM
Temporary fax filename: SYS$COMMON:[FAXSR.FAXES]STEVE_0_0_6.FAX;
Temporary cover page fax: SYS$COMMON:[FAXSR.FAXES]COVER-STEVE_0_0_6.FAX;1
Attempts (remains/total) 1/2
Retry interval: 00:05:00.00
Phone number: 8269675
Server requested/used: Any/1
Page dimensions: 60 rows
Resolutions: Fine
Font information: Font #998, 10 point, 6 LPI
Recipient FAX ID: 604 8269675
Connect time: 00:02:21.40
Pages sent: 3/2
Status: Sent OK
Notification: Broadcast
The line to look for has been bolded for the purpose of this illustration only. You can now resend the fax with the entry number of '0.0.6' or at the '$' enter:
$PRINT 1ØGHØ1.FAX/QUE=FAXSR_PRINT