!VOC.PATHNAME subroutine

Syntax

CALL !VOC.PATHNAME (data/dict,  voc.entry, result,  status)

Description

Use the !VOC.PATHNAME subroutine to extract the path names for the data file or the file dictionary of a specified VOC entry.

data/dict (input) indicates the file dictionary or data file, as follows:

IK$DICT or 'DICT' returns the pathname of the file dictionary of the 
specified VOC entry.
IK$DATA or ' ' returns the pathname (or pathnames for distributed 
files) of the data file of the specified VOC entry.

voc.entry is the record ID in the VOC.

result (output) is the resulting path names.

status (output) is the returned status of the operation.

An insert file of equate names is provided for the data/dict values. To use the equate names, specify the directive $INCLUDE SYSCOM INFO_KEYS.H when you compile your program. (For PI/open compatibility you can specify $INCLUDE SYSCOM INFO_KEYS.INS.IBAS.)

The result of the operation is returned in the status argument, and has one of the following values:

Value

Result

0

The operation executed successfully.

IE$PAR

A bad parameter was used in data/dict or voc.entry.

IE$RNF

The VOC entry record cannot be found.

Example

CALL !VOC.PATHNAME (IK$DATA,"VOC",VOC.PATH,STATUS)
IF STATUS = 0
THEN PRINT "VOC PATHNAME = ":VOC.PATH

If the user's current working directory is /usr/account, the output is:

 VOC PATHNAME =  /usr/accounts/VOC