
1






       Subject:  PRIMOS

       Release:  23.4

       Date:  March 26, 1993


       1. New Functionality
+         _________________


       1.1 Extended Memory for the 5000 Series
+          ___________________________________

       At Rev  23.4,  you  can increase the main memory of system models 5310,
       5320, 5330 and 5340 from 128 MB to 512 MB.  Before using this  extended
       memory, check  with  your  service  representative  to  ensure you have
       received and installed all applicable hardware and  microcode  updates.

       1.2 Online FIX_DISK
+          _______________

       PRIMOS Rev.   23.4  supports  Online  FIX_DISK.  Online FIX_DISK is the
       ability to check and repair, if necessary, a disk  partition  when  the
       disk partition  is  online.   That  is,  FIX_DISK  can  be  run without
       shutting down the disk partition.

       Online FIX_DISK is part of  the  PRIMOS  23.4  FIX_DISK  version.   The
       -ONLINE command  line  option tells FIX_DISK that the disk partition is
       online and to do an Online check or repair.

       The following FIX_DISK command line options are NOT supported by Online
       FIX_DISK:

       -COMMAND_DEVICE (-COMDEV)

       -CONVERT_19

       -CONVERT_20

       -CONVERT_21

       -CONVERT_22.1

       -INTELLIGENT_CONTROLLER (-IC)

       -ALL_CONTROLLER (-AC)

       -DBS

       -UFD_COMPRESSION (-CMPR)

       -AUTO_TRUNCATION (-AT)

       Note:  The command device is checked/repaired online by just specifying
       the physical device number (PDEV) of the  command  device  without  the
       -Command_Device option.





1







       The -PARTIAL  command  line  option  for  FIX_DISK is released at 23.4.
       -PARTIAL takes a pathname as an argument.  The  pathname  is  specified
       without the  name of the disk partition.  When -PARTIAL is specified to
       FIX_DISK, the traversal of the file system on  the  disk  partition  is
       traversed until  the  file  system object pointed to by the pathname is
       found.  If the file system object is a file,  then  just  the  file  is
       checked and  repaired,  if  needed  and  requested.  If the file system
       object is a directory  then  that  complete  sub-tree  is  checked  and
       repaired, if needed and requested.

       Online Fix_Disk will NOT add a bad spot if it belongs to a directory, a
       ufd or a Segment Directory.

       The following  FIX_DISK command line options are NOT supported with the
       -PARTIAL command line option:

       -UFD_COMPRESSION (-CMPR)

       -ADD_BADSPOT

       -CONVERT_19

       -CONVERT_20

       -CONVERT_21

       -CONVERT_22.1

       -DBS (-IC/-AC)

       -SECTOR (-ODI/-RDI)

       -MIN_EXTENT_SIZE

       -MAX_EXTENT_SIZE

       Previous versions of FIX_DISK output one of two messages about the
       state the disk partition.

          Disk not properly shutdown.  Full fix disk will be run.

          The quota system may be incorrect.

       FIX_DISK now  outputs  more  informative   messages.    The   important
       information for  either  cases  above  is  that  the file system may be
       incorrect!  The first case is that the last time the disk partition was
       not shutdown.  Fix_Disk will now output the following messages for  the
       first case.

          Disk not properly shutdown.
          The file system may be incorrect.

       When the disk is online, it follows that the disk is NOT shutdown!  The





1






       second case  occurs  when  the  disk  partition was added without being
       fixed.  Inconsistency between the On-Disk RAT and file  system  objects
       is significantly  more  important than directory quotas.  Fix_Disk will
       now output the following messages for the second case.

          The file system may be incorrect.

          The disk was previously not shutdown properly.

       Previous versions of FIX_DISK output one of three  messages  about  the
       state of the On-Disk RAT.

          "DSKRAT OK"

          "DSKRAT MISMATCH!"

          "DSKRAT UPDATED!"

       FIX_DISK now  outputs  additional  messages  when  the  On-Disk  RAT is
       inconsistent.  These messages will be output, when appropriate, whether
       the disk is online or assigned.

       The new messages are:

          "There are free (orphaned) records in the DSKRAT."

          "There are free (orphaned) records in the DSKRAT and/or there were
          files truncated or deleted by Fix_Disk."

          "In use records were missing from the DSKRAT!"

       If free (orphaned) records are the only reason that the On-Disk RAT  is
       inconsistent, there  were  no  other  file  system  errors  reported by
       FIX_DISK, and FIX_DISK was run  without  the  -FIX  option,  i.e.   the
       On-Disk RAT  was not updated, then FIX_DISK needs to only be rerun with
       the -Fix option when the administrator  is  concerned  about  the  disk
       partition becoming  full.   However,  in  use  records missing from the
       On-Disk RAT is a serious problem  and  the  disk  partition  should  be
       repaired.

       Please   note:   When  FIX_DISK  was  run  with  compression  requested
       (-UFD_COMPRESSION (-CMPR)), the message:  "There  are  free  (orphaned)
       records in  the  DSKRAT and/or there were files truncated or deleted by
       Fix_Disk."  can be a result of orphaned  records  that  were  generated
       through UFD  compression.   When  FIX_DISK  truncates or deletes files,
       FIX_DISK will identify those files.  It  is  important  to  review  the
       output from FIX_DISK to check for these messages.

       For further  information  please  refer  to the Operators Guide to File
       System Maintenance, UPD9300-6LA.

       1.3 CPL Enhancement
