DataMuseum.dk

top - download

    Length: 3366 (0xd26)
    Types: TextFile
    Names: »RELDESCR.T«

└─⟦e0c43619c⟧ Bits:30005797 CR80 Disc pack ( Vol:FNJ1 861029/EC CR80 S/W Package II+III+IV+V+VII )
    └─ ⟦this⟧ »CSP004_V0801.D!CSS205.D!RELDESCR.T« 

TextFile

*******************************************************

         R E L E A S E   D E S C R I P T I O N

*******************************************************




Module id number: CSS/0205
--------------------------

Module name:      FIDHELP
-----------------------------------

Actual release:   01.02            Release date: 850705
-----------------------            --------------------

Previous release: 01.01            Release date: 840111 ( not SCL )
-----------------------            --------------------




New facilities:
---------------

Changes:
--------

Errors corrected:
-----------------

Reported errors, not corrected:
-------------------------------

CPECRs implemented in current release:
--------------------------------------

Comments:
---------

   FIDHELP is a pascal library version of the swell library module
   FILEIDHELP, described in:

      FILEIDHELP USERS'S MANUAL, CSS/206/USM/0102


  FIDHELP version 01.01 is based on FILEIDHELP version 01.02.

  Two procedures are exported by this module :

  PROCEDURE PACK_FILEID

                (     BUFFER                  : UNIV ELEMENT ;
                  VAR BYTECOUNT               : INTEGER ;
                  VAR FROM_ADAM               : BOOLEAN ;
                  VAR FSN                     : FILE_SYSTEM_NAME ;
                  VAR VOLUME                  : VOLUME_NAME ;
                  VAR NAMELIST                : NAMELISTTYPE ;
                  VAR NAMENO                  : INTEGER ;
                  VAR CC                      : COMPLETION_CODE      ) ;

                              PAGE 1





  BUFFER is the first element of the buffer area containing the file
  name as packed text.  On entry, BYTECOUNT should hold the maximum
  number of bytes to be scanned in the buffer. On return, BYTECOUNT
  holds the number of bytes actually scanned to collect the file-id.


  PROCEDURE UNPACK_FILEID

                (     BUFFER                 : UNIV ELEMENT ;
                  VAR BYTES_UNPACKED         : INTEGER ;
                      FORMAT                 : INTEGER ;
                      FSN                    : FILE_SYSTEM_NAME ;
                      VOLUME                 : VOLUME_NAME ;
                      NAMELIST               : NAMELISTTYPE ;
                      NAME_NO                : INTEGER              ) ;

  BUFFER is the first word of the target area, into which the file-id
  is written as packed text.  The return parameter BYTES_UNPACKED
  holds the number of valid bytes in the buffer area.  The FORMAT
  parameter is as described in the user manual for FILEIDHELP, i.e. :

       FORMAT  <= 0   unpack entire name from root
                = 1   unpack only last name in name list
                = 2   unpack only last two names in name list
               ... etc

  NOTE : It is the responsibility of the user to supply a buffer
  area of adequate size. TAKE CARE.

  For FORMAT = 0, the size in bytes should be at least :

               1 byte for @
               6 bytes for file system process name
               1 byte for -
               4 bytes for group name
              17 bytes for volume name
         10 * 17 bytes for namelist
         -------------------------------------------
             199 bytes total
             ===============


















                              PAGE 2