Scheduling a PATROL PSL Script for Execution

This task provides information on how to schedule a script for execution via PATROL PSL. You can schedule an existing script for execution, or schedule a script that does not yet exist for execution.

If you schedule a script with incorrect information (for example, a non-existent script, or one that resides in a directory that is different from the one you specified) for execution, PATROL will attempt to execute it at the scheduled time. However, the execution will fail, and the script will not run.

Before you begin

Ensure that the following requirements are met:

• The PATROL Agent must have read and execute permissions for the script that is being scheduled for execution.
• The PATROL Agent must have write permissions for all output files, if you are creating a script with output files.

To schedule a script for execution via the operating system command line processor

Access the Scheduler application menu as described in Accessing-KM-Commands-and-InfoBoxes.

1. Select Schedule Tasks from the pop-up menu.  The Schedule-Tasks-dialog-box is displayed.
2. In the Actions group box, highlight Schedule New Task and click Accept.
3. The Schedule-New-Task-dialog-box is displayed.
4. Select the Schedule a PATROL PSL Script option button and click Accept.
5. In the Execute Script at group box, use the spinner buttons or type a value in the following fields to schedule the script:
   
   • Month—indicate the month in which the script should execute
   • Day—indicate the date on which the script should execute
   • Year—indicate the year in which the script should execute
   • hh—indicate at which hour of the day the script should executeEnter hours in military time. For example, if you want to schedule a script to execute at 4 P.M., enter 16 in this field.
   • mm—indicate at which minute the script should execute
   • ss—indicate at which second the script should execute
6. If you want to set the script to occur at regularly scheduled intervals, use the spinner buttons or type values in the following fields of the Repeat Execution group box:
   
   • Days—indicate the number of days that should pass between script executions
   • hh—indicate the number of hours that should pass between script executions
   • mm—indicate the number of minutes that should pass between script executions
   • ss—indicate the number of seconds that should pass between script executions

7. Select the Execute Once Immediately option button if you want the script to execute now.

   Note

   If you do not select this option and you are scheduling a script that was supposed to run in the past, it will not run again until the repeated execution runtime. For example, if you have a backup script that is supposed to run every Sunday evening, but you fill out this dialog box on a Monday morning, PATROL will not run the script until the next scheduled execution. You must toggle the Execute Once Immediately button on to run the script now.

   
   

8. In the Internal PSL Process Name field, type the name of the PSL process that will be run with the script. For more information on PSL process names, look up the PslEexecute() function in the PATROL Script Language Reference Manual Volume 2—PSL Functions.

9. In the Script File Name field, type the full path and file name for the script.

   Note

   If you enter an incorrect file name and path, the patrol scheduler file name dialog box will display when you click Accept. This dialog box prompts you to correct the file name and path, or schedule the task as-is.If you schedule a script with incorrect information (for example, a non-existent script, or one that resides in a directory that is different from the one you specified) for execution, PATROL will attempt to execute it at the scheduled time. However, the execution will fail, and the script will not run.

10. In the Write Compile Errors To field, type the full path and file name for the error output file. This field is optional.

    Note

    If you specify an error output file name in this field, the PATROL Agent must have write permissions for the output file.

11. In the Write Compile Warnings To field, type the full path and file name for the warning output file. This field is optional.

    If you specify a warning output file name in this field, the PATROL Agent must have write permissions for the output file.

12. Click Accept. The dialog box closes, and PATROL schedules the script for execution.

Related topics

Modifying-an-Existing-Scheduled-Script

Using-the-PATROL-KM-for-UNIX-to-Schedule-Tasks-for-Execution