view release on metacpan or  search on metacpan

lib/Biblio/Isis/Manual.pod  view on Meta::CPAN

=head1 DESCRIPTION

This is partial scan of CDS/ISIS manual (appendix F, G and H, pages
257-272) which is than converted to text using OCR and proofread.
However, there might be mistakes, and any corrections sent to
C<dpavlin@rot13.org> will be greatly appreciated.

This digital version is made because current version available in ditial
form doesn't contain details about CDS/ISIS file format and was essential
in making L<Biblio::Isis> module.

This extract of manual has been produced in compliance with section (d) of
WinIsis LICENCE for receiving institution/person which say:

 The receiving institution/person may:

 (d) Print/reproduce the CDS/ISIS manuals or portions thereof,
     provided that such copies reproduce the copyright notice; 

=head1 CDS/ISIS Files

This section describes the various files of the CDS/ISIS system, the
file naming conventions and the file extensions used for each type of
file. All CDS/ISIS files have standard names as follows:

  nnnnnn.eee

where:

=over 10

=item C<nnnnnn>

is the file name (all file names, except program names, are limited to
a maximum of 6 characters)

=item C<.eee>

is the file extension identifying a particular type of file.

=back

Files marked with C<*> are ASCII files which you may display or print. The
other files are binary files.

=head2 A. System files

System files are common to all CDS/ISIS users and include the various
executable programs as well as system menus, worksheets and message
files provided by Unesco as well as additional ones which you may
create.

=head3 CDS/ISIS Program

The name of the program file, as supplied by Unesco is

  ISIS.EXE

Depending on the release and/or target computer, there may also be one
or more overlay files. These, if present, have the extension C<OVL>.
Check the contents of your system diskettes or tape to see whether
overlay files are present.

=head3 System menus and worksheets

All system menus and worksheets have the file extension FMT and the
names are built as follows:

  pctnnn.FMT

where:

=over 10

=item C<p>

is the page number (A for the first page, B for the second, etc.)

=item C<c>

is the language code (e.g. E for English), which must be one of those
provided for in the language selection menu xXLNG.

=item C<t>

is X for menus and Y for system worksheets

=item C<nnn>

is a unique identifier

=back

For example the full name of the English version of the menu xXGEN is
C<AEXGEN.FMT>.

The page number is transparent to the CDS/ISIS user. Like the file
extension the page number is automatically provided by the system.
Therefore when a CDS/ISIS program prompts you to enter a menu or
worksheet name you must not include the page number. Furthermore as
file names are restricted to 6 characters, menus and worksheets names
may not be longer than 5 characters.

System menus and worksheets may only have one page.

The language code is mandatory for system menus and standard system
worksheets. For example if you want to link a HELP menu to the system
menu EXGEN, its name must begin with the letter E.

The B<X> convention is only enforced for standard system menus. It is a
good practice, however, to use the same convention for menus that you
create, and to avoid creating worksheets (including data entry
worksheets) with X in this position, that is with names like xB<X>xxx.

Furthermore, if a data base name contains B<X> or B<Y> in the second
position, then the corresponding data entry worksheets will be created
in the system worksheet directory (parameter 2 of C<SYSPAR.PAR>) rather
then the data base directory. Although this will not prevent normal
operation of the data base, it is not recommended.

=head3 System messages files