Create Batch Job Input - PDS - Reference

Plant Design System (PDS) ISOGEN

PPMProductFamily
3D Design and Visualization
PPMProduct
PDS
PPMCategory
Reference
Version_S3D
12.x(2018)

To extract isometrics using the batch software, you must create a batch job input file. The batch job file is an ASCII data file that is submitted to the batch extraction software as an input file.

You create the batch input file by identifying which lines to create drawings for and setting the options that determine how the job will be processed. Lines can be selected for the batch input file using one of two methods. These include defining search criteria to select large groups of lines and selecting lines by line ID.

Once a batch input file is created, it can be scheduled by using the Schedule Batch Job command. Refer to Schedule Batch Job for more information.

  1. Select the Create Batch Job Input button from the Batch Environment form.

    The system displays the Create Batch Job Input form.

    When the accept button is selected on this Create Batch Job Input form, line ID records will be written to the batch job input file using this form's current search criteria. Be sure that you do not select accept on this form unless you have set the appropriate search criteria. Select cancel (X) to exit the form without writing line records.

  2. Batch Job Input File

    Key in the batch job input file name. If a file name is not keyed in, the system options to the exported variable ISOBATCH.

    The system checks that the existing file is a valid batch job input file and that it was generated from the same Project Control Database.

    If the file already exists the system will display the Overwrite, Append and Review/Edit buttons. Select Overwrite to overwrite the batch input file, or select Append to append the information to the existing batch input file information. Select Review/Edit to display the batch input file in the default editor.

    The default editor is notepad. You can use the export variable PD_EDITOR to define a different default editor.

  3. Default Set Option

    Select the Default Set Option field to select another default set from the Isometric Extraction Default Sets form.

    Select a default set from the form and select the accept button.

    The system returns to the Create Batch Job Input form and displays the selected default set and description in the Default Set Option field.

  4. Delete Existing Files / Save Existing Files toggle

    If the Delete Existing Files option is selected, the system will overwrite all miscellaneous files that were created as a result of a previous isometric generation. These files include any ISOGEN output you have enabled using the options file and error message files produced by the ISOGEN software.

    If the Save Existing Files option is selected, the system will not delete any of the generated miscellaneous files.

    This toggle will not purge old versions of the MTO neutral files. The batch extraction software uses the extraction number to name the neutral files.

    Example:

    The MTO neutral file named as follows:

    iso name + sheet number + .b + extr number

    indicates that an MTO file named CW10022.b7 is the MTO neutral file for ISO CW1002, sheet 2, from extraction number 7.

    As shown in the above example, the MTO neutral file generated by the ISOGEN interface is split up into multiple files by the batch extraction software. Each new MTO file contains the material associated with a single isometric drawing sheet.

    If you choose not to delete the existing files, the existing ISO will be copied to "output path"/isolast/.

  5. Do Not Save Details/Save Previous Details toggle

    If the Do Not Save Details option is selected, the system ignores any previously added graphics.

    If the Save Previous Details option is selected, the system adds all manually added MicroStation graphics of the previous isometric drawing version to the new version.

    Before using the Save Previous Details option, the MicroStation file, edg.exe, must be loaded locally to the workstation that will be used to process the isometric drawings.

    The software looks in the output directory (as specified in the area level data) for each drawing sheet as it is produced. If a drawing sheet is found, then all graphics that reside on levels 0 and 60 through 63 are merged into the new version of the drawing. This allows you to add manual details that will be retained from version to version of the drawing.

    Some changes, particularly those made to the isometric drawing itself, will not be acceptable or correct when merged into a new version of the drawing.

  6. Submit for Plotting / Do Not Plot toggle

    If the Submit for Plotting option is selected, the selected isometric drawings will be submitted for plotting.

    A Plot Request file name must be specified in the default set. For more information, see Define Default Sets.

    If the Do Not Plot option is selected, none of the isometric drawings will be plotted.

  7. Increment Revision Number/Do Not Increment Revision Number toggle

    If the Increment Revision Number option is selected, the system will update the drawing revision block when an isometric is successfully generated.

    If you plan to export the isometric drawing documents to PDME (Plant Data Maintenance Environment), the revision toggle must be set to Increment Revision Number. For more information on exporting isometric drawing documents, refer to the PD Project Administrator (PD_Project) Reference Guide.

    If the Do Not Increment Revision Number option is selected, the system will not update the revision block. You will encounter problems later when attempting to delete a drawing if a revision history does not exist for a drawing. Refer to Delete Drawing for more information about deleting drawings.

    When the batch job is run, the system will use the inputs for By, Chk, Date and Descr to update the revision block for the drawing in the Project Control Database.

  8. By, Chk, Date, Descr

    To increment drawing revision numbers, key in information to these fields to specify the revision block data.

    The data will be written back to the Project Control Database only if the isometric is successfully extracted. If you leave the Date field blank, the current date will be used.

    The Date field allows you to specify an issue date for the isometric that is different from the current date. If, for example, you are extracting a number of drawings over a period of a few days for issue on a given date, you should key in that issue date to this field.

    Rather than key in Chk initials at extraction time, you might want to update the Project Control Database with Chk and Aprv initials after the drawing has been plotted.

    Up to 60 characters can be entered into the field "Desc", which will be written to the third line of the Batch Job Input File and, if the batch extraction succeeds, will be written to the table pdtable_186 in the project database.

  9. Search Criteria

    Search criteria 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 an isometric extraction.

    • Type

      Select the Type field gadget and select the appropriate isometric drawing type. Using this option will help limit the number of drawings displayed.

    • Iso Area

      Key in the name of the ISO area that you want to extract lines from.

      OR

      1. Select the Iso Area List button.

        The system displays the Iso Areas form.

      2. Select the appropriate ISO area and the accept button.

        The system returns to the Create Batch Job Input form with the selected area in the Iso Area field.

        To restrict the list further, you must supply additional criteria such as batch reference numbers and drawing numbers.

    • Batch Reference

      Key in the batch reference number of the lines you want to extract.

      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

      1. Activate a cursor in the Drawing Number Low field by placing a data point.

      2. Select the Drawing List button.

        The system activates the List Drawings form.

      3. Select the drawing that will represent the low drawing number and select the accept button.

        The system returns to the Create Batch Job Input form with the selected drawing displayed in the Drawing Number Low field.

      4. Repeat the above steps for the Drawing Number High field.

  10. Do Not Use Model Revised Date / Use Model Revised Date toggle.

    The Model Revised Date is an attribute of pdtable_185 and works in conjunction with the Use Model Revise Date option for extraction. Select the Use Model Revised Data option to specify that only lines whose Model Revised Date is greater than or equal to the last drawing revision date can be included in the list of lines to extract.

    • The Model Revised Date attribute is not used when making modifications inside the piping designer (pdtable_113, for example). If you make any changes in the model, this attribute is not used to extract those modified lines.

    • To change the Model Revised Date, select Revise Drawing > Select the ISO drawing > Change the Model Revised Date on the Revise Single Drawing form.

  11. Once all of the necessary search criteria has been set, select the accept button to begin processing.

    If enabled, the system displays the Write to Batch Input File Cancel/Accept form.

  12. Select the accept button to begin posting the list to the batch input file.

    The Write to Batch Input File Cancel/Accept form is an added feature to help prevent new users from writing an unnecessary number of lines to the batch input file. To prevent the form from being displayed, add the following environment variable:

    In the pds.cmd file, $ENV{’NO_CONFIRM_WRITE_BJ’} = ’anything’;

  13. Select By Line ID

    The Select by Line ID button can be used instead of the various search criteria to select lines for the batch input file. It allows you to select individual lines for extraction as opposed to defining different search criteria to select a specific group of lines.

    1. Select the Select By Line ID button.

      The system displays the List Iso Areas form.

      Select an ISO area and the accept button.

      The system displays a second Create Batch Job Input form which lists all lines contained within the selected ISO area.

      The Rev No field displays the number of the last extracted revision. If the line has never been extracted, the revision number displays as –1. After the line is extracted the first time with the Increment Revision Number option turned on, the revision number displays as 0. After the second extraction, the revision number displays as 1, and so on.

    2. Select the lines to be included in the batch file.

      OR

      Select the Type field gadget and select the appropriate isometric drawing type. Using this option will help limit the number of drawings displayed for selection.

      OR

      Select the Select All button to include all of the listed files in the batch file.

      OR

      Select the Iso Area List button to select a different ISO area from the List Iso Areas form.

      Use the Reset Selection button at any time to cancel all previous line selections.

    3. Select the accept button once all of the appropriate lines have been selected.

      The system activates the third Create Batch Job Input form. The By, Chk, Date and Description fields will be initialized with the input values that were entered in step 8.

    4. If necessary, select the By, Chk, Date, and Description fields on the form and key in the appropriate information for each line.

      If any of the previously mentioned fields are revised, each line is posted to the batch input file with separate option lines. If the fields are not revised, all of the selected lines will be posted to the batch input file under the same option lines.

    5. Select the accept button.

      The system posts the list to the batch input file.

  14. Iso Type

    This field is for review purposes only. It displays the type of drawings that are listed.

  15. Iso Area List

    This button displays the List Iso Areas form. When an Iso area is selected from the form and accepted, the system returns to the Create Batch Job Input form with the ISO area in the Iso Area field.

  16. Drawing List

    This button displays the List Iso Areas form. Once an area(s) is selected and accepted, the systems displays the List Drawings form. Select the cancel button to dismiss the form and return to the Create Batch Job Input form.

  17. Schedule Batch Job

    This button displays the Schedule Batch Job form. Refer to the next section, Schedule Batch Job, for more information.