Defining a connection to the Classic federation server

To access data in a z/OS® file, you must define a connection that specifies the data source name for the Classic federation server, as well as the data set, user name, and user password.

Before you begin

Complete these prerequisite tasks:
  • Verify that the z/OS File stage is configured properly.
  • Create a job that reads or writes data by adding the z/OS File stage and Complex Flat File stage to it and creating any required links.
  • Verify that the user name that connects to the Classic federation data server has DBADM authority.

Procedure

  1. Double-click the z/OS File stage icon to open the stage properties.
  2. In the Data source name field, enter the ODBC data source name for the Classic federation driver. On UNIX and Linux, use the name of the data source that you specified in the DATASOURCE parameter in the file that is named in the CAC_CONFIG environment variable. On Microsoft Windows, use the name of the data source that you created by using the Microsoft ODBC Data Source Administrator.
  3. In the User name field, enter the name of the user who has authorization to access the z/OS files that you want to read from or write to. On UNIX and Linux, if you do not enter a user name, the value of the USERID parameter in the file that is named in the CAC_CONFIG environment variable is used.
  4. In the User password field, enter the password that is used to log into the Classic federation data server. On UNIX and Linux, if you do not enter a password, the value of the USERPASSWORD parameter in the file that is named in the CAC_CONFIG environment variable is used.
  5. In the Dataset name field, enter a fully qualified valid data set name.
  6. If you are defining a connection for a job that reads a z/OS file, you might need to complete these additional optional fields:
    • Volume(s) – Enter a list of one or more volume names, separated by commas. Specify a volume name if the z/OS data set is not cataloged.
    • Allocation type – Choose Shared (default) to specify that the file can be shared with other jobs, or choose Exclusive to specify that the file is for use only by this job.
    • Missing file – Choose what to do if the file specified in the Dataset name field cannot be found. Choose Error (default), and the job terminates with an error. Choose OK, and the job runs but treats the missing file as an empty file.