Converting Robot/SCHEDULE Command Jobs that Contain the Robot/CLIENT RCLEXEC Command to Robot/SCHEDULE Enterprise Agent Jobs

This Help/FACTS describes how you can convert your existing Robot/SCHEDULE command-type jobs that use the Robot/CLIENT RCLEXEC command to Robot/SCHEDULE Enterprise Agent jobs. The conversion process helps you identify where the RCLEXEC command is used and then performs the conversion to Robot/SCHEDULE Enterprise.

Note: This process addresses only the RCLEXEC command found in private command sets in Robot/SCHEDULE jobs. It does not address shared command sets that include the RCLEXEC command, or other Robot/CLIENT commands used in Robot/SCHEDULE jobs or elsewhere on your system. 

Before You Begin

The conversion process consists of two commands. The commands and supporting objects are in a save file that you can download from the Help/Systems website. After restoring the RBTCVTLIB library from the save file on your IBM i system, the following commands are available:

• RBTRCLRPT (Convert RCLEXEC Jobs Report)—Creates a series of reports that show how each Robot/SCHEDULE job that contains the RCLEXEC command will be converted to an Agent job. You must run this command before you start converting any jobs that contain the RCLEXEC command so you know exactly how the resulting jobs will be set up. The command produces multiple reports for each Robot/SCHEDULE job that will be converted.
• RBTCVTRCL (Convert Jobs with RCLEXEC Cmd)—Converts your existing Robot/SCHEDULE jobs that use the Robot/CLIENT RCLEXEC command to Robot/SCHEDULE Enterprise Agent jobs. Note: Robot/SCHEDULE Enterprise must be installed on your system and the Agent(s) connected to the system to run the conversion.

Both of these commands allow you to specify selection criteria that identify the jobs to report on and/or convert. The original jobs are not changed either by the report command or the conversion process.

Only the following RCLEXEC commands found in Robot/SCHEDULE private command sets qualify for conversion:

• RCLEXEC
• *LIBL/RCLEXEC
• RBTRCLLIB/RCLEXEC

The RBTRCLRPT and RBTCVTRCL commands generate the following reports. You should review these reports carefully and make any necessary changes identified in the reports before proceeding with the conversion.

• Ineligible Jobs Report (RBTRCLXP4)
  Lists the Robot/SCHEDULE jobs that meet the selection criteria, but are ineligible for conversion because they use shared command sets or contain a nested job.
• Error Report (RBTRCLXP3)
  Lists Robot/SCHEDULE jobs that meet the selection criteria but have at least one error that prevents the job from being converted.
• Warning Report (RBTRCLXP2)
  Lists information about Robot/SCHEDULE jobs that contain setup information that is not carried over from the original job to the new jobs. Warnings do not prevent a job from being converted; however, you must review the new jobs and set up any of the conditions that you want to maintain. The following conditions issue a warning:
  • Reactivity (a job is a prerequisite job, or dependent on another job)
  • Group membership
  • Jobs that have job monitors defined
  • Jobs that are referenced in an OPAL object
  • Jobs that contain report distribution information
• Successful Report (RBTRCLXP1)
  Lists all Robot/SCHEDULE jobs that will be converted by the RBTCVTRCL command and the jobs they’ll be converted to.

You also need to identify any Robot/SCHEDULE commands (such as AUTORUN, RBTBCHUPD, and SNDRBTDTA) or queries that reference the original job number and modify them so that they refer to the new job. The Robot/SCHEDULE Enterprise Analyze Robot/CLIENT Usage (RBEANZRCL) command helps you to identify which commands you need to change. (See the Additional Information section for more on the RBEANZRCL command.)

When you run the conversion, it creates new jobs as shown in the reports. The new jobs are placed on Hold and have an Application Code of RBTCVTRCL for easy identification. Review all new jobs to ensure they are set up properly before releasing them.

