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, \/*:?”<>.