

























               Pascal 3.23 External Reference Specification

                Preliminary - HP Confidential Information

                              _A_p_r_i_l _5, _1_9_9_0

                  Hewlett Packard; Colorado Language Lab























                           Pascal 3.23 External
                         Reference Specification











                                  - 2 -



                             Preliminary - HP
                         Confidential Information

                              April 5, 1990


























































       PaWS 3.23 Prelim ERS   April 5, 1990                       3



       1.  PPPPaaaassssccccaaaallll 3333....22223333 SSSSyyyysssstttteeeemmmm

       1.1  DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn

       Pascal 3.23 is a minor upgrade  of  the  Pascal  Workstation
       software  for  the  series  200 and series 300 systems.  The
       primary objectives of this release are to  support  the  375
       and  345 SPUs, add support for SCSI and HP Parallel devices,
       add new Plotter support (HPGL mode only),  and  resolve  all
       critical and serious defects.

       1.2  HHHHeeeewwwwlllleeeetttttttt----PPPPaaaacccckkkkaaaarrrrdddd  PPPPrrrroooopppprrrriiiieeeettttaaaarrrryyyy

       The information in this ERS is preliminary  and  subject  to
       change.  This  document contains HP proprietary information,
       and should not be  distributed  outside  HP  unless  a  non-
       disclosure agreement has been executed.













































       PaWS 3.23 Prelim ERS   April 5, 1990                       4



       2.  PPPPrrrroooodddduuuucccctttt SSSSttttrrrruuuuccccttttuuuurrrreeee

       2.1  GGGGeeeennnneeeerrrraaaallll IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn

       The PWS 3.23 release will be supplied with  the  same  media
       options   available   on   the   3.2  release:  single-sided
       minifloppy,  single-sided  microfloppy,   and   double-sided
       microfloppy.

       The format of the manual set for the standard  product  will
       not  change.   (That  is,  the  number  of manuals and their
       titles will be the  same  as  used  for  the  3.2  release.)
       Manuals  will  be updated to include information relating to
       new features and known manual problems will be repaired.

       2.2  DDDDiiiisssskkkkssss

       Revision 3.23 will not require any new discs in  either  the
       single-sided or the double sided configurations.

       Changes to single sided media (Options 042, and 044) are  as
       follows:

       LIB:

             1.  Add SCSIDVR.
             2.  Add SCSIDISC.
             3.  Add PARALLEL.
             4.  Add SCSILIB.
             5.  Add BUBBLE.
             6.  Add EPROMS.
             7.  Add EDRIVER.
             8.  Add ETU.CODE.

       CONFIG:

             1.  Remove BUBBLE.
             2.  Remove EPROMS.
             3.  Remove EDRIVER.
             4.  Remove ETU.CODE.

       Changes to double sided media (Option 045) are as follows:

       ACCESS:

             1.  Add SCSIDVR.
             2.  Add SCSIDISK.
             3.  Add PARALLEL.

            SYSVOL:












       PaWS 3.23 Prelim ERS   April 5, 1990                       5



                  1.  Add SCSILIB.

       2.3  MMMMaaaannnnuuuuaaaallllssss

       Other manual changes  relating  to  code  or  manual  defect
       repairs will be done as needed on the appropriate manuals.

       Changes to the PWS manual set, other than those  related  to
       defect repair, are listed below.  Manual changes relating to
       code or manual defect repairs will be done on an  as  needed
       basis.

       PPPPaaaassssccccaaaallll UUUUsssseeeerrrrssss GGGGuuuuiiiiddddeeee

               o+ Correct errors in FILER description.

               o+ Correct error in  description  of  AUTOSTART  file
                 creation.

               o+ Modify Appendix E to clarify where in the appendix
                 essential tasks are described.

               o+ Add warning about HFSCK and Access Control Lists.

               o+ Clarify how LIF files get a date  assigned  during
                 RESTORE from Backup.

       PPPPaaaassssccccaaaallll WWWWoooorrrrkkkkssssttttaaaattttiiiioooonnnnssss SSSSyyyysssstttteeeemmmm MMMMaaaannnnuuuuaaaallll ((((VVVVoooollll IIII))))

               o+ No Changes Required.

       PPPPaaaassssccccaaaallll WWWWoooorrrrkkkkssssttttaaaattttiiiioooonnnnssss SSSSyyyysssstttteeeemmmm MMMMaaaannnnuuuuaaaallll ((((VVVVoooollll IIIIIIII))))

               o+ Remove unnecessary phrase from the sentence noting
                 that the boolean type is an enumerated type in the
                 chapter on string manipulation.

               o+ Add  the  note  concerning  consequences  to  unit
                 numbers when coalescing LIF volumes in the Special
                 Configurations chapter.

               o+ Update the  Special  Configurations  chapter  with
                 SCSI and HP Parallel information.

               o+ Update to note that the EPROM and  BUBBLE  drivers
                 have been moved to a new disk.

       PPPPrrrroooocccceeeedddduuuurrrreeee LLLLiiiibbbbrrrraaaarrrryyyy MMMMaaaannnnuuuuaaaallll

               o+ Correct sample programs in chapter on segmentation
                 procedures.











       PaWS 3.23 Prelim ERS   April 5, 1990                       6



               o+ Remove table on device dependent values  from  the
                 Procedure Library Summary.

               o+  Correct  line  style  numbers  in  the  Procedure
                 Library Summary.

               o+ Add a chapter  describing  the  SCSI  programmer's
                 interface.

               o+  Add  a  chapter  describing   the   HP   Parallel
                 programmer's interface.

               o+ Update throughout to reflect new SCSI and Parallel
                 IO drivers.

               o+ Update reference for new plotter support.

       HHHHPPPP PPPPaaaassssccccaaaallll LLLLaaaannnngggguuuuaaaaggggeeee RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll

               o+  Add  changes  to  the  description   of   strings
                 emphasizing that PAC variables and strings are not
                 interchangeable.

               o+ Add correction to the range  restriction  for  the
                 strinsert function.

               o+ Repair the incomplete sentence in the  description
                 of the write function.

               o+ Add description of domain restriction on  the  SIN
                 function.

               o+ Table of Contents needs to be updated.

               o+  Correct  the  non-sensical  statement   currently
                 appearing in the description of Modules.

               o+ Correct the error in the description of  the  WITH
                 statement.

               o+ Add sample programs illustrating the  use  of  the
                 IORESULT function.

               o+ Correct the error in the description of strinsert

               o+ Change the descriptions of UNITREAD and  UNITWRITE
                 in   the   implementation  dependency  section  to
                 emphasize that the async parameter has no effect.

       GGGGrrrraaaapppphhhhiiiiccccssss TTTTeeeecccchhhhnnnniiiiqqqquuuueeeessss MMMMaaaannnnuuuuaaaallll












       PaWS 3.23 Prelim ERS   April 5, 1990                       7



               o+ Add mention of the  new  7595B,  7596B  and  7599A
                 plotters   supported   with   this  release  where
                 appropriate. These plotters are supported in 7595A
                 or 7596A emulation mode only.


























































       PaWS 3.23 Prelim ERS   April 5, 1990                       8



       3.  HHHHFFFFSSSS iiiinnnn 3333....22223333

       3.1  CCCCoooommmmppppaaaattttiiiibbbbiiiilllliiiittttiiiieeeessss SSSSuuuummmmmmmmaaaarrrryyyy

       For new  HP-UX  capabilities,  the  following  are  expected
       compatibilities and interactions:

         1.  Longfilenames - occur first in HP-UX 6.2. All PaWS HFS
             revs are safe and ignore these filesystems.

         2.  CDFs - first occur in HP-UX 6.0. All PaWS HFS revs are
             safe  and show the CDF as a directory containing files
             named for context words. BACKUP will not  restore  CDF
             information.

         3.  ACLs - first occur in HP-UX 6.5.  All  PaWS  revs  are
             safe  and  ignore  ACLs, except for HFSCK. BACKUP will
             not save or restore ACLs, nor will HP-UX  cpio.  HFSCK
             will   destroy   ACL   information;  its  use  is  not
             recommended when the HFS is shared with a 6.5 or later
             HP-UX  system which may have placed ACL information on
             the disk.








































       PaWS 3.23 Prelim ERS   April 5, 1990                       9



       4.  SSSSCCCCSSSSIIII oooonnnn PPPPWWWWSSSS

       NNNNOOOOTTTTEEEE:::: This chapter deals with information  required  to  use
       SCSI on PWS.  Most of this information will be placed in the
       Special Configurations chapter  of  the  Workstation  System
       Vol. II manual.

       4.1  SSSSCCCCSSSSIIII BBBBuuuussss DDDDrrrriiiivvvveeeerrrr

       The PWS implementation of SCSI discs requires  two  separate
       programs,  a  SCSI  bus  driver and a SCSI Disc Driver.  The
       SCSI bus driver accepts SCSI Commands, transmits them on the
       bus, handles any data I/O the command generates, and returns
       the command status and data.  Applications wishing to access
       the SCSI bus will use the SCSI bus driver.

       A  programmer's   interface   is   provided   which   allows
       applications  to  access  the SCSI bus driver.  Refer to the
       Procedure Library Manual for more information concerning the
       SCSI programmer's interface.

       The SCSI Disc Driver is a SCSI application  which  uses  the
       SCSI  programmer's  interface  to access to the SCSI bus and
       provide the PWS File System with SCSI disc capability.

       4.2  SSSSooooffffttttwwwwaaaarrrreeee RRRReeeeqqqquuuuiiiirrrreeeedddd

       To use a SCSI Disc, the SCSI bus driver and  the  SCSI  Disc
       Driver should be placed in INITLIB.  These file names are:

          o+ SCSIDVR, and
          o+ SCSIDISC.

       These files are located on the LIB: disc  for  single  sided
       media and on the ACCESS: disc for double sided media.

       Once placed in INITLIB, PWS should be  rebooted  to  acquire
       support of SCSI discs.

       Alternatively, the user could execute each  of  these  files
       (which PLOAD themselves), and then execute TABLE.

       4.3  HHHHaaaarrrrddddwwwwaaaarrrreeee RRRReeeeqqqquuuuiiiirrrreeeedddd

       The PWS SCSI bus driver  requires  either  the  HP98265A  or
       HP98658A SCSI bus interface card.  The driver will work with
       the internal SCSI bus drivers provided with the 375 and  345
       S300 workstations.














       PaWS 3.23 Prelim ERS   April 5, 1990                      10



       4.4  SSSSCCCCSSSSIIII DDDDeeeevvvviiiicccceeee RRRReeeeqqqquuuuiiiirrrreeeemmmmeeeennnnttttssss

       Any SCSI device that is supported by the PWS SCSI bus driver
       must support the following SCSI messages:

          o+ Identify
          o+ Command Complete
          o+ Abort
          o+ Initiator Detected Error

       The SCSI  bus  driver  also  recognizes/uses  the  following
       messages.    Peripheral   support   of   these  messages  is
       desirable, but not required.

          o+ Disconnect
          o+ Save Data Pointer
          o+ Restore Pointers
          o+ Extended Synchronous Data Transfer Request
          o+ Message Reject
          o+ Message Parity Error

       The SCSI features of disconnect,  and  synchronous  transfer
       are supported by the SCSI bus driver.

       4.5  SSSSCCCCSSSSIIII DDDDiiiisssscccc RRRReeeeqqqquuuuiiiirrrreeeemmmmeeeennnnttttssss

       SCSI discs attached to PWS must support these SCSI commands:

          o+ TEST UNIT READY (0x00)
          o+ INQUIRY (0x12)
          o+ REQUEST SENSE (0x03)
          o+ READ CAPACITY (0x25)
          o+ READ EXTENDED (0x28)
          o+ WRITE EXTENDED (0x2a)
          o+ FORMAT UNIT (0x04)

       This list is a subset of the  Common  Command  Set  required
       commands,  so any disc that claims CCS conformity for SCSI-1
       should, in theory, work with PWS.

       If the disc supports the following commands, PWS  will  make
       use of them:

          o+ MODE SENSE (0x1a)
          o+ PREVENT/ALLOW MEDIUM REMOVAL (0x1e)

       PWS will initially support the following HP discs:

          o+ 7957S
          o+ 7958S
          o+ 7959S











       PaWS 3.23 Prelim ERS   April 5, 1990                      11



          o+ (C1701A) 6300 650/A (optical)
          o+ C2212A
          o+ C2213A
          o+ 340/345 built in discs

       4.6  SSSSCCCCSSSSIIII TTTTaaaappppeeeessss

       SCSI Tapes are not supported in this release of SCSI on PWS.

       4.7  SSSSCCCCSSSSIIII PPPPrrrriiiinnnntttteeeerrrrssss

       SCSI Printers are not supported in this release of  SCSI  on
       PWS.

       4.8  PPPPWWWWSSSS AAAAuuuuttttoooo----CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn wwwwiiiitttthhhh SSSSCCCCSSSSIIII

       SCSI Hard discs and floppies will be  treated  the  same  as
       CS80  hard  discs  and floppies.  Hard disc partitioning and
       Autocoalescing will be supported.

       However, SCSI adds a new dimension, and that is the  optical
       disc.  These discs are neither hard nor floppy, yet can have
       capacities of greater than 300Meg!  Unfortunately, it is not
       possible to ascertain if the device is optical or not.

       To allow user flexibility, three options have been added  to
       the options module of CTABLE.  These options allow removable
       media to be configured as follows:

        1.  A Hard disk if it has a size greater than 10M.
        2.  A Hard disk always.
        3.  A Floppy disk always.

       CTABLE has been modified as follows:

          type
               SCSIRemovableOptionsType = (AllOver10MAreHard,
                                           AllAreHard,
                                           AllAreFloppy);
          const
               SCSIRemovableOption = AllOver10MAreHard;


       To  select  an   option,   set   the   constant   value   of
       SCSIRemovableOption  to  one of the SCSIRemovableOptionsType
       enumerations.   By   default,   CTABLE   will   select   the
       AllOver10MAreHard enumerated type.

       When treating SCSI removable media as a hard disk,  PWS  and
       CTABLE will use the following rules:












       PaWS 3.23 Prelim ERS   April 5, 1990                      12



         1.  If the removable media is not  on  line  at  the  time
             CTABLE  is  executed,  the  size  of  the  disk is not
             available.  If the AllAreHard option  is  being  used,
             then  a  unit entry will NOT be created for it. If the
             AllAreFloppy AllOver10MAreHard option is used, then  a
             unit entry for a floppy disk will be created for it.

         2.   CTABLE  will  attempt  the  PREVENT  MEDIUM   REMOVAL
             command.

         3.  If the removable media goes off line for  any  reason,
             such  as  removing  the  media,  PWS  will discontinue
             communication with that device until CTABLE  has  been
             rerun.
















































       PaWS 3.23 Prelim ERS   April 5, 1990                      13



       5.  SSSSCCCCSSSSIIII PPPPrrrrooooggggrrrraaaammmmmmmmeeeerrrr''''ssss IIIInnnntttteeeerrrrffffaaaacccceeee

       For a description of the SCSI  programmer's  interface,  see
       the attached Procedure Library chapter.


























































       PaWS 3.23 Prelim ERS   April 5, 1990                      14



       6.  HHHHPPPP PPPPaaaarrrraaaalllllllleeeellll IIIInnnntttteeeerrrrffffaaaacccceeee oooonnnn PPPPWWWWSSSS

       NNNNOOOOTTTTEEEE::::  This  chapter  describes  information  pertinent   to
       supporting   the   HP   Parallel  Interface  on  the  Pascal
       Workstation.  Most of this information will be placed in the
       Special  Configurations  chapter  of  the Workstation System
       Vol. II manual.

       6.1  SSSSooooffffttttwwwwaaaarrrreeee RRRReeeeqqqquuuuiiiirrrreeeedddd

       In order to  drive  the  HP  Parallel  interface,  the  file
       PARALLEL,  found on the LIB: disc for single sided media and
       on the ACCESS: disc for double sided media, will have to  be
       either added to the INITLIB file or executed separately.

       When using the HP Parallel Interface programmer's interface,
       a  program may reference the PARALLEL_3 module.  This module
       will be added to the IO  file.   Chapter  1  and  2  of  the
       Procedure Library describe usage of the IO file.

       6.2  HHHHaaaarrrrddddwwwwaaaarrrreeee RRRReeeeqqqquuuuiiiirrrreeeedddd

       An HP Parallel port is provided with the 345 and  375  SPUs.
       This  port  is required to use the PWS HP Parallel interface
       software.  To date, there are no plans to provide a separate
       DIO I Parallel card.

       6.3  AAAAuuuuttttoooo----CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn wwwwiiiitttthhhh tttthhhheeee HHHHPPPP PPPPaaaarrrraaaalllllllleeeellll IIIInnnntttteeeerrrrffffaaaacccceeee

       In order to use the HP Parallel port as the default port for
       the PWS printer unit, the following steps must be taken:

          o+ The PARALLEL module must be added to INITLIB

          o+ The PRINTER module must  be  in  INITLIB  (The  shipped
            INITLIB has the PRINTER module in it).

          o+ The TABLE  program  must  be  modified  such  that  the
            local_printer_option   constant   must   be   equal  to
            PARALLEL.

            The  local_printer_type  enumerated   type   has   been
            extended     to    include    PARALLEL.     When    the
            local_printer_option   is   set   to   PARALLEL,    the
            local_printer_timeout  constant  is  set to 10 seconds.
            If  this  timeout  value  is  unacceptable,  then   the
            local_printer_timeout option must be modified as well.















       PaWS 3.23 Prelim ERS   April 5, 1990                      15



       7.  PPPPaaaarrrraaaalllllllleeeellll IIIInnnntttteeeerrrrffffaaaacccceeee DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn

       For a description of the  HP  Parallel  Interface,  see  the
       attached Procedure Library chapter.


























































       PaWS 3.23 Prelim ERS   April 5, 1990                      16



       8.  DDDDGGGGLLLL PPPPllllooootttttttteeeerrrrssss

       There will be three new Draft Master plotters recognized  by
       the DGL HPGL drivers for this release.  They are:

                      7595B, 7596B, and 7599A.


       These plotters are supported in  7595A  or  7596A  emulation
       mode only.
























































                                 CONTENTS


       1.  Pascal 3.23 System..................................   3
           1.1  Description....................................   3
           1.2  Hewlett-Packard  Proprietary...................   3

       2.  Product Structure...................................   4
           2.1  General Information............................   4
           2.2  Disks..........................................   4
           2.3  Manuals........................................   5

       3.  HFS in 3.23.........................................   8
           3.1  Compatibilities Summary........................   8

       4.  SCSI on PWS.........................................   9
           4.1  SCSI Bus Driver................................   9
           4.2  Software Required..............................   9
           4.3  Hardware Required..............................   9
           4.4  SCSI Device Requirements.......................  10
           4.5  SCSI Disc Requirements.........................  10
           4.6  SCSI Tapes.....................................  11
           4.7  SCSI Printers..................................  11
           4.8  PWS Auto-Configuration with SCSI...............  11

       5.  SCSI Programmer's Interface.........................  13

       6.  HP Parallel Interface on PWS........................  14
           6.1  Software Required..............................  14
           6.2  Hardware Required..............................  14
           6.3  Auto-Configuration with the HP Parallel
                Interface......................................  14

       7.  Parallel Interface Description......................  15

       8.  DGL Plotters........................................  16


















                                  - i -




