Open topic with navigation

TIBCO® Managed File Transfer Platform Server for z/OS 8.1.0

# Substitutable Parameters

The following table lists the substitutable parameters supported by the DNI interface:

Parameter | Description | Example
--- | --- | ---
%ACB | Defines the name of the ACB that the Platform Server opens when the Platform Server SNA interface is initialized. It is defined by the Platform Server GLOBAL APPC-APPLID parameter. The value of this parameter can contain 1 - 8 characters. If the APPC-APPLID parameter is not defined, no data is substituted for this parameter. | `APPC-APPLID=FUSNACB REMOTE_FILE=c:\temp\%ACB.data` The remote file is changed to `REMOTE_FILE=c:\temp\FUSNACB.data`.
%FILE | Defines the Platform Server to substitute the file name. On a USS file, the file name is the text after the last slash. For an z/OS file, the file name is the same as the z/OS file name and returns the same result as the %LFILE token. | Example 1: `RF=/usr/data/%FILE` If the local file name is /tmp/acct/taxdata.txt, the remote file name is translated to `RF=/usr/data/taxdata.txt`. Example 2: `RF=/usr/data/%FILE` If the local file name is PROD.ACCT.DATA.TAXDATA.TXT, the remote file name is translated to `RF=/usr/data/PROD.ACCT.DATA.TAXDATA.TXT`.
%GDATE | Defines the Platform Server to substitute the Gregorian date at the time the DNI request is to be queued. The format of the date is YYMMDD. Note: If you want to include the century, use the %GDATEC parameter. | `GOOD_NEWDSN=TESTDNI.D%GDATE.FILE1` If the current date is December 31, 2008, the file name is changed to `GOOD_NEWDSN=TESTDNI.D051231.FILE1`.
%GDATEC | Defines the Platform Server to substitute the Gregorian date at the time the DNI request is to be queued. The format of the date is CCYYMMDD. | `REMOTE_FILE=C:\TESTDNI\ACCT\%GDATEC.tax` If the current date is December 31, 2008, the file name is changed to `REMOTE_FILE=C:\TESTDNI\ACCT\20081231.tax`.
%JDATE | Defines the Platform Server to substitute the Julian date at the time the DNI request is to be queued. The format of the date is YYDDD. Note: If you want to include the century, use the %JDATEC parameter. | `REMOTE_FILE=C:\TESTDNI\ACCT\%JDATE.tax` If the current date is December 31, 2008 (2008366), the file name is changed to `REMOTE_FILE=C:\TESTDNI\ACCT\08366.tax`.
%JDATEC | Defines the Platform Server to substitute the Julian date at the time the DNI request is to be queued. The format of the date is CCYYDDD. | `REMOTE_FILE=C:\TESTDNI\ACCT\%JDATEC.tax` If the current date is December 31, 2008 (2008366), the file name is changed to `REMOTE_FILE=C:\TESTDNI\ACCT\2008366.tax`.
%JOBN | Defines the Platform Server to substitute the started task name for this parameter. The started task name can contain 1 - 8 characters. | `REMOTE_FILE=C:\TESTDNI\ACCT\%JOBN.source` If the Platform Server started task name is FUSION, the file name is changed to `REMOTE_FILE=C:\TESTDNI\ACCT\FUSION.source`.
%LFILE | Defines the Platform Server to substitute the current local file (or LF or DSN) name. This name can be up to 44 characters in length. | `REMOTE_FILE=C:\PRODDNI\%LFILE` If the local file name for the DNI task is PRODDNI.ACCT.TAX.DATA, the file name is changed to `REMOTE_FILE=C:\PRODDNI\PRODDNI.ACCT.TAX.DATA`.
%LLQ | LLQ stands for low-level qualifier. This parameter defines the Platform Server to substitute the last qualifier in the current local file. This qualifier can contain 1 - 8 characters. | `REMOTE_FILE=C:\PRODDNI\acct\tax2008.%LLQ` If the local file name for the DNI task is PRODDNI.ACCT.TAX.DATA, the file name is changed to `REMOTE_FILE= C:\PRODDNI\acct\tax2008.DATA`.
%NOHLQ | NOHLQ stands for no high-level qualifier. This parameter defines the Platform Server to strip off the high-level qualifier. The local file name following the high-level qualifier is substituted for this parameter. | `REMOTE_FILE=C:\acct\%NOHLQ` If the local file name for the DNI task is PRODDNI.ACCT.TAX.DATA, the file name is changed to REMOTE_FILE=C:\acct\ACCT.TAX.DATA.
%PROC | Defines the Platform Server to substitute the process name defined by the DNI config PROCESS statement. This parameter can contain 0 - 8 characters. | `REMOTE_FILE=C:\acct\%PROC.dat` If `PROCESS=ABC123` is specified in the DNICFG parameter member, the file name is changed to `REMOTE_FILE=C:\acct\ABC123.dat`.
%Q01% - Q22 | Q stands for qualifier. A 44-byte z/OS dataset can have up to 22 qualifiers, although most datasets typically have far fewer than 22 qualifiers. A qualifier can contain 1 - 8 characters. The first character in the local file is %Q01. The qualifier counter is updated each time a period is encountered. To specify the high-level qualifier, simply specify %Q01. If no data is present for a qualifier, the qualifier is specified as the qualifier name by default. If you specify qualifier Q22 and qualifier Q22 does not exist in the Platform Server, the value `Q22` is used in qualifier substitution. | `REMOTE_FILE=PRODDNI.%Q02.%Q03.%Q06.%Q05.%Q04` If the DNI file that matches the DSN wildcard parameter is `TESTDNI.NY.ACCT.TEXT.TAX.Y2008`, the qualifiers are as follows: %Q01 TESTDNI %Q02 NY %Q03 ACCT %Q04 TEXT %Q05 TAX %Q06 Y2008 Note: Qualifiers %Q07 - %Q22 are not defined and as a result substitute the values `Q07` - `Q22`. In this case, the file name is changed to `REMOTE_FILE=PRODDNI.NY.ACCT.Y2008.TAX.TEXT`.
%SYSID | Defines the Platform Server to substitute the z/OS SYSID. This field can contain 1 - 4 characters. | `REMOTE_FILE=PRODDNI.%SYSID.BACKUP.DATA` If the z/OS SYSID is SYSA, the file name is changed to `REMOTE_FILE=PRODDNI.SYSA.BACKUP.DATA`.
%TIME | Defines the Platform Server to substitute the time when the DNI request is queued. The format of the time is HHMMSS. | `GOOD_NEWDSN=PRODDNI.T%TIME.BACKUP.DATA` If the DNI request was queued at 11:15:23, the file name is changed to `GOOD_NEWDSN=PRODDNI.T111523.BACKUP.DATA`.
%UDATA | Defines the fusion to substitute the user data defined by the DNI configuration DESCRIPTION statement. This parameter can contain 0 - 25 characters. | `REMOTE_FILE=C:\acct\%UDATA.dat` If `DESCRIPTION=ABCDEFGHIJ0123456789` is specified in the DNICFG parameter member, the file name is changed to `REMOTE_FILE=C:\acct\ABCDEFGHIJ0123456789.dat`.

Copyright © 2003-2021. TIBCO Software Inc. All Rights Reserved.