SAP ABAP Data Element PATHEXTERN (Physical path name)
Hierarchy
☛ SAP_BASIS (Software Component) SAP Basis Component
   ⤷ BC-CCM-FIL (Application Component) Platform-Independent File Names
     ⤷ SFIL (Package) Platform-Independent File Names
Basic Data
Data Element PATHEXTERN
Short Description Physical path name  
Data Type
Category of Dictionary Type D   Domain
Type of Object Referenced     No Information
Domain / Name of Reference Type PATHEXTERN    
Data Type CHAR   Character String 
Length 200    
Decimal Places 0    
Output Length 200    
Value Table      
Further Characteristics
Search Help: Name    
Search Help: Parameters    
Parameter ID   
Default Component name    
Change document    
No Input History    
Basic direction is set to LTR    
No BIDI Filtering    
Field Label
  Length  Field Label  
Short 10 Path 
Medium 15 Physical path 
Long 20 Physical file path 
Heading 55 Physical file path 
Documentation

Definition

Platform-specific physical path under which files are stored. It most contain the reserved word <FILENAME> as a placeholder for the file name. IT can also contain further reserved words (see below).

Use

The physical path name is used by the function module FILE_GET_NAME at run time to create a complete platform-specific file name.

Procedure

Specify a path. You can include the following reserved words in pointed brackets. These are replaced with current values at runtime.

Reserved Word Replacement Text

<OPSYS>    Operating system in call

<INSTANCE>    R/3 application instance

<SYSID>    R/3 application name in SY-SYSID

<DBSYS>    Database system in SY-DBSYS

<SAPRL>    R/3 release in SY-SAPRL

<HOST>    Host name in SY-HOST

<CLIENT>    Client in SY-MANDT

<LANGUAGE>    Log on language in SY-LANGU

<DATE>    Date in SY-DATUM

<YEAR>    Year in SY-DATUM, 4-character

<SYEAR>    Year in SY-DATUM, 2-character

<MONTH>    Month in SY-DATUM

<DAY>    Day in SY-DATUM

<WEEKDAY>    Day of the week in SY-FDAYW

<TIME>    Time in SY-UZEIT

<STIME>    Hour and minute in SY-UZEIT

<HOUR>    Hour in SY-UZEIT

<MINUTE>    Minute in SY-UZEIT

<SECOND>    Seconds in SY-UZEIT

<PARAM_1>    External parameter 1

<PARAM_2>    External parameter 2

<PARAM_3>    External parameter 3

<P=name>    Name of a profile parameter

    (see Report RSPARAM for valid values)

<V=name>    Name of a variable

    (stored in variable table)

<F=name>    Return value of a function module

    Naming convention for this function module:

    FILENAME_EXIT_name

<Y=name>    Return value of a function module

    Naming convention for this function module:

    Y_FILENAME_EXIT_name

<Z=name>    Return value of a function module

    Naming convention for this function module:

    Z_FILENAME_EXIT_name

Examples

  • Local directory for temporary files under Windows NT:

    D:\GLOBAL\ARCHIVE\<PARAM_1>\<FILENAME>

  • Local directory for temporary files under DOS:

    C:\TMP\<FILENAME>

  • Local directory for temporary files under UNIX:

    /usr/<SYSID>/local/tmp/<CLIENT>/<FILENAME>

Dependencies

The function module for the run-time variable <F=name> must meet the following requirements:

  • Name
    The name must begin with "FILENAME_EXIT_".
  • Parameter
    • An export parameter with the name "OUTPUT" must exist. No structure may exist for this parameters.
    • Import parameters are only supported if they have default values.
    • Table parameters are not supported.

Valid example: FILENAME_EXIT_EXAMPLE.

History
Last changed by/on SAP  19961018 
SAP Release Created in