The Schedule Batch Job command allows you to schedule a batch job for isometric extraction.
1. Select the Schedule Batch Job button from the Batch Environment form.
The system activates the Schedule Batch Job form.
2. Batch Input File
Key in the name of the batch input file that was previously created using the Create Batch Job Input command from the Batch Environment form. Blank fields in the file specification will be defaulted according to the current default directory.
If the file name does not exist, an error message will be displayed at the bottom of the form.
If the file name is valid, the remaining fields in the form will be given default values with the exception of the Run Time fields.
Batch Isometric Extraction 5 - 101
3. System Log File
Key in the name of a log file.
This field allows you to create a log of the command execution as the job processes in batch. This log is useful when you are having difficulties getting the batch software to operate. It contains a log of all error messages issued by the various software modules used to create an isometric.
The System log file (.job file) is different from the batch log file (.log file) created by the batch procedure. The system log file is named using the batch input file name together with a file extension of .job. The batch log file contains an entry for each attempted run together with an error code and/or message when the run fails.
All .job and .log files are written to the same directory as the batch job input file. If this is not the case, have your system administrator check the hosts.nqs file to verify write permissions.
If the batch job input file name remains the same, the .log file will maintain a cumulative history of each successive run.
4. Job Name
Key in a batch job name. This is the name for the batch run which will show up in the batch queue when you key in the qstat PDisocreatecommand. The default job name is the batch input file name.
5. Process Queue
Select one of the queues from the pull down list. The selected batch queue will extract the lines as defined in the batch input file.
The queues displayed in the Process Queue field are chosen first from the queues defined in the PDiso_batch portion of the queue_descript file (located in the project directory). If no queues are defined in the queue_descript file, the system generates a Process Queue list from locally defined queues.
Valid queue names include: PDiso_batch, PDiso_bat_1, PDiso_bat_*.
6. Mail Notify
Key in the email path of the machine that will be sent a mail message when the batch iso processing completes. A default for this field is provided by your system manager when the iso extraction product is installed on your system.
The mail message contains the identification of the batch job input file, the Project Control Database name, a brief error message, and an error code. The error code is explained in more detail in Appendix A.
7. Plot Queue
Select one of the queues from the pull down list. This field is only displayed if the file defined in the Batch Job Input File field was created with the Submit for Plotting toggle turned on. Refer to Create Batch Job Input, page 5 - 89 for more information on defining batch job input files.
The queues displayed in the Plot Queue field are chosen first from the queues defined in the PDiso_plot portion of the queue_descript file (located in the project directory). If no queues are defined in the queue_descript file, the system generates a Plot Queue list from locally defined queues.
If locally defined queues are used, only the pipe queues that are defined will be displayed in the Plot Queue pull down list. To display local device queues, create a pipe queue that points to the device queue.
Valid queue names include: PDiso_plot, PDiso_plot_1, PDiso_plt_*.
8. Plot Copies
Keyin the number of copies to be plotted for each extracted line.
9. Do Not Generate PDME Data / Generate PDME Data When set to Generate PDME Data, ISOGEN creates a
<isogen_drawing_name>.p<sheet_no> file for each extracted iso sheet in the iso output directory. The resulting .pXX file is used when exporting data to PDME (Plant Data Maintenance Environment). Refer to the Export to PDME command in the PDS Project Administrator document for information.
When using this option, Intergraph options 4 (ISOGEN component vs sheet number file) and 20 (Intergraph MTO Neutral File) must be set to 1 (active).
10. Do Not Extract Existing Sheets / Re-Extract Existing Sheets
When set to Do Not Extract Existing Sheets, ISOGEN extracts the line and
determines the amount of information that will be placed on each sheet and splits them accordingly.
When set to Re-Extract Existing Sheets, ISOGEN extracts the line normally.
However, unlike the previous toggle setting, the system honors the previous extraction’s pagination. Refer to Repeatability, page 15 - 1 for additional information.
This toggle should be set to Do Not Extract Existing Sheets if extensive changes are being made to a pipeline. If extensive revisions are made to a line and the previous pagination is honored, the result may be a sheet that contains too much information to decipher.
11. Do Not Save Sheet Extraction Data / Save Sheet Extraction Data
When the toggle is set to Save Sheet Extraction Data, the system generates and stores repeating data in the project and design databases. Repeating data includes such information as: traversal startpoint (saved to the project database) and the extracted item’s iso sheet number (saved to the design database). Refer to Repeatability, page 15 - 1 for additional information.
This toggle should be set to Do Not Save Sheet Extraction Data until the design is stable and your isometrics are ready to be issued for the first time.
Batch Isometric Extraction 5 - 103
12. Verify On / Verify Off toggle
Select the Verify On option to turn on batch job verification.
Select the Verify Off option to turn off batch job verification.
When verification is on, a log of all system commands executed by the batch extraction procedure is saved in the iso output directory.
Do not enable verification when large numbers of iso’s are being created since the resulting log files will use a large amount of disk space.
13. Debug On / Debug Off toggle
Select the Debug On option to enable the debugging logic in the batch job.
Select the Debug Off option to disable the debugging logic in the batch job.
The debugging logic causes the values of several batch procedure variables to be displayed in the system log file. This option is useful for tracking down problems or submitting problems to Intergraph.
14. Submit Batch Immediately/Delay Batch Submit Time toggle
Select the Submit Batch Immediately option to run the job immediately.
Select the Delay Batch Submit Time to specify a run time for the job. Define the run time by keying in the day of the week (Mon, Tue, etc.), the time and then select AM or PM.
15. After all fields contain the appropriate information, select the accept button.
As described earlier, a batch job log file (containing an entry for each attempted
extraction) is created and updated as the batch job executes. Examine this log after the job finishes to see that all drawings were successfully completed. When drawings fail, consult Appendix A for a more detailed explanation of the error code and message found in the log file. Also, check the .err files produced by the ISOGEN interface to make sure that the drawings do not contain errors.
The batch shell marks each entry in the batch job input file as it is processed.
Therefore, the batch procedure can be stopped and then restarted at any later time without causing drawings that have already completed to be rerun. If the system goes down and the job is not restarted automatically, it can be restarted using the Schedule Batch Job command. Drawings that have already been created will not be re-executed.
__________________________________________________________________________________________________________________________________________________
5.3.12 Reports
The Reports command allows you to define the report type and to choose whether or not an area or drawing will be included in the report.
Before reports can be printed, a pipe queue named PDprint must exist. For information on creating pipe queues for PDS, refer to the section Printer/Plotter Setup in the PD Project Administrator (PD_Project) Reference Guide.
1. Select the Reports button from the Batch Environment form.
The system displays the Batch Data Reports form.
2. Key in the report filename in the Output File field. If the system default variable, ISOREPORT, is exported in the control.sh file, the system will default to that value.
For example: ISOREPORT=node:/usr/directory.
3. Choose a report type.
Batch Isometric Extraction 5 - 105
Area Summary
creates an area summary report which shows all of the data associated with one or more piping areas. This report lists information such as:
Equipment Areas Continuation Areas The Current Default Set User Data
Default (Options) Summary
creates an options summary report which shows all default sets. This report lists information such as:
ISOGEN Project Options
Information on Each Default Set (such as the seed file, plot file, the default output path and border file defined for each default set)
Drawing Summary
creates a drawing summary report which shows selected data about each drawing that you are reporting. This reports lists information such as:
Drawing Number
creates a revision history report which shows the revision dates for each revision of the drawings being reported. This report lists information such as:
Line Number Type of Isometric Drawing Number
List of Drawing Revision Dates (up to the last five) Search Criteria:
The following are search criteria that can be used separately or together to locate a drawing or group of drawings within an iso area. All defined search criteria must be met before a drawing can be included in the report list.
If no search criteria is defined, the system generates reports on the entire project control database.
Iso Area
Key in the name of the iso area that you want to extract lines from.
— OR —
a. Select the Iso Area List button.
The system displays the Iso Areas form.
b. Select the appropriate iso area and the accept button.
The system returns to the Batch Data Reports form with the selected area in the Iso Area field.
If you want to restrict the list further, you must supply additional criteria such as batch reference numbers and drawing numbers.
Batch Isometric Extraction 5 - 107
Type
Select the Type field gadget and select the appropriate isometric drawing type. Using this option will help limit the number of drawings displayed.
Batch Reference
Key in the batch reference number of the lines you want to extract.
— OR —
Select the List Drawing button for a list of batch reference numbers.
To use batch reference numbers as criteria, specify them in individual drawing records when adding drawing records to the Project Control Database.
Model Status Code
Key in the status code if you want to restrict a list to all lines of a given status.
Drawing Number Low / Drawing Number High
Drawing Number High and Drawing Number Low define, by drawing number, the range of lines to extract.
Key in a drawing number in each field to identify the lines to extract.
— OR —
a. Activate a cursor in the Drawing Number Low field by placing a data point.
b. Select the Drawing List button.
The system activates the List Drawings form.
c. Select the drawing that will represent the low drawing number and select the accept button.
The system returns to the Batch Data Report form with the selected drawing displayed in the Drawing Number Low field.
d. Repeat the above steps for the Drawing Number High field.
4. Model Revised Date toggle field
Select the Use Model Revise Date option to specify that only lines whose Model Revised date is greater than the last drawing revision date can be included in the list of lines to extract.
5. Select one of three print options.
Print/Delete Print/Save Save
If the Print/Delete or Print/Save option is selected, the system displays a scroll field that lists available printing queues.
Batch Isometric Extraction 5 - 109
Select a print queue. If there is no queue connected to the client workstation, the system defaults to the Save option.
6. Select the accept button.
The system initiates report generation.
Interpreting the HITS Report 6 - 1
__________________________________________________________________________________________________________________________________________________