Overview

SNDFAXP or the 'Send fax from spooled file' command can be used as a command within a CLP program, the parameters entered here are exactly the same, the advantage is that no programming is required as the Cobwebb Fax Spooled file fax monitor checks the spooled file and runs the command from the parameters entered here.

The SNDFAXP command is used to send a fax from a specified spooled file or to select one or more spooled files using the selection criteria.

Although SNDFAXP can be used 'manually' from a command line, it has been designed for inclusion in a CL program to send faxes automatically, following the production of one or more spooled files, e.g. a Purchase Order print program.

Alternatively a subset of SNDFAXP is provided with the Spooled file monitor program (see 'Work with spooled file monitor'). Each spooled file can contain one or more faxes.

Spooled Files can be selected using the User Profile, the Output Queue, the Form Type, or User Data. The selected spooled files will be processed using the destination details extracted from the text.

A Cobwebb Fax 'Fax Form' can be specified, thus allowing a form outline to be overlaid over the text.

One or more fax destinations can be specified in the command, either by specifying the Fax number or by using a Cobwebb Fax directory entry. Alternatively the destination can be extracted from within the spooled file data.

A number of additional parameters can be specified, giving access to most of the features provided in the Cobwebb Fax programming API, allowing print programs to be used to send faxes as well as printing reports or documents, without the need to amend the source program.

The SNDFAXP command provides a wide variety of options. To make the command easier to use it is structured to show only those parameters which relate to the options selected.

Note: Only text (or SCS) spooled files can be processed.

Command Parameters

Select spooled file (SFILE)

The SNDFAXP command is used to send a fax from the spooled file selected according to the spooled file monitor selection criteria. The spooled file can contain one or more faxes. This parameter is always *SLTSPLF.

Spooled file (FILE)

The name of the spooled file(s) to be selected is displayed and can be changed, if required.

User (USRPRF)

The User profile used to select the spooled files is displayed and can be changed, if required.

Output queue (OUTQ)

The name of the print output queue and library name is displayed and can be changed, if required.

Form type (FORMTYPE)

The form type to be selected is displayed and can be changed, if required.

User data (USRDTA)

The User specified data to be selected is displayed and can be changed, if required.

Spooled file status (SPLSTS)

Sets the spooled file status after it has been processed.

Cover page (CRTCVRP)

Create a fax cover page? (Not implemented so leave this as *NO)

ROTATE - Rotation

Font Group (FNTGRP)

The name of the font group to be used.  This can either be *USRPRF to use the default font group for the user or a specific font group that has been set up in the ‘Work with font groups’ option.

Fax form file name (FAXFRM)

(Default file ASTDDOC in CPPD).

Enter the Fax form file name/library/member name of the Fax form. The Cobwebb Fax Standard Text File 'ASTDDOC'is normally 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.

Destination (DST)

The destination of the fax. Leave as *SLTDST.

First page of new document (SLTPAG)

This part of the command is used to specify the start of each new fax in a multi fax spooled file. Each fax can be one or more pages long. The start of a new fax 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 fax. 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 fax, e.g. 'Page   1'.

Compare data line number

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

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 (SLTDST)

Select destination from spooled file  This part of the command covers the selection of the Fax 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 Cobwebb Fax 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 Fax 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 of the destination. The maximum length is 19 characters, which is the same as the Cobwebb Fax directory entry.

Fax 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 1:  if a fax number of 'NOFAX' is used a fax will not be created for this directory entry (no queue record will be created).

NOTE 2:  the user exit program GETFAXNO can be found in source file 'QUSRTOOL' in library CPPD.

Directory exit program (EPROG)

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 (SNDTIME)

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

Date to send (SNDDATE)

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

From (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 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 identifies the line number. The resulting text will be placed in the From field (max 30 chs).

To (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).

Attention (ATTN)

Attention, up to 30 characters which will be included on the queue record and optionally in the text of the fax. The Attention 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 Attention field (max 30 chs).

Reference (REF)

The Reference data, up to 30 characters which will be included on the queue record and optionally in the text of the fax. The Reference 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 Reference field (max 30 chs).

User name (USRID)

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 file. The Logo and Department code can be selected from the Cobwebb User file based on the User name entered here.

User ID (QDEN)

Enter User ID  (if required). If the User id 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 (QDGN)

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

Priority (PRTY)

Cobwebb Fax priority. 0 = Hold (put fax on queue but do not send).  13 = Fax is put on queue at the appropriate priority.

Public authority (PAUT)

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

Cover page logo (LOGO)

Enter the logo number which will cause the appropriate logo to be included before the first line of text. If left blank the User name will be used to select the Cobwebb User file record, if found and if it contains a default logo (type 2) the default logo will be used from Cobwebb User file.

Cover page signature (SIGN)

Enter a logo number (signature) which will cause the appropriate logo to be included after the last line of text in the fax. If the signature is left blank the User name will be used to select the Cobwebb User file record, if found and if it contains a default logo (2) the default logo will be used from Cobwebb User file.

Department (DEPT)

Enter the Department code (only required if Cobwebb Fax costing in use). If left blank the Department code from the Cobwebb User file will be used (if not blank).

Start printing on line (PRTLIN)

Enter the start printing line number. This can be used to start the printing of the Fax on a different line than the first line number of the selected spooled file. Note: The first line of a printed form may take into account skipping over a pre-printed heading, a fax logo does not count as print lines, use this parameter to resolve this difference. If you require to remove blank lines in the text, this can be done when creating the form by using the *@ command with F17 on.

Transparency on (TRNON)

Not used at present.

Transparency off (TRNOFF)

Not used at present.

Transmission mode (TRNSMD)

Not used at present.