OB Resubmission Procedures

OVERVIEW

Observing in Service Mode:
Philosophy and Scheduling

OBs needing modification

Once your OBs and README file have been submitted to ESO, you have completed your Phase 2 submission, and you have notified ESO by pressing the p2pp-submit button in P2PP, the status of your OBs will be changed to prevent them from being checked out.

It is possible that during the Phase 2 package review process the support astronomers discover problems with your OBs or your README file that require their modification. Also, problems may be discovered only at the execution time, requiring the OBs to be modified before their execution can be attempted again. In such cases you will be notified by ESO. If the OBs or any of their components need modification, their status will be changed so that you can check the OBs out, implement the required changes, and check them in again. Likewise, if the README file needs to be modified, you will be contacted by your support astronomer so that you check out, modify, and check in again your README file.

This webpage describes step-by-step procedures for the modification and resubmission of OBs and README files. More detailed information on each of the operations involved can be found in the P2PP User Manual.

Checking out OBs and restoring them to the ESO Database

The procedure to modify your OBs can be summarized as follows:

Start P2PP
Select the folder that contains the OBs to be modified. If you are using the same P2PP installation where you prepared your OBs, they will appear displayed in the P2PP main GUI with a lock icon next to their name in the OB Summary grid. The icon means that these OBs, which reside in the Local Cache, have been submitted to the ESO Database. You cannot make the modifications directly on these OBs; instead, you need to check out the copies of the OBs that exist in the ESO Database, as explained below. Note that you do not necessarily have to be working from the same installation where you prepared your OBs, as you can check out your OBs from any P2PP installation.
To check out your OBs, start the ESO Database browser by selecting File > Check-out....
When the ESO Database browser widget appears, choose the information to be displayed that allows you to easily select and recognize the OBs that you wish to check out. For instance,
```
        Selected Columns: Name, ProgID, PIName
        Selection Criteria: Period = XX (e.g. 78)
```
Click on the Query button. All your OBs submitted for the selected Period will be displayed.
When the query is completed, select the OBs you need to modify.
Once you have selected the proper OBs, select File > Check-out in the ESO Database browser menu bar. Your OBs will be unlocked in your P2PP OB Summary grid and deleted from the ESO Database.
Make whatever modifications are necessary by highlighting the OBs to be modified, viewing their contents with the View icon, and editing them in the View OB window.
To save your modified OBs back to the Garching database, select them in the OB Summary grid and then select File>Check-in
Notify ESO by pressing the p2pp-submit button in the P2PP main GUI.
Exit P2PP

Resubmission of modified finding charts and ephemerides files

Finding charts and ephemeris files are submitted as integral parts of the OBs. Therefore, requests for changes in the finding charts require checking out the OBs that use them and following the procedure described above for OB modification and resubmission, with the following specific steps:

To modify the finding chart or ephemeris file, detach the original one from the checked-out OBs.
Produce a correct finding chart (in JPEG format) or ephemeris file.
Attach the corrected finding chart or ephemeris file to the affected OBs, and check them in when this is done.

Note about file naming: It is important to note that a one-to-one correspondence must exist between finding charts or ephemeris files and their contents in the ESO Database. For this reason,

If the finding chart or ephemeris file that you need to replace is still valid for other OBs in the Database belonging to the same run that have not been checked out, the corrected finding chart or ephemeris file must be given a different name. Otherwise, two finding charts or ephemeris files with the same name but different contents would exist, which is not allowed.
If the new finding chart or ephemeris file has a content identical to another file already existing in the ESO Database for the same run (for example, if a finding chart for a different object was attached by mistake in one of a series of OBs with the same target), the name of the correct file must be the same as that of the files already in the Database that have the same contents.

Modifying the README file

README files are prepared and submitted from P2PP. If the README file needs to be modified the steps are as follows:

Select the CheckOut Readme option under the Readme menu in the P2PP main GUI. The lock symbol on the Readme button in the P2PP main GUI will disappear.
Correct the content of the Readme file as needed.
Once a correct Readme file has been produced, use the CheckIn Readme option under the Readme menu in the P2PP main GUI to resubmit the Readme file to the ESO Database.