bpi.form.openpath()

bpi.form.openpath()

This subroutine is provided to allow cross-platform (unidata/uniVerse/etc) open path capability.  Unidata does not have the rich OPENPATH directive.  So, this subroutine, which can be used on all MultiValue hosts and allows for coding in a cross-platform way.

Subroutine Syntax

CALL bpi.form.openpath( path, prefix, remove, handle, verbose, status, message)

Parameters

Param

Direction

Description

path

passed

full path to directory or file to open

prefix

passed

On unidata, prefix text to use when establishing a temporary VOC pointer to access path (required for UniData)

remove

passed

On uniData, if @TRUE then the temporary VOC pointer is removed after the open directive succeeds or fails

handle

returned

A handle to the opened file (if open is successful)

verbose

passed

level of verbosity

status

returned

@FALSE if successful open, otherwise integer indicating error

message

returned

error message if open fails, otherwise return from unix file command

 Example

path= "/path/to/my/directory"
bpi.form.openpath( path, "", @TRUE, hdl.path, 1, status, message)
IF (status) THEN
   CRT \There was an error when opening \: path
END ELSE
   CRT \successfully opened \:path
END