PJP Documentation > Reference Manual Menu
The Process Detail Screen gives the user the ability to:
- Enter and update scheduling and execution parameters for an individual process.
- Stack inputs for processes which require user input.
|
|
||
|
Phantom Console – Process Detail Screen
02/28/2005 22:36:05
|
||
|
CCI –
RTN_FILES |
||
|
|
||
|
Run Instruction:
ABC.RETURN.FILE |
||
|
Cycle: M-F |
||
|
Time: 03:15 |
||
|
Max Run Time: 00:45 |
||
|
Override Next Launch: |
||
|
Email on
Completion: john.george@cubsconsulting.com;marc.kahn@cubsconsulting.com |
||
|
|
||
|
Stacked
Inputs: 01. Y |
||
|
02. @DATE-1 |
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
(/)change, (F)ile,
e(X)it: |
||
|
|
||
Run Instruction: Enter the instruction for the process to be run, as if entering it from TCL. It can be a MD item, cataloged program name, or other, such as “RUN PL XXXXX”. Remember that 2 processes within the same phantom can’t have the same run instruction.
Cycle: Enter specific days of the week, separated by semicolons (M;TU;W;TH;F;SA;SU). Available shortcuts are:
A range of days (i.e. M-F or TU-SA).
“D” = daily (all days).
“C” = Continuous run, for background processes with X minutes between runs.
“H” = Hourly runs, at a specified number of minutes past each hour.
“Mdd” = Where dd is the day of the month. Run only on the specified day.
“X” = Disable this job, leaving it set up for activation later.
Time: The significance of the value entered here is dependent upon the “Cycle” option chosen above.
For a cycle of “C” (continuous runs)
Enter the number of hours and minutes (HH:MM) to wait between runs of this process (i.e. 10 minutes should be entered as “00:10”)
For a cycle of “H” (hourly runs)
Enter the number of minutes past the hour to run this process (i.e. 00:15 will cause the process to run at quarter past each hour).”
For all other cycle options:
Enter the time to run this process (in 24 hour military time).
Max Run Time: Enter the maximum expected duration for this process to run. This will be used to determine whether or not a phantom is hung, so please enter a realistically high number. Enter the time in the format HH:MM (i.e. 30 minutes should be entered as “00:30”).
Override Next Launch: There are 2 prompts here, one for a date and, if a date is entered, another for the time.
For the date prompt, enter the date to run this process next, skipping the normal cycle.
For the time prompt, enter time to run this process next, on MM/DD/YY. Time must be in 24 hour format HH:MM and must be in the future.
Note: The override next launch feature is rarely if ever used. It was originally designed to help the phantom administrator recover from a system failure by allowing the re-scheduling of processes which should have run, but didn’t, while the system was down. In practice, missed processes are typically executed manually from TCL.
Email on Completion: Enter email addresses, separated by semi-colons (;), for people to notify when this process is completed. There are only 56 characters available in this field. Frequently, that is not enough characters to enter all of the desired recipients for the email. If the field is too short, the recommended solution is to set up an email recipients group on your email server. Enter the email address of the recipients group here.
The stacked inputs are a bit like having a screen within a screen. They have their own command prompt at the bottom, and the ability to enter up to 99 inputs for the process to be executed.
The purpose of stacked inputs is to allow you to run programs which require user input.
Important Note: Depending upon the process being run, stacked inputs may prove to be troublesome. Click here for details.
Stacked Inputs Command Prompt Options:
(N)ext, (B)ack, (A)dd, (I)nsert, (D)elete, nbr, e(X)it:
N: Next page. Used if there are more stacked inputs than fit on a single page, and this is not the last page.
B: Back a page. Used if there are more stacked inputs than fit on a single page and this is not the first page.
A: Add a stacked input to the end of the existing ones.
I: Insert a stacked input before an existing one. To put a new one on the end, see “A” above. To move a stacked input, it is necessary to delete it and insert it into the right place. After entering “I”, a secondary prompt will ask you to specify which stacked input line number to insert before. If you would prefer to go a bit faster, you can enter Inn where nn is the line number before which you would like to insert the new line.
D: Delete a stacked input line. After entering “D” a secondary prompt will ask you which stacked input line number to delete. If you would prefer to go a bit faster, you can enter Dnn where nn is the line number to delete.
nbr: Go to that line number to modify the existing stacked input value. That line number must exist or an error message is displayed.
X: Return to the main Command Prompt for the Process Detail screen
Stacked Input Options: Enter the input expected by the program, in the order that it is expected. You can enter a literal constant or one of the following symbolic values:
@ENTER: For an empty input field. It’s not good enough to enter an empty field here because the program will interpret that as no entry at all.
@DATE: For the current date, in the format MM-DD-YYYY.
@DATE+n: For the current date plus n number of days, in the format MM-DD-YYYY.
@DATE-n: For the current date minus n number of days, in the format MM-DD-YYYY.
@DATE=BOM: For the first date of the current month, in the format MM-DD-YYYY.
@DATE=EOM: For the last date of the current month, in the format MM-DD-YYYY.
/: Slash at the command prompt will take you back to the first prompt at the top of the screen
.
F: F at the command prompt will permanently save the changes that you have made and return you to the phantom detail screen.
X: Return to the Phantom Detail Screen. If there have been changes made to this process which haven’t yet been saved, you will be prompted to enter “X” again to confirm your desire to lose the changes.
Copyright 2008, Cubs Consulting, Inc.