Additional Parameters

The following two additional parameters can be used in the DSN field to override the NODE or IPNAME parameter in the request that is queued.

Note: When the %IPNAME or %NODE parameter is specified in the DNI configuration, DNI substitutes an asterisk wildcard (*) for the parameter when scanning the z/OS catalog for a dataset match.

Parameter Description
%IPNAME Overrides the IPNAME parameter in the request that is queued.

Because z/OS only supports 8-digit qualifiers, the IPNAME parameter is limited to 8 characters.

%NODE Overrides the node name in the request that is queued.

If the node is not defined to a Platform Server, this parameter is used as the SNA LUNAME.

For example: 

DSN=TESTDNI.%NODE.TEXT.DATA

In this example, DNI internally changes this parameter to TESTDNI.*.TEXT.DATA.

Assume that the catalog scan returns the following datasets: 

TESTDNI.NYNODE.TEXT.DATA
TESTDNI.CHICAGO.TEXT.DATA
TESTDNI.LA.TEXT.DATA

DNI will queue the following three transfer requests:

  • Request 1 is with the TESTDNI.NYNODE.TEXT.DATA local file to the NYNODE node.
  • Request 2 is with the TESTDNI.CHICAGO.TEXT.DATA local file to the CHICAGO node.
  • Request 3 is with the TESTDNI.LA.TEXT.DATA local file to the LA node.

The %IPNAME processing is identical to that of the %NODE parameter, except that instead of overriding the NODE parameter, the IPNAME parameter is overridden.