# $PCCC_Release SCore Release 7.Beta.3.0 of SCore Cluster System Software (2009/11/16) $
# $PCCC_Copyright
#          SCore Cluster System Software version 7
#          Copyright (C) 2003-2009 PC Cluster Consortium
#  
#  This software is free software; you can redistribute it and/or modify
#  it under the terms of the GNU Lesser General Public License version
#  2.1 published by the Free Software Foundation.
#  
#  This software is distributed in the hope that it will be useful, but
#  WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
#  Lesser General Public License for more details.
#  
#  You should have received a copy of the GNU Lesser General Public
#  License along with this software; if not, write to the Free Software
#  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
#  USA
#  
#  NOTICE:
#          SCore Cluster System Software versions 1 through 4
#            Copyright (c) 2001,2000,1999,1998,1997
#                        Real World Computing Partnership
#         The SCore Cluster System Software copyright was transferred to
#         the PC Cluster Consortium from Real World Computing Partnership.
#  $

How to Install and Use Xabclib on SCore7

1. Installation

   Xabclib is newly introduced from the SCore 7 Beta 3.
   The name of the Xabclib rpm file is

       	score7.Beta.3-xabclib-7.Beta.3-1.x86_64.rpm

   If you installed SCore7-B3 via the bininstall command, xabclib is
   already installed.

   The rpm file includes the Xabclib library for the GNU and Intel
   compilers. If you want to use xabclib with the other compiler(s),
   please compile Xabclib from the source files described below.

   The name of the tarball of Xabclib source file for is

       	score7-xabclib.tar.gz

   1. If you want to add compilers, add compilers to the SCore
      compiler database. For more details of the compiler database,
      consult the compilers man page. Here, the scorer command is the
      man page command for SCore commands.

        $ scorer compilers
	
   2. Untar the Xabclib tarball in the score7-src/eSCience/xabclib
      directory. 

   3. Build

        # cd score7-src/eScience/xabclib
	# smake
	# smake install

2. Compiling and linking with Xabclib

   To compile your programs using Xabclib, please use the scoref90
   command with the "-env xabclib" option.

        $ scoref90 -env xabclib your_program.f -o your_program

   If you want to use the Intel compiler, for example, please add the
   "-compiler" option.

        $ scoref90 -env xabclib -compiler your_program.f -o your_program

   The environment variables SCORE_COMPILERS and SCORE_COMPILER_ENV are
   used to change default compiler and compiling environment.
   The following examples compile shows a way to compile your_program
   with Xabclib using the Intel compiler.

        $ SCORE_COMPILER_ENV=xabclib
	$ export SCORE_COMPILER_ENV
	$ scoref90 -compiler intel your_program.f -o your_program
	$ SCORE_COMPILER=intel
	$ export SCORE_COMPILER
	$ scoref90 your_program.f -o your_program

<end>