+          _______________

       The performance of CPL has been improved;  CPL programs that primarily





1






       execute active functions and CPL directives will benefit most.  Small
       CPL programs that simply execute Primos commands or run non-CPL
       programs will benefit little.

       1.4 New MATCH Utility
+          _________________

       MATCH is a program that searches for text strings within files.  It can
       be invoked from the command line by typing:

            MATCH string [-option],...

       If you type the word MATCH and press  return,  it  prompts  you  for  a
       search string  plus  any  additional options.  You can also invoke Help
       for MATCH by entering MATCH -Help at the command line.

       MATCH is aware of three types of files:  ASCII, Binary, and  PrimeWORD.
       PrimeWORD files are displayed as Muse files.

       MATCH has over a dozen options, and is capable of extended wildcarding.
       Both these features make MATCH a powerful tool.

       In the  following  example, MATCH displays the filenames and text lines
       within each file that match the requested string:

            MATCH 23.4
+           __________
       [MATCH Rev. 23.4 Copyright (c) 1993, Computervision Corporation]
       Warning:  FILE.RPA assumed to be a binary file

       File:  MATCH_DOCUMENTATION
              1:  This file documents MATCH at PRIMOS REV.  23.4

       File:  SPOOLER_DOC
              3:  This file documents SPOOLER at PRIMOS Rev. 23.4

       File:  ONLINE
              2:  This file documents the Online FIX_DISK
                  program at PRIMOS Rev.  23.4

       File:  CONFIG_USERS.DOC
              1:  This file documents CONFIG_USERS at PRIMOS Rev.  23.4

       MATCH Options

       MATCH has many options which allow a user to specify, in great  detail,
       a string  of  information for the program to find.  Many options can be
       combined.  An option can be invoked by entering the option word, or the
       first letter of the option word.  The following  is  a  list  of  MATCH
       options:

       -ALLBINARY
       -A

       Searches all  files  as  if they were binary files, i.e.  with no space
       compression or newlines.  Files that actually appear to be  binary  are





1






       not searched if you also include the -NOBINARIES option.

       -BRIEF
       -B

       Does not  print  a  warning  if  an  unexpected file type is found (for
       example, if the file X.BIN appears to be ASCII).

       -CASEDEPENDENT
       -C

       Only matches in a case-dependent fashion.

       -DEEPWILD
       -D

       Applies the supplied wildcarding criteria to files and segdirs  at  the
       current and lower levels.  UFDs are always searched.  If you use the -D
       option without the -LEVELS option, it has no effect.

       -FILES <template>
       -F

       Searches a  single  specified  file  or  a wildcard template (which may
       include treewalking).

       If the object specified or returned is a UFD, MATCH does not  look  for
       strings within  it;   if the object is a UFD, and the user included the
       -LEVELS option, MATCH searches for strings to the level requested.

       -FILES does not  abbreviate  to  -FILE,  which  remains  a  wildcarding
       option.

       -GO
       -G

       Ignores the rest of the command line after this option.  Use -G to omit
       the options in your .MATCH$OPTIONS global variable.

       -IGNORESPACES
       -I

       Ignores spaces  in  the  search  (although  spaces still count as token
       delimiters).  If you use the -I option it implies  -NOBINARIES  (binary
       files will not be searched).

       -LEVELS <n>
       -L

       Searches subufds  to  the depth specified.  If <n> is 0, MATCH searches
       as deeply as possible.

       -MOUNTPOINTS
       -M





