NETPORT=(
listener_node
        ,
port
       [,
cpnode]
       [,
cpport]
        ,
netport_member
       [,
substitution_1]
       [,
substitution_2]
       [,
substitution_3]
       [,
substitution_4]
       [,
substitution_5]
       [,
substitution_6]
       [,
substitution_7]
       [,
substitution_8]
)

listener_node

Required. Listener node name from the LISTENER statement associated with this NETPORT statement.

This value must also match the node name in the PARM parameter of the EXEC JCL statement for the running PowerExchange Listener. Otherwise, the PowerExchange Listener does not listen on the listener port on the LISTENER statement.

port

Required. TCP/IP port from the LISTENER statement associated with this NETPORT statement. The PowerExchange Listener uses the port on the associated LISTENER statement to listen for netport job requests.

Valid values are from 1 through 65535.

cpnode

Optional. Listener node name in the DBMOVER member that the netport job uses. If the netport JCL executes the DTLLST3 program, the DBMOVER member specified in the DTLCFG DD statement must contain a LISTENER statement with this node name.

Default is the

listener_node

parameter value.

cpport

Optional. TCP/IP port in the DBMOVER member that the netport job uses. If the netport JCL uses the DTLLST3 program, the DBMOVER member specified in the DTLCFG DD statement must contain a LISTENER statement with this port.

Default is the

port

parameter value.

netport_member

Required. Data set that contains the netport JCL. You can use either a sequential data set or a PDS with a member.

If you use a PDS, you must specify the member name in parentheses and enclose the entire value in quotes (“).

substitution_1

Optional. Populates the netport JCL substitution variable %1. In the IMSJCL member of the RUNLIB library, PowerExchange uses this variable to populate the PSB=%1 parameter in the DLIBATCH PROC.

substitution_2

Optional. Netport JCL substitution variable %2.

substitution_3

Optional. Netport JCL substitution variable %3.

substitution_4

Optional. Netport JCL substitution variable %4.

substitution_5

Optional. Netport JCL substitution variable %5.

substitution_6

Optional. Netport JCL substitution variable %6.

substitution_7

Optional. Netport JCL substitution variable %7.

substitution_8

Optional. Netport JCL substitution variable %8.

You can enter up to ten NETPORT statements in the DBMOVER file.
PowerExchange uses the substitution parameter values in the NETPORT statement, if specified, to replace substitution variables in the netport JCL before submitting the JCL.
Use a netport job to invoke the following programs to complete PowerExchange and non-PowerExchange functions:
The IMS DLIBATCH PROC or DFSRRC00 program to access IMS databases.
The batch PowerExchange Listener program, DTLLST3, to access data sets.
With DTLLST3, the netport job can wait for tape mounts or data sets without impacting other users of the PowerExchange Listener.
The batch PowerExchange Listener program, DTLLST3, to access CA IDMS/DB tables with full user ID checking.
By default, a PowerExchange Listener waits 60 seconds for spawned jobs to start. To increase this timeout period, define a SUBMITTIMEOUT statement. If the batch job does not start in the timeout period, PowerExchange times out the job, stops the task in the PowerExchange Listener, and writes the PWX-00426 message to the PowerExchange message log.
For IMS sources and targets, the netport job can access an IMS source or target database for bulk data movement. Define this statement only if you use the DL/1 BATCH access method, which provides DL/I or BMP access to the IMS database. A NETPORT statement is not required for ODBA access to IMS data.
You can override the PSB name in the NETPORT statement, if specified, in the PowerCenter session properties for the source or target and in the PowerExchange Navigator advanced parameters for a database row test. In this case, you must include the %PSBNAME substitution variable in the netport JCL. You can use the overrides to prevent exceeding the limit of ten NETPORT statements in the DBMOVER file.
If you include the PSB=%1 substitution variable in the netport JCL, the PSB name is taken from the sixth parameter (
substitution_1
) in the NETPORT statement.