FTP Type Uprocs

Node settings can be set to configure FTP or SFTP protocol, refer to section Dollar Universe – FTP settings. To change a local behavior, these variables can be updated in the node variables, management unit variables, Uproc variables and in the Uproc script (with this priority order, the most important being the script).

Use Variables

The parameters host, source file, source path, target file and target path name can include variables that are processed by Dollar Universe at Uproc submission.

The variables are delimited with the character ‘!’ as follows !CODE:FORMAT!. The delimiter character "!" cannot be part of the variable name.

• CODE

  Can take any code described in the table below or a variable of type node, MU, Uproc, task, launch or a batch environment variable (examined in that order).

  Code	Description
  DTRAIT or PDATE	Processing Date: variable S_DATRAIT. By default the format is YYYYMMDD. Format rules (below).
  DTRAIT_X or PDATE_X	Processing Date: variable S_DATRAIT_X. Format is set with the environment variable U_FMT_DATE.
  COMP or SOC	Company: variable S_SOCIETE.
  NOEUD or NODE	Node: variable S_NOEUD.
  ESP or AREA	Area: variable S_ESPEXE.
  UG or MU	Management Unit: variable S_CODUG.
  APP	Application: variable S_APPLI.
  UPR	Uproc: variable S_PROCEXE.
  SESS	Session: variable S_CODSESS.
  FIC	Variable FIC, value obtained from the Management Unit directories table.
  EXE	Variable EXE, value obtained from the application directories table.

• FORMAT

  Can be null, if not, it should be in the form n,p., which translates by taking p characters of the variable value starting from position n (n starts at 1).

  Warning! The DTRAIT code takes a special format including any of the following string combinations ‘YYYY’(or ‘AAAA’), ‘YY’(or ‘AA’), ‘MM’, ‘DD’(or ‘JJ’).

Dollar Universe initially starts by looking for the code (see the list of codes in the table below) before looking for the variable.

To specify the character '!' in the host name: it should be preceded by the backslash (\) character, as shown: \! Example: if !FRSDAIX!VAR! is the required couple, where VAR is a variable, the correct syntax would be \!FRSDAIX! VAR!

To specify the character '!' in a path or file name: it should be preceded by the hash sign (#), as shown: #! Example: if c:\!rep! VAR! is the required sequence, where VAR is a coded variable, the correct syntax would be: c:\#!rep\! VAR!

If the code indicated is neither a Dollar Universe code, nor an existing variable, the string !CODE:FORMAT! is replaced by a null string (variable not found).

If the folder or file name obtained after replacement of all variables is larger than the acceptable maximum size (256 characters), the procedure aborts and an error message is displayed.

Examples

!CODE:FORMAT! used with variables and values obtained:

!DTRAIT!              20110427

!DTRAIT:DD-MM-YY!     27-04-11

!COMP!                UNIV60

!COMP:4,3!            V60

Use Wildcards

Wildcards (? and *) may be used in file names (but not in the path).

• ? represents a single character.
• * represents: 0 to N characters, where N is an integer greater than 0.

Rules apply to the use of wildcards:

• ? may be followed by any number of ? or a *
• * may not be followed by another wildcard

The following examples would be acceptable:

• ??? (Exactly three characters)
• ?* (One or more characters)

The following examples, however, are meaningless:

• *?
• **