Using remote todsn and fromdsn clients requires that IBM z/OS OpenSSH be configured on z/OS. z/OS V2R2 and later includes OpenSSH. We provide a Quick Install Guide to help systems programmers quickly configure IBM z/OS OpenSSH.
The Dataset Pipes todsn and fromdsn commands may be used from any of the following z/OS Unix shell environments:
The TSO "OMVS" command
The BPXBATCH utility, running under MVS batch or TSO
Note:The BPXBATCH enhancement OA11699 significantly improves its usability.
The z/OS Unix Shell under a telnet or ssh console.
For more information on z/OS Unix, see:
The Dataset Pipes utilties open MVS datasets in "record mode" using the z/OS C library fopen() routine. For example:
fopen( name, mode);
where:
- name
either
"//'fully.qualified.dsn'"or"//dd:ddname"depending on whether BPXWDYN allocation keywords were used (Section F.4, “The z/OS BPXWDYN dynamic allocation service”).- mode
"rb,type=record,noseek"- if reading (fromdsn)"wb,type=record,noseek"- if writing (todsn)"ab,type=record,noseek"- if appending (todsn -a)
Additional open mode options may be specifed by using the
-ooption.
The Dataset Pipes utilites read and write records using the z/OS C library fread()
and fwrite() routines. For more information on the capabilities of record-mode dataset
processing with the z/OS C library, see:
z/OS XL C/C++ Programming Guide. See Ch. 10 "Performing OS I/O operations.
The Dataset Pipes utilities allow for flexible allocation of MVS Datasets through use of the
BPXWDYN text-based allocation service. If you specify allocation keywords,
either with the -x option, or by using the allocKeywords
option, then a new system-assigned DDNAME will
be allocated with BPXWDYN and that DDNAME will be opened with Section F.3, “The z/OS C library fopen() routine”fopen().
You may use any allocation keywords defined by BPXWDYN, except the following:
DA(), DSN(), FI(), DD(), MSG(), or REUSE()(automatically supplied)PATH() , PATHDISP(), PATHMODE(), PATHOPTS(), PATHPERM()RTDDN, RTDSN, RTVOL(only works if called from REXX)SYNTAX
For more information on using BPXWDYN allocation keywords, see:
The Dataset Pipes utilities rely on the z/OS Unicode Conversion Service when possible, for codepage/character set translation.
This subsystem provides hardware-assisted high-performance codepage conversions services. This is the same service used by later versions of z/OS DB2, so many shops already have it configured in their environments. For z/OS 1.6 and later, the service is configured by default, with a starter set of codepage (CCSID) mappings.
For more information on configuring and customizing this subsystem:
When Unicode Conversion Services are not available, Dataset Pipes falls back to iconv for codepage translation
