Customizing Connect:Direct File Agent

To customize Connect:Direct® File Agent:

Procedure

From the TSO COMMAND option of ISPF/PDF, execute the DGA#FINS CLIST, where $CD is the high-level qualifier used to install IBM® Connect:Direct for z/OS® files, as in the following example.

=== > EXEC '$CD.SDGAISPC(DGA#FINS)' ‘$CD’

During the installation process, you will create and name a Connect:Direct File Agent JCL dataset . All installation variables are saved in this JCL. The following table describes these installation variables:

Field	Description
Configuration job	Name of the job that starts the Connect:Direct File Agent Configuration Interface.
Execution job	Name of the job that start Connect:Direct File Agent.
Shutdown job	Name of the job that shuts down Connect:Direct File Agent.
File Agent home	Full path of the directory where Connect:Direct File Agent is installed.
X11 Display variable	X11 display variable used to connect to the X11 GUI server. The Connect:Direct File Agent Configuration Interface displays on the monitor that matches this display variable. You can specify the netowrk ID of the terminal that you want to use for the Connect:Direct File Agent Configuration Interface. Note: If you want to display the Connect:Direct File Agent Configuration Interface on a Windows computer, you can specify the first node of the Full Computer Name. To obtain this information, right-click on My Computer, click Properties., and then click the Network Identification tab. The Full Computer Name is displayed.
Job card information	JCL used for the job card.

You can edit the Connect:Direct File Agent JCL dataset with ISPF to change an installation variable.

The Connect:Direct File Agent Installation Main Menu is displayed after all elements have been unloaded.

                                                                    More:     +
                   Connect:Direct File Agent v.rr.mm
                      Installation Main Menu                    TIME-hh:mm
                                                                DATE-yyyy/mm/dd

 CMD ==>

          This panel can be scrolled up and down to view the entire
                    set of fields to be entered


             Press ENTER to continue, PF5 to Terminate the JCL Generation

  File Agent jcl dataset...
  Member name for
      Configuration job.... CDFACONF
      Execution job........ CDFAEXEC
      Shutdown job......... CDFASHUT
  Unix path for
      File Agent home...... ___________________________________________________
                     ...... ___________________________________________________
                     ...... ___________________________________________________
                     ...... ___________________________________________________
 X11 DISPLAY variable...... ___________________________________________________

 Job Card Information...... //CDFA JOB (CDFA),'XX FILE AGENT',
                     ...... //*
                     ...... //*

To create the DGA#FINS JCL used to install Connect:Direct File Agent in the $CD.SDGAJCL dataset, specify the fields and press Enter.

When the Connect:Direct File Agent JCL Generation Main Menu is displayed, press Enter to generate the File Agent JCL.

                         Connect:Direct File Agent v.rr.mm
               JCL Generation Main Menu                    TIME-hh:mm TIME-hh:mm
                                                           DATE-yyyy/mm/dd

CMD ==>

 Connect:Direct File Agent  JCL Generation Complete, RC=0

 Name                 Description
 -------              -----------
 CDFA                 The job to build the File Agent jobs

   Review and submit member CDFA to finish the JCL generation.
   CDFACONF, CDFAEXEC, and CDFASHUT will be created by job CDFA


                 Press ENTER to continue

After the JCL has been generated, the following panel lists the jobs created.

To install Connect:Direct File Agent in the appropriate HFS directory, execute the CDFA JCL member, which generates the CDFACONF, CDFAEXEC, and CDFASHUT JCL members. The CDFACONF, CDFAEXEC, and CDFASHUT job names are based on the JCL member names you entered in the Connect:Direct File Agent Installation Main Menu panel. The CDFA job name is taken from the job card information entered during the installation.
Note: The CDFACONF, CDFAEXEC, and CDFASHUT job names are based on the JCL member names you entered in the Connect:Direct File Agent Installation Main Menu panel. The CDFA job name is taken from the job card information entered during the installation.
Open an X11 window, and then run the CDFACONF job to execute the Connect:Direct File Agent GUI. This job copies files from the mainframe library into the UNIX (HFS) directory.