<datapath assignment>

── DATAPATH ── = ─┬─ <path specification> ───────────┬─────────────────┤
                  └─ ( ── <path specification> ── ) ─┘

<path specification>

  ┌◄──────────────────────── , ────────────────────────┐
──┴─┬─<directory>────────┬─ ON ─┬─<family name>──────┬─┴───────────────┤
    ├─ # ──<string expr>─┘      └─ # ──<string expr>─┤
    └─ # ──<string expr>─────────────────────────────┘

<directory>

──┬─ * ── DIR ── / ──<subdirectory>─┬──────────────────────────────────┤
  ├─ ( ── * ── ) ───────────────────┤
  ├─ ( ──<usercode>── ) ────────────┤
  └─ * ─────────────────────────────┘

Explanation

The DATAPATH attribute determines the directories that the task uses when creating files or searching for files if the prefix and family name have not been explicitly specified.

String expressions and string primaries that evaluate to constants can be used for DATAPATH in the WFL job heading. WFL job parameters can be used in constant expressions.

When the DATAPATH assignment appears in the job heading or in task equation, parentheses are not allowed. When a DATAPATH assignment appears in a task attribute list, parentheses are required.

Examples

The following is an example of a DATAPATH assignment:

DATAPATH = DIR/SHARED ON PROJECTPACK, (*) ON HOMEPACK;

The following DATAPATH assignment uses a previously defined string variable named SDATAPATH:

SDATAPATH := "DIR/SHARED ON PROJECTPACK, (*) ON HOMEPACK";
    .
    .
    .
RUN OBJECT/TEST;
  DATAPATH = #SDATAPATH;

The following DATAPATH assignment uses a string expression. SDIR, SFAM, and SPATHELEMENT are previously defined string variables:

SDIR := "*DIR/SHARED";
SFAM := "PROJECTPACK";
SPATHELEMENT := " (*) ON HOMEPACK";
    .
    .
    .
RUN OBJECT/TEST;
  DATAPATH = #SDIR ON #SFAM, #SPATHELEMENT, * ON DISK;

The following is an example of a DATAPATH assignment in a task attribute list. It uses a string expression. SDIR, SFAM, and SPATHELEMENT are previously defined string variables:

SDIR := "*DIR/SHARED";
SFAM := "PROJECTPACK";
SPATHELEMENT := " (*) ON HOMEPACK";
    .
    .
    .
MYJOB (DATAPATH = (#SDIR ON #SFAM, 
   #SPATHELEMENT, * ON DISK), VALUE = 5);