Logo
Dnote

FlexLibrary Notes

Jul 2023 630.01 Update for mcp 63

Update for mcp 63

Jul 2023 620.13 debug

Jan 2023 620.12 Remove Pre63 Density Att Values

Most tape density values are deimplemented in 63.

Jul 2022 620.11 Fixes an invalidinx error introduced by 620.09

Version 620.09 introduced a bug which would cause an invalid index if the number of volumes in the stats file exceeded 2047

Jul 2022 620.10 Fix Oflo Bug in VS Handling

Avoid Invalid Index when Vol Stats entries exceed 2047.

Feb 2022 620.09 Support mergetapes new method of merging cdim

Supports mergetape's new method of merging cdimages.

Nov 2021 620.08 Avoid OBI Seg Array in :FL

Patch 620.07 increased the maximum size of the return in :FL to 519 wds. OBI sets all bits and Flex Inquiry passed an array of 512 wds. Flex Library will now resize the array is if the return overflows

Sep 2021 620.07 COPYSRC vs FORMID in :FLAT

Files with a FORMID no longer have corrupted COPYSRC atts in :FLAT.

Aug 2021 620.06 Support for new NAMEID function

Supports the new Opal Function NAMEID.

Jul 2021 620.05 Fix myself(heapids)

MYSELF(HEAPIDS) will now return the correct value

Apr 2021 620.04 Correct error message for perm variable

Gives the correct error message if an attempt is made to store a permanent variable > 393209 characters. Supports the new Myself(MYFAM) attribute.

Mar 2021 620.03 Support for rules op defaults

Supports changes described in Flex D-Note 620.04. Adds reporting af any faults in a RULES SAVE ALL

Feb 2021 620.02 Support for Rules Modification Timestamp changes

Support for the Rules Modification Timestamp changes in FLex 620.02

Feb 2021 620.01 Support rules op keyedio

Supports the new RULES FAM OP KEYEDIO

May 2020 610.01 Support imagefam in listvl html reports

Supports reporting of Family in Flex Listvl reports.

Mar 2020 600.05 Support MYSELF(COUNTRY)

MYSELF(COUNTRY) Returns the country identifier associated with the Flex task, which is normally the same as SYSOPS COUNTRY.

Jan 2020 600.04 Allow Permdir files to be backed up

PERMDIR files will no longer be excluded from Familymanager backups. Although not very useful for reloads in normal use, they may be restored to a relacement volume if a volume has been destroyed.

Nov 2019 600.03 Protect read of rules

The command RULES SAVE ALL as ... Caused a read of the first record of the Rules file which was not protected by a Lock. Generally this was not a problem except if it was done at the same time as Familymanager was creating METALOGIC/FLEX/RULES/BACKUP. The generated copy would hang waiting for METALOGIC/FLEX/RULES.

Jun 2019 600.02 Fix BackupInvalid Att in Archive

The BACKUPINVALID attribute now works correctly for KEYED file searches and :LIN searches with an Archive.

Mar 2019 600.01 Update for mcp 60

Update for MCP 60

May 2018 590.06 Handle 53 Archive File Format

5.3 changed the SYSTEM/ARCHIVE file formats to closely resemble rows in the SYSTEM/CATALOG. They can be distinguished by different values in the header NEXTROW word. Flex can now correctly handle files created in the new format.

OBJECT/FLEX can now process archived files using the FILES IN ... syntax.

Jun 2017 590.05 Correction for version 590.04

Remove debug code

Jun 2017 590.04 Only warn on missing rules_fam config on full Flex

The Rules File is only required for Full Flex but if the config variable FLEX_RULESFAM was missing then the following mesages could be displayed on installations where Full Flex was not enabled:

 FLEXLIB:OPEN ERROR:Cannot open Rules File exclusive
 FLEXLIB:Please run OBJECT/META/INSTALL from the Metalogic release
 FLEXLIB:Missing Config variable 'FLEX_RULESFAM'

The missing config variable will now be logged but will no longer be displayed.

Apr 2017 590.03 Supports Opal Version 590.02

Supports the changes made in Opal version 590.02

Apr 2017 590.02 Allow :FLAT on VSS3 Disks

On VSS3 disks, the flat directory has different attributes, which are dealt with in this patch.

Mar 2017 590.01 Fix INUSE attribute for not flat calls

Version 580.03 Fixed the INUSE attribute for calls from Supervisor but unfortunately broke it for normal Flex Files commands.

May 2016 580.03 Fix Keyed with only InUse Att

If a simple keyed multi-file search only had the InUse and a Title att, the InUse attribute was always false. The problem was most likely to occur in Supervisor when Flex was not invoked.

Apr 2015 580.02 protect against dynamic variable keys > 17 ch

If a dynamic variable key was > 17 characters for a non .perm variable the internal variable tables would be corrupted and unexpected values could be returned. In particular if a long name was used for a global variable then a SHOW GLOBAL command would fault. This change will kill any ODTS using a dynamic variable > 17 chars with the error: Function variable key cannot be > 17 chars in REPORT. This restriction does not apply to .perm variables.

Ex. REP DO BEGIN $S:="123456789012345678";$$S:="TEST";END would get the new error

REP DO BEGIN $S:="123456789012345678";$$S.PERM:="TEST";END would be OK

Jan 2015 580.01 Protect against bad entries in the flat directory

It was possible that corruption in the flat directory could cause a FILES ...:Flat to report non-existent files with invalid ON parts. This change will cause Flex to log a warning to the flex log for such files but otherwise ignore them.

Jul 2014 570.01 Allow libmaindivir for LTO5 and LTO6 tapes

FamilyManager will now recognise LT05 and LT06 tapes as valid for LibMaintDir.

Feb 2013 560.04 Fix problem after thawing Flex Library

Version 560.03 introduced a problem where thawing Flex Library without thawing Magus would cause subsequent calls to Flex Library to fail with a 'requires privilege' error.

Feb 2013 560.03 Support granulated privileges when running Object/Flex

This change supports OBJECT/FLEX in respecting Granulated Privileges

Dec 2012 560.02 Colon Cat Time Stamps

Files:cat in Flex Inquiry will now correctly display resident time stamps when the resident entry is not Generation 0.

Jun 2012 560.01 Fix Full Hdr Return When Not Cataloging

Full header requests now work when non-Cataloging.

Nov 2011 540.31 Rules (Internal Change)

Information about the RULESMANAGER from RULES_MANAGER_GET was restricted to SECADMIN and PU. Now it isn't.

A FAMILY name of 17 characters was rejected by LOAD_FAMILY_GET.

Oct 2011 540.30 DFH

Internal change.

Oct 2011 540.29 Support file sorts in FInquiry

Flex Inquiry sorting changes. Fix Maint Merge vs Long File Names.

Sep 2011 540.28 Allow alternate STATS file handling

Internal change to allow SUPERVISOR to access non-local Flex STATISTICS files (using the VL context) and MERGETAPE to create them from a non-live SYSTEM/CATALOG file. See SUPERVISOR DNote 541.76 and FLEX MERGETAPE DNote 540.07 for more information.

Jul 2011 540.27 Fix invalid index in Familymanager

Internal change. (duplicate)

Jul 2011 540.26 Fix INVALID INDEX at 2116400 in FAMILYMANAGER

