!=============================================================================!
!  DIVISION   I :                                    HELP MODULE DECLARATION  !
!=============================================================================!
!                                                                             !
!      -----------------------------------------------------------------      !
!      SECTION 01 :                                      INITIAL VERSION      !
!      -----------------------------------------------------------------      !
!                                                                             !
!      File Specification: ACCSRC_HELPOPR:FEEDER.HLP                          !
!      Author            : Udo H Schwenzig                                    !
!      Initial version   : 01.00.00 17-JAN-1985 VMS 3.7                       !
!                                                                             !
!      -----------------------------------------------------------------      !
!      SECTION 02 :                                 MODIFICATION HISTORY      !
!      -----------------------------------------------------------------      !
!                                                                             !
!      01.01.00 29-MAR-1985 VMS 4.1: Anton B Rang                             !
!                                    Updated for new version of program.      !
!                                                                             !
!=============================================================================!
!  DIVISION  II :                                 HELP MODULE SPECIFICATIONS  !
!=============================================================================!
!                                                                             !
!      Key 1 (Command name)............ SETFEEDER                             !
!        Key 2 ........................   Qualifiers                          !
!        /qualifier ...................     /CPI                              !
!        /qualifier ...................     /QUEUE                            !
!        /qualifier ...................     /FORM                             !
!        /qualifier ...................     /PAGE_LENGTH                      !
!        /qualifier ...................     /RESET                            !
!        /qualifier ...................     /LEFT                             !
!        /qualifier ...................     /TABS                             !
!        /qualifier ...................     /TOP                              !
!        Key 2 ........................   Setup                               !
!        Key 2 ........................   Errors                              !
!          Key 3 ......................     INVALEFT                          !
!          Key 3 ......................     INVALEN                           !
!          Key 3 ......................     INVALTABS                         !
!          Key 3 ......................     INVALTOP                          !
!          Key 3 ......................     INVALQUE                          !
!          Key 3 ......................     NUMTOOLRG                         !
!          Key 3 ......................     UNEXPECT                          !
!          Key 3 ......................     UNSIGNINT                         !
!                                                                             !
!=============================================================================!
!  DIVISION III :                                              SPECIAL NOTES  !
!=============================================================================!
!                                                                             !
!                                                                             !
!=============================================================================!
!
!
!=============================================================================!
! Key 1                                                             SETFEEDER !
!=============================================================================!
!
1 SETFEEDER
Creates and queues a file to format the Diablo for use with the single
page feeder.

Format:

     SETFEEDER[Qualifier_List]
!
!=============================================================================!
! Key 2                                                            Qualifiers !
!=============================================================================!
!
2 Qualifiers
/CPI

  /CPI[=n]

  Specifies  the  characters  per inch.  The valid values for /CPI are
  ten (10), twelve (12), and fifteen (15).  If no value  is  specified
  after /CPI, the characters per inch defaults to ten (10).
 
/QUEUE

  /QUEUE[=queue_name]

  Specifies  the  queue to which the formatting file will be sent.  If
  the qualifier or the queue name is absent, the file will be sent  to
  the  queue  SYS$DIABLO.   The  queue  name  must  be  less  than  16
  characters long, or it will  be  truncated.   If  it  is  truncated,
  SETFEEDER  will  continue to execute, and attempt to send the format
  file to the truncated queue name.

/FORM

  /FORM[=form_name]

  Specifies the form with which the formatting file will be submitted.
  If the qualifier or the form name is absent, the DIABLO form will be
  assumed (this does not depend on the value of the /QUEUE qualifier.)
  The form name must be less than 16 characters long.

/PAGE_LENGTH

  /PAGE_LENGTH[=n]

  Specifies the lines per page.  The valid values for /PAGE_LENGTH are
  two  (2)  through  89.  If no value is specified after /PAGE_LENGTH,
  the lines per page default to  60.   The  value  on  this  qualifier
  should  be  equal  to  the  number  of  lines on the page, minus the
  desired bottom margin.  If a bottom margin of 6  lines  is  desired,
  and   standard   paper   (66  lines/page)  is  being  used,  specify
  /PAGE_LENGTH=60 (the default).

/RESET

  /RESET
  /NORESET (default)

  Specifies  that all characteristics should be set to default values,
  unless specifically listed in the qualifier list.

/LEFT

  /LEFT[=n] (default 10)
  /NOLEFT
 
  Specifies the left margin in terms of the number of  print  columns.
  The valid values for /LEFT are zero (0) through 131.  If no value is
  specified after  /LEFT,  the  right  margin  defaults  to  ten  (10)
  columns.  /NOLEFT is equivalent to /LEFT=0.

/TABS

  /TABS[=n] (default 8)
  /NOTABS

  Specifies the tab stop length in terms of the number of spaces.  The
  valid values for /TABS are zero (0) through 131.   If  no  value  is
  specified  after  /TABS,  the  tab stop length defaults to eight (8)
  spaces.  This is the normal VAX/VMS default.

  /NOTABS clears all tab stops.  This should  be  used  with  caution.
  Unexpected  print  results  can  occur  if  the  file  to be printed
  contains the <tab> character and no tab stops have been set.