The conversion also creates new groups, when necessary. The conversion uses groups to maintain a sequence of tasks (jobs) that are as close as possible to the original job. The groups have 10-character names with the format GRPnnnnnnn, where n is a numeric value starting at 1 (for example, the first group created is named GRP0000001, the next is GRP0000002, and so on). Groups are created as follows:

Note: The RBTRCLRPT command does not create groups, but it does identify the jobs for which groups will be created during a conversion. The Successful Report indicates which jobs will require groups with the text “pseudo” in the New Group Name column.

The RBTCVTRCL command requires a mapping of each Robot/CLIENT system name to a Robot/SCHEDULE Enterprise Agent. Use the Robot/SCHEDULE Add Client Agent Map Entry (ADDCAMAPE) command to define the mapping entries before running the conversion.

Notes:

1. You can use the Display Client Agent Map (DSPCAMAP), Change Client Agent Map Entry (CHGCAMAPE), and Remove Client Agent Map Entry (RMVCAMAPE) commands to display, modify, or remove existing entries. Note: You must be on Robot/SCHEDULE R10M28 or higher to use these commands.
2. You must have Agent environments defined for each Agent that will be mapped.
3. The RBTRCLRPT command does not use the mapping entries. However, setting up the mapping entries in advance provides a more realistic representation of what the conversion actually will do.

Requirements

You should be aware of the following before starting a conversion project:

• The user profile that runs the commands must have *ALLOBJ special authority.
• Robot/SCHEDULE must be at release R10M28 or higher to run the RBTCVTRCL command.
• Only one user can run the RBTRCLRPT or RBTCVTRCL commands at a time.
• You must run the RBTRCLRPT command at least once before running the RBTCVTRCL command.
• Some files in the RBTCVTLIB library contain historical information from each time you run the RBTRCLRPT and RBTCVTRCL commands. After you’ve completed your conversion project, you can delete the library from your system.
• We do not recommend mirroring the objects in library RBTCVTLIB.

Steps to Convert RCLEXEC Jobs

If Robot/SCHEDULE Enterprise is not installed on your system, you can run only the RBTRCLRPT command to create reports. If Robot/SCHEDULE Enterprise is installed, you can run both the reporting command, RBTRCLRPT, and the conversion command, RBTCVTRCL. Note: Robot/SCHEDULE Enterprise must be installed to create Agent job types using the conversion command.

Note: You can run the RBTRCLRPT and RBTCVTRCL commands multiple times to ensure that all your Robot/SCHEDULE jobs that contain the RCLEXEC command are converted properly. 

Additional Information

Using the RBEANZRCL Command
The Robot/SCHEDULE Enterprise Analyze Robot/CLIENT Usage (RBEANZRCL) command is designed to help you prepare to migrate from Robot/CLIENT to Robot/SCHEDULE Enterprise. It can search for instances of all, or specific, Robot/CLIENT commands, as well as Robot/SCHEDULE commands that contain the AUTORUN, RBTBCHUPD, and SNDRBTDTA commands. You can search Robot/SCHEDULE private and shared command sets, and CL source code in source files.

For the purposes of this Help/FACTS, you should search for instances of the RCLEXEC command in all locations. To run the command, enter RBEANZRCL on a command line and press F4 to display the command prompt panel. Press F1 to display the command help for more information. 

The RBEANZRCL command generates a report (RBE4091P) that lists all the jobs that contain the RCLEXEC command. Because these jobs are not converted when you run the RBTCVTRCL command, you must modify them manually.

The RBEANZRCL command ships with Robot/SCHEDULE Enterprise 1.15 or higher. It also is available in the RBEANZRCL save file that you can download from the Help/Systems website.

Note: The RBEANZRCL command can identify where all Robot/CLIENT commands are used. Running the command for all Robot/CLIENT commands (*ALL) helps you to determine the scope of a conversion to Robot/SCHEDULE Enterprise.

Updated: October 28, 2011