Logo
Dnote

FamilyManager Notes

Jul 2023 630.01 Update for mcp 63

Update for mcp 63

Nov 2022 620.10 Prevent job syntax on mutivolume image

If a file to be backed up to a cdimage is greater that the MB specified in the Familymanager run (to a maximum of 3950)then a multivolume image is created. In this case if the length of the image title was greater than 58 characters a line in the generated job was truncated, causing a syntax error.

Oct 2022 620.09 Familymanager will ds after a fault

If FamilyManager faulted with a bound error or invalid index then a program dump was taken and the fault was reported but the program would come to a normal EOT. This made it impossible for a parent job to react to the failure. In such situations FamilyManager will now DS

Feb 2022 620.08 Allow backup of files > 4GB to CDIMAGE

Familymanager can now backup files > 4Gb to CDIMAGE. This is done using the MULTIVOLUME option in Copywrite. There is a slight difference to the naming convention. The first image has a suffix of /0001 the second /0002 etc. The last letter of the the image title will always be Z. Ex. For files backed up on family dev. *DEV/I00130F2022026Z/0001 ON CDIMAGE : PROMBURNERDATA >22224000< *DEV/I00130F2022026Z/0002 ON CDIMAGE : PROMBURNERDATA >172236< Only one file at a time is backed up to a mutivolume image by Familymanager.

Dec 2021 620.07 Eliminate spurious comment on bigfiles

If a file bigger than the bigfile threshhold was being backed up the bigfile report would have a comment like:

 'because no current backups exist' added to the report.

This will no longer happen.

Apr 2021 620.06 Update for MCP 62

Update for MCP 62

Mar 2021 620.05 Fix bigfiles to diskreport

For a diskreport bigfiles were not reported if no other rules applied.

Mar 2021 620.04 Improved bigfile reporting

Fixed a bug where files marked as dontBackup were not reported in summary reports if they exceeded bigfile thresh holds. Added count of big files to summary reports.

Mar 2021 620.03 Support global rules options

Supports changes described in Flex D-Note 620.04

Feb 2021 620.02 Support RULES modification timestamp

Support for the Rules Modification Timestamp changes in FLex 620.02

Feb 2021 620.01 Allow backup of Keyedio files

Familymanager is now able to backup Keyediofiles as long as they are not inuse. Setting the new RULSES OP KEYEDIO for a family will allow allow this. A test run of Familymanager will now email the summary report to the Rules Manager.

Jan 2021 610.07 Improve BIGFILE reporting

If a BIGFILE threshold was set for a family, a disk file listing all of the big files on that family should be produced. In the run of Familymanager the title of thes files could be altered by file equation of BIG<familyname>. ex FILE BIGMYPACK=BIG/MYPACK ON REpORTS