/TOP

  /TOP[=n] (default 6)
  /NOTOP

  Specifies the top margin in terms of the number of lines.  The valid
  values  for  /TOP  are zero (0) through 89. If no value is specified
  after /TOP, the top margin defaults to six  (6)  lines.   /NOTOP  is
  equivalent to /TOP=0.
!
!=============================================================================!
! Key 2                                                                 Setup !
!=============================================================================!
!
2 Setup
For  correct feeding of paper, the single sheet feeder must know where
a page begins relative to the Diablo printer.  The following procedure
must  be  followed  each  time you restart automatic printing, after a
manual feed operation, change paper size,  or  have  a  paper  jam  or
misfeed:
  
    1. Press down the paper release button and lock in place.
    2. Rotate platen until the feed rollers stop moving.
    3. Unlock the paper release button by pressing the button down and
       to the rear of the unit; the button will be in the up position.
    4. Rotate platen until sheet of paper reaches  the  desired  print
       position.
    5. Issue the  SETFEEDER  command  with  /RESET  plus  any  desired
       qualifiers.
!
!=============================================================================!
! Key 2                                                                Errors !
!=============================================================================!
!
2 Errors
Errors  detected by the SETFEEDER command are listed below.  SETFEEDER
errors are prefixed by the code %DIABLO and  are  not  listed  in  the
VAX/VMS manuals.
!
!=============================================================================!
! Key 3                                                              INVALEFT !
!=============================================================================!
!
3 INVALEFT
%DIABLO-E-INVALEFT, left margin must be less than 132

A maximum page width of 132 characters is assumed, and  since  a  left
margin  of  132 characters would leave no room for text, an error will
result if such a left margin is specified.  To  set  the  left  margin
correctly use the SETFEEDER command with a margin of less than 132.
!
!=============================================================================!
! Key 3                                                               INVALEN !
!=============================================================================!
!
3 INVALEN
%DIABLO-E-INVALEN, page length must be between 2 and 90

Since the single page feeder works on a 90 line feed cycle,  the  page
length  should  not  exceed  90.   This  error  can  be  corrected  by
re-entering the SETFEEDER command with a valid /PAGE_LENGTH.
!
!=============================================================================!
! Key 3                                                             INVALTABS !
!=============================================================================!
!
3 INVALTABS
%DIABLO-E-INVALTABS, tab stops can not be set past column 132

With  a  page  width  of 132, setting tab stops longer than 132 spaces
will not work.   This  error  can  be  corrected  by  re-entering  the
SETFEEDER command with tabs shorter than 132.
!
!=============================================================================!
! Key 3                                                              INVALTOP !
!=============================================================================!
!
3 INVALTOP
%DIABLO-E-INVALTOP, top margin must be less than 90

Since the single sheet feeder works on a 90 line feed cycle,  the  top
margin should be less than 90 lines.  The top margin will not be reset
if this error occurs.  To correctly set the top margin,  re-enter  the
SETFEEDER command with a top margin of less than 90.
!
!=============================================================================!
! Key 3                                                              INVALQUE !
!=============================================================================!
!
3 INVALQUE
%DIABLO-E-INVALQUE, invalid queue name

This error occurs if the queue specified  with  the  /QUEUE  qualifier
does not exist.  Re-enter the command with a valid queue name.
!
!=============================================================================!
! Key 3                                                             NUMTOOLRG !
!=============================================================================!
!
3 NUMTOOLRG
%DIABLO-E-NUMTOOLRG, number too large

Since no qualifier to this command takes a value larger than 131,  the
value  200 is taken as a maximum value for any possible qualifier.  To
correct this error re-enter the SETFEEDER command with the  values  on
the incorrect qualifiers in their correct ranges.
!
!=============================================================================!
! Key 3                                                              UNEXPECT !
!=============================================================================!
!
3 UNEXPECT
%DIABLO-E-UNEXPECT, unexpected error while trying to print format file

This error can occur under two circumstances.  First, if  the  calling
process did not have a CLI to perform the function, or the CLI did not
support the request type.  And second, if the CLI  returned  an  error
status  which  was not recognized.  This error may not be correctable,
and every effort should be made to identify the reason for its return.
!
!=============================================================================!
! Key 3                                                             UNSIGNINT !
!=============================================================================!
!
3 UNSIGNINT
%DIABLO-E-UNSIGNINT, value must be an unsigned integer

The values given after all but the /QUEUE and /FORM qualifiers must be
unsigned integers.  If the  value  is  not  an  unsigned  integer  the
qualifier  will  not  be executed.  To correct this error re-enter the
SETFEEDER command with the incorrectly specified qualifiers  in  their
correct form.
