◄Key► ◄Details►                             ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Routine:      CBL_LOCATE_FILE
 
  Function:     This routine has two uses. It can be used to expand
                an environment variable in a file specification, where the
                environment variable contains a list of several paths. It
                can also determine whether an OPEN INPUT using a particular
                file specification will find the file in a library or as a
                separate disk file.
 
 
  Syntax:       CALL "CBL_LOCATE_FILE" USING     user-file-spec
                                                 user-mode
                                                 actual-file-spec
                                                 exist-flag
                                                 path-flag
                                      RETURNING  status-code
 
  Parameters:   user-file-spec         PIC X(n).
                user-mode              PIC X COMP-X.
                actual-file-spec       Group item defined as:
                  buffer-len             PIC X(2) COMP-X.
                  buffer                 PIC X(n).
                exist-flag             PIC X COMP-X.
                path-flag              PIC X COMP-X.
                status-code            See ◄Key►
                                    -♦-