version

Get the Interchange version number and/or other Interchange-related information.

Summary

• [version extended]

Parameter	Description	Default
extended	Enables all of the other parameters listed on this page.	None
child_pid	Output the current Interchange page server's process ID.	No
db	Output database-related Perl module information.	See parameter description
env	List the Environment variables.	No
global_error	Output the name of the global error log file.	No
global_locale_options		No
hostname	Output the hostname that's running the Interchange instance.	No
joiner	Separate the lines in the output with the given value.	<br>
local_error	Output the name of the local error log file.	No
mode	Output the current Interchange run mode(s).	No
modtest	Test for the availability of the named Perl module.	No
module_test	Alias for modtest.	No
moduletest	Alias for modtest.	No
modules	Output information certain Perl modules.	No
perl	Output the Perl version number, along with the path to the "perl" command.	No
perl_config	Output lots of Perl build and configuration details.	No
pid	Output the Interchange instance's master process ID.	No
safe	Output the current value of the SafeUntrap global configuration directive.	No
uid	Output the Interchange instance's username and user ID.	No

Examples

Tag expansion example

Perl example

or similarly with positional parameters:

Description

Get the Interchange version number and/or other Interchange-related information.

Parameters

extended

This parameter enables all of the other parameters listed on this page.  None of the other paramaters will be available for use unless this parameter is set true.

If extended is true and no other parameters are specified (apart from the optional joiner) then the Interchange version number will be output and the db parameter will be set true.

child_pid

Output the current Interchange page server's process ID.

db

Show database-related Perl module information.

If extended is true and no other parameters are specified (apart from the optional joiner), then this parameter will default to true, otherwise this parameter will default to false.

env

Output the names of the environment variables specified using the Environment global configuration directive.

global_error

Output the name of the global error log file, as specified using the ErrorFile global configuration directive.

Note The full path to the global error log file is output, rather than a path relative to the Interchange instance's installation directory.

global_locale_options

hostname

Output the hostname that's running the Interchange instance.

joiner

Separate the lines in the output with the given value.

The default value is "<br>".

local_error

Output the name of the local error log file, as specified using the ErrorFile local configuration directive.

Note The full path to the local error log file is output, rather than a path relative to the website's home directory, as specified using the Catalog directive.

mode

Output the current Interchange run mode(s), which can be one or more of the following:

Mode	Description
INET	Connections can be made via a TCP/IP socket.
UNIX	Connections can be made via a UNIX-mode socket file.
SOAP	Accepting SOAP requests.
mod_perl	Running with Apache's mod_perl.

modtest

Test for the availability of the named Perl module.  If the named Perl module is available then this test will output "1", otherwise "0" will be returned.

Warning If you call this tag from local embedded Perl then you will not be able to use this parameter without also untrapping the "require" opcode.  See the SafeUntrap global configuration directive.

modules

Output the availability, version number and other information about the following Perl modules:

Archive::Tar Archive::Zip Bundle::LWP Business::UPS Compress::Zlib Crypt::SSLeay DBI Digest::MD5 Image::Size LWP::Simple

MIME::Base64 Safe::Hole Set::Crontab Spreadsheet::ParseExcel Spreadsheet::WriteExcel Storable Tie::ShadowHash Tie::Watch URI::URL

perl

Output the Perl version number, along with the path to the "perl" command.

perl_config

Output lots of Perl build and configuration details.

pid

Output the content of the PIDfile, which contains the Interchange instance's master process ID.

safe

Output the current value of the SafeUntrap global configuration directive.

uid

Output the UNIX username and numerical user ID that's running the current Interchange instance.

Category:  Interchange tags

Last modified by: Kevin Walsh Modification date: Thursday 9 August 2007 at 12:03 PM (EDT)