Table of Contents

Search

  1. Preface
  2. Introduction to PowerExchange
  3. DBMOVER Configuration File
  4. Netport Jobs
  5. PowerExchange Message Logs and Destination Overrides
  6. SMF Statistics Logging
  7. PowerExchange Security
  8. Secure Sockets Layer Support
  9. PowerExchange Alternative Network Security
  10. PowerExchange Nonrelational SQL
  11. PowerExchange Globalization
  12. Using the PowerExchange ODBC Drivers
  13. PowerExchange Datatypes and Conversion Matrix
  14. DTL__CAPXTIMESTAMP Time Stamps
  15. PowerExchange Glossary

NETPORT Statement

NETPORT Statement

The NETPORT statement defines information for a netport job and associates the netport job with a specific listener port. You must specify a corresponding LISTENER statement.
z/OS
All
ADAUSER, GDGLOCATE, LISTENER, SUBMITTIMEOUT, TAPEWAIT, and WAITDSN
No
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.
The following example shows sample LISTENER and NETPORT statements that use the IMSJCL member from the RUNLIB library:
LISTENER=(node1,TCPIP,9999) NETPORT=(node1,9999,,,"PWX.RUNLIB(IMSJCL)",mypsb,sub2,sub3,sub4)
This sample NETPORT statement passes a PSB called mypsb to the IMSJCL member. This statement also passes three additional values to use as substitution variables in the IMSJCL member.