Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

OS2::DLL
access to DLLs with REXX calling convention.

OS2::DLL - access to DLLs with REXX calling convention.


NAME

OS2::DLL - access to DLLs with REXX calling convention.

NOTE

When you use this module, the REXX variable pool is not available.

See documentation of the OS2::REXX manpage module if you need the variable pool.


SYNOPSIS


        use OS2::DLL;

        $emx_dll = OS2::DLL->load('emx');

        $emx_version = $emx_dll->emx_revision();


DESCRIPTION

Load REXX DLL


        $dll = load OS2::DLL NAME [, WHERE];

NAME is DLL name, without path and extension.

Directories are searched WHERE first (list of dirs), then environment paths PERL5REXX, PERLREXX, PATH or, as last resort, OS/2-ish search is performed in default DLL path (without adding paths and extensions).

The DLL is not unloaded when the variable dies.

Returns DLL object reference, or undef on failure (in this case one can get the reason via DynaLoader::dl_error()).

Create a REXX DLL handle


        $dll = OS2::DLL->new( NAME [, WHERE] );

Same as load, but croaks with a meaningful message on failure.

Check for functions (optional):


        BOOL = $dll->find(NAME [, NAME [, ...]]);

Returns true if all functions are available.

Call external REXX function:


        $dll->function(arguments);

Returns the return string if the return code is 0, else undef. Dies with error message if the function is not available.


ENVIRONMENT

If PERL_REXX_DEBUG is set, emits debugging output. Looks for DLLs in PERL5REXX, PERLREXX, PATH.


AUTHOR

Extracted by Ilya Zakharevich ilya@math.ohio-state.edu from the OS2::REXX manpage written by Andreas Kaiser ak@ananke.s.bawue.de.

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy