NAME

VMS::Stat - Perl extension for access to HP C extensions to the mkdir() function in the C RTL.

SYNOPSIS

use VMS::Stat qw(&vmsmkdir);
vmsmkdir( 'SYS$DISK:[.MARS]',0777,,1 ); # Equivalent to DCL: $ create/directory/version_limit=1 [.MARS]

DESCRIPTION

vmsmkdir

The vmsmkdir function enables you to specify optional RMS arguments to the VMS CRTL when creating a directory. Its operation is similar to the built-in Perl mkdir function (see perlfunc for a complete description). Up to 4 optional arguments may follow the directory name. These arguments should be numbers which specify optional directory characteristics as allowed by the CRTL. (See the CRTL reference manual description of mkdir() and chmod() for details.) If successful, vmsmkdir returns a true value; error occurs, it returns undef.

Directory characteristic options:

mode

A file protection.

uic

The user identification code that identifies the owner of the created directory.

max_versions

The maximum number of file versions to be retained in the created directory.

r_v_number

The volume or device on which to place the created directory if the device is part of a volume set.

HISTORY

0.01

Original version; created by h2xs 1.22 with options -C -c -n VMS::Stat stat.h

SEE ALSO

The VMS::Stdio extension provides VMS::Stdio::vmsopen() as an interface to the C RTL's fopen() funciton.

AUTHOR

Peter Prymmer, <pprymmer@best.com>

COPYRIGHT AND LICENSE

Copyright 2004 by Peter Prymmer

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.