1







       Searches down mount points and remotely ADded  disks  if  in  the  root
       (-F<).  Unlike  most  MATCH  options, -M is a toggle which reverses the
       prevailing action:   if,  for   instance,   you   have   -M   in   your
       .MATCH$OPTIONS global  variable, including it on the command line turns
       it off.

       -NOBINARIES
       -N

        Does not search files that appear to be binary.

       -ONCEONLY
       -O

       Outputs only the first matching line from  an  ASCII  file,  and  stops
       searching the file at that point.

       -PATHNAMES
       -P

       Prints the  full  pathnames of files with matches, rather than printing
       the matching text string.  Warnings are printed as  normal  unless  you
       included the -BRIEF option.

       -REPORT <filename>
       -R

       Output to  a  specified  file instead of the terminal.  If iterating or
       treewalking, MATCH appends  to  an  existing  file.   -R  files  always
       creates DAM files.

       -STOPONERROR
       -S

       Pops to  the  command  level on an error trying to access a file system
       object.  Since MATCH tries to access the same file system  object  file
       when you  re-enter  it,  you  must take some action to fix the problem.
       For example, insufficient  access  rights,  either  SET_PRIORITY_ACCESS
       (SPAC) the  disk  or EDIT_ACCESS (EDAC) the object.  (SPAC is described
       in the Operator's Guide to System Commands;  EDAC is described  in  the
       (EDAC) the object.  (SPAC is described PRIMOS Command Reference Guide.)

       -TOKENSEARCH
       -T

       Treats the  string to search for as a Token (a word in a text file, for
       instance, or a variable name in a program source).  Matches only  occur
       when delimited  by  non-alphanumeric characters ($ and _ are treated as
       alpha).  For example:

                      MATCH END

                matches on FRIEND.  But:





1







                      MATCH END -T

       only matches on the word END, including:

                      END,
                      END;
                      END.

       If you use the -T option it implies -NOBINARIES (binary files will not
       be searched).

       -VMODE
       -V

       Mainly a diagnostic option that  instructs  MATCH  to  use  a  slightly
       different (and  slower)  routine  for  character matching.  This option
       automatically takes effect if you are on a P400 or  P350.   You  cannot
       use -IGNORESPACES and -WINDOWLINES with the -V option.

       -WINDOWLINES <n>
       -W

       Outputs a  window  of  the  number of lines specified, after outputting
       each matching line in an ASCII file.  Matched lined ( after the  first)
       in a file are preceded by a blank line.

       If you  use the -W option it implies -NOBINARIES (binary files will not
       be searched).

       -XPRESS
       -X

       Instructs MATCH to examine all CAM and DAM files using block mode  I/O,
       whether the  files appear to be database files or not.  (Block mode I/O
       can lock out products like INFORMATION from their files, regardless  of
       the RWLOCK  on these files.  In the absence of -X, files with an RWLOCK
       of UPDT or NONE are opened for non-block I/O.)

       Action when No Options are Suppiled

       By default, MATCH searches for the search string in all  files  in  the
       current UFD.   The  search is case-independent, with one space matching
       one or many spaces.  If the string is matched in  an  ASCII  file,  the
       file name  is  output, followed by all lines containing the string.  If
       the string is matched in a binary file, only the  filename  is  output.
       If MATCH  cannot open a file or attach to a sub-UFD, it reports this at
       the terminal and in the -REPORT file (if there is one).

       Also by default, MATCH does not go down any Mount  Points  or  Remotely
       Added Disks when searching in the root (<).

       For additional  information  on  MATCH,  please  refer  to the Rev 23.4
       Software Release Document.





1








       1.5 CONFIG_USERS
+          ____________

       Several enhancements have been added to CONFIG_USERS:

         o  New command line options

         o  New List User's Project IDs and Time Window screens

         o  New ACL Groups field in the Add Single User, Change User
            and List User screens

         o  Traversing different projects for users in the Change User
            and List User screens

         o  New List User's Project IDs and Time Window screens

         o  Additional error messages

       Description of the New CONFIG_USERS Command Line Options

       Several new options have been added to Rev 23.4 of CONFIG_USERS.  These
       include  -ACL_GROUP,   -ALL,   -CHANGE_USER,   -DETAIL,    -LAST_LOGIN,
       -LIST_PROJECT,   -LIST_SYSTEM,  -LIST_USER,   -LOGIN_STATUS,   -OUTPUT,
       -PASSWORD_STATUS, -SERVER, and -SORT.

       The following is a description of these new CONFIG_USERS options:

       -ACL_GROUP group1 group2 ... group16
       -GROUP

       Use this option to specify the ACL group or groups for a new user.   If
       the user  is  a  new system user, the ACL Groups are System ACL groups;
       if the user is an existing user being added  to  the  system,  the  ACL
       Groups are Project ACL Groups.

       -ALL

       Use -ALL with -LIST_SYSTEM for a list of all the system's projects, ACL
       Groups, and  users.   Use  -ALL  with  -LIST_USER for a list of project
       attributes for each project to which a user  belongs.   Use  -ALL  with
       -LIST_PROJECT for  a  list  of  project  attributes  for each user that
       belongs to the project.

       -CHANGE_USER [user-id] [-PW pw] [-IAP pathname]
       -CU

       Changes an existing  user's  password  and/or  origin  (IAP).   If  you
       include the USER ID, you should also include the user's PASSWORD and/or
       IAP.  If  you use -CHANGE_USER with the -PROJECT option, it changes the
       origin for the specified project.  Otherwise, it changes the origin for
       the user's assumed project.  If you omit the USER ID, it  displays  the
       Change User screen.





1







       -DETAIL
       -DET

       Use with  -LS  and  -ALL  for  complete  details  about  each ACL Group
       including all User IDs that belong to that ACL Group, each project that
       has that ACL Group as a project group.  It  also  lists  all  USER  IDs
       belonging to each project.

       -LAST_LOGIN
       -LLOG

       Outputs the  date/time  when  a user last logined.  The date/time stamp
       displays only  when  used  with  the  -LIST_USER,   -LIST_PROJECT,   or
       -LIST_SYSTEM -ALL options.

       -LIST_PROJECT [project-id]
       -LP

       Lists an  existing  project's  profile.  If you omit the project-id, it
       displays the List Project screen.

       -LIST_SYSTEM
       -LS

       Lists the system's attributes including the system administrator's USER
       ID, the  SAD  version,  password   attributes,   and   system   default
       attributes.   For  additional  information,  use  -LS  with  the  -ALL,
       -DETAIL, -LAST_LOGIN,  -LOGIN_STATUS,  -PASSWORD_STATUS,  and   -SERVER
       options.

       -LIST_USER [user-id]
       -LU

       Lists an  existing  user's  profile.   If  you use -LIST_USERS with the
       -PROJECT option, it lists the profile for the  specified  project.   If
       you omit the user-id, it displays the List User screen.

       -LOGIN_STATUS
       -LSTAT
       -LOGIN_STAT

       Outputs  additional  system  or  user  information  relative  to  login
       attributes.  The -LOGIN_STATUS and -LIST_SYSTEM  options  show  Logging
       Successful Logins, Logging Failed Logins, and System Default for number
       of Concurrent  Logins.   The  -LOGIN_STATUS and -LIST_USER options show
       the Number of Concurrent Logins, if the account is enabled or  disabled
       (if disabled,  until when it is disabled, or if disabled indefinately),
       and the LOGIN window.

       -OUTPUT pathname

       Causes output to go to a specified file rather than the terminal.   Any
       information already  in  the  file  will be overwritten by this option.





1






       Use -OUTPUT pathname with -LIST_USER,  -LIST_PROJECT,  or  -LIST_SYSTEM
       options.

       -PASSWORD_STATUS
       -PW_STAT

       Outputs additional  system  or  user  information  relative to password
       attributes.  The -PASSWORD_STATUS and  -LIST_SYSTEM  options  show  the
       Password  Lifetime,  Status  of  Computer  Generated  Passwords,  Force
       Password Change, Initial Password Change,  Rev.2  Password  Encryption,
       Allowable Password  Failures,  Password  History,  and Maximum Password
       Changes per Hour.  The -LIST_USER  and  -PASSWORD_STATUS  options  show
       when the password was changed and when Force Password Change is enabled
       for the user.

       -SORT

       Causes names  to sort alphabetically when you output a list.  Use -SORT
       with -LIST_USER, -LIST_PROJECT, or -LIST_SYSTEM options.

       -SERVER
       -SR

       Outputs the InterServer Communications (ISC) attributes, maximum number
       of sessions, synchronizers and timers.


       New Field in Add Single User, Change User, and List User

       As of Rev.  23.4, the ACL Groups field in the Add Single  User,  Change
       User, and  List User screens now reads SYSTEM ACL GROUPS or PROJECT ACL
       GROUPS, identifying the ACL Groups as  either  System  or  Project  ACL
       Groups.  For  a  list  of  Project  ACL groups, move your cursor to the
       Project field and specify the Project ID.

       New List User's Project IDs Screen

       As of Rev.  23.4, the system administrator can display  a  List  User's
       Project IDs  screen  which  contains  all  of  the  projects to which a
       specified user is a member.

       To view the List User's Project IDs screen, choose the User  Operations
       field from  the CONFIG_USERS main menu.  At the User Operations screen,
       move your cursor to the new field List User's Project,  and  press  the
       ZoomIn key.

       At the  List  User's  Project  IDs  screen, enter a user in the USER ID
       field to list all the projects to which the user belongs,  as  well  as
       their assumed  login  project.  For the user's Project Attributes, move
       your cursor to that project and press the ZoomIn key.

       Traversing Different Projects for a Specified User in the  Change  User
       and List User screens






1






       You can  list  and  change the project attributes for a user's projects
       from the Change User and List User screens.  To do this, position  your
       cursor in the Project field and use the NextVal and PreVal keys.

       New Time Window Screen

       As of  Rev.  23.4, the system administrator can configure a Time Window
       for user accounts.  The Time Window  displays  the  times  a  user  can
       login, including  the  dates the account is active and the actual hours
       during which a user can access their account.

       You can view the Time Window from the List User screen.  You can  view,
       set, or  change  the Time Window from the Change User, Add Single User,
       and Add Multiple User screens.  To access any of these screens,  select
       User Operations  from  the  CONFIG_USERS main menu, and then select the
       appropriate menu item.

       To view the Time Window from the List Users screen, highlight the  View
       Time Window  field and press the ZoomIn Key.  To set or change the Time
       Window from the Change User, Add Single  User,  or  Add  Multiple  User
       screens, highlight  the Set Time Window field and press the ZoomIn key.

       You can configure a Time Window for each user on a  per  system  basis.
       You can  specify  any  or all the parameters;  any parameter left blank
       defaults to no limits.  For example, if  you  specify  valid  hours  as
       follows:

       Additional Error Messages

       Rev.  23.4 of CONFIG_USERS has several new error messages.

       USER ID username does not have an assumed login project.

       The user  does  not have an assumed login project.  Use the CHANGE USER
       screen in CONFIG_USERS to set up an assumed login project.

       USER ID  username  is  not  a  member  of  the  assumed  login  project
       projectid.

       The user  has  an  Assumed  Login  project, but is not a member of that
       project.  This can occur if an administrator  deletes  a  user  from  a
       project set up as the user's assumed login project.

       USER  ID  username  is  not  a  member  of  Project  projectid,  system
       attributes were updated.

       The user is not a member of their assumed login project.  The user must
       specify the project name when they  login  (this  changes  the  current
       system attributes, not the project attributes).

       WARNING:  Invalid date specified.

       The administrator  specified  an invalid date when entering information
       in the Account Active From field of the Time Window.   You  must  enter





1






       the date  using digits only, starting with the month, the day, and then
       the year.

       WARNING:  Invalid time specified.

       The administrator specified an invalid time when  entering  information
       in the  During  the  Hours of field of the Time Window.  You must enter
       the time in hours and minutes, using a military clock.   Valid  entries
       range from 00:01 (12:01 a.m.)  to 23:59 (11:59 p.m.).

       1.6 New LOGIN_SERVER Features
+          _________________________

       The LOGIN_SERVER now supports the following new features:

         -  The ability to configure new Login Timewindow and Account
            Disabled messages

         -  The ability to configure the User id, password and project id
            prompts

         -  The creation of a new SAD>LOGIN_SERVER.STARTUP file which
            reports the options that login_server was started up with.


       The START_LSR  command  has  be  enhanced  to support the following new
       options:

         -User_Id_Prompt <prompt-string>  (abbrev -UIP)
       When specified, the -User_Id_Prompt replaces the "User  Id?"   message.
       If the  -User_Id_Prompt  option  is not specified the LOGIN_SERVER will
       issue the default "User Id?"  message.


         -PassWord_Prompt <prompt-string>  (abbrev -PWP)

       When specified, the -PassWord_Prompt replaces the "Password?"  message.
       If the -PassWord_Prompt option is not specified the  LOGIN_SERVER  will
       issue the default "Password?"  message.


         -ProJect_Prompt <prompt-string>  (abbrev -PJP)

       When specified,  the  -ProJect_Prompt replaces the "Project?"  message.
       If the -ProJect_Prompt option is not specified  the  LOGIN_SERVER  will
       issue the default "Project?"  message.


       Example:

         Ok, START_LSR -UIP 'User: ' -PWP 'Password: ' -PJP 'Project: '

         Will cause the users to see the following at login:

         User: CRICKET





1






         Password: BUGGY
         Project: ADMIN

       Each of  the  new  prompt  options  may  contain  embedded  RDY  prompt
       variables.

       When the LOGIN_SERVER is started up  either  at  coldstart  or  by  the
       START_LSR command  the LOGIN_SERVER creates a como file in the system's
       SAD directory called  LOGIN_SERVER.STARTUP.   This  file  contains  the
       date/time that the LOGIN_SERVER was started along with the options that
       it was started with.

       Note:  The  SAD directory was chosen as the location of this file since
       the LOGIN_SERVER already has write access to the SAD.  If the you  have
       ACL'd your  SAD  such  that the LOGIN_SERVER does not have write access
       the LOGIN_SERVER will be unable to startup.

       The contents of the file will differ on configuration  and  may  be  as
       follows:

       If the  login_server  was  started  at  coldstart  or  started with the
       START_LSR command  and  NO  other  options  the  following   might   be
       displayed:

       LOGIN_SERVER started  at:   12  Mar  93 12:23:08 Friday No options were
       specified.  Using configured default options.  Default options:  '

       If the login_server was started with  the  START_LSR  command  and  the
       administrator supplied one or more options, then the following might be
       displayed:  -UIP '

       LOGIN_SERVER started  at:   12  Mar 93 12:23:08 Friday Supplied options
       overriding LOGIN_SERVER's   configured   default   options.    Supplied
       options:  -UIP 'Login:  ' -IMPLICIT_LOGIN


       1.7 Spooler Enhancements
+          ____________________

       At Rev.   23.4  the  spooler has been enhanced to support the following
       new user features and options:

          o Logs operator requests to the log file

          o Can suppress the first form feed in a print job

       The spooler is enhanced to  support  the  following  new  Administrator
       features and options:

          o PDN despooler defers a printing job if it receives
            a clearing error

          o Can prevent error messages from printing at the supervisor
            terminal






1






          o Can modify the frequency of error messages

          o TCP/IP despooler supports binary (8-bit) data transfers

       1.8 New DISK Support
+          ________________

       At Rev.  23.4, PRIMOS supports two new disk drives:

       Model 4734,  a  3.5"  1.0GB  SCSI  drive.  Model 4734 has a capacity of
       505,714 records distributed amongst 31 pseudoheads as follows:

            o  Heads 0 - 6 have a capacity of 16,510 records per head.

            o  Heads 7 - 30 have a capacity of 16,256 records per head.

       Model 4736, a 5.25" 2.0GB SCSI drive.  Model 4736  has  a  capacity  of
       958,342 records distributed amongst 31 pseudoheads as follows:

            o  Heads 0 - 21 have a capacity of 30,988 records per head.

            o  Heads 22 - 30 have a capacity of 30,734 records per head.

       The FIX_DISK  command  and  the  -DISK_TYPE options of the MAKE command
       both accept these new drives.  The following is a  list  of  acceptable
       disk types for these commands:

               Disk Type      Description

               CMD            Cartridge module device
               SMD            80MB or 300MB removable SMD
               68MB           68MB fixed media
               158MB          158MB fixed media
               160MB          160MB fixed media
               600MB          600MB fixed media SMD
               MODEL_4475     300MB fixed media SMD
               MODEL_4711     60MB fixed media
               MODEL_4714     84MB fixed media
               MODEL_4715     120MB fixed media
               MODEL_4719     258MB fixed media
               MODEL_4721     328MB fixed media SCSI
               MODEL_4729     673MB fixed media
               MODEL_4730     213MB fixed media SCSI
               MODEL_4731     421MB fixed media
               MODEL_4732     1.34GB fixed media SCSI
               MODEL_4734     1.0GB fixed media SCSI
               MODEL_4735     496MB fixed media SMD
               MODEL_4736     2.0GB fixed media SCSI
               MODEL_4845     770MB fixed media SMD
               MODEL_4860     817MB fixed media SMD

       Paging Partitions on SCSI Disks

       Splitting a SCSI disk results in the unavailability of some records due
       to alignment  restrictions  (in  addition  to the unused records on the





1






       file system portion of the split disk).  Therefore,  you  may  need  to
       allocate more  paging  records on a SCSI disk than on an SMD disk.  The
       number of unavailable records is different for each SCSI disk, as shown
       in the following table.  This table assumes that the disk is being used
       as a single partition, split  to  allocate  a  minimal  10-record  file
       system portion.


              SCSI Disk Model     Unavailable Records

                   4721                   56
                   4729                 1050
                   4730                 1122
                   4731                 5718
                   4732                 5448
                   4734                  123
                   4736                  253


       1.9 Data Backup and Recovery (DRB) Enhancements
+          ___________________________________________

       At Rev.  23.4, there are several enhancements to DRB which speed up the
       time it takes to do a partial restore.  These enhancements include:

         o  A new DRB configuration file directive, CHECKPOINT_FREQUENCY

         o  A new index file format

         o  New output from the SEARCH_INDEX_LIB command

         o  A new MAGRST subcommand, FS

       Please refer to the Rev.  23.4 Software Release Document for additional
       information.

       2. Problems Fixed- User Visible
+         ____________________________


       Spar 4062740:
                     Disallowed "lo -" as a legal format of the logout command
                     which was  logouting  out all users without any checking.

       Spar None:
                     After an ECCC affecting a wired page, in the  case  where
                     user 1  has  a  como file open, the system will no longer
                     halt while trying to extend the como file to  accommodate
                     the ECCC message sent to user 1.

       Spar 4063081:
                     Changed to fail nicely on UNASSIGN MTXX where XX  is  not
                     0-11.

       Spar 4061227:
                     Fixed catch-up  copy  to  copy  the  entire  file  system





1






                     portion of a mirrored disk partition on a SCSI disk.

       Spar 4061043:
                     KLM$PR will  now  report  the  correction   serialization
                     information   when  called  by  initialization   routines
                     invoked from the REGISTER_EPF command.

       SPAR 4060958:
                     The despool phantoms will no longer be allocated from the
                     special pool of phantoms.

       Spar 4057459:
                     ICS lines no longer hang during logout.

       Spar None:
                     The spooler  will  now  coldstart  successfully   without
                     getting an OUT_OF_BOUNDS$ condition.

       Spar 4059087:
                     Primos will no longer halt if the AMLIBL config directive
                     is set  too  large.   An  appropriate  error  message  is
                     printed at  the  console  and  the buffers are set to the
                     largest available value.

       Spar None:
                     The MESSAGE command gave operators an error message  when
                     sending broadcast  messages  to users who were not logged
                     in.  This no longer happens.

       Spar 4060483:
                     Swordfish disk  controllers  may  not  enter  ICOP+  when
                     extremely busy or dual ported.

       Spar None:
                     Fixed unterminated IOA$ strings.

       Spar None:
                     Primos no longer halts when RMS process  takes  an  eccc,
                     which is  processed  before  it  can  return the chunk of
                     memory it is working on.

       Spar 4059486:
                     Fixed RMSGD$ to no longer modify  arguments  incorrectly.

       Spar None:
                     Fixed DELSEG ALL to not remove  registered  EPF  segments
                     incorrectly.

       Spar 4058544:
                     The DISK_DLL  command  will  now  work  for  disk  drives
                     interfaced via  controllers  running  in  7210_DLL  mode.
                     Note that  it  will  not  work  for   other   4005   mode
                     controllers or  controllers  running  in  ICOP  or  ICOP+
                     modes.





1






       Spar None:
                     Dual ported disks are now properly released  for  use  by
                     other systems  on a "SHUT ALL" or other orderly shutdowns
                     (slow halts).

       Spar 4060471:
                     The COMM_CONTROLLER command now works  with  ICS3's  when
                     using the  Program_Name option.  Primenet now checks that
                     each FDX line has been shutdown prior to logout.

       Spar 4059728:
                     Changed PRIMOS to stop system halts via MIK_FATAL  caused
                     by incorrect error handling in IS$AS.

       Spar 4061857:
                     Changed INIPAG to no longer halt when adding a badspot to
                     a paging disk.

       Spar 4061970:
                     PRIMOS will now write modified pages to the correct disk.

       Spar 4063139:
                     Fix copy server problems with bad data on secondary.

       Spar 4061376:
                     Prevent halt at LKPRV_ caused by eccc code not  correctly
                     handling a  queue  full  case  which  caused  an  invalid
                     physical page number to be used.

       Spar 4060354:
                     Magtape I/O will optionally use four DMA channels instead
                     of slower DMC  for  records  larger  than  8K.   This  is
                     particularly useful  in  MAGNET  with  odd length records
                     which are read/written in "one  character  per  halfword"
                     mode.  IMPORTANT  NOTE:   The  extra DMA channels come at
                     the expense  of  disk   controllers.    For   each   tape
                     controller enabled  to use this feature, you can have one
                     less disk  controller.   For  instance,  with  two   tape
                     controllers enable to use four DMA channels, you can only
                     have a maximum of six disk controllers.

                     To enable  this  feature,  use  the  MTDMA config command
                     followed by four "YES" or "NO" arguments  to  selectively
                     enable/disable the  use of four DMA channels on each tape
                     controller.  For instance, the config command "MTDMA  YES
                     NO NO NO" will enable the use of four DMA channels on the
                     first tape  controller (driver units 0 - 3) at expense of
                     one disk controller (you can only have seven at most).

       Spar 4061227:
                     Fixed catch-up  copy  to  copy  the  entire  file  system
                     portion of a mirrored disk partition on a SCSI disk.

       Spar 4060308:





1






       Added code to PRIMOS during verify of memory to prevent halts at  4/306
                     caused by missing memory on P2450.

       Spar 4060771:
                     Changed file open code to speed it up.

       Spar 4060249:
                     Fixed MIRROR_ON to correctly remirror paging  partitions.

       Spar 4056329:
                     Fixed Delseg all to not remove registered  EPF  segments.

       Spar 4059470:
                     Fixed RMSDG$ to not modify arguments improperly.


       2.1  RRS Migration Information

       The following 23.3 RRS fixes are also in 23.4 FCS.

       RRS Release      Spar Number       Product
       -----------------------------------------------------------
       23.3.0.R43       4064239           PRIMOS
                        4062740           PRIMOS
       23.3.0.R42       4059452           X.25
       23.3.0.R41       4057541           PRIMOS
       23.3.0.R40       4063544           PRIMOS/Comm_Controller
       23.3.0.R39       4060471           PRIMOS/Comm_Controller
       23.3.0.R38       4063170           DRB
       23.3.0.R37       4063139           PRIMOS
                        4061376           PRIMOS
       23.3.0.R36       4063081           PRIMOS
       23.3.0.R35       4062103           Primenet/ICS3
       23.3.0.R34       4058936           DRBSRC
                        4059208           DRBSRC
       23.3.0.R34       4058936           DRBSRC
       23.3.0.R33       Online FIXDISK    PRIMOS, FIX_DISK, STBR
       23.3.0.R32       4059728           PRIMOS
       23.3.0.R31       4060354           PRIMOS
       23.3.0.R30       4057492           UX_TAPE
       23.3.0.R29       4061857           PRIMOS
       23.3.0.R28       4061993           DRB
       23.3.0.R27       4057157           PRIMOS
       23.3.0.R26       4061279           DRBSRC
       23.3.0.R25       4061970           PRIMOS
       23.3.0.R24       4061853           SPOOL
                        4051196           SPOOL
                        4061249           SPOOL
                        4061110           SPOOL
       23.3.0.R23       4061680           SPOOL
                        4061696           SPOOL
       23.3.0.R22       4061295           SPOOL
                        4061171           SPOOL
                        4061174           SPOOL





1






                        4061115           SPOOL
       23.3.0.R21       4059465           COPY
       23.3.0.R20         None            PRIMOS
       23.3.0.R19       4056143           DRB
                        4058885           DRB
       23.3.0.R18       4059444           DSMSRC
       23.3.0.R17       4060883           SPOOL
                        4061171, 4061173  SPOOL
                        4060939           SPOOL
                        4061170           SPOOL
                        4061197           SPOOL
                        4055291           SPOOL
       23.3.0.R16       4060353           PRINET, X.25
       23.3.0.R15       4060308           PRIMOS
       23.3.0.R14       4061227           PRIMOS
       23.3.0.R13       4060129           PRINET, X.25
       23.3.0.R12       4057283           PRINET, X.25
       23.3.0.R11       4057753           PRIMOS
       23.3.0.R10       4060958           PRIMOS
       23.3.0.R9        4059456           DRBSRC
       23.3.0.R8        4060259           PRINET
       23.3.0.R7        4059334           PRINET
       23.3.0.R6        4061081           PRINET
       23.3.0.R5        4060771           PRIMOS
       23.3.0.R4        4060483           PRIMOS
       23.3.0.R3        4060249           PRIMOS
                        4056329           PRIMOS
                        4059470           PRIMOS
       23.3.0.R2        4060550           SPOOL
                        4060552           SPOOL
                        4060553           SPOOL
                        4059606           SPOOL
                        4058334           SPOOL
                        4057063           SPOOL
                        4058414, 4058437  SPOOL
                        4058766           SPOOL
       23.3.0.R1        4055830           DRB


       3. Problems Fixed- Not User Visible
+         ________________________________

       None.


       4. Outstanding Problems
+         ____________________

       At the time of 23.4 release, we are not aware of any problems with 23.4
       specific changes/enhancements.


       5. Permanent Restrictions
+         ______________________

       At the  time  of  23.4  release,  we  are  not  aware  of any permanent
       restrictions with 23.4 specific changes/enhancements.





1








       6.  Environment
+          ___________

       Standard.


       7.  Installation and Build Procedures
+          _________________________________

       Please note:

       Rev 23.4 requires T3 or greater to be installed.  If you are  modifying
       PRIMOS source at 23.4, you MUST install T3.2.

       A BUILD  file,  called  PRIMOS.BUILD, is generated for each release and
       will probably be different for each release.  Be sure to always use the
       latest PRIMOS.BUILD  supplied  with  each  release.   PRIMOS.BUILD  and
       BUILDFILE are used by BUILD to build Primos.  There are a few new files
       for search rules set up and there is a new directory called BUILD.

       There are some changes to PRIMOS.BUILD.CPL.  PRIMOS.BUILD.CPL now takes
       a -NO_TOOLS (-NT) and a -INTEG option.

       The -NT  option will suppress the building of PSD, USAGE, LOGIN_SERVER,
       COPY_SERVER, MAPGEN, NAME_SERVER, SCHEDULER and the rebuilding of  hash
       tables.  This  will save some time when rebuilding if they are known to
       be correct  and  rebuilding  the  tools  is  not  necessary.   The  -NI
       (no_install) option  will  now copy runfiles and maps to PRIMOS>PRIRUN.

       The -INTEG option should always be used, it assumes all source  modules
       reside   in  PRIMOS.   It  prevents  PRIMOS.BUILD.CPL  from   searching
       auxiliary directories for PRIMOS source modules.

       The format of the build file (PRIMOS.BUILD) is:

       FOO.BIN:  FOO.PLP BAR.INS.PLP

       This means foo.bin is  created  from  foo.plp,  its  source  file,  and
       bar.ins.plp.  If,  at build time, anything on the right side of the ':'
       is found to have a more recent  DTM  ('Date/Time  Modified')  than  the
       object on the left, the entry (in this case, foo.plp) is rebuilt either
       by using  the  default  rules  at the top of BUILDFILE or using special
       rules which may follow any entry in PRIMOS.BUILD.  (For an  example  of
       special rules,  look  at  the rules that follow the dependency list for
       PRIMOS.SAVE, which is the first entry in PRIMOS.BUILD.)  Any new source
       and/or the adding or removing of  insert  files  from  source  must  be
       reflected by  changing  the build file.  If a dependency list uses more
       than one line, use a '\' at the end of the first line as a continuation
       marker.  A blank line  must  separate  each  dependency  list.   Please
       examine the  PRIMOS.BUILD file and related source for further examples.

       When building PRIMOS without using any options,  a  full  PRIMOS  build
       will be  performed (all source modules will be compiled).  Runfiles and
       maps will get copied to the top-level PRIRUN directory.





1







       Building PRIMOS using  any  of  the  available  options  (-NT,  -NI  or
       -INTEG), will  result in a partial build.  Only those modules modified,
       will be compiled.  If insert files are modified, all modules which  use
       those insert files will be re-compiled.


       What does all of this mean?

       When source is modified and PRIMOS is rebuilt, only the source affected
       by the  changes  will  be recompiled.  (The tools will still be rebuilt
       unless suppressed.  See instructions concerning the -NT option, above).
       The build will be forced to recompile all  source  if  no  options  are
       supplied.

       COMPILE.CPL was  re-added  to  PRIMOSs  as  of  22.1.  It is useful for
       compiling single  modules.   The  recommended  procedure  is   to   use
       PRIMOS.BUILD.CPL.  Do  not  use  COMPILE.CPL  for  the  compilation  of
       definition modules.  If changes are  made  to  definition  modules  use
       PRIMOS.BUILD.CPL to  ensure all appropriate modules are compiled in the
       correct sequence.






































