Fileset FTP/Local outbound file name templates

Template name are consistent with those in Tcl commands. The %USERDATA% template gets the entirety of the USERDATA value. This can be empty or a long string.

The fileset protocols have a filter for inbound. This consists of a field to specify the file extension. For example, *.dat.

  • White space is not replaced.
  • The engine supports white spaces in the outbound (OB) file name. The full path length is restricted to 260.
  • An error results if the limit is exceeded.

Templates from message metadata

  • %MSG.TYPE%: msgType
  • %MSG.CLASS%: msgClass
  • %MSG.PRIORITY%: msgPriority
  • %MSG.MID%: msgMid
  • %MSG.HOSTID%: msgHostId
  • %MSG.ORIGSOURCECONN%: msgOrigSrcThread
  • %MSG.ORIGDESTCONN%: msgOrigDestThread
  • %MSG.SOURCECONN%: msgSrcThread
  • %MSG.DESTCONN%: msgDestThread
  • %MSG.TRXID%: DRIVERCTL. _TRXID_
  • %MSG.TIMEIN%: msgTimeStartIb
  • %MSG.TIMEOUT%: msgTimeStartOb
  • %MSG.USERDATA%: msgUserData

Additional templates

  • %SYS.TIME%

    The time of writing OB files. For example, 09-10-YYYY.

  • %SYS.DATE%

    The date of writing OB files. For example, 03-31-YYYY.

  • %SYS.TIMESTAMP%

    The timestamp of writing OB files.

  • %CIS.SEQUENCE%

    Starts from 0 and increases by one (1) for every OB message.

    To keep the state of the sequence after a process stop:

    • If you started the whole process, then the sequence is set to 0.
    • If you start only an individual thread, then after restart the sequence number continues from the last sequence number.
  • %CIS.IBFILENAME%

    The inbound (IB) file name read from DRIVERCTL.FILENAME.

  • %CIS.PROCESS%

    The process name.

  • %CIS.SITE%

    The site name.

  • %CIS.THREAD%

    The thread name.

  • %CIS.HOSTNAME%

    The host name.

Notes:

  • If the template is %USERDATA%.dat and the USERDATA is empty, then the OB file name is.dat.
  • If the value of the template is empty or includes characters that cannot be used as a file name, then an error is reported for an invalid OB file name. For example, \/*:?”<>.