Previously, if more than 256 pack families existed in the system configuration, FAMILYMANAGER would have faulted with an INVALID INDEX at 21164000. This problem has been fixed.

Jul 2011 540.25 CZ

Internal Change.

Jul 2011 540.24 Mark FTAUDIT as DONTBACKUP/unmark PRINTFILE

This change marks FILEKIND=FTAUDIT as DONTBACKUP so that FAMILYMANAGER knows to exclude such SYSTEM files from Library Maintenance copy operations. Similarly, FILEKIND=PRINTFILE has had its DONTBACKUP status removed so that FAMILYMANAGER can now copy such files.

Jun 2011 540.23 Correct multiple RULES TEST handling

The change described by DNote 540.21 did not resolve all issues with the multiple use of RULES TEST from FLEX utility. These issues have been resolved.

Jun 2011 540.22 Correct LMD FILENO for missing files

When reading a Libmaint Dir, FLEX was not allowing for non-copied files that were still retained in the directory but not present on the tape. Because FLEX was counting the File Number in the LMD itself, this caused WFL actions such as 'COPY #N FROM TAPE' (where #N has been provided by FLEX) and 'PDT IN <LibMaint Dir Name>' to provide inaccurate File Number for entries later than the not-copied file. This offsetting of File Number, due to one or more missing files, caused Mergetape to potentially load wrong files from its source tapes.

This problem is now fixed: the File Number if now retrieved from the LibMaint Dir entry for the file and not counted by FLEx.

Jun 2011 540.21 PPD

A RULES TEST FA <familyname> where the <familyname> was greater than 10 characters resulted in a STRING PROTECT fault in FAMILYMANAGER.

Mar 2011 540.20 Support for FLEX logging

FLEX Library will now write run-time information into the Flex log file system and includes BOT/EOT, errors and warnings encountered during its life. FLEX Library entries in the log file have an identity of 'Flib(12345)' where 12345 is the mix number of the caller: note that this will often not be the mixnumber of the Library stack.

12:54:44 Job:Flib(22714):BOJ Flex LIBRARY [Version 54.999.20] initiated

Please FLEX DNote 540.32 for more information.

Mar 2011 540.19 Correct duplicate file handling in FLEX lists

This change addresses a problem with the maintenance of tree file lists, used by various components of Metalogic software, which caused files to be inserted incorrectly into the list or duplicate check to fail. The most noticeable side-effect of this problem was the presence of various duplicate files in the Metalogic release container, particularly METANOTES files. Also, EXCLUDE file handling by MERGETAPE and FAMILYMANAGER were affected.

Nov 2010 540.18 Include SETHEADERTITLE declaration

Internal Metalogic change.

Sep 2010 540.17 Rationalise OPAL debug and NOTES

Internal Metalogic change.

Aug 2010 540.16 Protect DFH attributes

Various disk file header attributes such as DFHLOCATION, DFHCATALOGED etc. now return consistent values for a all disk files when used in a FLAT search.

Jul 2010 540.15 Stop error msgs for REM on NR files

:REO will now be respected for NR files if Cat info is not asked for.

Jul 2010 540.14 ML_AddUser Entry Point

Add Export of ML_AddUser Proc.

Jul 2010 540.13 Internal change - LGBUFF declaration

Internal Metalogic change.

Jul 2010 540.12 Return quoted FILEID nodes

Previously, the FILEID function did not quote file name nodes that should have been i.e. the level "ABC.TXT" would have been returned as ABC.TXT by FILEID. This behaviour has been corrected.

In FLEX usage, expressions such as FILEID("A/B/C",0) and FILEID(FILENAMEID,0), where the target did not have a usercode, would have always returned the usercode of the caller. FLEX now returns an empty string in such circumstances and is compatible with SUPERVISOR behaviour.

May 2010 540.11 MCPDisplayToStandard

OPAL Zip functions use MCPDisplayToStandard.

May 2010 540.10 Internal change only

Use declaration of STEP_DIR in Include/Meta

May 2010 540.09 Support for ZIP and UNZIP methods and functions

Preliminary support for ZIP and UNZIP functions, ZIPFILE and UNZIPFILE methods in both SUPERVISOR and FLEX.

Apr 2010 540.08 Store additional processor loop information

Processor loop detection within the OPAL machine now provides extra information for determining the causes of unusual loop detection.

Apr 2010 540.07 FORMID

Add FORMID.

Apr 2010 540.06 Support MYSELF(INPUTPARAM)

MYSELF(INPUTPARAM) returns the text of the FILES command.

Mar 2010 540.05 Clarify FETCHIMAGEHEADERS error

Previously, if a FILES request was handled for a CD image file but no matching files were returned, FLEX would correctly display a 'No files' found message but also a confusing 'Invalid container or Image' display even though the image was valid. This error message has been removed.

Mar 2010 540.04 Avoid security violation with :Flat

If a non privileged user used the :Flat option , a security violation was logged. A non privileged user can scan their own directory using :flat. An attempt to scan a directory other than their own will return an error but no security violation will be logged.

Feb 2010 540.03 Add #[NoLook] to flex

A new lookup function, #[NOLOOK], was recently added to Supervisor and has now been added to Flex. It allows text strings that have embedded lookups to be displayed to the screen or printed without FLEX performing substitution. This is particularly useful for displaying or printing lines of Opal read from files using the .Read method.

For example:

SHOW("#[NOLOOK] #[SUB] #[CAN]")   would show
#[SUB] #[CAN] instead of the highlight characters.

Jan 2010 540.02 Support new InputParam attribute

INPUTPARAM Returns the text of the most recent command.

Ex REP HEAD INPUTPARAM Followed by FILES =BoB= ON DEV:FL Would return FILES =BoB= ON DEV:FL followed by the list of files

Dec 2009 540.01 Better error message if container is missing

Previously a command like FILES (*)= IN CONT would return an error like:

#8103 FLEXLIB:CATALOG/DIR not available

The more informative message like:

#8103 FLEXLIB:Container/LibMaintDir not available

is now returned.

Aug 2009 530.25 Support functions as statements in Opal

Support for Opal version 530.62

Jun 2009 530.24 Internal change only

Support new attributes VSVER and VSORIGINALREFS.

May 2009 530.23 Fix At Host Loads

Load AT <hostname> did not set the Kind correctly in it was not a request for a specific unit number.

Mar 2009 530.22 Fix = AT

FILES AT <host> no longer assumes * if no usercode is explicit.

Mar 2009 530.21 Simplify RULES MANAGER handling

The handling of the RULES MASTER or RULES MANAGER command in FLEX Inquiry has been improved. Please refer to FLEX DNote 530.36 for more information.

Feb 2009 530.20 Use SYS_USDATES for default USDATES option

Previously, for FLEX sites that did not use the RULES system, there was no obvious mechanism to apply a system-wide setting for the USDATES option held in FLEXSOPTIONSFORME files.

For FLEX use where no valid FLEXSOPTIONSFORME files exist, as long as the Magus SYS_USDATES configuration variable has been set to the value TRUE, any new options file will automatically set the OP USDATES option to TRUE. Note that SYS_USDATES may be set via the 'System' screen from a CONFIG run of the INSTALL utility.

Further, if a RULES CREATE is subsequently performed, the Full Flex setting of USDATES (as seen from the DEFAULTS menu) will be automatically use the SYS_USDATES setting.

Feb 2009 530.19 Keyed and BL/PACK Tape Niggles

Fixes minor niggles with searches for BL/PACK or Conditioned Key tapes.

Feb 2009 530.18 :FAST with MT/CD/IN

FetchTapeDirectory is used if a :FAST search is done on MT, CD. It is simulated for containers, allowing use of CopyWrite exotica, hybrid CDs, CD images, Zip and Tar archives.

Feb 2009 530.17 CopyWrite Loads

MLFlatReader now supports returning Backup information on non-Library/ Maintenance CDs, looking at the FAST in an unknown container, and forcing the use of CopyWrite to access containers or CDs.

An abbreviated header will be used in a sorted FLAT search. This means that the DFHIMAGE attribute will not return the full header if used in the report parts of FamilyManager rules or in reports with :FL,-UNSO.

Jan 2009 530.16 Add Backup Refs For Lib Maint Tapes/CDs

MLFlatReader will return a dummy backup entry if in an MT/CD or LibMaintDir search. This allows Flex to do e.g.

F (*) MT 27:CAT LOAD (*)= on FLEX=(MT)

 

Dec 2008 530.15 Insert_UserType

Internal Change.

Dec 2008 530.14 Large BACKUP

If a BACKUP of a large number of files which exceeded the LIBRARY/MAINTENANCE list limits was done, it would fail in MCP code, possibly with a Memory Dump, instead of returning an error indication.

Nov 2008 530.13 ML_LibMaint

Backup options and ML_LibMaint.

Nov 2008 530.12 Replace COPYWRITE_CATSN by FLEX_DFSERIALNO

Previously, the Magus config variable COPYWRITE_COPYCATSN was used to control the allocation of Disk Farm volume serial numbers for FLEX. This variable has now been renamed to FLEX_DFSERIALNO for clarity reasons and COPYWRITE_COPYCATSN is not used by FLEX.

Oct 2008 530.11 Fix rules text for old code

Version 530.09 introduced a bug in the Rules text reported by Familymanager. If the Rules were created with a version of Opal older than 52033 then the rules text reported would be nul or corrupted. Old code now works correctly.

Oct 2008 530.10 Internal change only

Needed to match changes in OPAL/PD/GLOBALMEM

Jul 2008 530.09 Internal change only

Internal Metalogic change.

Jul 2008 530.08 Correct SECURITYGUARD handling

The change described in DNote 530.06 had the side-effect of causing FLEX to randomly return incorrect values for attributes such as SECURIYGUARD,NOTE and RELEASEID. This problem was only observed with GETSTATUS-only requests and is now fixed.

Jul 2008 530.07 Changes for OPAL resequence

Internal Metalogic change.

Jun 2008 530.06 Support for DFHIMAGE attribute

A new attribute called DFHIMAGE has been implemented for both FLEX and SUPERVISOR (PD context). DFHIMAGE returns an image of the Disk File Header of the selected file. By default, this is returned in JavaScript array format with each header word in hexadecimal format delimited by commas. For example:

[128,'3F3F0A4003E8','801000000000','000000000052',...]

The first entity in the array indicates the size of the header in words.

Jun 2008 530.05 Internal change only

Internal change

May 2008 530.04 Fix USERMIXLIST attribute

Usage of the USERMIXLIST attribute for both FLEX and SUPERVISOR's PD context caused what should have been a list of value mix numbers to be returned as '0,0,0...' or cause the calling OPAL to fault with an INVALID INDEX. This problem is now fixed; the attribute PDUSERMIXLIST was unaffected by this fault.

May 2008 530.03 Control WFL usage

This DNote supports the change described in FLEX DNote 530.05 for the control of the WFL function.

Feb 2008 530.02 Do not update timestamp using CONTAINER

FLEX will no longer change the USETIME attribute of files that it searches when the CONTAINER attribute is being checked.

Jan 2008 530.01 Correct LOAD error messages

Previously, the FLEX LOAD command would show corrupt and incorrect information messages if an individual requested file was already resident. FLEX would also show inconsistent behaviour when attempting to load generation 0 of a file with generation 1 already resident. These problems have been resolved.

Dec 2007 520.27 Internal change

Use INCLUDE/META

Nov 2007 520.26 Allow Catalogs, Archives and Flat Dirs

The container file specified in the Flex Inquiry syntax F x IN <title> can now be a directory. The search will be chosen according to the file found: SYSTEMDIRFILE :FLAT Catalog, Archive :LIN Access :FAST

This is an alternative to the MAINT ALT syntax in Flex, but can be used from Supervisor. Note that the :LIN and :FAST options do not change the default handling.

Nov 2007 520.25 FetchFH

Internal change to FetchForeignHeaders Directory request.

Nov 2007 520.24 FLEX/LIBRARY | Fix File&Dir Lib Maint Searches

When a Flex Inquiry Files command used a Library/Maintenance interface, such as FetchTapeHeaders, it would only return files in the specified directory, but not the root file. For example, F ABC MT 33 would return ABC/D but not the file ABC.

This is consistent with Library/Maintenance, but not with the usual file search convention in the MCP and Flex.

Flex will now return both, but some searches may be a little slower as a result. Searches affected are: F x IN <CD Image> F x IN <Disk Farm> F x .. AT <hostname> F x CD <unitno> and F x ON y (CD) where the CD is in Lib/Maint format F x MT <unitno> and F x ON y (MT)

Handling of AT <hostname> and some error message handling have been integrated with other searches, saving 110 source records.

Oct 2007 520.23 Fix VL Backup Atts in Supervisor

Backup atts from the Vol. Lib. can now be requested independently of Catalog Block atts.

A spurious value is no longer reported in some cases for BACKUPKIND of a non-existant backup.

Oct 2007 520.22 Support for Myself(LastDir)

Support for The Lasdivir mnemonic of the Myself attribute as described in Opals/GSTableGen note 520.52

Oct 2007 520.21 PD Object Length

A length word has been added to the PD object. This fixes 3 low probability bugs and slightly reduces CPU and memory requirements. For now, the format is being kept compatible in case an older program links to a newer Library.

Aug 2007 520.20 Fix One File PDs from Supervisor

Single file PD Context requests passed from Supervisor will no longer wait for the end of the Flex task to display the results.

Jul 2007 520.19 Fix early SELECT terminations

FILES requests from FLEX Inquiry will now not terminate unexpectedly early for certain kind of SELECT conditions with FILES:FLAT requests.

Jul 2007 520.18 FProc

No Flat Error when F_Proc quit requested.

Jul 2007 520.17 Wrap or CopyWrite

Flex assumed that a FileKind = DATA file with FileStructure = STREAM was a Wrapped Container, when it could be a CD Image. Flex now tries to process the container, and if an error occurs, it then calls CopyWrite.

Jul 2007 520.16 Make FLEX SELECT work again

The change applied in FLEX LIBRARY DNote 520.15 had the unfortunate side-effect of causing all FLEX SELECT conditions to always return TRUE. This problem has now been fixed.

Jul 2007 520.15 Suppress FLEX displays on restricted PD context

This change supports the fix discussed in SUPERVISOR DNote 520.99 to better handle SUPERVISOR PD context requests that used EVAL or DO limits. Please refer to the above not for more information.

Jun 2007 520.14 DisplaySubKindList

Implement PDSUBKINDLIST.

Jun 2007 520.13 :Lin FileKind Error

:LIN in FLEX and MergeTape could get a null FileKind after 520.11

Jun 2007 520.12 UseDay vs Non-Resident under Cataloging

When an OPAL referenced the UseDay or UseDate attributes of a Non- Resident file without the UseTS or UseTime attributes, the value returned would be NULL, even if CATALOGUSETS was valid. These attributes now return the correct values. Non-Resident Archived files did not have the problem. Note that the CATALOGUSETS and related attributes are not valid if the file is resident because their values are not updated until the file is removed.

Jun 2007 520.11 rationalise FILEKIND Handling

Handling of the properties that FLex assigned to different FILEKINDs was implemented when Flex was first starting out and has hardly changed since. As a result many 'new' FILEKINDs were treated inappropriately. The implementation was also quite inefficient, and posed problems for the Supervisor PD context.

It has now been re-written, saving about 250 cards in a full Flex compile, and reducing the average working set of Flex programs by 300 words.

May 2007 520.10 Support for OPAL WRITE method

This change supports the new WRITE method for OPAL string variables as described in DNote 520.64. Please refer to this note for more details.

May 2007 520.09 Don't change amended TS for new backup date

Support for Flex/Familymanager version 520.08

Mar 2007 520.08 Store the version of the Opal compiler used t

The version of the Opal compiler used to compile Rules is now stored in the Rules block. This will make it easier in future to determine which Rules may need to be recompiled in respones to changes in Opal.

Some preparation for Rules reporting by email has been done.

RULES OP MANAGEREMAIL will change reporting mode to be email to

the rules manager.

RULES OP USEREMAIL will change reporting mode to be email to

the User.

Full details will be described in Familymanager DNote 520.01.

Feb 2007 520.07 Do not continue after script failure

FLEX scripts will now gracefully abort after any OPAL failure is detected whilst executing a REPORT or SELECT. Previously, FLEX would have continued to process the next selected file which would then caused the same fault to potentially appear many times. Such errors would include CONCATENATED STRING TOO LONG, DIVIDE BY ZERO etc.

Feb 2007 520.06 Support 1,999,999 character strings

SUPERVISOR and FLEX will now both support OPAL strings up to a maximum size of 2,000,000 characters; previously this limit was 393,209. All string operations are supported by this change except for storage into PERM and CONFIG variables and this limit remains at the previous value.

Dec 2006 520.05 Roundup

Internal change only.

Nov 2006 520.04 Fix Usage on Ex-Cat System

The USAGE report without :BRIEF is now fixed on non-Cataloging systems.

Nov 2006 520.03 Allow lower case lookups.

The lookup function (#{...]) is no longer case sensitive.

Nov 2006 520.02 Fix GSHEADER attributes

Previously, using special disk file header attributes, such as DFHCATALOGED, DFHBLOCKLENGTH and PROTECTION, inside a SELECT would cause FLEX to fault with 'FAULT TERMINATION in SELECT@82024000'. This change also protects a SEG ARRAY ERROR @ (10766690) fault when handling the same subset of attributes for files with a large number of rows.

Oct 2006 520.01 Support Opal #[$...]

This change supports the extension to lookup functions, described in Opal Dnote 520.34

Aug 2006 510.31 Allow methods on properties with variables

This change supports the changes described in Opal Dnote 520.30.

Aug 2006 510.30 :FAST Archive Search

':FAST' can now be used with Archive files, either :ARC or when an Archive is a MAINT ALT CAT. As with :ARC, if '=' is given for the title family to search, all *SYSTEM/ARCHIVE files on the DL CATALOG family will be searched.

Aug 2006 510.29 Expand FLat Sort Capacity

A family with more than 300,000 files led to the FLAT SORT disk sizes being too small. All the Sort parameters in FLEX have been increased and Option(SortLimits) is now set to allow operator intervention if necessary.

A resident entry with a non-matching Archive block, will no longer return TRUE in the Archived attribute.

Aug 2006 510.28 Move Sort_To_Volume to FLEX Inq + Arc Fixes

Some minor Archive fixes for keyed searches, and a procedure used in LOAD is now in FLEX Inquiry.

Archive PGs are skipped if no SYSTEM/ARCHIVE is valid for that family.

Jul 2006 510.27 ZAP/PG on Archiving

A ZAP or PURGE on a non-Cataloging system is now treated as an ARCHIVE PURGE.

Jul 2006 510.26 MLCatReader handles Live Archives

If MLCatReader is called without an explicit name on a non-Cataloging system, it will now search the *SYSTEM/ARCHIVE/= files.

Jul 2006 510.25 Support New :Cat Report

This deletes the old LINEARCAT report, which is not needed as the CAT report works with :LINEAR.

CATALOGBLOCK now works with ARCHIVE records. If the search is :LINEAR it returns the record number just as with the Catalog. If the search is keyed, it returns the files-to-dat counter.

Cycle and Version now work correctly with linear Archive searches.

Jul 2006 510.24 Allow MAINT ALT on Archives

Flex Library now supports :LIN searches on SYSTEM/ARCHIVE files specified using the MAINT ALT command.

Jul 2006 510.23 Re-format SameIds

To support the new Flex Format and LF, FLEX uses the changed SameIds format and fixes a bug in the USAGE command. In :FLAT, problems with the LicenseKey and MP= attributes are resolved.

Jul 2006 510.22 Support for RECORD statement

The RECORD statement is now available for FLEX's REPORT BEGIN blocks and is currently only available for those FLEX customers who are also licensed for SUPERVISOR. The latest *METALOGIC/SUPERVISOR/RECORDER must be installed and SL-ed to the RECORDERLIB function.

RECORD usage is identical to that of SUPERVISOR allowing the use of a numeric subfile or REC mnemonic; the semantics are shown below:

---- RECORD -- [ -+- <integer> -+- ] -- ( -- <string> -- ) ----|
+- <mnemonic> +

The RECORD mnemonics are validated at compile-time and also run-time and must appear in the list returned by SUPERVISOR's TT REC NAMES command. FLEX's RECORD statement allows users to send file information or messages to SUPERVISOR's alert mechanisms (such as HOTLINE) and SUPERVISOR RECORD files.

For example:

REP BEGIN
RECORD [META_FILE] ("TITLE: ",TITLE);
END;

Scripts that use RECORD must be running from sessions active under a usercode that has PU, SECDAMIN or SYSTEMUSERS status. FLEX will abort any script that attempts RECORDs from other usercodes.

Jun 2006 510.21 Re-format Flex Directory Object

Support for new format Directory object and simplify What conventions for the search entry points. Calls of File_Search no longer force Volume Library searches if only Backup Attributes that do not need them are requested. Reduces source by about 500 lines.

Jun 2006 510.20 Fix 'MAINT MERGE FILES' for old catalog entries

The MAINT MERGE FILES command, used to merge catalog information from an external catalog into the current catalog, could fail.

Either an entry with Cycle=0 or which had a backup reference of type TAPEPE could cause problems.

The command can now handle either of these cases correctly.

May 2006 510.19 Support WAIT statement for FLEX

This change supports the WAIT statement now available in FLEX; please refer to OPAL DNote 520.15 for more information.

Mar 2006 510.18 Support for OPAL QUIT,EXIT and ABORT

This change supports the new FLEX OPAL statements discussed in OPAL DNote 520.12.

Feb 2006 510.17 Support OPAL REPORT blocks in FLEX

This changes supports the new OPAL REPORT BEGIN capability described in detail in FLEX DNote 510.13. Key words such as BEGIN, END, CASE, WHILE and DO are now permitted from FLEX REPORTS and the MAIL and KEYIN functions have also been made available. New OPAL statements for FLEX include ODT, WFL, SHOW and DISPLAY.

Feb 2006 510.16 Fix longnames with short levels

Version 510.15 introduced a problem when handling long filenames with single levels shorter than 80 characters. This change corrects the problem.

Jan 2006 510.15 Avoid FamilyManager syntax errors on long names

This change fixes a bug in Familymanager. A filename with a single level longer than 80 characters would cause a syntax error in the Familymanager generated job. Such filenames are now handled correctly.

Nov 2005 510.14 Make REMOVESPACES external procedure

Internal Metalogic change.

Nov 2005 510.13 Fix INV INDEX with :FAST for search of more

If a :FAST search was initiated using a wildcard family specification that returned more than 9 families, FLEX would die with an INVALID INDEX at 20578400. This problem is now fixed.

Oct 2005 510.12 Give Archive Info if Cat not available

If Catalog info is not available, MLCatSearch will try and get it from the Archive. File_Search will now look up Archive info if Catalog info is requested on a :FAST call. This is quite slow because a separate GetStatus is needed for every Title.

Sep 2005 510.11 Implement FAST Reading

File_Search now has a "FAST" option which reads the FAST from the ACCESS/CATALOG, and implements FILE:FAST in Flex Inquiry.

Sep 2005 510.10 Support for $.FILE symbolic read extension

This change support the enhancement to the variable .FILE method to allow access to symbolic and data files. Please see OPAL DNote 510.24 for more information.

Aug 2005 510.09 Protect against Supervisor only MYSELF variants

This change will cause Flex to return -0 for any variants of the MYSELF attribute which only apply to Supervisor. Ex Myself(CodeVersion)

Jul 2005 510.08 IMPLEMENT INTRINSIC FILES REPORT

Small change to Load_Default_Reports to remove Files_Report etc.

May 2005 510.07 DETOUR MCP COPY #FILENO PROBLEM FOR MISSING FILE RECORD

This change addresses an inconsistency in the way MCP handles missing files in a LIBMAINTDIR. In tape-tape merging, MERGETAPE uses the COPY #<fileno> syntax to LOAD targeted files from a source tape; <fileno> is used directly from the appropriate file record in the LIBMAINTDIR file, if present.

Unfortunately, MCP does not use this same file number value held in the LIBMAINTDIR file and 'calculates' its own file number. When missing file records are present in a LIBMAINDIR, the MCP will not include these in the file number counting. The result of this means that, for a LIBMAINDIR with missing records, MERGETAPE loads may not actually copy the correct files.

MERGETAPE now uses the MCP numbering mechanism to specify the correct file number for loads instead of using the file number specified in the LIBMAINTDIR.

Apr 2005 510.06 MORE PROBLEMS WITH CDIMAGE/FARM SERIAL NUMBER

Corrects further problems selecting CD Image or Disk Farm serial numbers. Unusual combinations of pack volume serial numbers were required to cause the fault.

Apr 2005 510.05 FIX POSSIBLE ERROR SELECTING NET CD IMAGE

If volumes existed in the volume library with serial numbers similar to the serial numbers used for CD images or Disk Farms it was possible that the wrong serial number for a new image or farm would be used. Ex. If the prefix for images was CIN and a volume with serial CI0001 existed then CIN000 would be used for an image, even if CIN000 was already in use.

Mar 2005 510.04 SMALL SPEED GAIN IN MLCATREADER (:LIN)

Even when not used for debugging the Catalog, MLGETFASTBLKS was checking the FAST blocks in the first row. Now it will only do so under the DEBUGPAST compile-time option.

Mar 2005 510.03 SUPPORT FLEX TAPES IN MEGABYTES

This change supports reporting the size of flex tapes in megabytes.

Mar 2005 510.02 CORRECT HANDLING OF CONTAINER/IMAGE WITH LONG FILENAME

Previously, a FILES command would fail for any Unisys wrapped container whose title conformed to a long file name i.e. any file node with more than 17 characters. FLEX would have truncated the given file name and therefore fail to process the file. This problem is now fixed.

Mar 2005 510.01 FORCE SURE DELINK AFTER EACH FLEX REQUEST

FLEX LIBRARY will now automatically delink from the SURELIB library once a FLEX run has completed. Previously, FLEX LIBRARY would remain permanently connected to SURELIB unless the FLEXLIB library was manually thawed.

Feb 2005 500.22 HANDLE EXPANDED SYSTEM DIRECTORIES

If a SYSTEMDIRECTORY/001 directory file had been extended using the EXPAND command, FLEX Inquiry would fail with:

FLEXLIB: I/O error reading CATALOG/DIR

The EXPAND command allows the SYSTEMDIERCTORY file to reserve extra areas to be used for future expansion. In such circumstances, FLEX incorrectly calculated the last valid record number of the file causing it to read past EOF. This problem has now been resolved.

Feb 2005 500.21 FIX FILE NAME TRUNCATION WARNINGS

This change fixes several problems with the truncation of file title levels that have more than 17 characters. When handling such files, MCP WARNING 35 was being generated. The affected routines in FLEX/LIBRARY, used primarily by by FLEX Utility, will now handle such files correctly.

Dec 2004 500.20 HANDLE NOT COPIED FILE RECS IN LIBMAINTDIR

A PDT LD or a file search in a LIBMAINTDIR could randomly fail when encountering "NOT COPIED" records.

Nov 2004 500.19 OPTION FOR LIBMAINTDIR FILES WHEN COPYING TO TAPE

Supports an option for creating LIBMAINTDIR files when making tapes.

Oct 2004 500.18 FIX COMPILE WITH FI ATTRIBUTES

Internal Metalogic change only.

Sep 2004 500.17 FAMILYMANAGER SCRATCHPOOL PROTECTION

FAMILYMANAGER will now apply the SCRATCHPOOL setting, as provided in its parameter string, instead of unconditionally overriding with the default setting in the RULES file.

Aug 2004 500.16 EXPIRY LIMIT FOR UNUSED SCRATCH VOLUMES

FLEX/LIBRARY will now automatically VOLUME DELETE any SCRATCH volumes that were scheduled for use by a FAMILYMANAGER or MERGETAPE CD, CDIMAGE or DISK FARM copy but were not subsequently used. It is not unusual for SCRATCH volumes such as these to appear in the Volume Library for a variety of reasons (e.g. program failure, operator DS) and this mechanism provides a way to keep this structure free of excessive numbers of SCRATCH entries.

The deletion occurs if the creation date of the SCRATCH volume is more than 7 days old. The following message will be seen prior to the VOLUME DELETE:

  DELETING EXPIRED UNUSED SCRATCH VOLUME NNNNNN

Earlier releases of FLEX software also created SCRATCH volumes in the Volume Library but did not assign a creation date (a PV response shows the date as UNKNOWN for these entries). Now, when such volumes are detected, FLEX/LIBRARY will assign a creation date of today; this means that these old SCRATCH volumes will be deleted the following week. The message below will be seen:

  UPDATING CREATION DATE FOR SCRATCH NNNNNN

Jul 2004 500.15 INTERNAL CHANGE

Internal Change.

Jul 2004 500.14 EXPORT CHECK_LMD AND CLEANUP TAPE7/9

Check_LMD is a lower level procedure used by Find_LMD to search for a LIBMAINTDIR. Resources for the deimplemented TAPE7 and TAPE9 tapes are longer calculated.

Jul 2004 500.13 SUPPORT BASEPACK ATTRIBUTE

Several new FLEX attributes, BASEPACKUNIT and PDBASEPACKUNIT, have been implemented allowing the unit number of the base pack of the file family to be returned to the caller. The APL and PDAPL attributes have been deimplemented to support this change.

Jun 2004 500.12 ADD FLEX NOCAPSULE ATTRIBUTE

This change adds a new FLEX attribute, RELEASED, which reflects that a capsule on a PC Disk Farm has been released from that farm. This information can only be retrieved from the LIBMAINTDIR associated with the Disk Farm.

Jun 2004 500.11 INCREASE LENGTH OF VALID COPY STATEMENT

There is a limit on the length of a valid copy statement. Both Mergetape and Familymanager restrict copy statements to that limit. The limit used was six times less than required. It has now been increased to approximately one million to approximately six million characters.

500.10 INTERNAL CHANGE ONLY

Internal change only.

May 2004 500.09 ALLOW FILES COMMAND FOR DATA WRAPPED CONTAINER

Previously, the FLEX Inquiry FILES command would only operate correctly for Unisys wrapped containers whose FILEKIND was CONTAINERDATA. However, valid containers with FILEKIND=DATA (e.g. for containers downloaded via the Internet) were not recognised. This behaviour has been corrected.

May 2004 500.08 CHECK FOR IMAGE BACKUP REFS

The CD image file residence checking performed by Flex LIBRARY routines during a FAMILYMANAGER run have been improved. Previously, if a CD image could not be found on the default image family then the associated volume would have been unconditionally marked as DESTROYED. This procedure is used prior to CD image creation during FAMILYMANAGER
operations.

This behaviour has been changed with the implementation of 'Hard Links' (please see FAMILYMANAGER Dnote 500.07 for more details) to alternate image families. FAMILYMANAGER will now mark a CD image volume as DESTROYED if the associated image file is missing AND:

1. The file does NOT have any backup references or its catalog information is invalid.
2. The file has a Hard Link but the linked file is not present on the alternate image family.

MERGETAPE, during a CD image merge, will now verify that all CD image volumes are available; a CD image volume will be omitted from any MERGE process if the associated image file is missing AND:

1. The CD image file does not have a valid Hard Link reference to an alternate image family.
2. A Hard Link reference is present but the specified family is not currently on-line or available.

When either MERGETAPE or FAMILYMANAGER check for CD image file availability, messages may be generated for any of the conditions described above:

IMAGE <Image Name> IS NON-RESIDENT BUT HAS NO HARD LINK
IMAGE <Image Name> NO RESIDENT FILE OR CATALOG ENTRY
IMAGE <Image Name> HAS HARD LINK BUT FILE NON-RESIDENT
IMAGE <Image Name> HAS HARD LINK BUT FILE IS NOT PRESENT
IMAGE <Image Name> HAS HARD LINK BUT FAMILY OFFLINE

Both CD image and Disk Farm volume average MBytes per file will now use better defaults for estimating volume sizes. Previously, these values erroneously defaulted to DLT settings.

Lastly, any output SCRATCH volume entry added by FAMILYMANAGER or MERGETAPE into the Volume Library prior to its use will now have its volume creation information updated with the current data and time. This allows any old volumes to be safely identified if they do not get subsequently used.

May 2004 500.07 ALLOW FEET=0 IN FMGR TO OVERRIDE DEFAULT FEET

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

May 2004 500.06 SUPPORT NEW FAMILYMANAGER REPORT TYPE OF EMAIL

This change allows Email to be specified for familymanager Reports. The email address is taken from the Email node in the Userdatafile. If no Email node exists for the user then the Email node for the rules manager will be used. If it does not exist then the report type will default to 'printed'.

Mar 2004 500.05 SUPPORT GLOBAL PROPERTY IN OPAL VARIABLES

This change supports Global variables as described in Opal Dnote 500.06

Mar 2004 500.04 FIX TRUEBACKUPS ATT FOR NON-RESIDENT CAT ENT

When used in a FLEX Inquiry non-linear (i.e. normal) FILES search, the TRUEBACKUPS cataloging attribute could have returned incorrect values for resident, non-cataloged files. This problem is now fixed.

Mar 2004 500.03 FIND_LMD TO SUPPORT PDT LD

Find_LMD is used to find a LIBMAINTDIR from the Volume Library, Volume Directory or TRIM volume info.

Feb 2004 500.02 IMPROVED SURELIB LINKING DIAGNOSTICS

FLEXLIB will now give better diagnostic display messages when library linkage errors are detected, especially when handling SURELIB requests. With the latter, the name of the current SURELIB will be displayed if the library linkage fails.

Feb 2004 500.01 BETTER USE OF OLD CD IMAGE SERIAL NUMBERS

The last serial number in a range of available serial numbers was not being allocated. If CI0001 and CI0004 were available then only CI0002 would be reused.

The volume library is now scanned at least one per day to check for serials which might be reused. Previously it was scanned after every 2000 allocations and when Flex Library was restarted.

Feb 2004 490.15 FIX BAD CATALOG INFO IF NR ARCHIVE ENTRY

On systems with both cataloging and archiving entries, it was possible for Flex to return a corrupted file TITLE attribute if the following applied:

1. The file is not resident, not cataloged but has an archive reference.

2. Any catalog attributes such as BACKUPS, BACKUPSERIAL etc. were used in a SELECT or REPORT.

This problem is now fixed.

Feb 2004 490.14 SUPPORT NEW PARAMETER OF OPALVERSION IN MYSELF

The Myself attribute now has a new parameter, OpalVersion.

Myself(OpalVersion) returns the version of the Opals compiler used to create this code.

Feb 2004 490.13 FIX TIMESTAMPS IN MULTFAM GETSTATUS

In rare cases, MLCATSEARCH, failed to return some TimeStamp attributes when processing wildcards in the FAMILY. This is now no longer the case as this problem has now been fixed.

Feb 2004 490.12 ALL FILE IN LIBMAINTDIR

Flex Library will now unpack the file info from a LIBMAINTDIR in a similar way to a Wrapped container. As the header is not available, only a few attributes are valid. The new FILENO attribute is now supported for LIBMTDIR, LIBMTTAPE, LIBMTCD, and LIBMTIMAGE searches. The :ATT report has been updated and can now be used with :LIN. Some minor problems in dealing with wrapped files have been fixed.

Feb 2004 490.11 ALLOW UNISYS ISO CD FOR MAINT ALT

The :FLAT search can now use an MAINT ALT FLAT directory on a Unisys format ISO CD.

Nov 2003 490.09 FIX CATALOGED ATTRIBUTE

The CATALOGED attribute available in FLEX was not always consistent in the way that it handled resident files. For example, if a resident file had been CATALOG ADDED but had not yet been backed up, FLEX would mistakenly return FALSE instead of TRUE. This anomaly has now been addressed.

Regarding resident files, it should be noted that the DFHCATALOGED attribute is also available to return the status of the catalog bit and may be used for normal GETSTATUS and ':FLAT' searches; however, it use is NOT possible using a ':LINEAR' file search.

Nov 2003 490.08 SUPPORT FAMILYMANAGER RULES CHECKING

This patch supports additional checking, invoked by FAMILYMANAGER and also MERGETAPE, to determine if the RULES file has been setup correctly and a Rules manager usercode is available. Please see FAMILYMANAGER Dnote 490.04 for more details.

Nov 2003 490.07 CORRECTLY HANDLE EMPTY VOLUME LIBRARY

Both the FAMILYMANAGER and MERGETAPE utilities would fault with an INVALID INDEX @ 038:008A:3 if CATALOGING was enabled on the system but there were no disks or other media in the VOLUME LIBRARY. This problem is now fixed; both these utilities will now provide informational messages in future.

Nov 2003 490.06 FIX INVALID INDEX DURING SCRATCH SN SEARCH

Previously, it was possible for FAMILYMANAGER to fault with an INVALID INDEX @ 567735250 when building the internal table of scratch volume serial numbers for use by CD, CD image and disk farms backup. This problem, caused by the presence of an existing high-number serial number in the volume library for any of the backup types, is now fixed.

Oct 2003 490.05 SUPPORT FOR CONTAINER ATTRIBUTE

Internal change to support the new Flex CONTAINER attribute as documented in OPAL Dnote 490.04.

Oct 2003 490.04 LOST XIT

An Invalid Index could occur if a Family had a large number of members.

Sep 2003 490.03 MERGETAPE SUPPORT FOR LOCKEDFILES

This patch supports the controlled removal of LOCKEDFILES loaded by MERGETAPE to a work pack during a family merge. Other file removal routines in Metalogic software are unaffected.

Sep 2003 490.02 CORRECT MISSING LIBRARY ERROR MESSAGES

FLEX will now display the appropriate library function name when a call to the OPALUSERLIB, OPALTAPELIB or SURELIB libraries fail. Previously, the OPALUSERLIB library would have always been considered to be the culprit.

Aug 2003 490.01 UPDATE VERSION FOR MCP 49.1

Internal version change for MCP 49.1.

Jun 2003 480.12 MORE SUPPORT FOR DISKFARMS

This change adds more support for backing up and restoring using CopyWrite disk farms.

It also adds code to allow CD/CDimage and Disk farm serial numbers to be reused.

Jun 2003 480.11 LONG HDR DIV BY ZERO

A Files (*)= IN <container> failed with a DIVIDE BY ZERO fault if there was a file with a Long Disk File Header in the Wrapped Container.

Apr 2003 480.10 PREVENT REPEATED VOL DESTROY FOR MISSING IMAGE

The Copywrite image residence check discussed in Dnote 480.09 did not check if the volume had already been marked as destroyed either manually or in a prior FAMILYMANAGER run. This behaviour has been corrected.

Apr 2003 480.09 FIX BADREFS HANDLING FOR CD AND IMAGE

If a Flex tape, CD or CD image was marked as DESTROYED in the Volume Library or assigned as BAD BACKUp in the Statistics files, FAMILYMANAGER is meant to re-backup any of the resident files that were present on the damaged media. Unfortunately, this mechanism was only working correctly for tape media, CD and CD image volumes would be ignored. This problem is now fixed.

Also, during FAMILYMANAGER runs that create Copywrite disk images, FAMILYMANAGER will now verify that all disk containers found in the Volume Library are present on the image family. If any containers are missing, each will be marked as DESTROYED in the Volume Library and any resident files that had been backed up on the missing image will be reprocessed. FAMILYMANAGER will generate appropriate display messages when such containers are found.

Apr 2003 480.08 USE LENGTH FROM PARAMETER

Recent changes to Familymanager meant that any value specified in the FEET parameter was ignored, the tape length being taken from the 'defaults' value. This problem has been corrected.

Mar 2003 480.07 DONT UPDATE DENSITY FOR FAMILYMANAGER

The FLEX LIBRARY entrypoint used to provide the FAMILYMANAGER program with backup parameters will not update the callers DENSITY value if it is already non-zero. This change enables FAMILYMANAGER better control of its backup parameters if the default backup density is overridden by the site.

Jan 2003 480.06 SUPPORT OPAL 480.19

This change supports Opal Version 480.19 which allows longer strings and protects against attempts to extend string beyond their limit.

Dec 2002 480.05 ADD SUPPORT FOR COPYWRITE DISK FARMS

This change is to support Familymanager and Mergetape copying to CopyWrite Disk Farms.

Dec 2002 480.04 AUTOBINDING

Add AutoBinding Compiler Control Option. Internal change only.

Dec 2002 480.03 BL

Files <pattern> MT <unit> on a non Library/Maintenance tape calls CopyWrite to return the Disk File Headers.

Jun 2002 480.02 INCORRECT ROW HANDLING FOR VSS-2 DISK

After the re-RC of a VSS-2 disk, it was possible for FLEX to incorrectly process the last row of the system directory using the :FLAT option. This could cause ghost entries from the old directory to be detected during a :FLAT scan. This problem was caused by FLEX miscalculating the size of the row in a VSS-2 disk and is now fixed.

Mar 2002 480.01 CHANGE VERSION TO 48

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

Dec 2001 470.13 IMPLEMENT 'FILES AT' COMMAND

Implement support for "Files AT <hostname>" command in Flex Inquiry.

Oct 2001 470.12 FIX BUG IN FILES :ACT WITH LONG NAMES

When running the command FILES :ACT on a directory containing long file names and on a non cataloging system, errors could occur. Sometimes Flex would fault, other times corrupted file names were returned.

Oct 2001 470.11 HANDLE LONG FILE NAME SEARCHING
The various file searching routines used by FLEX software would get a GETSTATUS 119 SIMPLE NAME ERROR when encountering a long file name with more than 17 characters in one or more levels of the title. This problem is now resolved.

Oct 2001 470.10 INCREASE COPYWRITE NFT LIMITS FOR MCP 48
Default values for WFL/NFT copies used by COPYWRITE have been altered to match the new limit imposed on normal COPY statements on MCP 48 or later. This change offers improved usage of space for Flex CD media in particular as well as image files.

Oct 2001 470.09 VOLUME CREATION DATE WITH LONGFILENAMES CAT
When running the MERGETAPE utility on MCP 48.1 systems with SYSOPS LONGFILENAMES set, the creation date of the volume stored in the STATISTICS file was not being correctly handled. This caused any tape volumes whose dates had been modified to hold the packed value, to subsequently become marked as BAD REFS in the Stats file. This caused later runs of FAMILYMANAGER to re-backup all files on these tapes.

This problem, which was because MCP 48.1 now holds creation date as a packed integer in the volume library entry, is now resolved.

Sep 2001 470.08 HANDLE LONGFILENAME CATALOGS
The FLEX package will now operate correctly on cataloging systems with SYSOPS LONGFILENAMES set. Previously, running FAMILYMANAGER on such a system would have failed because of the changes effected by the MCP on the structure of the Catalog file. Some restrictions on the copying of files with very long file names may still apply but this area will be verified shortly.

Jul 2001 470.07 FIX FAMILYMANAGER RULE MISBEHAVIOUR
If FAMILYMANAGER ran with specific file attributes compiled into any FLEX rule, it was possible for one or more rules to return incorrect results because attribute information could be randomly corrupted. The attributes that instigated this behaviour are relatively new: e.g. FILELENGTH, FILESTRUCTURE, FILEORGANISATION, NOTE and were introduced in OPAL GSTABLEGEN changes 460.09 and 460.17. If you are using any of these attributes in existing rules, it is essential that this version of FAMILYMANAGER is used in the future. The rules do not need to be recompiled.

Jun 2001 470.06 INCREASE MAX UNIT TO 65535
When using a wild-card family pattern in a FILES command with the FLEX utility program e.g. FILES *= ON =, disk families whose base units had a unit number greater than 4095 were being ignored. FLEX will now correctly handle units up to the value 65535

Apr 2001 470.05 FIX MAINT ALT FLAT
The MAINT ALT FLAT command was inadvertently broken by the changes made to support VSS2 disk; this caused all :FLAT commands to the alternate directory to fail with BAD BLOCKING FOR CATALOG/DIR. This problem is now resolved.

Jan 2001 470.04 NO BCL ON MCP 47.1

Internal Metalogic change. No documentation

Dec 2000 470.03 FIX VSS2 DISK HANDLING
Due to a change in MCP 46.1A.105, FLEX would fail with a FLAT I/O ERROR when reading the SYSTEMDIRECTORY on a VSS-2 disk. This was due to the way that MCP now handles the logical blocking of the file and has now been fixed for this latest MCP version but is still compatible with earlier MCP levels.

Sep 2000 470.02 SUPPORT COPY TO CDIMAGE
This change supports copies to CD images and adds PERMDIR as an excluded Filekind.

Aug 2000 470.01 SUPPORT FOR MCP 4.7

This version is required in order to run on MCPs 4.7 or later.

Aug 2000 460.14 FAVOUR COPYWRITE FOR IN <file>
If CopyWrite is available, it will now be used for the IN <file> searches unless the FILEKIND of the <file> is CONTAINERDATA. This will give CopyWrite users access to a wider variety of Containers from FLEX, including WRAPPEDFILE, LIBMAINTDIR, self-extracting Archives, and SIMPLEINSTALL data files.

Aug 2000 460.13 IMPLEMENT PRODUCT & GROUP ATTS
The PRODUCT and GROUP attributes are now available.

Aug 2000 460.12 FIX INTEGER OVERFLO IN :LIN
A :LINEAR search will no longer get an INTEGER OVERFLOW in certain rare NOROW situations.

Jul 2000 460.11 QUOTE FILES WITH LEADING UNDER SCORE
When being dumped by Familymanager file titles starting with the underscore character were not being correctly quoted. This caused syntax errors in the generated job.

Jun 2000 460.10 SUPPORT UNISYS VSS2 DISK IMPLEMENTATION

FLEX will now recognise SYSTEMDIRECTORY files on VSS2 disk packs. Previously, FLEX Inquiry would have given an error when handling file requests that used the FLAT option.

Apr 2000 460.09 FIX SECURITYUSE ATTS FROM FLAT

If FLEX was using the :FLAT option, the SECURITYUSE attribute would consistently return incorrect mnemonic values although non-FLAT runs would be fine. This problem is now fixed.

Mar 2000 460.08 ALLOW FOR #3 OF 2 IN VOLUME LIBRARY
If reel 1 of a 3 tape family was released the volume library shows the remaining reels as #2 of and #3 of 2. This caused a problem in Mergetape where reel #3 could be released, even if there were still files on reel #2. This problem has now been corrected. If reel #2 has references then no subsequent reel will be released.

Feb 2000 460.07 SIMPLIFY NEXTROW ACCESS IN :FLAT OR :LIN

This patch uses the DMTIMESTAMP File Attribute to access NEXTROW info for use in :FL or :LIN. :FL searches against GETSTATUS copied directories should now work. Some old development code has been eliminated. The source for FLEX/LIBRARY is thereby reduced more than 500 cards.

Jan 2000 460.06 YET MORE FLEX DIRECTORY ATTS
Implements the new attributes defined by GSTABLEGEN 460.09.

Jan 2000 460.05 SUPPORT EXTRAINFO FLEX DIRECTORY ATTS
This change supports the new FLEX Directory attributes derived from the GETSTATUS EXTRAINFO structure and documented in GSTABLEGEN 460.08

Dec 1999 460.04 IMPLEMENT SOFT HDR ATTRIBUTES

This change provides support for returning the header to callers for use by GETHEADERATTRIBUTE, as detailed in GSTABLEGEN 460.07.

Dec 1999 460.03 ALLOW SERCHING OF WRAPPED CONTAINERS

The FILE ... IN ... command can now be used with Wrapped containers.

FILES = IN WRAPPED/BOB Would return all files in the container with the Usercode which Flex is running from.

FILES *= IN WRAPPED/BOB would return all non Usercoded files.

FILES (*)= IN WRAPPED/BOB would return all files.

These and all other wild card patterns are valid, As is any selection expression or report.

If the Error FLEXLIB: Invalid Container or Image is displayed then running Flex with the debug option set and retrying the command will cause an additional display with more detail of the problem.

Ex U FLEX; Option Debug

Sep 1999 460.02 FAST INITIALIZE & MYSELF(WIDTH/PAGESIZE)

The standard reports are now present in code form, not symbolic as before. On an NX4200, this change reduced the CPU Time of Library initialization from 40 seconds to 2 seconds, and core used from 55000 words to 9000. The FLEX/LIBRARY source is now 2500 lines shorter.

MYSELF(WIDTH) returns the current page width. MYSELF(PAGESIZE) returns the current number of lines per page. They return 0 if no output medium is defined.

Aug 1999 460.01 CHANGE DEFAULT RULE THRESHOLD TO 0

The previous default value for Rules Threshold was 17%. This could cause problems if Familymanager was run on a new family before any shares had been assigned. The default is now 0% meaning that no limits will be applied unless specifically requested by setting RULES THRESHOLD for the family.

Jun 1999 450.05 ADD SUPPORT FOR FRAMESIZE IN FLAT
The FRAMESIZE attribute will now return a valid result when used with :FLAT.

Apr 1999 450.04 Support for FLEX 450.03
This change supports FLEX 450.03.

Mar 1999 450.03 FIX :LIN,TEST COUNT
Fix for minor cosmetic problem and possible bear-trap.

Feb 1999 450.02 SUPPORT FILE ON CD/MT
This change provides support for the enhanced FILE command in FLEX Inquiry, which gives access to CDs, Libmaint tapes, and CopyWrite Image files.