Transferring data sets to and from Connect:Direct nodes
You can transfer data sets between WebSphere® MQ File Transfer Edition agents and IBM® Sterling Connect:Direct® nodes using the Connect:Direct bridge. You can specify a data set as the transfer source, transfer destination, or both.
Specifying data set names
- You must prefix the data set name with the Connect:Direct node name and a colon (:). The syntax is as follows:
For example, to specify a partitioned data set called OBJECT.LIB on the system where the Connect:Direct node CD_NODE1 is located, use the following syntax:cdNode:data_set_name{;attrib1;...;attribN}
In the above example, three optional attributes are specified by the text RECFM(F,B);BLKSIZE(800);LRECL(80).CD_NODE1://'OBJECT.LIB';RECFM(F,B);BLKSIZE(800);LRECL(80)
The specified data set name is interpreted as a fully qualified data set name, regardless of whether it is enclosed by single quotation mark characters. The system never adds any prefix. If you want to specify a prefix, such as the user ID that the agent runs under, you must specify it as part of the data set name. This differs from the behavior for data set transfers that involve only WebSphere MQ File Transfer Edition agents, where if the specified data set name is not enclosed by single quotation mark characters, the system adds a prefix of the default high-level qualifier for the destination agent.
- You must prefix the data set name with two forward slash characters (//).
- If you want to specify data set attributes, provide these after the data set name, separated by semicolons. Attributes must be provided in the format key(value), which is suitable for BPXWDYN.
For more information about specifying data sets in a transfer request, see fteCreateTransfer (create new file transfer) and fteCreateTemplate (create new file transfer template).
Parameters to use in your transfer request
- All the agents involved in the transfer are v7.0.4 or later
- The source agent is the Connect:Direct bridge agent, and is therefore v7.0.4 or later, and the destination agent is v7.0.3 or earlier
- To specify a sequential data set or partitioned data set (PDS) member as the destination of a transfer, use the -df parameter.
- To specify a PDS as the destination of a transfer, use the -dd parameter.
Specifying data set attributes
Certain data set attributes are set by WebSphere MQ File Transfer Edition and passed through as parameters to the Connect:Direct COPY process. You can also supply certain attributes in the transfer request, by specifying the appropriate BPXWDYN key. The Connect:Direct bridge converts keys that have equivalent Connect:Direct properties to the format that is required by Connect:Direct. For example, in the data set specification CD_NODE1://'OBJECT.LIB';RECFM(F,B);BLKSIZE(800);LRECL(80), the attributes RECFM(F,B);BLKSIZE(800);LRECL(80) are converted to DCB=(RECFM=FB,BLKSIZE=800,LRECL=80).
For details of the mappings between these two types of parameter, including details of the BPXWDYN keys that are supported for use with a Connect:Direct transfer, see Mappings between Connect:Direct process statement parameters and BPXWDYN keys. Not all BPXWDYN keys have an equivalent Connect:Direct process parameter, and not all Connect:Direct process parameters have an equivalent BPXWDYN key.
Additional considerations
- If your transfer destination is a partitioned data set at a Connect:Direct node, you must create the partitioned data set before the transfer, because the Connect:Direct node does not create it for you.