Configuring to use AFP Download Plus

Before AFP Download Plus can send data sets from z/OS to the Ricoh ProcessDirector system, an administrator must do configuration tasks on z/OS. The administrator also does corresponding tasks on the Ricoh ProcessDirector system to configure the input devices that receive the data sets and to configure the workflows that the data sets are assigned to.

Before you begin this procedure, review the supplied workflows. If you find one that contains some or all the steps that you want to include in your workflow, you can copy it and modify it to meet your needs. The DownloadAFP and DownloadLineData workflows are recommended for use with AFP Download Plus.

In addition, determine whether you can use one of the Download input devices that Ricoh ProcessDirector provides or whether the installation requires a customized input device. Ricoh ProcessDirector provides several Download input devices that you can use with only minor modifications or that you can copy to create a customized Download input device.

To configure to use AFP Download Plus:
  1. On the Ricoh ProcessDirector system, copy and modify a workflow that contains the processing steps that you want the jobs that are submitted by AFP Download Plus to follow.

    To copy and modify one or more workflows:

    1. Click the Workflow tab.
    2. In the Workflow Objects portlet, click the Workflows tab.
    3. Select the workflow that you want to copy, and click Copy workflow (Copy workflow icon).
      We recommend using the DownloadAFP and DownloadLineData workflows with AFP Download Plus.
    4. Name the copy of the workflow, fill in or edit other values that you need, and click Ok.
    5. Select each step and click Properties (Properties icon) on the Workflow Editor portlet. Modify the properties as necessary.
    6. If the AFP resources (such as fonts, overlays, and page segments) required by the jobs that are processed through this workflow are not going to be sent inline with the input file, make sure that those resources are available to the Ricoh ProcessDirector system. We recommend that you move these resources to /aiw/aiw1/resources (AIX and Linux) or C:\aiw\aiw1\resources (Windows) or /usr/lpp/psf/reslib (AIX and Linux) or C:\Program Files (x86)\Ricoh\PSF\reslib (Windows), so that they are available to all the components of Ricoh ProcessDirector. If you cannot use those directories, you can set the AFP resource path property on one of the steps in the workflow to refer to the directory or directories that hold the resources.

      • The AFP resource path can be set as a default job property on various step templates, including EnableRepositioning, CreatePageRanges, PrintJobs, and ConvertLineDataJobIntoAFP. You need to set the value on only one of the steps; the others inherit the value.
    7. When you are finished updating the workflow, click Save workflow (Save workflow icon).
    8. On the Workflow Objects portlet, select the workflow and click Enable workflow (Enable Workflow icon).
    9. Repeat these steps if you want to create an additional workflow.
  2. On the Ricoh ProcessDirector system, copy and modify a workflow that contains the processing steps that you want the jobs that are submitted by AFP Download Plus to follow.

    To copy and modify one or more workflows:

    1. Click the Workflow tab.
    2. Right-click the workflow that you want to copy and select Copy.
      We recommend using the DownloadAFP and DownloadLineData workflows with AFP Download Plus.
    3. Name the copy of the workflow, fill in or edit other values that you need, and click Continue.
    4. In the workflow editor, right-click each step and select Properties. Modify the properties as necessary.
    5. If the AFP resources (such as fonts, overlays, and page segments) required by the jobs that are processed through this workflow are not going to be sent inline with the input file, make sure that those resources are available to the Ricoh ProcessDirector system. We recommend that you move these resources to /aiw/aiw1/resources (AIX and Linux) or C:\aiw\aiw1\resources (Windows) or /usr/lpp/psf/reslib (AIX and Linux) or C:\Program Files (x86)\Ricoh\PSF\reslib (Windows), so that they are available to all the components of Ricoh ProcessDirector. If you cannot use those directories, you can set the AFP resource path property on one of the steps in the workflow to refer to the directory or directories that hold the resources.

      • The AFP resource path can be set as a default job property on various step templates, including EnableRepositioning, CreatePageRanges, PrintJobs, and ConvertLineDataJobIntoAFP. You need to set the value on only one of the steps; the others inherit the value.
    6. To save and enable the workflow, change Image, the Save & Enable/Disable switch, to the On position.
    7. Repeat these steps if you want to create an additional workflow.
  3. On the Ricoh ProcessDirector system, configure an input device so that it assigns the correct workflow or workflows for the z/OS data sets that it receives. We recommend that you copy and rename one of the supplied Download input devices, then verify or update the settings described below.
    1. Click the Administration tab.
    2. In the left pane, click Devices → Input Devices.
    3. Right-click the Download input device that you want to copy and select Copy.

      • The new input device that Ricoh ProcessDirector creates through the copy action is the same type as the copied input device. You cannot create a new Download input device by copying a hot folder or an LPD input device.
    4. In the left pane, click Show all tabs to display all the properties for this input device.
    5. Verify or update the values for these properties:

      Port number

      The port number that this input device uses to communicate with AFP Download Plus. Make note of the port number that you specify so that you can use it in your routing control data set on z/OS. If InfoPrint Manager for AIX or Windows is also receiving jobs from this z/OS system, make sure you assign a port number that InfoPrint Manager is not using.

      Folder location

      The directory on the primary computer that receives data sets from AFP Download Plus. Make sure that the file system is set up so that the directory you list here is large enough to handle the amount of data that AFP Download Plus sends without filling the file system.

      Staging location

      The directory that Ricoh ProcessDirector moves input files to before they are submitted as jobs. Make sure that the file system is set up so that the directory you list here is large enough to handle the amount of data that AFP Download Plus sends without filling the file system. Remember that there might be two copies of an input file in the system at any time, one in the Folder location directory and one in the Staging location directory.

      Report errors

      Lets Ricoh ProcessDirector report internal processing errors to AFP Download Plus for assistance with problem determination. To use this function, set this property to Yes.

      Send return code to host

      Controls some aspects of communication between Ricoh ProcessDirector and the host system that submits jobs to this input device. Yes means the input device does not complete the transmission from the host system until after it checks the return code that the exit program or script reports.
      • If the return code is zero, the input device reports success to the mainframe and ends the transmission.
      • If the return code is any other value, the input device reports failure to the mainframe and ends the transmission.
      No means that Ricoh ProcessDirector ends the transmission with the host system without checking or reporting the return code.
    6. If the input device needs to accept single or multiple data set jobs:
      1. Set the Submit step property to SubmitInputFiles and the Workflow property to ParentNoPrint.
      2. Determine how you want the input device to assign the workflow for each single job or child job. You can select one of these:
        • Set the Child workflow initialization step property to Not set and set the Child workflow property to the name of an existing workflow to assign the same workflow to every job that this input device processes.
        • Set the Child workflow initialization step property to SetJobTypeFromRules and use the Child workflow parsing rules property to specify the name of the control file that can set the workflow from a JCL parameter value.
          Ricoh ProcessDirector provides a sample control file that uses the values of JCL parameters to set the workflow. The sample control file, called receive_jcl_jobtype.cfg, is installed in the /aiw/aiw1/samples/rules/ (AIX and Linux) or C:\aiw\aiw1\samples\rules\ (Windows) directory. You can copy that file to the /aiw/aiw1/control_files/rules/ (AIX and Linux) or C:\aiw\aiw1\control_files\rules\ (Windows) directory and modify it to meet your needs, then update the value of the Child workflow parsing rules property to point to your file.
        • Set the Child workflow initialization step property to SetJobTypeFromFileName and use the Child workflow pattern property to specify the string that Ricoh ProcessDirector should look for in the input file name and use as the workflow name. If you use this method, you must make sure that a workflow with the corresponding name exists.
  4. On z/OS, use the AFP Download Plus documentation to install AFP Download Plus. Configure the AFP Download Plus sender to send jobs to Ricoh ProcessDirector using the configuration information provided in Print Services Facility for z/OS: AFP Download Plus (S550-0433).
    When you define the JES work-selection criteria for each FSA, include:
    • On the IPADDR parameter, the TCP/IP address of the parent server that is running the target input devices.
    • On the PORTNO parameter, the port numbers of the target input devices.
  5. Start the AFP Download Plus sender and FSAs.
  6. If in a previous step you created a control file that sets job scheduling properties such as Class, Form, or Destination based on the JCL parameters of the job, make sure that the corresponding scheduling properties are set on the target printers in Ricoh ProcessDirector. If the scheduling properties do not match, the jobs cannot be automatically scheduled to those printers.
  7. On the Ricoh ProcessDirector system, make sure that the input devices that you created to receive jobs from AFP Download Plus are connected and enabled.
  8. On the z/OS system, submit jobs to Ricoh ProcessDirector. If errors occur, correct the errors that messages from z/OS or Ricoh ProcessDirector identify.
 
Copyright © 2006, 2018