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_SPLIT_FILENAME
 
  Function:     Splits a file-name into its component parts; that is,
                the device-name, basename and extension.
 
  Syntax:       CALL "CBL_SPLIT_FILENAME" USING     split-join-params
                                                    split-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.
                split-buffer           PIC X(n).
                status-code            See ◄Key►
                                    -♦-