Substitutable Parameters
MFT Platform Server supports Substitutable Parameters to allow you to take full advantage of the 256 character maximum on the command data. When using substitutable parameters, you do not have to copy the filename from the LocalFileName or RemoteFileName parameters.
MFT Platform Server does not support file name tokens within PPA, because they are relatively long and the substitutable parameters conserve as many bytes as possible within the PPA action data field. The PPA Substitutable fields use the percent character (%) as the escape character instead of the $ that tokens use.
The following is a list of the substitutable parameters that are supported. In the examples of the list, assume that there is a file named C:\a\b\c\d\config.txt.
| Substitutable Parameter | Description | Resolved Name Example |
|---|---|---|
| %DIR | Remote File Name directory without the file name or drive. | a\b\c\d |
| %DRIVE | Remote File Name Drive. | C |
| %NODRIVE | File name without Drive. | a\b\c\d\config.txt |
| %SDIR | The lowest level directory. | d |
| %HDIR | The high level directory. | a |
| %NOSDIR | Directory name without lowest directory. | a\b\c |
| %NOHDIR | Directory name w/o high level directory. | b\c\d |
| %FILE | The file name without the directory. | config.txt |
| %LFILE | File name with directory. | C:\a\b\c\d\config.txt |
| %LLQ | Low Level Qualifier of file (data after last period(.)) | txt |
| %HLQ | High level qualifier of file. | config |
| %TRN | Transaction number. | I824500001 |
| %PROC | Process name. | ABC123 |
| %UDATA | User data. | USRDATAABC123 |
| %JDATE | Julian Date (YYDDD) | 05236 |
| %JDATEC | Julian Date with Century (CCYYDDD) | 2005236 |
| %TIME | Time (hhmmss) | 165030 |
| %GDATE | Gregorian Date (yymmdd) | 050824 |
| %GDATEC | Gregorian Date with Century (ccyymmdd) | 20050824 |
There can be multiple PPA parameters within a single PPA data field. Each Substitutable parameter must be processed one at a time before going onto the next byte of PPA data. Some fields do not make sense such as %DRIVE in a UNIX environment. If a field does not make sense in the environment where PPA is used, the substitutable data is the text in the name of the parameter without the % sign. If UNIX detects the %DRIVE parameter, the value DRIVE should be used as substitution. Similarly, %PROC becomes PROC and %UDATA becomes UDATA if not interacting with a z/OS system.