IBM Support

Transfer ZFS, HFS files between LPARs

Question & Answer


Question

How to use transfer (copy) z/OS USS (ZFS or HFS) files between LPARS?

Cause

A customer had asked where was it documented on how to use Connect:Direct to transfer z/OS USS files ZFS or HFS between LPARs? Also wanted the process and security requirements to make this happen.

Answer

We do not provide an example of a process in our documentation on how to copy (transfer) HFS/ZFS files between z/OS LPARs. The Connect:Direct Process Language Reference Guide comes the closest with an example on copying HFS files between OpenVMS and z/OS but that is of no help for copying files between z/OS LPARs. The Connect:Direct Process Language Reference Guide does have some explanations of the parms used when copying HFS/ZFS files under the chapter Sterling Connect:Direct for z/OS Process Parameters. Below is an example of a process shared with the customer that has been successfully used to copy a HFS/ZFS file between z/OS LPARs:

* Process to copy HFS file to HFS file using PNODE to a different SNODE
*                                                                      
* If using a Stage1 and Stage2 exit you also have to have both SNODEID  
* and PNODEID                                                              
*                                                                      
HFS2HFS  PROCESS  &NODE=%PNODE SNODE=BPONI1.CD520 NOTIFY=%USER -        
           SNODEID=(BPONI2,<password>)                 -          
           PNODEID=(BPONI1,<password>)                                  
STEP1 COPY FROM(PNODE                                  -            
          FILE='/u/bponi1/cd520.pgmdir.pdf'            -                
                  DISP=SHR)                            -                
         TO(SNODE                                      -                
          FILE='/u/bponi2/cd520.pgmdir.pdf'            -                
               DATATYPE=TEXT PERMISS=777               -                
                  DISP=(RPL, CATLG ) )                                  

We document the security requirements required. Below is a copy/paste from the Connect:Direct for z/OS: Administration Guide, under the chapter on Implementing Security:

Considerations for Systems with z/OS UNIX System Services

The following considerations apply to systems with z/OS UNIX System Services:

  • Access to HFS files is controlled by UNIX System Services. The user ID under which the DTF runs must have UPDATE authority to the BPX.SERVER facility. In addition, the submitter ID/password, the PNODEID/password, or SNODEID/password must be valid. z/OS UNIX System Services enables or denies access based on the UNIX permission rules.
  • Sterling Connect:Direct can also check HFS access without requiring a password. To use a password length of zero, you must set up an IBM RACF profile BPX.SRV.userid in class SURROGAT and make sure that the Sterling Connect:Direct started task userid has READ access to this profile. For more information, see Defining a Surrogate for User IDs with No Password.
  • UNIX System Service (BPX) calls are executed in the Sterling Connect:Direct IUI under the TSO or Batch User ID. BPX calls require that a user ID has an OMVS segment defined to it within the external security product, such as IBM RACF, ACF2 or CA-TOP SECRET. The BPX calls are used to resolve the TCP/IP name or address for reporting purpose in Select Statistics. See Special Considerations in IBM Sterling Connect:Direct for z/OS Release Notes for more detailed information on adding an OMVS segment to a user ID.

[{"Product":{"code":"SSFGBN","label":"IBM Sterling Connect:Direct for z\/OS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"--","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"5.2;5.1;5.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
17 December 2019

UID

swg21997670