Unfortunately if the files was not file equated the report was deleted. Now if there is no file equation a default title is used: (<rules manager>BIGFILES/<FAMILY> ON <rules manager default family>

It was always possible to set a global bigfile threshold but the value was ignored. Now if user has a BIGFILE value of 0 ,the global value is used.

May 2020 610.06 Avoid no file error on files without DIS

Version 610.04 could case the generated copy job to hang waiting for *OBJECT?FLEX ON DISK. This would happen when runing on systems without a Family DISK.

Apr 2020 610.05 Remove debug code

Internal change only

Apr 2020 610.04 Write to Flex log if problems in the copy

Problems in the copy task in the generated Copy job are now logged. If the copy faults a log entry like:

 Err:Fmgr Copy task 7437 failed

is created and the job aborted. If one or more files are not copied, a log entry like:

 Wrn:Fmgr Copy task 7424 Not all files were copied

is created.

/

Apr 2020 610.03 Prevent syntax error in generated job

Version 610.01 introduced a bug which could cause the generated copy job to fail with syntax errors in some circumstances.

Apr 2020 610.02 Correct check for diskfam copy

This fixes a bug introduce by version 610.01

Mar 2020 610.01 Better chaeckfor CDIMAGE copy completion

When copying to CDIMAGE the COMPLTETDOK attribute of the Libmaint task is not reset on a failure. Instead the taskvalue is set to 1. The generated copy jobs now reflects that.

Nov 2019 600.08 Use Wrn ID for warnings

Familymanager will now log warnings with the Wrn id, instead of Msg

Oct 2019 600.07 Mark newly created CDIMAGES as PUBLIC

By default CDIMAGES are created with Private security. The copy job will now mark them as PUBLIC IN. This enables non privileged users to load from CDImages. Version 600.06 introduced a bug where when Mergetape faulted the copy job would never terminate.

Oct 2019 600.06 Log summary for all users and families

Version 600.05 only logged summary information for Families and Users which had a rule option report type of email. Summary is now logged for all Users and families. If there is nothing significant to report (all totals are 0) a special entry with type nul is logged. From Flex: LOG NUL will list those entries. LOG SUM,USR,NUL will list all summaries The extra FMGR in the summary log entries has been deleted. The Generated copy Job will now abort id either The Copy or Mergetape fail.

Sep 2019 600.05 Add release total to email subject

The email messages for Family Summary and User Summary will now include the released total in the subject. New log entries are now created for Family and Usercode summaries. Category Usr is used for usercode summaries. Category Sum is used for family summaries.

Sep 2019 600.04 Log parameters to Flex log

The paramers used to start Familymanager are now recorded in the Flex log with Type Job.

Sep 2019 600.03 Allow for quoted usercodes

Familymanager will now correctly handle quoted usercodes.

Sep 2019 600.02 Log and report more detail for attribute

Any attribute errors when setting the title of a file are now reported in the Flex log with the full title of the file involved.

Mar 2019 600.01 Update for mcp 60

Update for MCP 60 Some preparation for 2035 time 6 changes

Apr 2017 590.01 Fix release level

Cosmetic change

Mar 2015 580.01 Allow for usercodes with more than 65535

Version 570.01 introduce a bug which caused Familymanager to fault if processing a usercode with more than 65535 files. This change corrects the problem.

Jul 2014 570.02 Fig bug with big dump to CDIMAGE

If a duplicated dump fot CDIMAGE generated two or more jobs, only the first job was started. (The others were save and could be starte manually) Fixed a bug where Familymanager would fault if processing a very large number of usercode directories.

Jan 2014 570.01 Detour future MCP sort in sort restrict

MCP 57 gives warnings that a Sort within a Sort will not be allowed in future releases. This change replaces a system sort with a QUICKSORT to avoid this problem.

Feb 2013 560.01 Protect against string protect fault

Passing a very long parameter to familymanager could cause a string protect fault which should have terminated Familymanager but did not until a subsequent error (the consequence of the first) occurred.

Jun 2012 550.02 Fix Rule Test AryLen Too Big Error

Very old rules can no longer cause an AryLen Too Long in Rules Test.

May 2012 550.01 Fix waiting entry when copying very big files

If a file to be copied was the only file to be copied and it was larger than the limit specified for the output volume then the copy job generated would wait for a second job which would never be created.

Oct 2011 540.08 Support FInq Sort

Accommodate FLexLib interface change.

Jul 2011 540.07 Allow rules test for system-node

Previously an attemp to perform a rules test via Flex utility for USER * or USER SYSTEM-NODE or would have caused Famliymanager to fault. A Rules Test for any user shorter than 5 charcters would not find any files. Both problems have been corrected.

Jun 2011 540.06 Fix NO FILE *OBJECT/FLEX with LOAD rule

Previously, any Flex LOAD rule, if triggered, could have caused the generated load WFL job to wait on a NO FILE *OBJECT/FLEX when trying to touch the file after a successful load. This was because the LOAD job's FAMILY assignment did not include an OTHERWISE DISK part.

Mar 2011 540.05 Support for FLEX-wide logging

The FAMILYMANAGER utility will now write run-time information into the Flex log file system and includes BOT/EOT, job and volume information, errors and warnings encountered during the run. In particular, information written to the CHECKFILE is also copied into the FLEX log. Note that FAMILYMANAGER log entries have an identity of 'Fmgr(12345)' where 12345 might be the mixnumber of the FAMILYMANAGER utility.

12:54:44 Msg:Fmgr(22713):Parameters:DUMP DEV CDIMAGE DUPLICATED 12:54:44 Job:Fmgr(22713):BOJ Flex FAMILYMANAGER [Version 54.999.05] run

Please see FLEX DNote 540.32 for more information on the logging mechanism.

Jan 2011 540.04 Fix spelling of cataloged

This change fixes the spelling of Cataloged (was catalogged) in HTML reports.

Sep 2010 540.03 Rationalise NOTES and DEBUG

Internal Metalogic change.

May 2010 540.02 Internal change only

Internal change only.

Jan 2010 540.01 Internal change only

Change in params to RULES_ENVIRON.

Jan 2009 530.05 Remove Summarise and Analyse Commands

The Flex Usage command has long been a better way to do this. With the recent addition of wastage info, there is no good reason to use Analyse and Summarise in Familymanager, so they have been deleted with a reduction of nearly 1100 lines of source code.

Jan 2009 530.04 De-imp Discard

Load:Flat <familyindex> in Flex Inquiry is a better way to do the DISCARD function, so it has been de-implemented in FamilyManager, saving about 5% in the source and object file sizes.

Dec 2008 530.03 Correct handling of JOBSUMMARYTITLE

Setting the JOBSUMMARYTITLE attribute in a job which rune Familymanager would cause the copy job generated by Familymanager to fail syntax.

The Jobsummarytitle used by the generated jobs will now be the JobSummaryTitle of FamilyManager's parent with the job name appended.

Nov 2008 530.02 Internal Change

Internal Metalogic change.

Oct 2008 530.01 Internal Change

Clean Up.

Dec 2007 520.13 Internal change

Use Include/Meta

Oct 2007 520.12 PD Object Length

Make use of addition of Arylen in PD Object.


          
Jul 2007 520.11 Allow the tape name prefix to be changed

Tapes created by Familymanager currently have prefixes of FLEXCOPY or the name of the family being dumped. A new parameter (PREFIX) is now allowed which will override the default. The specified prefix must be 10 or fewer characters and be valid for tape names. The Prefix parameter is also valid in Mergetape.

Ex ("DUMP DEV,PRODUCTION PREFIX DEVPROD")
or
("DUMP = PREFIX=HOSTA_ALL")

          
Jun 2007 520.10 Use New FILEKIND Handling

Update to use FLEXLIB's new FILEKIND handling.

May 2007 520.09 Fix seg array error when default report

If the default report type was not set to ManagerEmail or UserEmail and the report type for one or more users was an email type it was possible for Familymanager to fault with a string protect error. This fault has been corrected.

May 2007 520.08 Update backup time for single family rules

The rules block backup timestamp is now correctly updated in runs where only one family is specified. Previously it was only updated on multi backup runs.

The Rules Block modified timestamp is no longer updated when the backup timestamp is changed.

Apr 2007 520.07 Option added to suppress DontBackup reports

A new option HIDEDONTBACKUP can be added to the parameter list passed to FamilManager. If this option is present then files not backed up do to a DONTBACKUP rule will not be listed in user reports.

Typically the same files are reported as 'not backed up' in every FamilyManager run and can make it difficult to recognise more significant actions in the reports.

Summaries will still report the number of files 'not backed up'.

Apr 2007 520.06 Fix WFL syntax error on very large backup

When generating a very large copy job which had to be split (60000- 100000 files depending on file title length) , the generated job would fail syntax. This problem started with version 510.11.

If too many files had titles close to 80 characters long, the calculation used to determine when to split a job due to WFL size restrictions was inaccurate. This could cause the generated job to fail due to WFL limits.

Mar 2007 520.05 Correct Summary totals when multi families

When running for two or more Families the totals, on family reports, no longer include values for other Families.

Mar 2007 520.04 Purge unused SUMMARY file if emailing

If only Summary Reports were emailed during a FAMILYMANAGER run and not printed, an empty SUMMARY print file with an associated Prints request would remain on the system. This behaviour has been corrected; this print file will now be automatically purged if the Summary Reports are only emailed.

Mar 2007 520.03 Better 'From' in emails

Change the 'From' in emailed reports to have a 'Friendly name' of

FMGR <hostname> to make it easier to filter emailed reports
Mar 2007 520.02 Fix string protect error in Rules Test

Fix as String Protect error which could occur in a RULES TEST FAM .. command if a number of users had no significant rulings.

The Email summary report now correctly reports file counts for generations > 0;

Mar 2007 520.01 Add support for reports via email

FamilyManager reports can now be directed to email. For sites without Supervisor,the Metalogic Mail Library can be configured via Marc if the Mail directive is set up.

The Marc command DIRECTIVE MAIL = *METALOGIC/MAILLIB/DIRECTIVE sets
up the Directive.
Once set up MAIL becomes a valid Marc command.
Ex. MAIL STATUS
MAIL HELP

Two new Rules Options have been added:

MANAGEREMAIL  - Sends User reports in the form of HTML email
messages to the Rules Manager.  If the Rules Manager
usercode has an email entry in the UserData file
then that address is used otherwise the Usercode of
the rules manager is used as the address.  If
set as a family option then the  FamilyManager
summary report is sent as email instead of being
printed.
USEREMAIL     - Sends User reports as an HTML email to the User.  If
the user has an email entry in the Userdata file
then that address will be used otherwise the
Usercode is used as the address.                   

            

            

          
Dec 2006 510.11 More consistent naming convention for C

If running with the DEBUG option, appending to tapes or after detection of WFL syntax errors, FAMILYMANAGER will lock the generated WFL COPY jobs on the dumped family. The names of these files were inconsistent and did not reflect the type of backup performed nor the medium used. Also, where multiple FAMILYMANAGER jobs were running in series, it was possible for CDIMAGE and CD dumps to occasionally fail because of job file overwrite problems.

The COPY jobs now have the following naming convention using backup command type, the output media, the name of the disk family being handled and creation date:

JOB/<backup type>_<output medium>/<family>/<date>/<reel>
Where a multi-family backup is being run, <Family> will be replaced by the text "FLEXCOPY" and FAMILYMANAGER's mix number.

For example:

JOB/BACKUP_FARM/DEV/2006336/0
JOB/DUMP_CDIMAGE/WORK/2006335/2
JOB/BACKUP_TAPE/FLEXCOPY12345/2006330/1
Jun 2006 510.10 New Directory Object Support

FamilyManager now supports the new format Directory object.

Volume based Backup attributes now work for family TAPE or when the non-Flat SW2 option is set.

Mar 2006 510.09 Inform MERGETAPE of appended volume information

FAMILYMANAGER will now pass on additional information about APPEND runs for tape. The tape serial numbers designated for the APPEND, if explicitly selected by the user or chosen by FLEX itself, are passed to the MERGETAPE utility in the Flex CHECKFILE. This allows MERGETAPE to determine the correct average megabyte per file rating, used to assign weighting in a MERGETAPE run, by directly reading the LIBMAINDIR file for the appended tape.

Jan 2006 510.08 TADS compile option removal

Internal Metalogic change.

Dec 2005 510.07 Don't try to backup own Libmaindivir

If backing up the DL Libmaindivir family and appending to an earlier tape it was possible for the generated copy job to hang attempting to copy the libmaindivir file for the tape being used. Libmaint dir files relating to the current copy are now excluded from the copy.

Dec 2005 510.06 Append continuation tapes where possible

The restriction in WFL on the total length of a Copy statement can force Familymanager to split a dump into multiple tapes even though the physical capacity of the tape has not been reached. If TapeLength is set to 0 (Infinite) and the specified density is capable of appending then Familymanager will make the subsequent copies append to the original tape. This new option is MCP dependent. It is not available on MCPs < 4.8 and on 4.8 it must be 48.nnn.175 or later. On MCP 4.9 it must be 49.nnn.49 or later. MCPs 5.0 and above are fine.

A new option APPEND has been added. The APPEND option is only valid for Tape destinations. If set then Familymanager will search for the most appropriate volumes to be used for this. If the duplicated option is set then the most recent backup with the same volume prefix will be used. If duplicated is not set then the second most recent matching volume will be used.

Ex. RUN *METALOGIC/FLEX/FAMILYMANAGER("DUMP DEV APPEND")

When using Append either by specification, or if automatic due to a job split, then LIBMAINTDIR files become very important for recovery. Although is is possible to recreate LIBMAINTDIR files from a tape, it can take a very long time. Libmaintdir files should therefore be backed up, as should a copy of the current catalog.

Nov 2005 510.05 Prevent syntax error on large generated job

There is an MCP imposed limit on the size of a WFL Job. For Dump or Backup runs where a large number ( > 200000 ) of files are to be copied it was possible to exceed this limit. If a duplicated copy was requested, with the singledrive option set then two copies were done in the one job which reduced the limit to nearer 100000 files.

Familymanager now monitors files to be copied against the Job limit and will split the generated job if the limit is about to be exceeded.

If a generated job fails with syntax errors a waiting entry is now created. The name of the waiting entry is METALOGIC/FAMILYMANAGER/FAILURE with an RSVP indicating the name of the Job which failed. Once the failure has been noted an AX can be entered of the waiting entry.

Mar 2005 510.04 ALLOW OPTIONS AFTER SERIALNO OUT

Previously, specifying options after a SERIALNO OUT option would give errors in the options scanning. This is no longer the case.

Mar 2005 510.03 FIX FOR DUPLICATED WITH TWO OUTPUT SERIAL NUMBERS

This change fixes a problem in the Mergetape run in a Familymanager generated job. The problem would occur if both Duplicated and a SERIALNO OUT clause with two serial numbers was used. Mergetape would report, for each file copied, that the file was missing on Vol #1.

Mar 2005 510.02 FIX FARM AND IMAGE JOBS

Fixes a problem with SERIALNO OUT vs FARM and CDIMAGE Jobs

Mar 2005 510.01 SERIALNO OUT TO LIBMTAPPEND=TOEND TAPES

A new parameter allows FamilyManager to append to existing tapes using the Library/Maintenance option "LIBMTAPPEND=TOEND".

The syntax is:

--- SERIALNO --- OUT --- <serialno> ------------------------------->
+--- , --- <serialno> ---+

The second serial number is needed if appending to 2 tapes on a DUPLICATED run. FamilyManager will flag an error if it cannot find the LIBMAINTDIR for a specified serial number.

Examples:

SERIALNO OUT 33
SERIALNO OUT A00044 , BKUPMT

Using SERIALNO OUT is incompatible with RETRIES options other than NONE Setting RETRIES to another value will flag an error.

In line with MergeTape, FamilyManager now uses only MegaBytes for tape lengths.

Nov 2004 500.11 OPTION FOR LIBMAINTDIR FILES WHEN COPYING TO TAPE

FamilyManager may now make a LIBMAINTDIR file when copying to tape, if a new Default option is set appropriately. See FLEX/Inquiry notes for details.

Nov 2004 500.10 CHECK COPYWRITE LIBRARY STATUS

FAMILYMANAGER will now verify that the COPYWRITE library is available and active, before commencing all backup operations to CD, CD image or Disk Farms. The following messages may be seen:

'Missing GETCOPYWRITESTATUS entrypoint in MAGUS'
'COPYWRITE library is inactive or not installed'
'COPYWRITE DSS functionality is DISABLED'

The first message indicates an unlikely incompatibility problem with an older version of MAGUS. If COPYWRITE is already installed, then it may be necessary to re-install using the COPYWRITE utility e.g. from CANDE:

U *METALOGIC/COPYWRITE REINSTALL

Sep 2004 500.09 DON'T IGNORE DUPLICATED AFTER CDIMAGE

Previously, FAMILYMANAGER would ignore the first keyword after a CDIMAGE clause in the parameter though CDIMAGE=<alt.family> would work correctly. For example,'DUMP DEV CDIMAGE DUPLICATED' would cause the DUPLICATED option to be discarded; this problem is now fixed.

FAMILYMANAGER will now correctly handle overrides of COMPARE, RETRIES, SAVEFACTOR and SCRATCHPOOL, provided by its parameter string. These settings were scanned correctly but subsequently ignored prior to the job creation processing.

Jun 2004 500.08 FIX INVALID INDEX WHEN COPYING TO TAPE

Version 500.07 inadvertently introduced an Invalid Index error when dumping to Tape. This has been corrected.

May 2004 500.07 ALLOW ALTERNATE FAMILY FOR CDIMAGE

For DUMP and BACKUP activities to CD disk images (using the CDIMAGE modifier, FAMILYMANAGER will use the family specified by the Magus config variable FLEX_CWIMAGE as image file destination. It is now possible to override this setting using the following modified syntax:

--- DUMP --- <Family> --- CDIMAGE ---+-----------------------+-- ...
+-- = <Alt.Family> ---+

When an alternate CD image is specified, the CD images are generated as normal on the default image family and then automatically COPY&BACKUP by CopyWrite to the alternate family. Copywrite removes the image from the original family but leaving a non-resident file entry pointing to the alternate family. This is referred to in Metalogic software as a 'HARD LINK'. You may specify as many as alternate families as required (as long as the family is volumed).

In this example, the default image family is DISK and an alternate image family is called ALTIMAGE. After creation of the image, a PD of the image on each family appears as:

PD *DEV/CI0017F2004142A

FILE *DEV/CI0017F2004142A ON DISK (PROMBURNERDATA)
NOT RESIDENT
FAMILY SERIAL NUMBER: 000505
ENTRY 1 (PROMBURNERDATA):
CYCLE: 1 VERSION: 0
SECURITY: PRIVATE
TIMESTAMP: Friday, May 21, 2004 (2004142) AT 11:52:15
LASTACCESS: Friday, May 21, 2004 (2004142) AT 11:52:02
BACKUP MEDIA IS: PK
SERIAL: 000600
BACKUP MEDIA IS: PK
SERIAL: 000600

On ALTIMAGE (pack serial number 600):

PD *DEV/CI0017F2004142A ON ALTIMAGE

FILE *DEV/CI0017F2004142A ON ALTIMAGE (PROMBURNERDATA)
CREATION DATE= Friday, May 21, 2004 AT 11:52:01 BST
LASTACCESS DATE= Friday, May 21, 2004 AT 11:52:01 BST
ALTER DATE= Friday, May 21, 2004 AT 11:52:01 BST
ATTMODIFY DATE= Friday, May 21, 2004 AT 11:52:16 BST
BACKUP DATE= Friday, May 21, 2004 AT 11:52:01 BST
COPYDEST DATE= Friday, May 21, 2004 AT 11:52:01 BST
COPYSOURCE DATE= Friday, May 21, 2004 AT 11:52:01 BST
EXECUTE DATE= Friday, May 21, 2004 AT 11:52:01 BST
READ DATE= Friday, May 21, 2004 AT 11:52:01 BST
TOTAL SECTORS: 88,896 (5,556 PER AREA)
SECURITY = OWNER *:RWX, GROUP <none>:NO, OTHER:NO
(PRIVATE - USAGE: READ/WRITE) LOCKEDFILE
FAMILY SERIAL NUMBER: 000600
ENTRY 1 IS RESIDENT, NOT CATALOGED (PROMBURNERDATA):
CYCLE: 1 VERSION: 0
SECURITY: PRIVATE
TIMESTAMP: Friday, May 21, 2004 (2004142) AT 11:52:15
NO ARCHIVE BACKUP RECORD FOR FILE

The MERGETAPE utility has been changed to support this new feature, please see MERGETAPE DNote 500.02 for more information.

May 2004 500.06 CORRECTLY RECORD AVERAGE FILE SIZE

This change allows the FEET=0 option in Familymanager to override a non zero default tape feet value.

In addition when FEET=0 is specified the correct file size will be used when calculating the average file size value used by Mergetape. Previously when FEET=0 was used a value of 1 was used for every file.

May 2004 500.05 CORRECT INVALID INDEX WHEN DUMPING TO TAPE

Version 500.05 inadvertently introduced an Invalid Index error when dumping to Tape. This has been corrected.

Apr 2004 500.04 RESTORE SERIALNO HANDLING FOR DISK FARM

The change described in DNote 500.02 caused the SERIALNO assignment for a FARM copy to be assigned an empty string which caused the COPY to fail. Disk FARM copies will now again correctly allocate a serial number.

Apr 2004 500.03 FIX INVALID INDEX WHEN DUMPING TO CD

The change applied in Dnote 490.06 had the side-effect of causing CD dumps to fail with INVALID INDEX at 56735490. This problem is now fixed.

Apr 2004 500.02 DON'T CREATE SCRATCH VOLUME IF NO FILES

For CDIMAGE and CD backup runs, FAMILYMANAGER would unconditionally create a SCRATCH volume entry for the impending backup even if there were no eligible files for copying. This meant that spurious SCRATCH entries were permanently left in the Volume Library. This behaviour has been corrected.

Feb 2004 500.01 IDENTIFY CALLER TO OPAL MACHINE

Internal change only.

Jan 2004 490.06 CORRECT WFL LIMIT ON MCP 47 FOR CD IMAGE

When dumping to CDIMAGE on MCPs < 4.8 it was possible for the generated Job to fail with a syntax error 'COPY OR ADD STATEMENT TOO LONG'. This problem has been corrected.

Attempts to remove files with 'long filenames' would give an attribute error and the file would not be removed. This problem has also been corrected.

Nov 2003 490.04 CHECK RULES AVAIL AND MASTER USER/ACCESS

During FAMILYMANAGER's initialisation phase, the availability of the FLEX RULES file and the setup of the RULES manager usercode and accesscode will now be verified. Previously, FAMILYMANAGER would not give any warnings if these essentials features were not established.

If the RULES has not been set up or is unavailable:

 'RULES file is not valid or does not exist' 

If both the RULES Manager usercode and its alternate usercode have not been setup:

 'RULES Manager USERCODE is NOT assigned' 
If both the RULES Manager accesscode and its alternate accesscode have not been setup:
 'RULES Manager ACCESSCODE is NOT assigned'
In any of the above circumstances, FAMILYMANAGER will emit the error and then terminate gracefully.

Nov 2003 490.03 TARGET

When backing up files to a Disk Farm the TARGET task attribute is set so that CopyWrite performs the Copy, even if NFT is configured.

Nov 2003 490.02 FIX DUPLICATED REFERENCE BUG FOR DISK FARM

When producing backups to PC Disk Farms using the FARM function, FAMILYMANAGER would always ignore the DUPLICATED modifier. So, if DUPLICATED was set e.g.

RUN *METALOGIC/FLEX/FAMILYMANAGER ("DUMP DEV FARM(META1) DUPLICATED")

The above run would cause FAMILYMANAGER/COPYWRITE to generate a single reference for each dumped file instead of 2. This, in turn, caused MERGETAPE to fail, assuming that the second backup reference had failed. This problem is now resolved.

Oct 2003 490.01 UPDATE VERSION FOR MCP 49.1

The internal version of FAMILYMANAGER has been changed to reflect MCP 49.1 compatibility.

Aug 2003 480.12 CHECK CONFIG ACCORDING TO BACKUP TYPE

Previously, FAMILYMANAGER would unconditionally give a run-time error processing a CD, CDIMAGE or FARM request unless all the Magus config variables were set up. For example, a CDIMAGE run would fail if the FLEX_CWHOST config (used for CD production) was not set up. This behaviour has been corrected and FAMILYMANAGER will only check the appropriate config items, as set up by the INSTALL utility.

Jun 2003 480.11 ALLOW FAMILYMANAGER TO DUMP TO COPYWRITE

The parameter FARM ( <hostname>) will cause Familymanager to backup files to the Copywrite disk farm on the PC specified by <HostName>.
Ex.
RUN *METALOGIC/FLEX/FAMILYMANAGER("DUMP DEV FARM(BACKUPPC)")

Apr 2003 480.10 PROTECT IMAGE CONTAINERS

FAMILYMANAGER will now ALTER disk containers generated by Copywrite so that the LOCKEDFILE attribute is always set. This helps protect these files from accidental removal.

Apr 2003 480.09 PERMIT CONTAINERS>650MB AND IMPROVE DEBUG

During a DUMP to CD, the change applied by 480.07 caused the familyname being dumped to be incorrectly written to the Flex CHECKFILE. This caused the MERGETAPE run, which uses Copywrite to catalog the files on the CD, to use an incorrect FAMILYOWNER for each file. This problem is now fixed.

Apr 2003 480.08 WRONG FAMILYOWNER FOR CD ADD&CATALOG

During a DUMP to CD, the change applied by 480.07 caused the familyname being dumped to be incorrectly written to the Flex CHECKFILE. This caused the MERGETAPE run, which uses Copywrite to catalog the files on the CD, to use an incorrect FAMILYOWNER for each file. This problem is now fixed.

Mar 2003 480.07 FIX DUPLICATED BACKUP VS. CHECKFILE CON

Using the keyword DUPLICATED in a FAMILYMANAGER CD image run causes the creation of a second, duplicated backup reference for each file dumped. During the MERGETAPE run to verify the backup references, MERGETAPE would display 'Failure on second backup' producing warning messages for each file indicating that the second backup reference was incorrect. This problem is now fixed.

Mar 2003 480.06 ALLOW FOR PRE 4.8 RESTRICTION ON COPY STATEMENT

On MCP's prior to 4.8 there is a restriction on the total length of a COPY statement when copying to CDIMAGE. This could cause Familymanager generated copy jobs to fail with a syntax error.

Familymanager now takes this limit into consideration and will split the job when required. The created job is now locked if any syntax error occurs and a message indication the name of the Job in question is displayed.

When copying to CD image the default behaviour was to generate one CD image but to set both backup references to that image. This has been changed. Now only one reference to the image is created. To get old behaviour it is necessary to set the DUPLICATED option in the parameter to Familymanager.
Ex.
RUN METALOGIC/FLEX/FAMILYMANAGER("DUMP DEV CDIMAGE")
will create one reference for the files copied.
RUN METALOGIC/FLEX/FAMILYMANAGER("DUMP DEV CDIMAGE DUPLICATED")
will create two references to the image for the files copied.

Jan 2003 480.05 NEW DIRECTORY FOR CD IMAGES

Previously backups to CDIMAGE created the image under the directory *FLEXCDIMAGE. If backups were done from various families it was very difficult to determine which family a particular image was for. The convention has been changed and the directory name now matches the family name. So, if PACK1 is backed up to CDIMAGE the directory is *PACK1/...

Jan 2003 480.04 BETTER CONTROL OF DUMP TO CD/CDIMAGE

This change allows Familymanager to dump to CD or CDIMAGE on a system where the Flex defaults are still set to Tape. CD or CDIMAGE can be added to the DUMP parameter.

Ex: ("DUMP MYPACK CDIMAGE").

The only prerequisite is that four config variables are set up using U META/INSTALL CONFIG Select 7 for Full Flex and then change each of FLEX_CWHOST,FLEX_CWIMAGE
FLEX_CDSERIALNO and FLEX_CWSERIALNO.
FLEX_CWHOST should be the host name of your system.
FLEX_CWIMAGE should be the family where you want to keep CD images.
FLEX_CDSERIALNO at present should be CD0001 (It will be updated by FLEX
FLEX_CISERIALNO at present should be CI0001 (It will be updated by FLEX

Dumping to CDIMAGE requires the additional Metalogic product COPYWRITE.

Dec 2002 480.03 PREPARATION TO ALLOW DUMPING TO DISK FARMS

This change does some preliminary work to allow Dumps to Copywrite Disk Farms.

Jun 2002 480.02 BUG FIXES FOR SUMMARISE AND ANALYSE COMMAND

Any file with a blocksize < 6 characters would cause an Analyse or Summarise run to fault with a divide by zero.

The summary by date for the Analyse and Summarise command was wildly inaccurate if any user code did not have files which had been accessed on the day of the run. In extreme cases Familymanager would fault with a resize error.

Both faults have been corrected.

Mar 2002 480.01 CHANGE VERSION TO 48

This patch only changes the version to 48. Version 470.07 is still valid for MCP 48.

Oct 2001 470.07 HANDLE LONG FILE NAMES

FAMILYMANAGER will now correctly handle files with long names on system running with SYSOPS LONGFILENAMES set. Also, the DISCARD function will now work correctly establish its internal sort files and process files whose FILESTRUCTURE is STREAM.

Jul 2001 470.06 WRONG FAMILY NAME COULD BE USED ON COPY

When running Familymanager on three or more families it was possible for the generated copy job to use the wrong familyname for one of the families. This would happen if there were no files to be copied on the first of three consecutive families

Jun 2001 470.05 FIX INVALID OP FOR CONTINUATION CD

Previously, when dumping only to CD or CD images, the JOBBUILDER processes would unconditionally fail with INVALID OP when generating any continuation volumes. This meant that only the first volume (name suffixed by "A") would be created successfully. This problem is now fixed.

Sep 2000 470.04 PROTECT DBDAT FILE FROM OTHER RULES

FAMILYMANAGER automatically excludes certain file kinds from being backed up at any time. For example, files such as DBDATA, JOBDESC, SYSTEMDIRECTORY etc. However, despite popular belief to the contrary, these files were NOT excluded from rules such as RIP, REMOVE and ZIP.

In the interest of file safety, all such files will now be exempt from *any* Flex rule during a FAMILYMANAGER run.

Aug 2000 470.02 ALLOW BACKUP TO CDIMAGE

CD and CDIMAGE are now allowed as modifiers in the parameter to Familymanager. If CDIMAGE is specified the Metalogic CopyWrite product is required, and files are backed up to a Copywrite CD image. Both backup references are set to the same image. The config variable FLEX_CWIMAGE is used to specify the family where the images are to be kept, as described in Dnote 450.02. The Config variable FLEX_CDSERIALNO is used to assign serial numbers to the image. Thus if FLEX_CDSERIALNO=I00000 the next serialno would be I00001 and FLEX_CDSERIALNO would be updated to I00001. The CD images are entered in the volume library as pseudo packs so PV PK I00001 would give details of the image.

Example run:

     RUN METALOGIC/FLEX/FAMILYMANAGER("DUMP DEV CDIMAGE") 

The Duplicated attribute is deimplimented on MCP 4.6. Consequently Familymanager will no longer accept Duplicated in a file equation. Use the Duplicate option the task parameter instead.

Apr 2000 470.01 SUPPORT FOR MCP47

This change is required if running on MCP 4.7 or later

Apr 2000 460.03 RESET TADS

Version 450.98 inadvertently left the TADS compiler option set. This does not effect the results produced by FamilyManager but does impose a processor overhead. The option has been reset.

Mar 2000 460.02 FIX SEG ARRAY ERROR WITH VERY LONG NAME

It was possible for Familymanager to fail with a seg array error when processing file names of 14 levels each of 17 characters.

Feb 2000 460.01 CORRECT FORGET ACTION FOR RESIDENT.

Prior to this release a Forget rule would not forget backups for a resident entry.

This has now been corrected.

Feb 2000 460.00 ELIMINATE ARCHIVE LOG REPORT LINES

The Archive Log count lines have been eliminated from the standard reports, and the more efficient FLEXFORM masks are now used.

Jan 2000 450.11 OPTIMIZE MASKS,ZAP V LOCKEDFILE

FAMILYMANAGER will now treat files with LOCKEDFILE set as if they were RIP. If the file satisfies a ZAP, REMOVE, or RELEASE rule it will be removed. SYSTEMFILE files are now included in the INUSE report.

FAMILYMANAGER used to ask the file search for all attributes except the header, the GUARDFILE, and the USERINFO. Because of this GUARDFILE USERINFO, and SINGLEPACK did not work.

This has now been fixed by using information gathered by OPAL and stored in the rules blocks, which will allow new attributes to be implemented and more efficient searches.

Sep 1999 450.10 DUPLICATED VS SINGLEDRIVE

Previously, for a multi-family run with the DUPLICATED run-time option set, FAMILYMANAGER would ignore the setting of the SINGLEDRIVE Flex DEFAULTS option, unconditionally requesting two drives.

This could be easily detoured by including the keyword SINGLEDRIVE in the run-time parameter, as discussed in Dnote 450.09, but is now fixed.

Further, the key word DUPLICATES is now permitted as a synonym for DUPLICATED in the parameter options.

Jun 1999 450.09 BETTER PARSING AND MORE OPTIONS

To avoid the need to use File Equation to override default settings more options have been added to the parameter to Familymanager.

The Syntax Diagram now looks like:

diagram

For a Boolean option where neither ON nor OFF is specified, ON is assumed.

A Display, listing the action to be taken and the Families to be used has been added. A second Display lists the active options.

Jun 1999 450.08 ALLOW DUPLICATED OFFSITE SELECT

This is a temporary fix to allow the syntax DUPLICATED OFFSITE SELECT in FamilyManager. Previously the run would proceed but only DUPLICATED would be set, OFFSITE and SELECT would be ignored.

A subsequent change will improve parsing of commands and return an error if any part of the parameter is invalid. At present the program continues with a 'best guess' which can hide problems.

Apr 1999 450.07 CD OUTPUT ERROR CHECKING

When dumping files to CD using CopyWrite, certain configuration variables are required. If they are not set up the generated copy fails with syntax errors. The variables are now checked during initialisation, and Familymanager aborts if they are not present.

FLEX_CWHOST should be set to the host name of the system where the CD image file should be sent to be burned.

FLEX_CWIMAGE is the name of the family where CD image files are stored.

FLEX_CDSERIALNO is a six character string representing the next serial number to be used for CD output.

Apr 1999 450.06 FIXES A BUG WHERE BACKUPS WERE SWITCHED

This problem was caused by code inserted to detour an MCP bug. The bug was corrected in MCP 4.2 and had the effect that every FamilyManager run would switch the order of the backup references of each file scanned. When the 'SELECT TRUE' clause was used this could result in the oldest backup being retained and the latest being replaced by the new backup. The 'detour' code has now been removed.

This change also support the change to FLEX 450.03 which allows zero to be used for tape length. A tape length of zero is treated as an infinite length tape.

Mar 1999 450.05 FIX USER TERMINATION FROM PD/ZKBEHEER

450.03 introduced a bug with the last usercode on a family - now fixed.

Feb 1999 450.04 CHECK WFL COPY STMT LENGTH

FAMILYMANAGER now checks to make sure that the length of the WFL COPY statement for the output tapes does not exceed its maximum.

Feb 1999 450.03 PROTECT AGAINST MULTIFAM INV INDEX

This patch protects against an INVALID INDEX problem that may have been seen when FAMILYMANAGER was processing a specific family within a multi-family list.