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 data set can have up to 22 qualifiers, although most data sets 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.