VMS Help RTL Routines, LIB$, LIB$FID_TO_NAME  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Convert Device and File ID to File Specification routine
    converts a disk device name and file identifier to a file
    specification.

    Format

      LIB$FID_TO_NAME  device-name ,file-id ,filespec

                       [,filespec-length] [,directory-id]

                       [,acp-status]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 device-name

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Device name to be converted. The device-name argument is the
    address of a descriptor pointing to the device name. It must
    reference a disk device, and must contain 64 characters or less.
    LIB$FID_TO_NAME obtains device-name from the NAM$T_DVI field of
    an OpenVMS RMS name block.

 file-id

    OpenVMS usage:vector_word_unsigned
    type:         word (unsigned)
    access:       read only
    mechanism:    by reference, array reference

    Specifies the file identifier. The file-id argument is the
    address of an array of three words containing the file
    identification. LIB$FID_TO_NAME obtains file-id from the NAM$W_
    FID field of an OpenVMS RMS name block. The $FIDDEF macro defines
    the structure of file-id.

 filespec

    OpenVMS usage:char_string
    type:         character string
    access:       write only
    mechanism:    by descriptor

    Receives the file specification. The filespec argument is the
    address of a descriptor pointing to the file specification
    string. As of OpenVMS Version 7.2, the maximum file specification
    string that can be returned is 4095 bytes on Alpha systems, and
    510 bytes on VAX systems. On versions prior to Version 7.2, the
    maximum is 510 bytes on both platforms.

 filespec-length

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       write only
    mechanism:    by reference

    Receives the number of characters written into filespec,
    excluding padding in the case of a fixed-length string. The
    optional filespec-length argument is the address of an unsigned
    word containing the number of characters.

    If the output string is truncated to the number of characters
    specified in filespec, then filespec-length is set to that
    truncated size. Therefore, you can always use filespec-length
    to access a valid substring of filespec.

 directory-id

    OpenVMS usage:vector_word_unsigned
    type:         word (unsigned)
    access:       read only
    mechanism:    by reference, array reference

    Specifies a directory file identifier. The directory-id argument
    is the address of an array of three words containing the
    directory file identifier. LIB$FID_TO_NAME obtains this array
    from the NAM$W_DID field of an OpenVMS RMS name block. The
    $FIDDEF macro defines the structure of directory-id.

    This parameter is relevant only for a structure level-1 disk on
    OpenVMS VAX systems. This parameter is ignored on OpenVMS Alpha
    systems because level-1 disks are not supported on OpenVMS Alpha
    systems.

 acp-status

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    The status resulting from traversing the backward links. The
    optional acp-status argument is the address of an unsigned
    longword containing the status.