Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Key► ◄Details►                             ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Routine:      CBL_JOIN_FILENAME
 
  Function:     Forms a file-name by joining together its component
                parts; that is, the device-name, basename and extension.
 
  Syntax:       CALL "CBL_JOIN_FILENAME" USING     split-join-params
                                                   join-buffer
                                                   device-buffer
                                                   basename-buffer
                                                   extension-buffer
                                         RETURNING status-code
 
  Parameters:   split-join-params      Group item defined as:
                  param-length           PIC X(2) COMP-X.
                  split-join-flag1       PIC X COMP-X.
                  split-join-flag2       PIC X COMP-X.
                  device-offset          PIC X(2) COMP-X.
                  device-length          PIC X(2) COMP-X.
                  basename-offset        PIC X(2) COMP-X.
                  basename-length        PIC X(2) COMP-X.
                  extension-offset       PIC X(2) COMP-X.
                  extension-length       PIC X(2) COMP-X.
                  total-length           PIC X(2) COMP-X.
                  split-buf-len          PIC X(2) COMP-X.
                  join-buf-len           PIC X(2) COMP-X.
                  first-path-component-length PIC X(2) COMP-X.
                join-buffer            PIC X(n).
                device-buffer          PIC X(n).
                basename-buffer        PIC X(n).
                extension-buffer       PIC X(n).
                status-code            See ◄Key►
                                    -♦-