The process of sending a Fax or Email requires that the destination is known and that a spooled file containing multiple messages can be broken down into separate messages.

To specify the first page of each new message you can either enter a string, which if found anywhere in a page indicates a new message, or the line number and position of a control field can be specified.

The position of the field containing either the fax/email destination or a key to extract the destination is specified. If an Exit Program is specified the field data is passed to the program which should return the destination.

As each spooled file arrives in the output queue it is processed as above and a fax is generated and added to the Cobwebb queue.

Note : Only text (or SCS) spooled files can be processed. If you want to send an AFP spooled file by fax Cobwebb Fax contains a SNDFAXAFP command, but this requires the fax number to be passed as a parameter, rather than extracting it from the text (it is not practical to read the text of an AFP spooled file). This is one reason why CPPD starts with a text file and adds the overlay, font etc later.

Entries

Spooled file status

Rotation

Font Group

Specify the CPPD font group to be used to print the document. You may experience difficulty in selecting the same font for faxing as you used for printing. This will almost certainly happen if you are printing using variable pitch fonts such as Times Roman. Fonts used for faxing must be resident in the IBM i, whereas fonts used for printing can reside in the printer. The standard IBM i font library QFNTCPL contains a range of fixed pitch fonts from 15cpi to 10cpi, if you want to use the same font as in the printed output you may find it is not in QFNTCPL. In this case you will need to order the appropriate font library from IBM.

See Work with font groups in PPD File Maintenance for more details on CPPD font groups.

Fax form file name

Enter the Fax form file name/library/member name of the Fax form. A Fax Form is used if you have Cobwebb Fax without CPPD and want to add Cobwebb Fax text instructions or other text to each page of a spooled file. The Cobwebb Fax Standard Text File ASTDDOC is used for Fax forms.

Library

Enter a specific library name containing the Fax Form file.

Member name

Enter a specific member containing the Fax Form.

First page of new document

This part of the command is used to specify the start of each new message in a multi fax spooled file. Each message can be one or more pages long. The start of a new message can be when the 'Compare data text' is found on the page, or by specifying a field on the page which is compared with the next page, if the comparison (EQ/NE) is true then it is a new message. If a 'compare data position' is specified the field will either be on the 'compare data line number' or on the first line found with a string matching the 'compare data text'. Note:- The text string must be exactly as found in the spooled file, including the correct case.

Compare data text

Enter the text, which if found anywhere on the page indicates the first page of a new message, e.g. 'Page   1'.

or compare data line number

Enter the line number containing the data to be compared to indicate a new message.

Compare data position

Enter the start position in the line to be used for comparison.

Compare data field length

Enter the number of characters to be compared (max30).

Comparison

Enter the required comparison, either EQ=Equal, or NE=Not Equal.

Destination from spooled file

Select destination from spooled file - This part of the command covers the selection of the destination from the data in the spooled file itself. This is usually an Account number or name (rather than a fax number). The appropriate Account number or names can be set up as FAX / EMAIL directory entries. Note:- The message 'No destinations found' means that the place which was specified in the spooled file is blank, try again with another line number.

Destination text

Enter destination text. The destination text identifies the line on the spooled file which contains the  destination for Example 'YOUR ACCOUNT NO.' again the text must be correct, and is case sensitive.

or destination line number

As an alternative to the destination text the line on which the destination is to be found can be specified. It must be the same for all documents selected.

First position of destination

Enter first position of destination. This defines the exact print position of the first position of the destination.

Destination field length

Enter destination field length. This defines the length of the destination. For Faxing the maximum length is 19 characters, which is the same as the length of the Cobwebb Fax directory entry.

Fax/Email number or directory entry

The Fax number or Directory Entry parameter determines whether the fax number is in the text or whether it will be found in the Cobwebb Fax directory or a user directory. If the destination cannot be found in the Cobwebb Fax directory it will be put on the queue with the destination shown with an * in front and a status of QV (invalid destination). If the fax number cannot be found in the User directory, or if it is blank, an entry will be put on the queue with a blank fax number with the destination key shown in the 'Attn' field.

All documents on the spooled file will therefore create a queue record (unless fax no = NOFAX) so that documents do not get 'lost'.

NOTE : - if a fax number of 'NOFAX' is used a fax will not be created for this directory entry (no queue record will be created).

Directory exit program

If 'Fax number or directory entry' equals '4' (Exit program), the Directory exit program name is entered here. The default program name is 'GETFAXNO'.

Library

Enter the library name where the Exit program will be found.

Time to send

Enter the time to send the fax/email 'hhmm', if blank the fax will be sent immediately.

Date to send

Enter the date to send the fax/email 'yymmdd', if blank the fax will be sent immediately.

From

From, up to 30 characters will be included on the queue record (From) and optionally in the text of the fax. This is controlled by the Fax header page format specified in the Cobwebb User Profile associated with the USRID field of this command. The From field can be extracted from the spooled file by specifying the position of the data on the first page of each new fax as follows: - ?a,b,c where a,b and c are 1,2 or 3 digit numeric fields separated by commas. a=the line number of the data, b=the position, c=the length. OR ??a,b,c where a=a scan field which dentifies the line number. The resulting text will be placed in the From field (max 30 chs).

To

To or company name, up to 30 characters will be included on the queue record and optionally in the text of the fax. The To field can be extracted from the spooled file by specifying the position of the data on the first page of each new fax, as follows: - ?a,b,c where a,b and c are 1,2 or 3 digit numeric fields separated by commas. a=the line number of the data, b=the position c=the length. OR ??a,b,c where a=scan field which identifies the line number. The resulting text will be placed in the To field (max 30 chs).

User name

Enter a User name. This is the User name which is displayed on the Cobwebb queue and is used to look up the Cobwebb User profile. The Logo and Department code can be selected from the Cobwebb User file based on the User name entered here.

User ID (if required)

Enter User ID. If the Userid is used in addition to the User name a message will be returned to the User ID specified, via SNADS. See SNDAPI 'QRCD' for special use of this field.

User address (if required).

Enter User address. This is used together with the User ID to return a message to the originator, via SNADS.

Priority

Cobwebb queue priority. 0 = Hold (put fax on queue but do not send).  1-3 = Message is put on queue at the appropriate priority.

Public authority

Cobwebb queue public authority. Determines who can view the Fax on the Cobwebb queue.

Click on one of the following for entries specific to either *FAX or *EML

*FAX specific entries

*EML specific entries

Function keys