Home

CIMPLICITY HMI Tracking Operation Manual

1. _ RCV POINT LICIT RE ROP POINT 1 PRE tT EM 1D SUCCESS FAITLURE1 R1_BOX 3 TRANS_PT_1 1 REV POINT 2 CTL RE RSP POINT 2 PRE REFERENCE IDA SUCCESSA PALLUREZ Ri BOX FAFZS EL RCV POINT SCIL ORE RSP POUNT 3 PRI TTEM 1D SUCCESS3 FAILURES R1_BOX 2 1 RCV_POINT_4 CTI_2 RP RSP_POINT_4 SUCCESS4 FATLURE4 Rib BOX RG6 DROP BOXIZTPI I1 RCV POINT 9 CTT RP RSP POINT SIPRI ITEM PD Oe dite RCV POINT 2 6 CTI RP RSP _POINT 6 PRIREFERENCE IDLO Poe ee The above records correspond to points used by CTI to receive data and send responses An example of what the records stand for follows 1 The point RCV_POINT_1 will be used by the CTI process CTI_RP to receive updated PRT data The point RSP_POINT_1 will be used to send responses The response point will contain the value of the PRT_ITEM_ID field as well as either the text value SUCCESS1 for a successful transaction or the text value FAILURE1 for an unsuccessful transaction Items not found in inventory will be added to the RI_BOX region Existing items that are not already in the R1_BOX region will be moved to the RI_BOX region If either an add or a move fails TRANS_PT_1 will be set to 1 It will be up to an operator to reset this point to 0 The first response received when CTI_RP is started and when RCV_POINT_1 transitions from unavailable to available will be ignored The point RCV_POINT_2 will be used by the CTI p
2. IDT file generated by IDTPOP utility v1 0 RECORD PRT_INTPROC Interested Process Data provider mapping 0 prt_svc_id PRT Service ID providing info to above 1 INTPROC SVC_ID Interested Process Service ID 2 update_mask 1 Full O Brief all but auto move APRT DC PRTCNT 1 Service IDT file generated by IDTPOP utility v1 0 RECORD SERVICE SERVICE IDENTIFIERS 0 SERVICE_ID Service Identifier 1 SUBSYS_ID Subsystem Identifier 2 PROCESS_ID Process Identifier PRTCNT PRTCNT PRTCNT master mcp PRTCNT CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Appendix J Troubleshooting Troubleshooting Overview In an effort to continually provide our customers with up to date information on all of our CIMPLICITY products this guide lends solutions for problems with your Tracker system This section will evolve as new solutions arise and new tools are developed GFK 1216F J 1 PRT Interested Process Utility The PRT Interested Process Utility prt_inttest exe is used to ensure that the Tracker system is generating interested processes The utility is configured using a combination of CIMPLICITY and PRT files All files are stored in the master directory and can be edited using the IDTPOP Utility to convert records to ASCII text format The output generated by the PRT Interested Process Utility can be viewed in a Command window from the CIMPLICITY Workbench The following output can be g
3. PRTI_CRESEG_ERR Error creating segment Failure PRTI_BAD_MSG Error in segment Failure PRTI_BAD_SVC_NAME Bad service name no underscore Failure PRTI_XLATE_ERR Error in ipe_xlate getting physical addr Failure PRTI_WRITE_PORT_ERR Error in ipe_write_port Warn Fail 5 48 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_intproc_region Receive updates only from specific regions GFK 1216F Name prt _api_intproc_region Description This function provides a mechanism for a process to request that only specific region data is required A flag is passed to specify if the region should be added replaced or deleted The calling routine receives back a status indicating the success or failure of the request Syntax int prt_api_intproc_region Char region_id COR_U4 action_code CORSTATUS retetat Data Structures None Input Arguments region_id action code Output Arguments retstat Return Value region_id action_code retstat Region that this call applies to Code to specify what action needs to occur Valid values are PRT_FILTER_ADD Add this region_id to filter list PRT_FILTER_REPLACE Replace existing filter region_id with this one if one exists Otherwise add region_id PRT_FILTER DELETE Delete this region_id from filter list Pointer to COR_STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional erro
4. 18 19 20 21 22 23 24 25 26 2 28 4 14 Field Name region_lockable alarm_det_region alarm_region_not _empty alarm_region_lock alarm_loc_cap_excd alarm item hold alarm unknown _ item enable master _alarm_flag enable master _log_flag log_det_region log_region_not empty log_region_stat log_loc_cap_excd log_item_hold log_unknown_item Description Enable disable 1 0 locked region 1 e region must be locked to make modifications or to move items into the region Enable disable 1 0 alarm generation when items are moved to the detainment region Enable disable 1 0 alarm generation when a disperse tracking region is not empty and new items have arrived in the region Enable disable 1 0 alarm generation when an item enters an IN LOCKED region or exits an OUT LOCKED region Enable disable 1 0 alarm generation when the number of items at a single region location exceeds the configured maximum Enable disable 1 0 alarm generation when an item enters a region with an attribute that matches an item hold specification Enable disable 1 0 alarm generation when information cannot be retrieved for a serialized item Enable disable 1 0 alarming for this tracking region regardless of alarming enabled elsewhere Enable disable 1 0 logging for this tracking region regardless of logging events enabled elsewhere Enable disable 1 0 logging when i
5. An affected item has changed since the last display Failure Can not add item to unoccupied location inserting Warning Can not have two serialized items at one location Warning No detainment region configured for Warning Item type identifier NULL Warning Item type identifier not valid Warning ext_proc_flag set for non serialized item Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Parent ID specified for serialized item Warning Group identifier NULL Warning Group identifier not valid Warning External hold specified for non serialized item Warning Internal hold specified without reason Warning Non serialized item has attribute s Warning CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PRTI_NUM_ATTS_INVALID Invalid number of item attributes specified Warning PRTI_REG_ID_NULL Region identifier NULL Warning PRTI_REG_ID_NDEF Region identifier not valid Warning PRTI_INVALID_REG_LOC Invalid region location Warning PRTI_MF_INIT_ERR Error initializing segment Failure PRTI_CRESEG_ERR Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd GFK 1216F Production Tracking Application Interface 5 69 prt_api_modify_region Modify Tracking Region Data Name prt _api_ modify region Description This routine provides a mechanism to modify Tracking Region Data
6. char record_type 3 COR_BOOLEAN ext_proc_flag char region_id 17 COR T2 regIron VOC char item_id 21 char reference_id 21 char item_type_id 17 char parent_item_id 21 COR_U4 item_status COR_BOOLEAN ext_hold_active char group_id 17 COR_BOOLEAN int_hold_active char int_hold_reason 41 char comment 41 char user_or_svc_id 33 ADD If TRUE get all info from ext process for serialized item Region where the item is to be added to the queue or production start is to begin Specific location in the region where the Item is to be added Unique identifier of a serialized item Secondary identifier of a serialized item Item type identifier Associated serialized item identifier Item status If TRUE item held due to external hold Identifier of the Tracking Group providing the reason for the hold If TRUE item held due to internal hold Comment specifying reason for internal hold Comment to be recorded in prt history log file User or service identifier If no Item Attribute information is to be specified for this item the ADD record need not be preceded by any ATT records for filling in elements within the Item Attribute array To specify Item Attribute information see the description of the ATT record type ADV Advance an Item Along a Specified Route The Application Interface call for this record type provides a mechanism for advancing the next Item Carrier to leave a Source Tracking Region to
7. identifier of the group COR IL n m atts valid Number of valid attributes in the list PRTIT_ITEM ATT item_att_list PRT _NUM_ATTRIBUTES Item Attributes pertain to Serialized Items P PRI ITEM STRUCT PRT TTIEM STRUCT Pre Input Arguments list_size Number of array elements allocated for item_list array required item_list Pointer to a buffer to receive returned items required Output Arguments item_list Populated list of Items retstat Pointer to COR_STATUS structure Return Value GFK 1216F Production Tracking Application Interface 5 37 Either COR_SUCCESS COR_FAILURE or COR_WARNING If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTI_TOO_MANY_REQ Total number in list less than number requested Warning 5 38 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_req_regionlist Request List Of Tracking Region Data Name prt_api_req regionlist Description This routine provides a mechanism to request Tracking Region Data for one or more Tracking Regions in a Tracking Region Group residing within all configured PRT services a specific PRT service a specific Tracking Group or a specific Tracking Region If the request is a success the calling routine will receive back a count of the number of Tracking Regions returned to the region list If the request fails the calling routine will receive back status information
8. 4 Result Using either method a check mark displays next to Auto Lock on the Operation drop down menu The check mark indicates the feature is turned on Operations and Setting Status Bits The operations affected by locked regions and the status bit settings are described below Auto Locks Region Operation Source Region Status Bit Destination Region Status Bit Add Item in_lock N A Insert Item in_lock N A Delete Item out_lock in_lock Fetch Item out_lock in_lock Move Item out_lock in_lock Advance Item out_lock in_lock GFK 1216F Using the Production Tracking Window 3 3 Printing Reports di Select the printer from the drop down list Select the paper size from the drop down list Select the Source of the paper supply at the printer Click to configure Network options 3 32 Based on the current view in the PRT window you can print a report with the same columns of information The View drop down list contains the different views configured you configured using the prt_window cfg file You can select the view that has the information you want to print and then print out a report for your records Use the print options to set up preview and print out your report You can do the following Set up a printed report Preview the printed report Print the report Procedure to Set up a Printed Report To set up printed report 1 Open the PRT window 2 Select the view that displays the infor
9. A decision can be processed for selection elimination from a number of decisions based on criteria which involves evaluation e g compare of the attributes of the last item in the destination region If the destination region is a shifting region and the last location contains a blank item then the decision will be dropped from the possible decision list i e this decision will not be processed C 10 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Shifting Region Process Behavior The following section describes other process behavior regarding shifting regions PRT PRT never returns blank items when a request for an item list is made It will return only the valid items and the RegionLoc field in the item structure will contain the actual location of that item GLB VERIFY GLB_VERIFY checks that the number of occupied locations of a shifting region is equal to the region capacity PRT UI PRT_UI will display a blank row for each blank location in a shifting region Items at these locations can not be modified deleted or moved by user PRT_EXPORT PRT_IMPORT While exporting a shifting region prt_export generates one record for every blank location even if the location can contain multiple items This record contains the location number and the item_type_id as GEF BLK ITMS On import of these records with the reserved item_type_ids prt_import generates blank item s at those locations PRT GRD
10. Dim prt as new Prt Get a list of item from PRT and display them one by one in a message box prt GetItemList for 3J Q Go pre PeemCount 1 MsgBox prt Item j ItemId next J Prt ltemClassld Property Read Write GFK 1216F Syntax Prt ItemClassIid Description String property to set or get the Item Class ID in the Prt object Used in conjunction with the Prt GetItemList method to retrieve a list of all items of a particular item class in PRT Example Dim prt as new Prt Get a list of item with a item class id of CARRIER from PRT l and display them one by one in a message box prt ItemClassId CARRIER prt GetItemList for J S 0 to pre eemCour 1 MsgBox prt Item j ItemId next J Appendix E Basic Control Engine Extensions for Production Tracking Prt ltemCount Property Read Syntax Prt ItemCount Description Contains the number of items find by a previous Get ItemList or LocateItem call Example Dim prt as new Prt Get a list of item from PRT and display them one by one in a message box prt GetItemList tor 3 0O Gorpre LteemCount 1 MsgBox prt Item j ItemId next J Prt Locateltem Method Syntax Prt LocateItem itemld refld numRetries Description Locates a serialized Item within PRT On return the total Item count can be obtained from ItemCount and the individual Items may be accessed via the It em function Comments Parameter Description i
11. NEWITEM NEWITEM ItemTypelId TYPES Status 0 to Tracking Database Add Prtitem ltemClassid Property Read Write GFK 1216F Syntax PrtItem ItemClassId Description String property to set or get the Item Class ID of the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupId Groupname NEWITEM RegionId Regname NEWITEM NEWITEM Upload NEWITEM RegionLoc PRT_LAST IntHold false NEWITEM NEWITEM NEWITEM ExtHold false ItemClassId CLASS Status 0 to Tracking Database Add Appendix E Basic Control Engine Extensions for Production Tracking E 29 Prtitem ltemld Property Read Write Syntax PrtItem ItemId Description String property to set or get the Item ID of the Item in the region Setting has does not update PRT until the Modify method is invoked Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupId Groupname s NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM IntHold false NEWITEM ExtHold false NEWITEM ItemTypelId TYPES NEWITEM Status 0 Upload to Tracking Database NEWITEM Add E 30 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Prtltem Insert Method GFK 1216F Syntax PrtItem Insert extProcFlag Description Inserts an Item into the Tracking Region queue If an Item is to be ins
12. Name prt_api_req groupitemlist Description This routine provides a mechanism to request all Serialized Item IDs in a Tracking Group If the request is a success the calling routine will receive back a count of the number of items in the list of Serialized Items in the Group If the request fails the calling routine will receive back status information on the reason for the failure Syntax prt_api_regq_groupitemlist group_id item_count retstat char group 1d PRT REGION TD LEN 13 COR_14 Aa emi Our te COR STATUS retstat Data Structures None Input Arguments group id Unique identifier of tracking group required Output Arguments item_count Count of Items returned to schema retstat Pointer to COR_STATUS structure Return Value Either COR_SUCCESS COR_WARNING or COR_FAILURE If the function returns COR_ WARNING or COR_FAILURE additional error information can be found in the COR _ STATUS structure Error Codes PRTS_NO_GLOBAL_XREF No XREF global section available Warning PRTS_REGION_NOT_DEFINED Region not configured Warning PRTS_NO_GLOBAL_REGION No global section available for Region Warning PRTS_NO_ITEMS_AT_LOCATION There are no items at location specified Warning PRTI_GRP_ID_NULL Group identifier NULL Warning PRTI_GRP_ID_NDEF Group identifier not valid Warning PRTI_UNEXPECTED_SEG_TYPE Unexpected segment type from PRT_DS Warning PRTI_PARTNER_DEAD Partner dead Warning PRTI_EXTRA_SEGS Ignore
13. Press ENTER Enter the attributes that you want to assign for the Item Class in a single record Be sure to use the delimiter character to separate attributes Poe EEE SO Ie ae 3 Click File on the menu bar once you have assigned attributes for your items and proceed as follows Do When Select Save The PRT_UI is configured to view all PRT Services select Save As The PRT_UI is configured to view a specific service Then A Enter aprt_window cfg in the File Name field Where aprt is the name of the PRT Service B Click Save 4 Close the text editor 4 32 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configuration File Example Expanded view of first record All items will have these attributes Fj prt_athibutes cig Notepad ES Fie Eda Search Hele a a w List all attribute names in a single record separated by a x IDH SERIALH ID SERIAL ITEHCLASS REFRIG COLOR WHITE MODEL 7525 STYLE TOP ITENCLASS ORVER COLOR BISCUIT MODEL B325 S5TYLE 31DE DOOR LTEHCLASS WSHR Aa COLOR WHITE MODEL 9625 STYLE TOP Keyword ITEMCLASS assigns attributes to the named Item Class ITEMCLASS WSHR COLOR WHITE MODEL 9625 STYLE TOP Expanded view of the fourth record These attributes apply to the Wshr Item Class only GFK 1216F Configuration File Guide 4 33 4 34 PRT STND CFG The PRT Standby Process prt_stnd cfg configuration file is used to assign a P
14. Run Time Notes lt in pathy corcn gt lt inc_path cor_stat h gt lt inc_path sc_recs h gt lt inc_path netcom h gt lt inc_path prt_api h gt structure definitions etc required by the application program If you start making off node PRT calls to a project on a particular Tracking server then move the project from the Tracking server to another computer the local project will no longer be able to find the off node project You must restart the local project to pick up the server project s new location 5 2 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Application Subroutines The following application subroutines are available for your use prt_api_init Initialize The PRT_API Interface Name prt_api_init Description The PRT_APT initialization routine is responsible for initializing the interface between an application process and the PRT_API utilities prt_api_init must be called by an application before any other PRT_APTI functions If an application process wishes to be an interested process to PRT it must instead call one of the PRT interested process initialization routines prt_api_ register _intproc or prt_api_register_dyn_intproc If an application process wants to access the standard PRT_API routines as well as sign up as an interested PRT process it must call both PRT_APT initialization routines Syntax int prt api init event_flag rcv_req_flag prt_system cimp_sys retstat COR_U4
15. Unknown REGION specified Failure Bad region location specified Failure PRTC_INS_IN_OCC_NON_NORMAL Attempt to Insert in occupied COMBINE DISPERSE PRTC_ITEM STAMP _TOO_NEW region Failure An affected item has changed since the last display Failure Production Tracking Application Interface 5 57 5 58 PRTC ADD GOC TOO BIG PRTC_ADD_MULTIPLE_SERIAL PRIC NODE TAINMENT CPG PRIIT_HITEM TYPE NULL PRTI_ITEM_TYPE_NDEF PRTI_NS_EXT_PROC_INVALID PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_SER_PARENT PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTI_EXT_HOLD_NON_SER PRTI_INT_HOLD_NO_REASON PRTI_NON_SER_ATTS PRTI _NUM_ATTS_INVALID PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Plus all error codes returnable by prt_api_check_route prt_api_send_cmd CIMPLICITY HMI Tracking Operation Manual July 2001 Can not add item to unoccupied location inserting Warning Can not have two serialized items at one location Warning No detainment region configured for Warning Item type identifier NULL Warning Item type identifier not valid Warning ext_proc_flag set for non serialized item Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Parent ID specified for serialized item Warning Group identifier NULL Warning Group identifier not valid Warning External hold specified for non serialized
16. prt_stnd cfg prt_window cfg File Definition PRT Item Type Translation PRT Route Invalid Type PRT Region Item Association PRT Status Code PRT Region Item Type Display Point PRT Region Item Attribute Display Point PRT Region Attribute Counter Definitions PRT Standby Process PRT Field Labels Description Translates item type codes received from detection devices into item type IDs that can be recognized by Tracker This file must be configured when the prt_route records have a translation type value of 2 Identifies an item type s that is invalid for a specified route Defines the item type roles for parent child associations of which there is one record configured for each item type Determines the status bits in the track model for both regions and items Configures the item type quantity in a region that is to be displayed through a setpoint Note Must be configured when prt_grd is configured Identifies the setpoint ID that will link item attributes by region Note Must be configured when prt_grd is configured Indicates the counters in item attributes This will in turn trigger the action taken when an item containing the defined attribute enters the region Determines the PRT data collector that the standby process will monitor Defines the column names for the PRT_UI PRT User Interface in place of attribute names A default record is provided with Tracker and must be presen
17. 0 Region GetItemList for j 0 to Region ItemCount 1 msgbox Region Item j ParentId next J Appendix E Basic Control Engine Extensions for Production Tracking region and display the ParentIds one by one in a message box E 37 Prtltem ProdStart Method E 38 Syntax PrtItem ProdStart extProcFlag Description Initiates production start for an item in a Tracking Region It is equivalent to the Add method but logs differently Comments Parameter ext_proc_flag Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM Upload NEWITEM ItemId IDNUMS Groupld Groupnames RegionId Regnames RegionLoc PRT_LAST IntHold false ExtHold false ItemTypeld TYPES Status 0 to Tracking Database ProOodstart Description Boolean External process flag if set to TRUE get all information from an external process If not provided defaults to FALSE CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Prtltem ProdStop Method GFK 1216F Syntax PrtItem ProdStop Description Removes an Item from the Production Tracking system as the result of its exiting out of a region along a route that has no destination region The specified Item must currently reside at a source region associated with such a route If the Item cannot legitimately transition out of the system along such a rou
18. Box A Check Tracker to install the entire Tracker option including the Tracker Display or B Check Tracker Display to install the Tracker Display only 1 6 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F HHI Server Options Installs complete functionality PRT file configuration changes HM Server Base 179895 K Application Options 36975 K Communications 235047 E to the PRT database Tracker A715 3 and Tracker Display Tracker Display 1784K CELESTE S Syse ites n Demo 76529 K HM Server Base Application Options Communications Tracker Tracker Display System Utilities Demo Installs Tracker Display only Option 2 HMI Runtime Viewer Options Dialog Box Check Tracker Display to install the Tracker Display Viewer Options Viewer TAEMA K Display only System Utilities O Cabling Redundancy 6 Click Next to proceed with installation 7 Reboot your computer when the entire CIMPLICITY program or the Tracker option addition has been installed GFK 1216F Introducing Production Tracking 1 7 Tracker Option Registration In order to acquire all of the benefits from the Tracker options register your product using the CIMPLICITY HMI Registration program Registering your new option is quick and easy as described below uy To register the Tracker option 1 Click the Start button on the Windows task bar 2 Select Progra
19. COR_SUCCESS Error Codes None Pointer to COR STATUS structure Production Tracking Application Interface prt_api_get_req Get Request From External Process Name prt_api_get_req Description This routine provides a mechanism for an application to receive requests from the PRT Data Collector Resident Process PRT_DC For example a PRT_DC can make a request to an external process for Item Tracking Data related to a specific Serialized Item This API allows the application process to access the request issued by the PRT process There are currently two requests a process may receive from PRT Request for Item Tracking Data the manifest constant for this request type is PRT_ITEM REQ Request for instructions on placing a HOLD status on a list of serialized Items the manifest constant for this request type is PRT_ITEM_HOLD_REQ If a Data Collector process which the application is configured to receive requests from terminates or some other error occurs the application will be notified by receiving a message with a request type of PRT_ERROR_RESP In this case the service id of the associated Data Collector process will be placed in the prt_svc_id field of the PRT REQ INFO Structure When prt_api_get_req is called it empties the datagram receive buffer of all messages that have arrived since the last call to prt_api_get_req or since the process registered as an external process via successive reads until a read is po
20. Can t put region s in group s wrong service No configured Services for the PRT System No configured Regions for the PRT System Error allocating memory Bad item type list Appendix A PRT API Error Codes A 3 Appendix B Event Codes for Interested Process Updates About Event Codes When prt_api_get_intproc_updates returns updated information one of the fields is the event code This event code which is a field in either the PRT_ITEM_UPDATE_STRUCT or PRT_REGION UPDATE_STRUCT indicates the exact nature of the update This chapter presents a listing of all codes that can be received in interested process updates the occurrences that cause them and how the intproc update structure is filled when they occur Note Modify _bitmask is set to 0 for all codes except IMOD ltem Related Event Codes IMOD Automatic item association when adding an item PARENT_ITEM_BIT set in modify _bitmask region_1_id contains the region id where the modify occurred When modifying item modify bitmask passed from API call region_1_idcontains the region id where the modify occurred When item moves and transition_type_ indicator is ASSOCIATE_REF_TO_ITEM or ASSOCIATE_TYPE_TO_ITEM modify bitmask set to REFERENCE_ID_MOD_BIT or ITEM_TYPE_BIT respectively region_1_idand region_1_1loc contain the destination location GFK 1216F B 1 ISTT When adding item via API and prod_start_flag is set region_1_idand region_1_1loc contain the location
21. D DEC PESET 6 alarm value Alarm Value or preset value OVEN1 ITEM COUNT GO 3 1 4 QUALCK1 ITEM COUNT 5 P 8 xl OVEN1 ITEM_COUNT 0 3 I 4 Expanded view of No delimiter needed the first record after last field Configuration File Guide 4 3 PRT_ATTRIBUTES CFG The PRT Attribute Labels prt_attributes cfg configuration file is used to assign attributes to your items Attributes can be assigned to all item types or can be assigned to a specific item class When assigning attributes to an item class use the keyword ITEMCLASS For each PRT Service that you have designated in your Tracking Model you will need a separate configuration file named for the Service This file can be viewed and edited without the IDTPOP Utility Simply enter notepad prt_attributes cfg where Notepad is the text editor on the Command line in the MSDos prompt window This file is not required to configure your Tracking Model but is recommended in order to gather comprehensive data on the items tracked through production OPTIONAL FILE J17 To assign attributes 1 Assign Attributes for all items as follows Note Enter attributes that you want to assign for all of your items in a single record Be sure to use the delimiter character to separate attributes 2 Assign Attributes for an item class es as follows Start a new record Enter the keyword ITEMCLASS Enter the delimiter character Enter the name of the Item Class
22. Dim main as new PrtGroup main Id MAIN Get a list of regions from a PRT group i and display them one by one in a message box main GetRegionList Lor J O ce main ReGlonCoun 1 MsgBox main Region j Id next J E 16 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtGroup Id Property Read Write Syntax PrtGroup Id Description String property contains the Group Id of the object Example Dim main as new PrtGroup main Id MAIN Get a list of regions from a PRT group and display them one by one in a message box main GetRegionList Lor 7 0 to Main Regon ounge d MsgBox main Region j Id next J PrtGroup Item Function GFK 1216F syntax PrtGroup Item index Description Returns an item at the specified index from the list which was found by a previous call to GetItemList Example Dim main as new Prtgroup main Id MAIN Get a list of items from group MAIN and display them one by one in a message box main GetItemList tor J _ 0 to Main eemCount 1 MsgBox main Item j ItemId next J Appendix E Basic Control Engine Extensions for Production Tracking PrtGroup ltemClasslid Property Read Write Syntax PrtGroup ItemClassId Description String property to set or get the Item Class ID in the PrtGroup object Used in conjunction with the PrtGroup GetItemList method to retrieve a list of all items of a particular item class in a Tracking Group Ex
23. E 65 PrtService object description Basic control engine E 3 PrtService GetGroupList method E 65 PrtService GetItemList method E 66 PrtService GetRegionList method E 66 PrtService Group function E 67 PrtService GroupCount property read E 67 PrtService Id property read write E 68 PrtService Item function E 68 PrtService ItemCount property read E 69 PrtService LocateItem method E 70 PrtService Region function E 70 PrtService RegionCount property read E 71 R Receive updates only from specific regions 5 49 REG PRT_EXPORT 4 68 Region related interested process updates event codes B 4 Region Status Production Tracking window 3 30 Register as a dynamically interested process for production tracking 5 47 Register as an interested process for production tracking 5 46 Registration Tracker option 1 8 Relational Database 1 4 Reorder Items Production Tracking window 3 29 Reorder locations within tracking region 5 79 Reports Production tracking 2 11 Request list of item tracking data 5 35 Request list of item tracking data for a class 5 33 Request list of serialized item ids in a tracking group 5 31 Request list of tracking group data 5 43 Request list of tracking region data 5 39 Required Configuration Files 4 2 Reserved Characters Comment 4 5 Configuration files 4 5 Continuation 4 5 Delimiter 4 5 Restrictions Configuration files 4 6 Return a list of all configured item types 5 82 Return each successive configu
24. EM RP agg I ee APRT_DC BP RI De APRT_DS BPRT IDS PRTGRD PRIS IND PDC DS CUT Re A eT LRP CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configurable Tracking Interface Specific Configuration Files The CTI application software has multiple configuration files that must be maintained separately from CIMPLICITY configuration These files are CTI_RP CFG CTI_RP_LAYOUT CFG CTI_RP_XLATE CFG CTI_PT_DEF CFG PRT_SRV_ATTR CFG These files reside in the directory sSITE_ROOT DATA for CIMPLICITY HMI for Windows NT and are manually edited The files have an IDT file format hence the first record containing indicates that is the field delimiter character is the line continuation character and is the line comment character The correct names for the first three files are determined by replacing the sequence CTI_RP in each file name with the name of the CTI resident process configured in the previous section The filename CTI_PT_DEF CFG is constant PRT_SRV_ATTR CFG s file name is determined by replacing PRT_SRV with the resident process name for the PRT Data Server which CTI will monitor note that this means a file name of _ATTR CFG in the case that CTI will monitor multiple servers The PRT field names used in all CTI configuration files will either be an attribute name as defined in PRT or one of the following constant field names PRT_ITEM_ID PRT_REFERENCE
25. GFK 1216F Input Arguments item_info reg_info Output Arguments x update_type item_info reg_info retstat Return Value Update information storage location on an item Update information storage location on a region Interested process update type Updated information on an item Updated information on a region Pointer to COR_STATUS structure Note See the chapter on event codes for a complete listing of the possible event codes for either item or region updated information Either COR_SUCCESS COR_FAILURE or COR_WARNING If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure If there are no requests pending the function returns COR_WARNING with the COR_STATUS err_code set to PRTI_ NOTHING_PENDING and update_type set to PRT_ERROR_RESP Error Codes TPC BERR PARTDEAD PRTI_UNKNOWN_INIT_ SRC PRTI_INIT_MSG_RCVD PRTI_UNEXPECTED_SEG PRTI _NOTHING_PENDING PRTI_BAD_MSG PRTI_READ_PORT_ERR PRTI_EF_CHECK_ERR Partner Dead Warning MF_INIT segment received from unknown service Warning Init segment received from Data Collector Warning Unexpected segment type Warning No requests pending Warning Error in segment Failure Error in ipe_read_port Failure Error checking event flag Failure Production Tracking Application Interface 5 53 prt_api_term_intproc Terminate PRT_API Interested Process Interface Name prt_ap
26. If the prt_att_pt file is configured to display n to n m items in a region and if any of the locations in that range is blank than no data is displayed for that location If the prt_att_pt file is configured to display the last n items in a shifting region then the last n valid items will be displayed However if the number of valid items is less than n then those items will be displayed and the remaining locations will display blanks GFK 1216F Appendix C PRT Rules and Assumptions C 11 Appendix D Using the Global Verifier About the Global Verifier GFK 1216F There is a utility available to validate the integrity of the global sections for a given Production Tracking service It resides in sBSM_ROOT exe and is called PRT_GLB_VFY EXE The utility requires three inputs from the user The service name of the PRT data collector that manages the global sections of interest A value that indicates the type of verification Enter 1 to analyze the global sections or enter 2 to attempt repairs The name of a file in which to deposit the output The program is run from the command line as a utility It requires that the corresponding PRT data collector and data server be terminated to prevent erroneous messages due to the global section changing during the verification Note also that this program maps onto the global sections which means that it must be run on the node where the global section backing files exist Val
27. Name prt _api_load_item_hold Description This PRT_API routine is used to load the answer for a PRT request for Serialized Item Hold Data into a response buffer The calling routine receives back a status indicating the success or failure of the request This function can be called multiple times to load multiple responses into the response buffer If the buffer becomes full the return status will be unsuccessful and additional error information will be found in the COR_STATUS structure The PRT_API routine prt_api_send_resp must be called to send the response buffer to the appropriate PRT process Syntax int prt_api_load_item_hold data_valid_flag item_id reference_id ext_hold_active group_id retstat COR_BOOLEAN char item_id PRT_ITEM ID LEN 1 char reference_id PRT_ITEM_ID_LEN 1 COR_BOOLEAN ext_hold_active char group 1d PRT REGLON TD LEN 1 COR STATUS Apes hat 3 Data Structures See Static Information Requirements Input Arguments data_valid_flag If TRUE data requested is being returned is valid FALSE indicates the request could not be satisfied required item_id Unique identifier of a Serialized Item optional if reference id specified reference_id Secondary identifier of a Serialized Item optional if item id specified ext hold active If TRUE Serialized Item held due to external hold group id Tracking Group applying the hold required if ext_hold_active TRUE Output Arguments
28. PO G 10 EO pre ReGen OUN iL MsgBox prt Region j Id next J Appendix E Basic Control Engine Extensions for Production Tracking E 9 Prt RegionCount Property Read Syntax Prt RegionCount Description Contains the count of the number of Tracking Regions found by a prior GetRegionList call Example Dim prt as new Prt Get a list of groups from PRT and display them one by one in a message box prt GetRegionList tor FJ S0 eo prt Region Count L MsSgBOxX prl Regr1ron id next J Prt Service Function Syntax Prt Service Description Returns a Service at the specified index from the list which was found by a previous call to GetServiceList Example Dim prt as new Prt Get a list of services from PRT and display them one by one in a message box prt GetServiceList EOE J e U GO pre Servi cecount I MsgBox prt Service j Id next J E 10 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prt ServiceCount Property Read Syntax Prt ServiceCount Description Contains a count of the number of Service found with a prior Get ServiceList call Example Dim prt as new Prt Get a list of services from PRT and display them one by one in a message box prt GetServiceList LO J O0 Por pre Cervi eCounk I MsgBox prt Service j Id next J PrtAttribute ld Property Read Write GFK 1216F Syntax PrtAttribute Id Description String prope
29. Syntax PrtItem IntHoldReason Description String property to set or get the Internal Hold Reason for the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupiId Groupname NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM NEWITEM NEWITEM Upload NEWITEM IntHold true IntHoldReason Insufficient Parts ExtHold false NEWITEM NEWITEM ItemTypelId TYPES Status 0 to Tracking Database Add Appendix E Basic Control Engine Extensions for Production Tracking E 33 Prtltem ltemTypeld Property Read Write Syntax PrtItem ItemTypelId Description String property to set or get the Item Type ID of the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM Upload NEWITEM ltemiId IDNUMS Groupld Groupnames RegionId Regnames RegionLoc PRT_LAST IntHold false EXtHold false ItemTypeId TYPES NEWITEM Status 0 to Tracking Database Add Prtltem Modify Method Syntax PrtItem Modify Description Modifies the Item All modified attributes and properties of the item are sent to the PRT Data Server An error will be generated if the PRT Data Server rejects the request Example Dim PrE ng 17 Get a list of items from PRT and initialize a particular as new Prt status bi
30. When the PRT_UI is initially launched a dialog box will display allowing connection with a remote project that has been enabled for broadcast GFK 1216F Using the Production Tracking Window 3 5 Common Navigation Techniques The PRT window is used to display information about items in a particular region Items for one region at a time can be viewed in the PRT window Your production facility can have anywhere from several to many regions and the PRT_UI offers you the flexibility to display other regions and to search for other regions in your database The most common navigation techniques are Display another region Browse for regions Modify criteria when browsing for regions Procedure to Display another Region You can view additional regions for the local project in the PRT window J1 To display another region 1 Click the down arrow in the Region ID field to display the list of configured Region IDs 2 Select the region from the drop down list Display another region zt PRT_UI GE Fanuc Automation File Operation View Help eke aaa BE DST2 Region Id OST Cit Mormal Status eae ESAC3 FSAC4 CF PLTF CAE Click and select region from drop down list Result The window displays the list of items for the selected region and update the item count on the status bar 3 6 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F di Browse Regions Use the Brows
31. char parent_item_id 21 COR_U4 item_ status COR_BOOLEAN ext_hold_active char group_id 17 COR_BOOLEAN int_hold_active char int_hold_reason 41 char comment 41 char user_or_svc_id 33 Unique identifier of a Serialized Item Secondary identifier of a Serialized Item Item type identifier Pertains only to Non serialized Items Item status If TRUE item held due to external hold Identifier of the Tracking Group providing reason for hold If TRUE item held due to internal hold Comment specifying reason for internal hold Comment to be recorded in prt history log file User or service identifier MOV Move an Item from a Source to a Destination Region The Application Interface call for this record type provides a mechanism to move an Item from the Tracking Region where it currently resides to a new Tracking Region It also permits the movement of an individual Item from one location to another within the same Tracking Region The fields in this record are char record_type 3 char src_region_id 17 char dest_region_id 17 CORTZ are req on loc COR_I2 dest_region_loc COR_BOOLEAN dest_insert_flag char item_id 21 char reference_id 21 char item_type_id 17 char comment 41 char user _or_svc_id 33 MOV Region the item is moving out of Region the Item is moving into Sequence number of the item in the source tracking region Sequence number of the item in the destination tracking region If TRUE the moved
32. optional for serialized items disposition Disposition of item to be deleted required Valid values are SCRAP Causes the item to be scrapped NO_LOCK_CHECK_SCRAP Causes the item to be scrapped overriding region locking status DELETE Causes the item to be deleted NO_LOCK_ CHECK DELETE Causes the item to be deleted overriding region locking status Note It may be necessary to force the delete of the item regardless of the region s lock status while using the PRT API functions to delete items in a region To do this use the NO_LOCK_CHECK_ versions of SCRAP and DELETE above comment Comment to be recorded in PRT history log file optional user_or_svc_id User or service identifier optional Output Arguments retstat Pointer to COR_STATUS structure Return Value Either COR_ SUCCESS COR_WARNING or COR_FAILURE If the function returns COR_ WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure 5 24 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F Error Codes PRTC_XREF_NOFIND PRTC_ITEM_NOT_FOUND PRTC_REF_NOT_FOUND PRTC_BAD_REG_SPEC PRTC_BAD_REG_LOC_SPEC PRTC_NO_ITEM_AT_LOC PRTC_NO_REG_LOC_SPEC PRTC_ITEM_STAMP_TOO_NEW PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_NON_SER_ID PRTI_SVC_ID_NULL PRI TW oVG TD NDE PRT GRP 1D NULL PRTI_GRP_ID_NDEF PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_INVALID_REG_LOC PRTI_INVALID_REG_LOC_MSG P
33. retstat Pointer to COR_STATUS structure Return Value Either COR_SUCCESS COR_FAILURE or COR_WARNING If the function returns COR_ WARNING or COR_FAILURE additional error information can be found in the COR _ STATUS structure If no more item information will fit in the datagram buffer the function returns COR_WARNING with the COR_STATUS err_code set to PRTI_DG BUF_FULL 5 10 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F Error Codes PRL DG BUF PULL PRT APT CANT RCV PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTI_EXT_HOLD_NO_GRP PRTI_CRESEG_ERR Datagram buffer full Warning PRT Application not initialized to receive asynch messages Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Group identifier NULL Warning Group identifier not valid Warning External hold specified without Group ID Warning Error creating segment Failure Production Tracking Application Interface 5 11 prt_api_send_resp Send Response To Production Tracking Name prt _api_send_resp Description This API provides a mechanism for external processes to send asynchronous responses to PRT_API requests This routine packages the applications response and sends it to the appropriate PRT resident process Syntax int prt_api_send_resp prt_svc_id retstat char Pre svc r SERVICE ID LEN
34. x 1 SUBSYS_ID Subsystem Identifier x 2 PROCESS ID Process Identifier PRT_CLNT PRT PRT_CLNT Master mcp PRT_CLNT GFK 1216F Appendix H Configuring PRT Client Startup Transition Type Overview The following gives an overview how each of the Transition Type Codes function Transition types include Limit Switch Type Detector Item Identifier Reference Identifier Associate Reference ID to Item Associate Item Type to Item Positive Edge Trigger ee eh ey ge ae Se Negative Edge Trigger Transition Type 1 Limit Switch The first location of the source region is checked for items Actions triggered by what items exist are If No items exist in the source region Then No items are moved If Multiple items exist at a location Then All items at the location move Actions triggered by the specified handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user Akk tt Guidelines for Limit Switch include 1 The transition point may be an integer or character string point 2 The first 36 characters of a setpoint if configured are First 16 characters Item type Next 20 characters Either the tem ID for a serialized item Associated or parent item ID for a non serialized item H 4 CIMPLICITY HMI Tracking Operation Manual July
35. 1 Select the project you want to delete from the Project Name drop down list 2 Click Delete A message box displays asking if you want to delete the project Important If by deleting the project there will be no active projects in the PRT window a warning message will display stating that the PRT UI will be terminated due to no projects Clicking Yes on this message box will close the PRT window 3 Click Yes to delete the project and to save your changes in a file A Save As dialog box opens Note Click No to cancel the operation 4 Navigate to the appropriate directory in the Save As dialog box 5 Click Save to save your configured file Result The project ts deleted from your configured file i Tip You can access the file configured to view multiple projects using the Command Line in the Program Properties dialog box See topic How to Set Parameters earlier in this chapter for details Moving Items between Projects When you are connected to multiple projects in the PRT window you can move items between projects In the PRT window the active region is displayed in the viewing window and all of the corresponding information is loaded into the appropriate fields You can move an item from the viewing window into another region within another project There are however some issues to take into consideration each of which are explained in detail as follows Item status Item types Note Skip ahead to topic Move
36. 1216F PRT Ul Functions Everything you need to monitor and control your tracking data can be performed from the PRT UI window The menu options toolbar buttons and drop down lists give you increased flexibility in performing everyday tasks GFK 1216F You can do the following Connect to multiple projects Move items between projects Add and insert items to a region Modify an item in a region Delete items in a region Fetch an item from one region to another Move an item from one region to another Advance an item from an exit location to an entrance location Find a specific item from within all regions Reorder the items in a region View and update a region status Print reports based on configured files Using the Production Tracking Window 3 9 3 10 Connecting to Multiple Projects di J You can view regions in multiple projects without having to open multiple PRT windows In order to view multiple projects PRT Services must be running on each project and you must have access privileges to the projects you want to view Projects can be added or deleted dynamically in the PRT window allowing you to limit or expand the number of regions in view Also you can save your changes and access the file when you want a particular view To connect to multiple projects 1 Click the Operation menu 2 Select the Projects option Result The Projects dialog box opens listing all available projects Managing project
37. API or user interface region_1_id and region_1_loc contain the location of item being deleted B 2 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F IIN When item is being added to destination region due to being advanced via API or user interface region_1_idand region_1_loc contain the destination of added item IDEL When item deleted via API or user interface and item is being deleted not scrapped and not production stopped region_1_idand region_1_1loc contain the location of the item being deleted ISCR When item deleted via API or user interface and item is being scrapped not deleted and not production stopped region_1_idand region_1_1loc contain the location of the scrapped item When an item becomes delayed and the region is configured to scrap rather than detain delayed items a message is generated for the item being scrapped region_1_id and region_1_1loc contain the location of the scrapped item IMRA Aut Repair Move When a combine or disperse region has a serialized item in it and another serialized item is moved into the region the item is automatically moved to a detainment region and two messages generated one for the item being deleted and one for the item being added region_1_id and region_1_loc contain the region from which the item is being deleted region_1l_id and region_1_loc contain the destination of detainment region to which the item is being added When
38. CW sas sate cawasapic tas Sata demoanan tad zatedsnnepanied a J 1 PRA Anterested Process Ulty sensein E E e e tetewssedaadeoetaceess J 2 Configuring the PRT Interested Process Utility ccccccceccceceeeeeeesseeeeeeeeeeeeeees J 3 Running the PRT Interested Process Utility ccccccccccccccccen eee eeneeeeeeeenseeeeeseeeeeeeees J 9 Contents xiv CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Introducing Production Tracking Welcome to Production Tracking Production Tracking PRT is one of two application modules that make up GE Fanuc s CIMPLICITY HMI Tracker product option This application module is fully integrated with CIMPLICITY HMI software s Base System functionality to enhance its already powerful monitoring capability in a full range of computer integrated manufacturing environments The Base System functionality Point Management Alarm Management Database Logging facilities and a full functioned User Interface enables you to collect data for reporting and to view data in lists graphic status displays and alarms The Tracker module also has the ability to integrate with many of the industry standard data communications products The Tracker Module is a flexible factory floor tool that provides Downtime reporting Production reporting Records of production counts at work stations Graphical monitoring of factory status Fault reporting through direct point values and alarms CIMPLICI
39. Defaults to 3 if not specified Example Dim Region as new PrtRegion RegGpon Ld SCHEDULE Get a single item from a region with its ReflId and display its ItemId in a message box Region LocateItem REFNUMS MsgBox Region Item Q0 ItemId GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 55 PrtRegion Loc Property Read Write Syntax PrtRegion Loc Description Integer property to set a specific region location for a subsequent Get ItemList The search will then only return a list of items which exist in that single location Example Dim Region as new PrtRegion Get a single item from a region with its RefId and display its ItemId in a message box Region Loc 0 Region GetItemList Get the Item list from the first location in the region and i display the results in a message box If Region ItemCount 0 then MsgBox Region amp Region amp has no Items Else Msgbox Found amp Region ItemCount amp items End If E 56 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtRegion MaxLocation Property Read syntax PrtRegion MaxLocation Description Integer property to get the last occupied region location Example Dim Region as new PrtRegion Region Id PRODUCTION Region GetData Get current max location information Region Loc Region MaxLocation Get all items in the last occupied region location and display them one by one in a me
40. Filter to use to select a particular class Enter a blank to select all items that is for no filtering Count of Items returned to schema Location number of the highest populated location in the region regardless of the Item Class in the region Pointer to COR_STATUS structure Either COR_SUCCESS COR_WARNING or COR_FAILURE If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure Error Codes PRIS_NO_ GLOBAL XREF PRIS _REGION NOT DEFINED PRTS_NO_ GLOBAL REGION PRTS_NO_ITEMS AT LOCATION PRTI _SVC_ID_NULL PRTI SVG Dp NDE PRTI REG ID NULL PRTI REG ITD NDEF PRII_ INVALID REG LOC PRII_GRP_ID NULL PRII_GRP_ID_ NDEF PRII_ REG NOTIN _GRP PRTI REG NOT IN SVG PRTI_GRP_NOT_IN_SVC PRTI_UNEXPECTED_SEG_TYPE PRTI_PARTNER_DEAD PRTI_EXTRA_SEGS No XREF global section available Warning Region not configured Warning No global section available for Region Warning There are no items at location specified Warning PRT service identifier NULL Warning PRT service identifier not valid Warning Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning Group identifier NULL Warning Group identifier not valid Warning Region not in group specified Warning Region not managed by service specified Warning Group ID inconsistent with service specified Warning Unexpected segment type from PRT_DS W
41. I COR_STATUS SrEL Stat Data Structures None Input Arguments pre sve ad PRT service identifier Output Arguments petstat Pointer to COR_STATUS structure Return Value Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTI_SVC_ID_NULL PRT service identifier NULL Warning PRTI_SVC_ID_NDEF PRT service identifier not valid Warning PRTI_WRITE_PORT_ERR Error in ipe_write_port Warn Fail PRTI_BAD_MSG Error in segment Failure PRTI_MF_INIT_ERR Error initializing segment Failure CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_modify_item Modify Item Tracking Data GFK 1216F Name prt _api_ modify item Description This routine provides a mechanism to modify Item Tracking Data associate an Item Type to an unknown Item associate a Reference ID to an Item ID and associate two Items The calling routine receives back a status indicating the success or failure of the request This routine does not allow for the modification of Item attributes Item attributes are modified using the prt_api_modify_item_att routine Syntax int prt_api_modify_item timestamp modify_bitmask status_bitmask time _t COR_U2 COR_U4 char COR IZ char char char char COR_U4 COR_BOOLEAN char COR_BOOLEAN char char char CORO TATUS region ad reqvon loc FLEE ud reference_id item_t
42. ID of 19000 When CTI receives the point update it first tries to locate an item with a reference ID of 9999 It will find the record with the Item ID 10000 Since 10000 is different than the Item ID received from the point 19000 CTI will try to find an item in Production CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Tracking with an item ID of 19000 It will find the item with Reference ID 9100 This record is no longer correct so it is deleted from Production Tracking The item record for reference ID 9999 is then updated with an Item ID of 19000 CTI will process point updates keyed by Item ID in the same manner it will try to locate stale records for the Reference ID received in the point Run Time Diagnostics The CTI software provides run time diagnostics to assist in determining application configuration or software problems Debugging Logicals GFK 1216F The CTI subsystem was compiled with debugging statements to assist debugging at run time Each CTI process can turn on or turn off default its debugging statements by defining a logical name lt PROCESS_ID gt _DEBUG PROCESS_ID is the name of the process as configured in the SERVICE file There are two levels low or high of debugging output and the debugging level is the value 1 for low or 2 for high of the logical name lt PROCESS_ID gt _DEBUG The low less verbose level will print selected applications messages intended to be used for appli
43. Id PRI REGION ID LEN F iL 3 COR_BOOLEAN int_hold_active char int hold reason SC DESCRIPTION LEN 1 COR iT num_atts_valid PRT_ITEM ATT item_att_list PRI_NUM_ATTRIBUTES COR_STATUS xrevstau Data Structures typedef struct char att _name PRT ATTRIBUTE LEN 1 item attribute name char att _value PRT ATTRIBUTE LEN 1 item attribute value PRT_ITEM ATT Input Arguments data_valid_flag If TRUE data requested is being returned is valid FALSE indicates the request could not be satisfied required item_id Unique identifier of a Serialized Item optional if reference_id is specified reference_id Secondary identifier of a Serialized Item optional if item_id is specified item type_id Item type identifier required item status Item status required ext hold active If TRUE Serialized item held due to external hold optional CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Group 1d int _hold_active int _hold_reason num_atts valid item _att list Output Arguments retstat Return Value Identifier of the Tracking Group placing the external hold on the item required if ext_hold_active TRUE If TRUE item held due to internal hold optional Comment specifying reason for internal hold optional Number of item attributes valid this specifies the number of array elements in the item attribute list that contain valid data If item_att_list isa NULL pointer the
44. If the function returns COR WARNING or COR_ FAILURE additional error information can be found in the COR_ STATUS structure Error Codes All error codes returnable by prt_api_modify_item_all except PRTI_NUM_ATTS_INVALID Production Tracking Application Interface 5 15 prt_api_modify_item_att Modify Item Tracking Data Attributes Name prt _api_ modify item att Description This routine provides a mechanism to modify Serialized Item attributes The calling routine receives back a status indicating the success or failure of the request Syntax int prt_api_modify_item_att timestamp region_id item_id reference _id num_atts_valid item_att_list comment ser Ot sve id tetstat time_t timestamp char Tegro te PRT REG LON Die Ne LI gt char teem PRT TEM SD oN se Lee char reference_id PRT_ITEM_ID_LEN 1 COR_ I1 num atts yalid PRT_ITEM ATT item_att_list PRI_NUM_ATTRIBUTES char comment OC DESCRIPTION DEN L13 char User Or Sve Fa SERVICE 1 umn F 117 COR_STATUS xretsta Data Structures typedef struct char att_name PRT_ATTRIBUTE_LEN 1 item attribute name char att _value PRT ATTRIBUTE LEN 1 item attribute value PRT_ITEM ATT Input Arguments Serialized Items Only timestamp The time the item was last moved or modified The timestamp is used to ensure that when attempting to modify an item s attributes the item has not changed or moved between the time when information
45. Indicator feeds a Tracking Region Items are stored in the region in the order in which the Entry Transition Indicators are received by PRT A region Transition Indicator reports the movement of an Item between two Tracking Regions Each Transition Indicator defines unique routes that exist between two regions A Transition Indicator is therefore the Exit Transition Indicator for the Source Tracking Region and the Entry Transition Indicator for the Destination Tracking Region The same Transition Indicator may specify a valid route between two regions for more than one Item Type In a Tracking Route if the Item Type is specified as a blank field or the wildcard character all Types in the region are assumed to be allowed to travel this route between the Source and Destination Tracking Regions The Item Type may also contain a mix of text and wildcard characters The wildcard character is an asterisk When a region Entry Transition Indicator is received by PRT PRT updates its tracking data regardless of what tripped the indicator PRT cannot distinguish between valid Item Transition Indications it receives and accidental Item Transition Indications it receives e g person walks in front of limit switch PRT receives the Transition Indication and updates the system to reflect Item movement Items tracked by PRT must always reside in a Tracking Region Production start must always occur in a Tracking Region with an Entry Transition Indicator
46. Interface to external software 2 11 Item classes 2 10 Item tracking 2 9 Relational database 1 4 Reports 2 11 Tracking regions 2 3 Production tracking application inteface Include files 5 2 Production tracking application interface About 5 1 Application subroutines 5 3 Contents 5 1 Process resynchronization 5 86 Production Tracking Application Interface Run time notes 5 2 Production tracking concepts 1 3 Production Tracking Window Delete an item 3 22 Production Tracking Window Advance an item 3 27 Fetch an item 3 23 Find an item 3 28 Move an item 3 25 Region status 3 30 Production Tracking Window About 3 1 Add an item 3 13 Auto lock regions 3 31 Connect to multiple projects 3 10 How to open the PRT window 3 2 How to set parameters 3 4 Insert an item 3 13 Modify an item 3 13 Move items between projects 3 12 Print preview 3 32 Print Reports 3 32 Print setup 3 32 Reorder items 3 29 View drop down list 3 32 Program elements PRT_IMPORT 4 53 Properties PRT Prt GroupCount E 6 Prt ItemCount E 8 Prt ProjectId E 9 Prt RegionCount E 10 Prt ServiceCount E 11 PrtAttribute Id E 11 PrtAttribute Value E 12 PrtGroup ExtHold E 15 PrtGroup ExtHoldReason E 15 PrtGroup Id E 17 PrtGroup ItemCount E 18 PrtGroup ProjectId E 20 PrtGroup RegionCount E 21 PrtItem AttrCount E 24 PrtItem ClearStatusBit E 25 PrtItem Comment E 26 PrtItem Delete E 27 PrtItem EntryTime E 27 PrtItem ExtHold E 28 PrtItem ExtHoldGroupId E 29 PrtItem In
47. Item I Modify End Lf next J Appendix E Basic Control Engine Extensions for Production Tracking E 61 PrtRegion Status Property Read Write syntax PrtRegion Status Description Integer property to get or set the region s status mask Example Dim Region as new PrtRegion Regi on id PRODUCTION Region GetData Perform a quick check for any status bits for a region being i set and display the results in a message box If Region Status gt 0 then msgbox One or more status bits are set Else msgbox No status bits set Enda If E 62 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtRegion StatusBit Method Syntax PrtRegion StatusBit b Description Accesses a particular status bit in the region s status mask Comments To obtain the region s status mask from PRT use the Prt Region GetData method Bits 0 15 are for User Use Bits 16 31 are for GE Fanuc use The following constants may be used to access GE Fanuc specific bits Constants Description PRI REGION FULL Region Full Bit PRI REGION EXT HOLD Region External Hold Bit PRT REGION_IN LOCK Region in Lock Bit PRI REGION OUT LOCK Region Out Lock Bit PRT REGION OUT OF SEQ Region Out of Sequence Bit PRT REGION CAP EXCEEDED Region Capacity Exceeded Bit PRT REGION NORMAL Region Normal Bit Example Example of PrtRegion StatusBit Function using a constant to j get the Region Full status bit and display it s status in a mes
48. Item is inserted in the destination Tracking Region queue ahead of the Item located at the specified destination region location Unique identifier of a Serialized Item secondary identifier of a Serialized Item Item type identifier Comment to be recorded in prt history log file User or service identifier 4 60 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F PTS Enable Disable Region Setpoints The Application Interface call for this record type provides a mechanism to enable and disable the Item transition setpoints configured in the PRT Tracking Route records These points are set by PRT when an Item transitions into the configured destination region The fields in this record are char record_type 3 char region 2d 1 7 COR_BOOLEAN enable_point_flag char comment 41 char user or svc_id 33 REG Modify Region Status PTS Tracking region identifier If TRUE enable region item transition setpoint If FALSE disable region item transition setpoint Comment to be recorded in prt history log file User or service identifier The application interface call for this record type provides a mechanism for modifying Tracking Region Data specifically the region status The fields in this record are char record_type 3 COR_U4 status_bitmask char region_id 17 COR_U4 region_status char comment 41 char user_or_svc_id 33 Configuration File Guide REG Indicates field that ha
49. Item type idir Item type identifier COR 11 disposition Manifest constant specifying the disposition of the item which can be specified as DEL DELETE or SCRAP char comment 41 Comment to be recorded in prt history log file Char User or svc td 33 User or service identifier DSP Print Message to Terminal This record type provides a means of printing a message out on the terminal Messages can be inserted in the Import input file to notify the user as to the current point of processing within the file The fields in this record are char record_type 3 DSP char display_string Message to be displayed on terminal The message can be as long as necessary HLD Apply a Group Hold to an Item The application interface call for this record type provides a mechanism to activate and deactivate a HOLD specification for a Tracking Group The fields in this record are char record_type 3 HLD char group iral Unique identifier of tracking group char ext_hold_reason 41 Text describing the reason for placing holds on Tracking Regions in this Tracking Group optional for activate does not apply to deactivate COR BOOUBAN act hold flag If set to TRUE the Hold Specification is activated If set to FALSE the Hold Specification is Deactivated char comment 41 Comment to be recorded in prt history log file char User or svc 1d 33 User or service identifier Configuration File Guide 4 57 4 58 INS Inse
50. Node Name Logical Process Name Decnet Object Name Redundant or Allocated Process Order MASTER PRT_CLNT PRT_CLNT 0 IDT file generated by IDTPOP utility v1 0 LOGPROG LOGICAL PROCESS IDENTIFIERS e IDT file Generaved by LDIPOP Utility wild RECORD NODE NOGPROG PROCESSES ON SPECIFIC NODES RECORD PROCESS_ID Process Identifier Logproc process_type_id pm_flags description Process Type Identifier Bits last 5 Process Description _CLNT RESIDENT 1 PRT Client Onna owt WN EF OO KO TO Li 12 IRE 14 1 16 18 T9 Node_Logproc NODE_ID PROCES S10 image_name PLLOrICy base_quan max_quan astlm lenke pies bytlm cpulm diolm engilm fillim pgflquota preml tqelm wsdefault wsquota Sys_priv_mask Decnet Node Name Process Identifier Executable Image name Process Priority Base quantity Max Quantity ASI limit BIO Limit BYTE LAmit CPU Limit DLO LIMLE ENQ Limit Bi BIMET Page file quota PRCLM field name is a typo TQELM Working set extet Working set quota System wide process privilege mask AP RSTAL LD NOAL WT MASTER PRT_CLNT BSM_ROOT exe PRTClient exe 20 1 1 80 50 50000 0 50 2000 100 50000 LO 20 V9 9 9999929 jad CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Service w TDD Fpl generated by LDEPOP uta ley VEs RECORD SERVICE SERVICE IDENTIFIERS 0 SERVICE 1 Service Identifier
51. OOED R n Time Diap nostiCS srie ee a eee Debus LOgical Sy inen a r e E COR STATUS MGSSa GOS eninin an ia aae Appendix G PRT Logging Configuration ADO PRT Data LOSSIN aii cs cis ci tantaclealpanidt tn cuaoieindedanuadeelaanet teens PRT 0 8018 FOr aeee E Fable ropra a r a taaaeuase Table Held S cr sncsate aiescactscnea sta asaisinluoneadeveveuonn N Pr Oi Peat acer an ceeteccns A sh css ets ae echaatatan estas suesenecunee PRE ITEM Ua secseha ata ctrcrsmate a E seatisneseesenk Geese oeeaseae PRIER Te Gi aes vaszcasrra accangatnmsoacieneen N COMMOUPATIOMPIICS oes gi ceshscoscssiavioee ieicoiel civeian coadaad aaocaeedeanwaeentocsecsasas Datalos 6 Renee cee eer orn rarer E Datas tied UG ect isaac cedar E edadaadoietditsaamdaadacitoieed Appendix H Configuring PRT Client Startup About PRT Client Startup Configuration ccccccccceeeceeeeeeeeeeeeeseeeeees PRT Client Configuration Files to be Modified ccccccesssseeeeeeeeeees FASS DOO a A E ness ecenteats LOS DOC sialic clita N IN OCG SIO CPL OC resis aa narnene chi s ehantassonssea E coat anetanuscen se ceereed SSL BAVA e ere E ers Re Re Re Pe E A EA Master mepe nn NaS Contents Contents xiii ATANSILON FYE VEL Vie Warri a N E tees tadsenee H 4 Transition Type 1 Limit Swithin ren anna a H 4 Transition Type 2 Type Detector cigs ween ane a a RE H 5 Transition Type 3 Item Identifier cc ccsssssesseeeececceeeeeeeeeaessassesseeeeeeeeeeee
52. POWER TNS Ge R32 CAR S217 3290 S172 993 CAR S73 TPRI EXFORT I ALT Mo PE at ATT COLOR BLUE ATT A C YES ATT ENG TYPE V8 ATT BRAKES MANUAL LENGE RS CARI S642 7390 S76991 CAR NEZTE F PRE EXPORT AT Ei Sik ATT COLOR GREEN ATT A C YES ATT ENG TYPE V8 ATT BRAKES POWER ENS ERS CAR 3 S46083690 514999 CAR 32 FE LF PRE BXPORT ALT S l VE SX ATT COLOR YELLOW ATT A C NO ATT ENG TYPE V6 ATT BRAKES POWER INSI F R32CAR 4 S14293 90571996 CAR SZ 2RT A xXPORT ATT STYLE GTI ATT COLOR GREEN ATT A C NO ATT ENG TYPE TURBO AQ T BRAKES SELEADJUS E LN SIER CARS S93 L723 9051999 CAR 3212 Fl PRT EXPORT Note Prt_import does not transfer region validation statistics data CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Production Tracking Export Program PRT_EXPORT This section describes the Production Tracking Export Program PRT_EXPORT The tasks performed by the Export program are described the Export file record formats are defined for both the input and output files and a procedure for running the program is provided The Production Tracking Export Program PRT_EXPORT lets you request information from the running PRT processes and write the information to an output file The output file is formatted to be compatible with the PRT Import program Export Input File Format The Export Program reads
53. PRT_ITEM att_16 value 12 16 726 PRT_ITEM att_17_name 12 16 742 PRT _LTEM acu Uy value i17 16 7Ss PRT_ITEM att_18_name 12 16 774 PRT ITEM tt 18 value lLziTeT90 PRT_ITEM att_19_name 12 161 806 PRT_ITEM att_19 value 12 16 822 PRT_ITEM att_20_name 12 161 1838 PRT_ITEM att_20_value 12 161854 PRT_ITEM att_21_name 12 161870 PRT_ITEM att_21 value 12 16 886 PRT _ ITEM att_22 name 12 16 902 PRT LTEM act 22 value 17 16 Sis PRT LTEM atto 23 name i2 16 9s34 PRI LTEM att 273 Value 12 16 950 PRT_ITEM att_24 name 12 16 966 PRT LTEM act 24 value 12 16 9382 PRT_ITEM att_25_name 12 16 998 PRT ITEMlatt 75 Value 12 16 L014 PRT_ITEM att_26_name 12 16 1030 PRT ITEM att 260 value 12 16 1046 PRT_ITEM att_27_name 12 16 1062 PRIT ITEM act 27 value lzi Te Lees PRT_ITEM att_28 name 12 16 1094 PRI VIBM ect 76 valve 17 6 9 PRT_ITEM att_29 name 12 16 1126 PRI ITEM ect 29 Value 17 16 1 42 PRT_ITEM att_30_name 12 16 1158 PRT TITEM ect 3 0 value T216 1LL74 PRT_ITEM att_31_name 12 16 1190 PRIT LTEM act 34t value lrizire 1206 PRIT ITEM a att 32 hamel L21 C6 1222 PRI LITEM act 32 value 12 16 2356 Appendix G PRT Logging Configuration G 7 G 8 PRI ITEM att 33 name 1l2 16 1254 PRI LTEM att 33 value Tr 270 PRT_ITEM att_34 name 12 16 1286 PRI LITEM act 34 vale i127 16 L302 PRT_ITEM att_35_name 12 161 1318 PRT ITEMi tt 353 Value i2 16 L
54. PRT_STND CFG 11 Press Enter 12 Type and press Enter 13 Create your record using the field descriptions as follows see the Configuration File Example Entr No Field Name Description Data Type Example 0 server_name Base name for the PRT Server that the standby 16 PRT process will support characters 1 project_name Name of the project that contains the PRT 32 GE_APP_TKR Server characters 2 reconnect_time The time in seconds between the failure of the Integer 30 PRT Server and the attempt to reconnect 3 resource_name Resource name that will be used by the standy 16 S YSTEM process to generate alarms characters 14 Click File on the menu bar 15 Select Save Result The prt_stnd cfg file is manually configured and saved to the Master directory Configuration File Example The reserved characters must be defined as part of the file prt_stnd cfg Notepad Of E4 e Edt Search Help CFG File n RECORD PRT_STHD CFG 1 record created PRT GE_APP_TKR 36 S STEM PRT GE_APP_TKR 30 SYSTEM Expanded view No delimiter needed of the record after last field GFK 1216F Configuration File Guide 4 35 PRT_WINDOW CFG The PRT Window Field Labels prt_window cfg configuration file is used to customize the columns and their order in the PRT User Interface PRT_UI This file has a DEFAULT record already configured If you want to rearrange or limit the information on screen you can do so by Vie
55. Provides access to the PRT User Interface Description CIMPLICITY HMI Tracker provides factory tracking routing solutions Space Required 370144 E Space Available 4761751 K lt Back Cancel GFK 1216F Introducing Production Tracking 1 5 Tracker Installation Installing the Tracker option on your HMI Server or HMI Viewer takes just moments using your original installation CD for CIMPLICITY HMI See the CIMPLICITY Getting Started manual GF K 1500 for details about installing CIMPLICITY J47 To install the Tracker option 1 Begin CIMPLICITY installation 2 Choose to either A Install the entire CIMPLICITY program or B Add the Tracker option to the same version of an installed CIMPLICITY program 3 Select the product you are installing as follows A Proceed to the CIMPLICITY HMI Product Options screen B Click one of the buttons as follows Button Installs HMI Server HMI Server system Viewer Either the Viewer Runtime or Viewer Development system C Click Next The screen that displays next depends on which button you click Button Next Screen HMI Server The Choose Destination Location screen Viewer CIMPLICITY HMI Setup Check either Viewer Runtime or Viewer Development The Choose Destination Location screen displays 4 Proceed to the Options dialog box that displays for the option you chose Select the following for Option 1 CIMPLICITY Server or HMI Development Viewer Options Dialog
56. REGION_ID gt SALL Note that ALL is used to refer to the all regions of the PRT service If lt INDEX gt is 0 all the elements of the statistics point will be set to 0 Otherwise the specified element will be set to 0 The field descriptions are Configuration File Guide 4 47 Field Service id Warning_alarm_id Failure alarm id Command_point Response_point keep_validation_flags Runtime Data Description service id Alarm Id to use for validation alarms that PRT was able to fix If not configured the alarms are logged to cor_status log Alarm Id to use for validation alarms that PRT was not able to fix and requires manual correction of the system If not configured the alarms are logged to cor_status log PRT command point PRT response point If it is 1 it means to keep the validity flags from the global memory when PRT starts up If set to O reset the validity flags to FALSE regardless of their values in the global memory The validation process is also required to maintain some statistics about the performance The following table gives the list of the elements of the statistics point Index Field 0 MODIFY_MASK 1 TOTAL_VALIDATIONS 2 INVALID_COUNT 3 TOTAL_INVALID 4 TOTAL_DBL_TRIGGER 5 TOTAL_MISMATCH 6 CONS_MISMATCH 7 TOTAL_NOREAD 8 CONS_NOREAD 4 48 CIMPLICITY HMI Tracking Operation Manual July 2001 Description Collection of bits giving information about the validation proce
57. Set Attributes for an Item Associate attributes with the item using fields on the Attributes tab of the dialog box You can select attributes and enter a value for each J17 Step 5 Set attributes for an item L Title bar will reflect the current operation i e Add Modify or Insert Item List of attributes currently associated with the item Function buttons Top to bottom Adds an attribute Deletes selected attribute Modified selected attribute Inserts an attribute before the selection in the list Select the Attributes tab to display the list of attributes that are currently associated with this item Note The window may not have any items listed Use the function buttons on the right of the dialog box to perform the following function See below for procedures Add an attribute to the list Delete an attribute from the list Modify an attribute in the list Insert an attribute before an item in the list Set Attributes Attributes tab General Infomation Attributes hian Status Aribe Vakie _ IDH SERIALY CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F L Add an Attribute Click Add The Add Attribute dialog box opens Add Attribute E4 Mame co LOA Value GREEN Cancel Enter the name of the attribute in the Name field Enter an associated value in the Value field Click OK to add the attribute to the list or Cancel to cancel
58. Setpoints cccccceeeeeeeeeeeeeeees Using the PRT ser Mite ace vcusanas teaver a Sean Trackin Items ennio a Wisin tem Classo Seeria a ia earhia a Generating Reports sseeeeessssssssssssseeetrrreesssssssssssseerereeesssssss Using the PRT Interface to External Software cceeee Tracking Data sienas cau aoent on tu a seacoast CIMPLICITY Software Component Interface Requirements Using the Production Tracking Window About the Production Tracking Window sssscceeceeeeeeeeeeaeesseeeeeees Procedure to Open the PRT Window c ssssseseeseeeeceeeeeeeeeeeeeeaaeeeeees Procedure to Set Information Parameters cccceccccececeeeeeeeeeeeeeeeeeeees Common Navigation Techniques isccccccaiccsecassccessevisesdseteveccssseecdavassecwesdsts PRUE BUN CHONS lt exisuesessessoatsongs tives tidus dawnt N iawn Connecting to Multiple Projects cccccceeeeeceeeeeeeeeeeeeeeeeeeees Moving Items between Projects cccceseeeeeceeeeeeeeeeeeaeeeeeeeees Adding Inserting or Modifying an Item eeeeeeeeees Deletine an Metis i555 eek tistaccacehtt EE eee ack POCO MIDS an Momie aa tas abate eeconesbaustoleetues Moving amn TS Ti arate sen ceewsufaa a sedans a Advancen amena vos eats gachechetets pata ran N Finding an We nis 2 i0 ecce lvceexisaventinte cna ar aclie N Reorderme Mems rebran a ar te eenwameneceants Updating a Region s Status ccccsssssseseeeeceeeee
59. TD LEN 1 COR_BOOLEAN int_hold_active char int horld reagon COR I1 num_atts_valid PRT ITEM ATT 16m awe See char Comment SC DESCRIPT LON DEN LIZ char user or svo Id SERVICE LD LEN a TI COR_STATUS KeLS bat Data Structures See Static Information Requirements Input Arguments Serialized Items Only ext_proc_flag External process flag if TRUE get all information from external process required item_id Unique identifier of a Serialized Item optional if reference_id is specified reference_id Secondary identifier of a Serialized Item optional if item_id is specified CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F ext_hold_active group_id num_atts valid item_att list Non Serialized Items Only parent_item_id Both timestamp region_id region_loc item_type_id item status int _hold_active If TRUE item held due to external hold required Group identifier providing reason for hold required if ext_hold_active TRUE Number of item attributes valid this specifies the number of array elements in the item attribute list that contain valid data If item_att_list isa NULL pointer the function sends a zero to the Data Collector for this argument regardless of what was actually passed required Item attribute list This argument is the pointer to an array of PRT_ NUM_ATTRIBUTES elements If the pointer is NULL this clearly indicates that no
60. TYPE Production Tracking Route Invalid Type a orig region id Ib of region item exits 1 dest region id ID of region item enters item type id ID of type invalid between these regions E 3 transition ptid ID of transition point between regions RECTA AFRDJI NETE TS 09 GATROR ELPOJASS00_REFIO_ TRAP Ls REG1 PROJ1 RTE_TST1 GMT800_ELPO ASSOC_REFID_TRANSPT Field Desciptions A Source region from which the item will exit B Fully qualified path to the project and destination region to which the item will enter C Item type ID that is not allowed to travel this route or the invalid item type ID Note that if you left this field blank or used the wildcard character in the PRT_Route record you may need more than one record to indentify the invalid item types D Transition Point ID between the two regions 4 40 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Automated Region Validation Automated PRT Region represents a combination of functions that address the need to effectively process positive identification data such as Smarteye RF Tag or bar code readers This functionality is used to make sure that the CIMPLICITY HMI Tracking Image is accurate at the head of zones where readers are located and decisions are not made on an item until it is at the head of a zone and the tracking system has been verified against the reader This can be used to reduce manual intervention when a read is missed
61. Textual description of the status code 40 characters Text to display with the status code for user 16 recognition Must be unique characters Bit to be set by PRT that will represent this Long word status code CIMPLICITY HMI Tracking Operation Manual July 2001 Entry Example CTRLWTRK 0 Blank Control w track 22 GFK 1216F Configuration File Example o pri vatus idt Hofeped Pie Edi gewch Help j IOT File generated by IDTPOP utility wi 8 RECORD PART STATUS Production Tracking Status Code T STATUS CODE coir type cadr drsr colr label bit_set Predefined records for region and item statuses CTRLWIRE control w7 track 22 BETALH 2 1MHED HOVE TO_REPAIR 8 BLAYD 1 delaged 16 BLY OTH 2 DELAY HOVE _TO_REFAIA 1 BLY SCRP 2 DELAY SCRAP 2 EROLO 1 jexternal hold 19 HOLD 1 jintermal hold 1 IMORML normal 31 RCAPEXC O capacity rxcj 4 REGHDULD j reg hrad validj 3 REHOLD H external hold t RFULL Aj region Full 1 RIMLOCK O in lock 1 amp RHORHL 8 normal 31 ROUTLOCK O out lock 19 ROUTSEQ O lout of Seg z8 SCRAP 2 1NMER SCRAP 2 WALTSGEC O waiting For dec 254 GFK 1216F Configuration File Guide Unique code identifying Reg ltem status Status Type fe hegion t lten 2 Reserved Status Code description User defined Status Display labe
62. Than Or Equal Between I Not Between Exists Contains The comparison may be Numeric N Alphanumeric A Float F Alphanumeric comparison values can specify the wildcard character Multiple region names can be specified by separating them with commas GFK 1216F Example Specify Source Regions 1 and 2 and Distribution Regions 1 and 2 SRC1 SRC2 DST1 DST2 When using Between or Not Between separate the high and low values with a comma Example Specify Between 2 and 3 2 3 Counts are stored in CIMPLICITY HMI analog non array points These points are initialized at startup and are updated as items enter and exit a region When the process first starts it Performs a count of all items in the configured regions Initialize the points with the count values Utilizes a configured reset point when the reset point updates PRTCNT will automatically recount all regions When an item is modified in a configured region PRTCNT will recount all counters associated with that region CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configuration Files The program looks for the configuration file PRTCNT CFG in SC_PATH data Attribute Counts by Region configuration file Record 1 lists the reset point Data on each succeeding line displays as follows RegionName ItemClass AttribName StartChar Length Operator Value CompareType PointID GFK 1216F Re
63. Tracking Application Interface 5 63 5 64 region_loc item_type_id item status int _hold_active int _hold_reason comment user or svc_id Output Arguments retstat Return Value Specific location in the region where the Item is to be added required Item type identifier required Item status required If TRUE item held due to internal hold required Comment specifying reason for internal hold required if int_hold_active TRUE Comment to be recorded in PRT history log file optional User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Pointer to COR _STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRIC NON ER LD PRTC_SER_NO_ID PRTC_UNKNOWN_REGION PRTC_BAD_REG_LOC_SPEC PRTC_ITEM_STAMP_TOO_NEW PRTC_ADD_LOC_TOO_BIG PRTC_ADD_MULTIPLE_SERIAL PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_NS_EXT_PROC_INVALID PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_SER_PARENT PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTI_EXT_HOLD_NON_SER PRTI_INT_HOLD_NO_REASON Non serialized item has item or ref id Failure Serialized item missing both item amp ref id Failure Unknown REGION specified Failure Bad region location specified Failure An affected item has changed since
64. Write i oii sos eae tvpeta nas caeaidewecaen sade EOG E 7 Pre fteme ount Property Read iis sesicnars erecta a a edn eandes ai E 8 Pa Locate he mM eMo he 6 3 os ced Sree A Bane kde vanadate yn a n aa aaa a a E 8 Pit Projectid Property Read W tite hascoc nnonser A biae tenes E 9 Pre 2100 UCU OR oaa akan E N a ueteoceidendeaneas oeutenwnciageds E 9 PreResionCount Property Read jeniec a a ai E 10 P Service CE UIC OI a a asa a a a ca a a E 10 Preservice Count Property REAd hoins a a noid dauttideapentiesieneelsnieen E 11 PrtAttribute td Property Read W UE anco a aiiseaton te E 11 PrtAttribute Value Property Read iis icacs cctocicetasiaes ite sansaiteatansictiandeidagsrdesacsunteatacanatiaientasias E 12 PriC neck Oute CIVICIN OG sis gsiattecscaiswssinendistecu a E vue nds adnan a EO ees E 13 PriGroup Clear EX HOL Meore a ale ical dunac lea eatca r da an ates E 14 PriGroup ExtHold Property Read hanna a a a a E EA E 15 PrtGroup ExtHoldReason Property Read ccccccccccccecccceeeeeeeeeseeeeeeecceeeeeeeeeeeaaaaeegenenes E 15 PrGroup Getiteml 1st VICI OG aesa sia wieusente acts neenta a aaacat tia dewuedeenanenaiotewtueamaaiiateas E 16 PrtGroup Gethe cionlist Method acrin sae a ncviedaandtndonatescnoouhidiencialy E 16 PriGroup id Property Read WII sisvx diwacuan coscanteed soit a N E 17 PriGroup item PunCO On 25 2095 esata cate ncots a ca Gunde a E 17 PrtGroup ItemClassId Property Read Write ccccccccccccccc
65. a Destination Tracking Region This call moves ALL items at the FIRST EXIT location in the source region to the LAST ENTRY location in the destination region The fields in this record are char char char char char record_type 3 ADV Srceregion 7d L7 dest_region_id 17 comment 41 file user _or_svc_1id 33 Configuration File Guide Region the item is moving out of Region the Item is moving into Comment to be recorded in prt history log User or service identifier 4 55 ATT Add an Item Attribute This record type provides a means of filling in the array of Item Attribute structures one element at a time the program maintains internally for providing as an argument to the PRT Application Interface functions invoked by the STT ADD INS and MAT record types The Item Attribute structure 1s typedef struct char att_name 17 char att_value 17 PRT _ITEM ATT The fields in this record are char record_type 3 ATT char att_name 17 Attribute name char att_value 17 Attribute value The array of PRT_ITEM_ATT structures has PRT_NUM_ATTRIBUTES elements This is the maximum number of ATT records that can appear in the Import file without an intervening STT ADD INS or MAT record which sends whatever Item Attribute data is currently in the array and then clears it out for the next Import command API call that uses it More than PRT_NUM_ATTRIBUTES ATT records without any intervening STT
66. a20 111 181 8 a yo 73 1 8 R00 TEST RES O Oj1 150 ALITAN jbati QTY DSTT PRT_BC DISPERSE bisperse DISPERSE SEQUEMTIAL 1 2 1 JUPRSTA_ OT OST STS 3 P ACO TEST TPTPTE AAPA A Ay The asterisk indicates that this text is comment only and not part of the record The vertical bars delimit or separate the fields penvdis invalid item type logging endis unknown item type alrm endis unknown item type logging enydis region capacity alrm en dis region capacity logging altenatic iten aoe Setpoint Tracking Region s Transition Region ID EDUEATIAL T ZI TII ae BPO By a By Ap aya pays FIELT IRCE TEST ire Ti STs jinen TEST RES B LAL POP Hp2Oy PPP EP ey ay ey ayReO TEST KHY ijij CIRI jo a PE TAIN 0 8 GO 8 6 8 ei AES 8 8 1 7 8 8 8 By 1 The hyphen indicates a continuation of the record and appends the next line to the record Configuration File Restrictions The following restrictions must be observed when editing the configuration files Delimiter Field length Field Order Field Type Field Values Fields Logical line length Padding All fields must be separated by a delimiter which is the first character defined in the first line of the file Must be less than or equal to its configured maximum Cannot exceed 250 characters The fields must be in the same order in the record as they appear in the input file Va
67. activate or deactivate a HOLD specification for a Tracking Group The calling routine receives back a status indicating the success or failure of the request Syntax Ene PrE api Group hola Group 10 ext hold reason act hold flag Comment user Or svo id Persia char group 1dc PRT REGION TD LEN 1 3 char ext hold reason SC DESCRIP YT TON CEN I3 COR BOOLEAN act hold flag char comment SC DESCRIPT LON EEN L13 char ser or sve 10 SERVICE LD LEN 113 COR STATUS retstat Data Structures None Input Arguments group_id Unique identifier of tracking group required ext_hold_reason Text describing the reason for placing holds on Tracking Regions in this Tracking Group required for activate does not apply to deactivate act_hold_flag Tf set to TRUE the Hold Specification is activated If set to FALSE the Hold Specification is Deactivated required comment Comment to be recorded in PRT history log file optional ser Or Sve id User or service identifier optional Output Arguments retstat Pointer to COR_STATUS structure Return Value Either COR SUCCESS COR_WARNING or COR_ FAILURE If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR _ STATUS structure Error Codes PRTC_NO_SUCH_GROUP No such group configured Warning PRTI_GRP_ID_NULL Group identifier NULL Warning PRTI_GRP_ID_NDEF Group identifier not valid Warning PRTI
68. ae 6 FANUC GE Fanuc Automation CIMPLICITY Monitoring and Control Products CIMPLICITY HMI Plant Edition Tracker Production Tracking Operation Manual GFK 1216F July 2001 GFL 005 Following is a list of documentation icons Fa OT Warning notices are used to emphasize that hazardous voltages currents temperatures or other conditions that could cause personal injury exist in the equipment or may be associated with its use va 4 a e e e e Caution provides information when careful attention must be taken in order to avoid damaging results J wa Important flags important information 44 To do calls attention to a procedure Note calls attention to information that is especially significant to understanding and operating the equipment or software i Tip provides a suggestion WN Guide provides additional directions for selected topics This document is based on information available at the time of publication While efforts have been made to be accurate the information contained herein does not purport to cover all details or variations in hardware or software not to provide for every possible contingency in connection with installation operation or maintenance Features may be described herein which are not present in all hardware and software systems GE Fanuc Automation assumes no obligation of notice to holders of this document with respect to changes subsequently made GE
69. already destLoc Integer Location to move to in destination region Sequence number of the item in the destination tracking region Specified as PRT_FIRST EXIT or PRT_LAST Entry or a number from 1 to n where n is the number of items in the queue insert_flag Boolean If true the moved item is to be inserted in the destination region queue before the item located at the specified destination region location unless the manifest constant last is specified in which case the item is inserted after behind the last item currently present in the region comment String optional An optional comment to write to the PRT log file Example Dim Region as new PRTREGION Regione td o SRCE Region GetItemList Set timestamp attributes for the head item in a region and then move the item to another region DSUFS _DATE TSUFS TIME Region bemt0 Setattr GRC amp DSUFS DATES Regqions ltem 0 aSetattr SRCs amp ISUrS TIMES Region Item 0 Modify Oji Region Item Moveto DESTREGIONS RegionLOC 0 E 36 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Prtltem Parentid Property Read Write GFK 1216F Syntax PrtItem ParentId Description String property to set or get the Parent ID of the item Parent IDs are only valid for non serialized items Example Dim Region as new PRTRegion Region Id DETAINMENT Get a list of all the items which exist in 1 location of a Region Loc
70. an error is generated Example Dim Region as new prt Region Region Id Detainment Get a list of items in a region and remove an attribute from i each of them one by one Region GetItemList For jJ 0 to Region ItemCount 1 Region Item j RemoveAttr BODYCOLOR Next Jj Prtltem Serviceld Property Read Write Syntax PrtItem Serviceld Description String property to get or set the Service ID associated with the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWLITEMSServy Geid PRT pC NEWITEM GroupiId Groupnames NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM NEWITEM NEWITEM NEWITEM Upload NEWITEM Appendix E Basic Control Engine Extensions for Production Tracking IntHold false EXtHold false ItemTypelId TYPES Status 0 to Tracking Database Add E 43 Prtltem SetAttr Method Syntax PrtItem SetAttr attrib value Description Sets an Attribute to a value for the Item If the Attribute exists for the Item it is overwritten If the Attribute does not exist for the Item a new Attribute is created PRT will be updated with the modified Attribute on the next Modify method Example Dim Region as new PRTREGION Region Id SRC Region GetItemList Set timestamp attributes for the head item in a region and i then move the item to another region DSUFS DATE TOUFS M TIME R
71. an item becomes delayed and the region is configured to detain rather than scrap delayed items two messages are generated for the item being detained one for the item being deleted from the combine disperse region and one for the item being added to the detainment region region_1_idand region_1_1loc contain the location of item being deleted region_1_idand region_1_1loc contain the destination of detainment region to which the item is being added IMRM Man Repair Move When an item is moved via an API call or user interface to its detainment region two messages are generated one for the item being deleted from the source region and one for the item being added to the detainment region region_1_idand region_1_1loc contain the location of the item being deleted region_1_idand region_1_1loc contain the destination of detainment region to which the item is being added GFK 1216F Appendix B Event Codes for Interested Process Updates B 3 ISTP Production Stop Production stop generated via API call region_1_id and region_1_loc contain the location of the item being stopped IDRF This item has been deleted because room was needed in the region region_1_id and region_1_1loc contain the location of the item being deleted Region related Interested Process Updates RORD Generated when a region is reordered via API call or user interface region_1_idcontains the region where the reorder occurred modify bitmask Set to
72. attribute list that contain valid data If item_att_list isa NULL pointer the function sends a zero to the Data Collector for this argument regardless of what was actually passed Item attribute list This argument is the pointer to an array of PRT_ NUM_ATTRIBUTES elements If the pointer is NULL this clearly indicates that no item attributes are being provided along with the item being added If the pointer is non NULL however it must point to an array of exactly PRT_NUM_ATTRIBUTES elements The num_atts_valid argument indicates how many of these elements contain valid data Associated serialized item identifier optional Region where the item is to be added to the queue required Item type identifier required If TRUE item held due to internal hold required Comment specifying reason for internal hold required if int_hold_active TRUE Comment to be recorded in PRT history log file optional User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Pointer to COR_STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRIC_NON_SER_ID PRIC_SER_NO_ID PRTC_UNKNOWN_REGION PRIC BADY REG LOC SPEC Non serialized item has item or ref id Failure Serialized item missing both item amp ref id Failure
73. base CIMPLICITY system Configuration error The lt POINT_ID gt must be configured as either a TEXT POINT or ANALOG POINT in the base CIMPLICITY Unexpected run time error Save the COR_STATUS LOG file and bring it to the attention of GE FANUC Unexpected run time error Save the COR_STATUS LOG file and bring it to the attention of GE FANUC This is a warning message The PLC was down or the communication between the Device Communication process and the PLC was broken This is an error message This process was unable to allocate memory A field is missing from a record of the configuration files Unable to write to the specified point The Q sort stack is full and an attempt was made to push another item onto it The constant QSORT_SS_SIZE in the header file CTI_QSORT H must be increased and the CTI module must be rebuilt The specified point ID is referenced in a CTI configuration file but is not configured in the CTI_PT_DEF CFG file The PRT API returned an error when CTI attempted to use it The ITEM_KEY used to locate a PRT record did not correspond to any record in the PRT database Verify that the ITEM_KEY is specified properly in the CTI Configuration files GFK 1216F Failed to translate logical lt _LOGICAL_NAME gt NULL point ID received from Point Management Point lt POINT_ID gt has too few elements Response field lt FIELD NAME gt not defined in layout file GFK 1216F Appendix F Configurable Tracking In
74. bo REG ron Item ype ount 1 x Region ItemType i Id amp amp Region ItemType i Count mSgbox x next 1 PrtRegion ltemTypeCount Property Read syntax PrtRegion ItemTypeCount Description Integer property to get the number of Item Type Count records available for the Region These records provide totals of item Type IDs for a region Example Dim Region as new PrtRegion Region id Schedule Display Id and Number for all Item Types in a region for i 0 to Region ItemTypeCount 1 x Region ItemType i Id amp amp Region ItemType i Count mSgbox xX next 1 E 54 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtRegion Locateltem Method Syntax PrtRegion LocateItem itemld refld numRetries Description Locates a serialized item within the tracking region Upon return PrtRegion ItemCount contains the number of items found and may access each found item through the Prt Region Item function Comments Parameter Description itemld String The Item ID to locate may be an empty string if refId is specified refld String The Reference ID of the item to locate may omitted or an empty string if itemId is specified numRetries Integer optional The number of times to retry to find the item before failing If an item is in transition from one tracking region to the next there is a small period of time when it doesn t appear in either regions tracking queue
75. defined in the template will be maintained but placed at the end of the list of attributes If no attribute template is defined for an item type and no default attribute template is configured the existing attributes will be maintained Examples of records found in the CTI_LATTRIBUTES CFG file are _ 25 CONFIG CODE UPPER COLOR PS SEQ APN CODE GA SEQ HOLD CODE FIRST RUN ASRS BIN DEST CONE FG CODE UPPER COLOR 2S SEO APN CODE GA SEQ HOLD CODE FIRST RUN ASRS BIN DEST The above records represent the attribute template that will be used by the CTI for different PRT item types The first template will be used for PRT item type 25 all other PRT item types will use the second template For example an existing item of item type 25 is updated by CTI Its current attributes are the following Name Value PS SEQ 666666 INSPECTION CODE 12321111 GFK 1216F Appendix F Configurable Tracking Interface F 11 A point is received which sets the PS SEQ to 666534 and CONFIG CODE to OY When the point is done being updated the attributes for the item will be the following Name Value CONFIG CODE oY UPPER COLOR PS SEQ 666534 APN CODE GA SEQ HOLD CODE FIRST RUN ASRS BIN DEST INSPECTION CODE 12321111 CTI Disable Logical F 12 The logical CTI_LDISABLE controls the processing of points received by the CTI If CTI_DISABLE is set to Yes then CTI will take no action when it receives points If CTI_
76. eS PRT ITEM reference _ id 12 20 105 PRT_ITEM item_type_id 12 16 125 PRT _ITEM assoc_item_id 12 20 141 PRT _ ITEM item_status 12 8 161 PRY LTEM aint hold active i2 1 169 PRT _ITEM int hold _reason 12 40 170 PRT _ITEM ext hold_active 12 1 210 PRI TTEM group ioaz TEGI PRT _ ITEM num_valid_atts 12 3 227 PRT_ITEM att_1_name 12 16 230 PRT ITEM att 1 value 12 16 246 PRT_ITEM att_2 name 12 16 262 PRT_ITEM att_2 value 12 16 278 PRT_ITEM att_3 name 12 16 294 PRI ITEM att 3 value 12 16 310 PRT_ITEM att_4 name 12 16 326 PRT_ITEM att_4 value 12 16 342 G 6 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F PRT_ITEM att_5 name 12 16 358 PRI LTEM att 5 value T2 6 3 74 PRT_ITEM att_6_name 12 161 390 PRT_ITEM att_6_value 12 161406 PRT_ITEM att_7_name 12 16 422 PRT_ITEM att_7_value 12 16 438 PRT_ITEM att_8 name 12 16 454 PRT_ITEM att_8_ value 1216 4 70 PRT_ITEM att_9 name 12 16 486 PRI ITEM a tt 9 value 12 6 502 PRI LTEM act 1 0 name 177 26 513 PRI LTEM att LO value lTi 26 5 54 PRT_ITEM att_11_name 12 161 550 PRT_ITEM att_11 value 12 16 566 PRT ITEM att 12 name i2 6 562 PRI LTEM acu 2 value i17 16 S59s8 PRT_ITEM att_13_name 12 16 614 PRT_ITEM att_13_value 12 16 630 PRT_ITEM att_14 name 12 16 646 PRT_ITEM att_14 value 12 16 662 PRT_ITEM att_15_name 12 16 678 PRT_ITEM att_15_value 12 16 694 PRT_ITEM att_16_name 12 16 710
77. event_flag COR_BOOLEAN rcv_req_flag Char prt_system Cher Camo sys CORASITATUS Sre Cotati Data Structures None Input Arguments event_flag Message receipt event flag not used if rev_req_flag is FALSE rev_regq_flag Receive requests flag if TRUE this indicates the application will receive requests from PRT Data Collector processes for item tracking data and serialized item hold information prt_system Name of the PRT data server to connect to This parameter allows you to connect to different Production Tracking systems with the same API You may also specify the prefix of all the data servers you wish to connect to This allows the API to connect to multiple servers cimp_sys Name of the project or node where the PRT data collector s reside Output Arguments kretstat Pointer to COR_STATUS structure GFK 1216F Production Tracking Application Interface 5 3 5 4 Return Value Either COR_SUCCESS or COR FAILURE If the function returns COR _FAILURE additional error information can be found in the COR_ STATUS structure Error Codes PRTI _MF_INIT_ERR PRTI_CRESEG_ERR PRTI_BAD_MSG PRTI_FILE_OPEN_ERR PRTI_EMPTY_FILE PRTI_FILE_READ_ERR PRTI_REG_DEF_MISSING PRTI_GRP_DEF_MISSING PRTI_REGION_NOT_IN_GROUP PRTI_GROUP_HAS_NO_REGIONS PRI TL CRGANO ROUTE PRTI_ITEM_TYPE_NDEF PRTI ROUTE NDEE PRTI_INV_EXPLICIT_ROUTE PRTI_NO_TYPE_FOR_ROUTE PRTI_SVC_DEF_MISSING PRTI_BAD_SVC_NAME PRTI_XLATE_ERR PRTI_AUX
78. filename gt Error in ipe_xlate getting physical addr of lt address gt Error in ipc_aux_nam Error in ipc_add port Error in ipc_read_port Error in ipc_write_port Error initializing segment Error creating segment Error in segment Expected STATUS_SEG as response revd Ignored extra segments after STATUS_SEG or END_SEG Unexpected segment type svc lt filename gt Unexpected segment type from PRT_DS Item type identifier not valid Item type identifier NULL Invalid number of item attributes specified Region identifier not valid Region identifier NULL Group identifier not valid Group identifier NULL PRT service identifier not valid PRT service identifier NULL A I 11427 11428 11429 11430 11431 11432 11433 11434 11435 11436 11437 11438 11439 11440 11441 11442 11443 11444 11445 11446 11447 11448 11449 11450 11451 11452 11453 11454 11455 11456 11457 11458 11459 11460 11461 11462 11463 11464 11465 11466 11467 11468 A 2 PRTI_NS_EXT_PROC_INVALID PRTI_SER_NO_ID PRTI_NON_SER_ID PRTI_INVALID_TRK_TYPE PRTI_INVALID_REG_LOC PRTI_EXT_HOLD_NO_GRP PRTIEXT_HOLD_NON_SER PRTIINT_HOLD_NO_REASON PRTI_REG_NOT_IN_GRP PRTI_REG_NOT_IN_SVC PRTI_GRP_NOT_IN_SVC PRTI_NO_DEL_SUCCESSES PRTI_INVALID_DEST PRTI_NO_SUCH_ROUTE PRTIINVALID_ROUTE PRTI_SER_PARENT PRTI_EXT_HOLD_NO_REASON PRTI_ROUTE_NDEF PRTIINV_EXPLICIT_ROUTE PRTI_NO_TYPE_FOR_ROUTE PRTI_NOTHING_PENDING PRTI_CFG_
79. hold active group 1d int hold active int Wole reason Num aves valid item att irst Commentby User Or sve id retstat timestamp ext_proc_flag region_id PRT_REGION_ID_LEN 1 region_loc item_id PRT_ITEM_ID_LEN 1 reference_id PRT_ITEM_ID_LEN 1 item type 10 PRE ITL LEM TYPE TD DEN t 113 parent_item_id PRT_ITEM_ID_LEN 1 item_status ext hold actives group 10d PRI REGION ID LEN 1 inte nord active xint_hold_reason num_atts_valid xitem att list comment SC DESCRIPTION EEN 113 user or Svc 1d SERVICE ID LEN L3 retstat See Static Information Requirements CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Input Arguments Serialized Items Only ext_proc_flag item_id reference id ext hold_active group_id num_atts_ valid item_att list Non Serialized Items parent_item_id Both timestamp region_id External process flag if TRUE get all information from external process required Unique identifier of a Serialized Item optional if reference_id specified Secondary identifier of a Serialized Item optional if item_id specified If TRUE item held due to external hold required Group identifier providing reason for hold required if ext_hold_active TRUE Number of item attributes valid This specifies the number of array elements in the item attribute list that contain valid data If item_att_list isa NULL pointer the fun
80. in PRT history log file optional GFK 1216F Production Tracking Application Interface 5 79 5 80 user_or_svc_id User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Output Arguments xretstat t Pointer to COR_STATUS structure Return Value Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTC_BAD_REG_SPEC Bad region specified Warning PRTC_REORDER_MISMATCH Num of locs in request different from num of locs in region Warning PRTI_REG_ID_NULL Region identifier NULL Warning PRTI_REG_ID_NDEF Region identifier not valid Warning PRTI_REORD_NUM_TOO_BIG Element bigger than list size Warning PRTI_MF_INIT_ERR Error initializing segment Failure PRTI_CRESEG_ERR Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_next_svc Return each successive configured PRT Service Name prt_api_next_svc Description The first time this routine is called the svc_rec should be the address of a NULL pointer The schema record associated with the first configured PRT service will be returned in the svc_rec and the service id copied into the prt_svce_id string Each subsequent call will use the svc_rec pointer to get the next servi
81. in the PRT_REGION file supplies the ID of a text point to be set when an item moves into a tracking region due to a point based automatic move This point is set according to the value of the NUM_SETPT_PARAM parameter in the global parameters file The format for the NUM_SETPT_PARAM global parameter is NUM SETPT PARAMI3 lt number gt Where Ifthe parameter is not present or lt number gt is set to 1 the point will be set with the Item ID If lt number gt is set to 2 the point will be set with the Item ID and Type If lt number gt is set to 3 the point will be set with the Item ID Type and Reference ID If lt number gt is set to 4 the point will be set with the Item ID Type Reference ID and Source Region Alarm Move Exceptions In order to generate the Undefined Source Region alarm the global parameter PRT_ALARM MOVE_EXCEPTION must be defined in the global parameters file as follows PRT_ALARM MOVE_EXCEPTION 1 YES Note Details on how to add or change a parameter in the global parameters file are found in the CIMPLICITY Base System User s Manual GFK 1180 GFK 1216F Configuration File Guide 4 7 Production Tracking Application Interface About the Production Tracking Application Interface CIMPLICITY HMI software s Production Tracking API lets application programs access Production Tracking functions These functions include adding items to the Production Tracking system deleting items mo
82. is capable of receiving Point data from multiple Point Management processes Configuration data specifies the information Production Tracking will provide to Point Management The interface with Point Management Transfers information on Items entering and exiting Tracking Regions Provides Point Management with information on Tracking Region status Calculates the quantity of Items in a Tracking Region and the quantity of Items by type in a Tracking Region PRT Process to Alarm Management Process PRT interfaces with Alarm Management for notification of alarm conditions PRT can be configured to generate alarms when exception conditions are encountered as Items are tracked Users are notified of CIMPLICITY HMI alarms based on their assigned role and their view of configured Resources Application Process to PRT Process PRT accepts unsolicited messages from application processes requesting Item and Tracking Region data Messages are also accepted requesting Item tracking data and Tracking Region data modifications Application processes can send messages to PRT to initiate production start for serialized and non serialized Items Application processes will communicate to PRT through a limited set of PRT application functions used to send the requests PRT User Interface Your tracking system can be viewed graphically using the CIMPLICITY CimView module Custom displays and scripts can be created to show a detailed view of your product
83. item attributes are being provide for the item being added If the pointer is non NULL however it must point to an array of exactly PRT_NUM_ATTRIBUTES elements The num_atts_valid argument indicates how many of these elements contain valid data optional Associated serialized item identifier optional The time the item was last moved or modified The timestamp is used to ensure that when attempting to insert an item the item s currently at the location where the new item is to be inserted in front of have not moved or been modified between the time when information was last obtained for that item s and the attempt to insert the new item in front of it them One of the fields in the structure which returns data on an item is the last_mod_ time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the timestamp associated with the item s at the location where the new item is to be inserted in front of then the insert function is not performed and a warning returned If the timestamp argument passed to this function is zero the operation is performed without any timestamp checking Region where the item is to be added to the queue required Specific location in the region where the Item is to be added required argument Specified as FIRST EXIT LAST ENTRY or a number from 1 to n where n is the number of items in the q
84. list B Click Bil on the toolbar The Modify Item dialog box opens when you use either method Modify an item ae PRI UI GE Fanuc Aut imalar ut Modify lem 2 Goto Step 4 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F di Step 4 Enter Specifications in the Item s Dialog Box Step 4 Enter specifications in the item s dialog box 1 Select the General Information tab Note The Region ID field displays the active region to which you are adding inserting or modifying this item and is read only 2 Enter the item location in the Location field Note A value of 0 will place the new item after the selected item a value of 1 will place the item before the selected item In the Item ID field type the item ID Select an Item Class ID from the drop down list of configured item classes In the Reference ID field type the reference ID for this item Select an Item Type from the drop down list of configured item types Check the Int Hold box if you want to place an internal hold on the item Tab to the Reason field and type in an explanation for the hold pe oe a Oy ae Check the Ext Hold box if there is an external hold placed on the item by an external process in the region Note This will only affect the item indirectly 10 Tab to the Reason field and type in an explanation for the hold 11 Click Apply to effect changes Using the Production Tracking Window 3 185 Step 5
85. lon ie Sa Reg Lan u all H Fecords pracesa ed COW LAPLICOTY AAT pen jer t 7 Type lt text editor gt lt filename idt gt e g notepad prt_region idt 8 Press ENTER Result The text editor will open with the ASCII text version of the file displayed IDT file displayed in text editor oO ot egen idt Hoteged Edt Seach Help iT File gi ut PnP ar ee HP RECORD FRT_REGIOHW Production Tracking Region prt suc_id Resident Process Se REGION ID Tracking Region ID region desc Tracking Region des region label User defined Tracki tracking type id Region tracking typ region cap Haz physical regio region loc cap Hak fiber of ten E E E B E E The text editor opens with the ASCll text version of the configuration file displayed 4 4 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F About Configuration File Setup GFK 1216F Each configuration file has a set of reserved characters and restrictions that you must observe Once you understand how the files are set up you will have no trouble configuring your tracking model Details about configuration file setup include Reserved characters Restrictions Configuration file format Configuration File Reserved Characters The first line in the idt file must define three reserved characters All other characters in the line are ignored You may select characters other than the ones used here however avoid using characters that wil
86. lt region gt type lt item type gt No requests pending Route has no source and no destination region Error checking event flag Item not found Item not found some service s down Total number in list less than number requested MF_INIT segment received from unknown service Route has no source and no destination region No service specified via svc_id group_id region_id PRT Data Server returned bad error response No more items available Pointer to data structure is NULL Response received from unknown service Configuration file has no records Bad service name no underscore Partner dead Datagram buffer full No segments received into datagram buffer PRT Application not initialized to receive asynch messages Init segment received from Data Collector Process is not configured as network process Not all services responded GFK 1216F 11469 11470 11471 11472 11473 11474 11475 11476 11477 11478 11479 GFK 1216F PRTI_LNON_SER_ATTS PRTI_CANT_MOD_ITEM_REF_IDS PRTI_CANT_MOD_ITEM_WOUT_REF PRTI_REGION_NOT_IN_GROUP PRTI_GROUP_HAS_NO_REGIONS PRTI_LREORD_NUM_TOO_BIG PRTI_GRP_SPANS_SVCS PRTI_SVC_NOMATCH PRTI_REGSVC_NOMATCH PRTI_BAD_ALLOC PRTI_NULL_ITEMTYPE_LIST Non serialized item has attribute s Can t modify both item amp ref ids Must specify ref id to modify item id Region lt region gt does not belong to any group Group lt group gt does not own any regions element lt element gt bigger than
87. module uses a Tracking Model that you design and configure to support its tracking functions The PRT Tracking Model is configured using the Tracker Configuration User Interface The Tracker Configuration User Interface provides a directory structure for maintaining data and associated dialog boxes for configuring PRT data The PRT tracking model defines Tracking regions Entry and exit transition indicators bounding Regions Item types Tracking events to log Exception conditions for generating alarms Points required to support the graphic display of Tracking data The Tracking Model can be configured to track Individual items Items combining to reside at a single location Combine Items Tracking Region Items dispersing to reside at individual physical locations Disperse Items Tracking Region Associated items both physically and logically connected Important A source PRT project must have a remote project login configured for the destination project through the prt_client See the Base System User s Manual GFK 1180 the System Management chapter Remote Projects section for details about configuring for remote projects CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Tracking Regions GFK 1216F A Tracking Region is bounded by devices that inform the tracking model that an item has entered or exited the region The Region s entry and exit indicators are responsible for p
88. of the event When moving and src region is NULL region_1_idand region_1_1loc contain the destination location IAUX When serialized item is added to region and xref table indicates that the item was already somewhere within the view of that service the item already there is deleted region_1_idand region_1_1loc contain the location of the item being deleted When item is being deleted in source region due to a point transition region_1l_idand region_1_1loc contain the location of the item being deleted IAUN When item is being added to destination region due to a point transition region_1_idand region_1_loc contain the destination of the added item IADD When item is added via API or user interface If item is not production start and is added not inserted region_1_idand region_1_loc contain the location of the event IIN When item is added via API or user interface If item is not production start and is inserted not added region_1_idand region_1_loc contain the location of the event IMVX When item is being deleted in source region due to being moved via API or user interface region_1_id and region_1_loc contain the location of the item being deleted IMVN When item is being added to destination region due to being moved via API or user interface region_1_idand region_1_loc contain the destination of the added item IADX When item is being deleted in source region due to being advanced via
89. of the type of event which triggered logging Region_ld Name of modified region Region_Status Region status mask Comment Extra data sent to PRT to describe the changes made User_lId Identifies the agent which modified the Region CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Configuration Files The nature of PRT database logging logging is such that the fields for a given entry in the idt files will be the same across most platforms and projects Therefore the following sections simply contain sample files showing the configurations for the maximum set of loggable data These are not replacements for your existing files but rather should be merged with them In your own configuration you need only copy out the lines from these files necessary for the specific PRT data you wish to log and add them to your own existing datalog idt and data_field idt files Remember to replace PRT with the base name of your data server Datalog idt GFK 1216F The following is a sample datalog idt file IDI file generated by IDTPOP utility v1 0 RECORD DATALOG PARAMETERS FOR DATA LOG FILES SAMPLE FILE merge with datalog idt FILE ID SERVICE ID max rec size max_recs alarm_rec rollover_recs auto_rollover daily TOLr over add_stamp rollover emd timed_rollup archive_id compres
90. process is optional PRT will only request an external process to provide information on serialized items The Tracking Route for a Production Start Tracking Region can specify a limit switch as the Transition Indicator if the Item Type is explicitly defined for the route The Tracking Route for a Production Start must be configured to provide the Item ID if the item is to be Serialized If a limit switch is used to transition an item and the source region is empty the limit switch is ignored If multiple Items reside at a single Tracking Region Location one and only one of the Items may be a Serialized Item Out of sequence errors will apply to Serialized Items only Unexpected Item errors will apply to Non serialized Items In PRT Service configuration the External Process and External Hold Process cannot be the same process If an Item identifier or Item type identifier is set and the Item cannot be found an Item with that ID reference ID or type as appropriate is created Processing of Item Identifier points works in the following manner The first character of the point value is checked when the point value is received If the character is not the point is expected to contain the configured identifier and that Item is searched for and moved If the first character is a the rest of the value is checked against the reserved words If the rest of the value is found to be a reserved word the corresponding action is t
91. required if ext_hold_active TRUE Number of item attributes valid this specifies the number of array elements in the item attribute list that contain valid data num_atts valid item_att_list Non Serialized Items Only parent_item_id Both timestamp Item Attributes pertain to Serialized Items Item ID of associated serialized Item optional The time the item was last moved or modified The timestamp is used to ensure that when attempting to modify an item the item has not changed or moved between the time when information was last obtained for that item and the attempt to modify it One of the fields in the structure which returns data on an item is the last_mod_time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the timestamp associated with the item at the time of the attempted modification then the modification is not performed and a warning returned If the timestamp argument passed to this function is zero the operation is performed without any timestamp checking modify_bitmask Indicates fields that have been modified required If a bit in the bitmask is set the corresponding argument provided to this function is required If a bit is clear the corresponding argument is not accessed in any way The following fields are potentially modifiable and have a corresponding bit in the modify _bitmask Field Name
92. returned information Example Dim prt as new Prt Get a list of groups from PRT and display them one by one in a message box prt GetGroupList for JS Ul iso Dees GroupCount sl MsgBox pre Group 7 1d next j Prt GetltemList Method E 4 Syntax Prt GetItemList Description Gets a list of all items in PRT After calling the method the total item count can be obtained from ItemCount and the individual items may be accessed via the Item function To get the item list for a particular item class set Prt temClassId to the desired item class id before calling Prt GetItemList See Prt temClassId for more details Example Dim prt as new Prt Get a list of item from PRT and display them one by one in a message box prt GetItemList EO 4 Oto Pre tvemCoune L MsgBox prt Item j ItemId next J CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Prt GetRegionList Method Syntax Prt GetRegionList Description Gets a list of all Tracking regions After calling the method the total region count can be obtained from RegionCount and the individual regions may be accessed via the Region function Example Dim prt as new Prt Get a list of groups from PRT and display them one by one in a message box prt GetRegionList Tor O Os prt Rec TonCounme JL MsgBox prt Region j Id next J Prt GetServiceList Method GFK 1216F Syntax Prt GetServiceList Descripti
93. simplify and expedite searches in the PRT database Item Classes Group item types together to create a larger subset in the database Are independent of region group or service i Tip Although item types do not have to belong to an item class it is strongly recommended that you create item classes Feel free to create just one item class to which all of your item types can belong CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Generating Reports Production Tracking provides the capability to generate reports using logged data A common method for logging data is by using Microsoft s ODBC SQL Server and then generating reports using a report writer Using the PRT Interface to External Software The Production Tracking process provides Tracking Region data and Item tracking data to external application programs through the PRT Application Interface PRT also accepts requests through the application interface to dynamically provide interested external application programs with Item tracking data modifications The external process must send PRT a message to indicate it is requesting to become an interested process in order to receive dynamic serialized Item updates Tracking Data GFK 1216F You can export and import tracking data to and from the PRT process using Export Tracking Data Import Tracking Data Export Tracking Data The EXPORT TRACKING DATA function provides a mechanism to export the c
94. source region to destination region PTS Enable disable 1 0 production setpoints REG Modify region status STT Initiate a production start STP Initiate a production stop Subsequent fields in the record are delimited by a field delimiter character usually 1 defined on the very first line of the Import file Note A blank line in the import input file causes the Import program to terminate processing of the input file at that point All fields in the file are of type character The actual data passed to PRT is converted to the correct type by the Import program For the DELete command the disposition can be specified as SCRAP DEL or DELETE These strings are translated to the manifest constants SCRAP and DELETE For any API functions that require a region location argument e g the ADD and INSert commands the region location can be specified as ALL LAST ENTRY or FIRST EXIT These are translated to the manifest constants ALL_LOCATIONS LAST and FIRST respectively For arguments that are required to be a Boolean value the strings T TRUE F or FALSE can be specified which translate to the manifest constants TRUE and FALSE CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F ADD Add an Item to be Tracked This command provides a mechanism to add an individual Item to a location in which another Item currently resides The fields in this record are
95. specification for a tracking group 5 22 Add an Item Production Tracking window 3 13 Add item to region General information Location 3 17 Add item to tracking region queue 5 62 Advance an Item Production Tracking window 3 27 Advance tracking model 5 77 Alarm move exceptions Customizing production tracking 4 71 Alarms Production tracking 2 8 ALL PRT_EXPORT 4 67 Application subroutines Production tracking application interface 5 3 Auto Lock Regions Production Tracking window 3 31 Automatic resynchronization Sequence monitoring 2 7 B Basic control engine PRT extensions E 1 PRT object attributes E 2 Prt object description E 3 PrtAttribute object description E 3 GFK 1216F PrtGroup object description E 3 PrtItem object description E 3 PrtService object description E 3 C CIMPLICITY software component interface requirements Production tracking 2 12 Combine items tracking region rules Production tracking C 3 Comment Character 4 5 Concepts Production tracking 1 3 Configuration Files File format 4 7 Identify 4 2 IDTPOP utility 4 4 Optional 4 3 PRT Attribute Labels 4 32 PRT Display Point 4 26 PRT Group 4 12 PRT Group Tracking Region 4 17 PRT Interested Process 4 11 PRT Invalid Type 4 22 PRT Item Association 4 23 PRT Item Type 4 18 PRT Item Type Translation 4 21 PRT Region 4 13 PRT Region Attribute Counter Definitions 4 30 PRT Region Item Attribute Display Point 4 27 PRT Route 4 19 PRT Service
96. specifying Item type or An Application Interface message specifying Item type as a Region Entry Transition Indicator or Be preceded by a Sequential Tracking Region also monitoring the relative sequence of the Items in the region by their Item Type A Pool Tracking Region maintains the Items in the tracking queue in the order the Items entered the region GFK 1216F C 1 C 2 A Pool Tracking Region monitoring the Items in the Region by their unique Item identifiers must have An automatic Item Identifier or A User transaction specifying Item ID or Reference ID or An Application Interface message specifying Item ID or Reference ID as a Region Entry Indicator or Be preceded by a Sequential Tracking Region also monitoring the relative sequence of the Items in the region by their unique Item or Reference Identifiers A Pool Tracking Region monitoring the Items in the Region by their Item Type must have An Item Type detector or A User transaction specifying Item Type or An Application Interface message specifying Item Type as a Region entry Indicator or Be preceded by a Sequential Tracking Region also monitoring the relative sequence of the Items in the region by their Item Type An Automatic Item Identifier is equivalent to a User transaction or an Application Interface message in that it provides PRT with positive unique identification of the Item If more than one Entry Transition
97. target file purge export target file GO CSV iC CSV Lames Of records to export time of records not to purge SQL cmd to execute on rollover Appendix G PRT Logging Configuration G 5 PRT_GRP DL_RP 200 500 0 100 1 0 1 0O PG O SLOGGING X 0 0 0 OH PO Sle O Oise FO FEICIO 3 64 00 PRI LITEM DGcRP 960 L000 TOTOO TETO Oe Pal SLOGGCING I X TONO OO OlS LIOlOIS O1 CIC1O 86400 PRI REG DiRP 130 500 0 200 1 0 AAO PRT S LOGGING X IOUO OTS FETO FOE AFO T CO 3 64 0 0 Data_field idt The following is a sample data_field idt file f IDL Tile Generaved by HDIPOP UCELLCY 120 RECORD DATA_FIELD DLRP Field Definitions A SAMPLE ECEE m Merge wiih data t eld Idt i Ol TAB LB ID DLRP Table Identifier 1 field_id DLRP Field to be logged 2 cimp_type CIMPLICITY Data Type of Field 3 field_len Size of Field in cimp_type units 4 offset Offset of field in DLAP buffer PRT_GRP event_type 12 14 1 PRI lt GRPE roup 2 d b2 16 15 PRT GRP ext_hold_active 12 1 31 PRT _GRP ext_hold_reason 12 40 32 PRT GRP ext service _1d 12 32 72 PRT_GRP comment 12 40 104 PRT_GRP user_id 12 32 144 PRT_ITEM event_type 12 14 1 PRE TEM pene ry 7 ame 23 21 ck PRT_ITEM modify_bitmask 12 4 36 PRT_ITEM region_1l_id 12 16 40 PRT_ITEM region_1l_loc 12 5 56 PRT_ITEM region_2_id 12 16 61 PRE TIEMI Eegi On 2 1loc 1 23 77 PRT_ITEM tracking_type 12 3 82 PRE LITEM aeem 2 V2 20
98. that is not the Exit Transition Indicator for any other Tracking Region Item movement is directed from the Source Tracking Region to the Destination Tracking Region and cannot reverse direction along a single route A Tracking Region may have one and only one Detainment Region Multiple regions may utilize the same Detainment Region Configuration data determines when an Item is placed in a Detainment Region CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F A Tracking Region must be a member of at least one Tracking Region Group All Tracking Regions in a Tracking Group must be configured for the same PRT process Service ID Combine Items Tracking Region Rules A Combine Items Tracking Region is a region in which multiple Items enter the region through separate region Entry Transition Indicators and reside physically on the same Item Carrier in that region Multiple Items may also enter through one Entry Transition Indicator by PRT receiving multiple notifications from the Transition Indicator The Items themselves are in no way required to be associated GFK 1216F The Items merely reside on the same physical carrier they are not required to be associated in any way Multiple region Entry Transition Indications are allowed A single Exit Transition Indication is required from the region The region must be configured to have a region capacity of one Positive Item Type detection is required for each Item entering t
99. the delimiter e g C Type the name of the region e g ROBOT 8 Press Enter 9 Create your record s using the field descriptions as follows No Field Name Description Data Type 0 field_type Code defining the field type as follows One 0 Internal character 1 Attribute 2 Status 1 prt_field PRT field for which the modified label will be used 16 Use the following keywords characters PRT_ASSOC_ITEM PRT_EXT_HOLD PRT_GROUP_ID PRT_INT_HOLD PRT_ITEM ID PRT_ITEM_CLASS_ID PRT_ITEM TYPE PRT_REFERENCE_ ID PRT_REGION_ID 2 prt_label Label or column head to be alternately used in the 16 PRT window Recommend title case for alternate characters labels 3 field_size Width of the field by number of characters Integer 10 Click File on the menu bar after you have created all of your views and proceed as follows Do When Select Save The PRT_UI is configured to view all PRT Services Select Save As The PRT_UI is configured to view a specific service Then A Enter aprt_window cfg in the File Name field Where aprt is the name of the PRT Service B Click Save 11 Close the text editor Result The records created in the prt_window cfg file will impact the type and arrangement of the information displayed in the PRT window by PRT Service by common view and by region GFK 1216F Configuration File Guide 4 37 Default view already configured Common view record created Region view record 4 38 created Co
100. the last display Failure Can not add item to unoccupied location inserting Warning Can not have two serialized items at one location Warning Item type identifier NULL Warning Item type identifier not valid Warning ext_proc_flag set for non serialized item Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Parent ID specified for serialized item Warning Group identifier NULL Warning Group identifier not valid Warning External hold specified for non serialized item Warning Internal hold specified without reason Warning CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F PRTI_NON_SER_ATTS PRTI_NUM_ATTS_INVALID PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_INVALID_REG_LOC PRTI_ITEM_TYPE_NULL PRTI_INVALID_DEST PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Non serialized item has attribute s Warning Invalid number of item attributes specified Warning Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning Item type identifier NULL Warning Destination region is invalid for item of this type Warning Error initializing segment Failure Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd Production Tracking Application Interface 5 65 5 66 prt_api_insert_item Insert Item Into Tracking Region
101. the operation Delete an Attribute 3 Select the attribute to be deleted from the list Click Delete The Delete Attribute dialog box opens Delete Attribute P To delete this attribute Name COLOR Fields are Value GREEN read only Cancel Click OK to delete the attribute or click Cancel to cancel the operation Using the Production Tracking Window 3 19 Modify an Attribute L Select the attribute to be modified from the list 2 Click Modify 3 The Modify Attribute dialog box opens Modify Attribute Name COLOR Walue BLUE Cancel Do either or both A Change the Name B Change the Value 4 Click OK to modify this attribute or click Cancel to cancel the operation Insert an Attribute l Select an attribute on the list as the insertion point Note Attributes are inserted before selected item Click Insert The Insert Attribute dialog box opens Insert Attribute E4 Name COLOR Valle GREEN Cancel Enter the name of the attribute to be inserted in the Name field Enter the associated value in the Value field Click OK to insert the attribute in the list or click Cancel to cancel the operation 3 20 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Step 6 View and Modify Status of Item 441 To view and modify the status of an item 1 Select the Item Status tab The status list displays Modify item status Adal Item Gen
102. v1 0 RECORD LOGPROC LOGICAL PROCESS IDENTIFIERS 0 PROCESS_ID Process Identifier 1 process_type_id Process Type Identifier 2 pm_flags Bits last 5 AP RSTAL LD NOAL WT 3 description Process Description PRTCNT RESIDENT 1 Prt Attribute Counts Node_Logproc GFK 1216F IDT file generated by IDTPOP utility v1 0 RECORD NODE_LOGPROC PROCESSES ON SPECIFIC NODES 0 NODE_ID Decnet Node Name 1 PROCESS_ID Process Identifier 2 image_name Executable Image name 3 priority Process Priority 4 base_quan Base quantity 5 max_quan Max Quantity 6 astlm AST Limit 7 biolm BIO Limit 8 bytlm BYTE Limit 9 cpulm CPU Limit 10 diolm DIO Limit 11 englm ENQ Limit 12 fillm Fil Limit 13 pgflquota Page file quota 14 preml PRCLM field name is a typo 15 tgqelm TQELM 16 wsdefault Working set Default 17 wsextent Working set extet 18 wsquota Working set quota 19 sys _priv_mask System wide process privilege mask MASTER PRTCNT BSM_ROOT exe prtcnt exe 4 1 1 80 50 50000 0 50 2 000 100 50000 10 50 99 999 9999 1 Appendix I Attribute Counts by Region Physproc IDT file generated by IDTPOP utility v1 0 RECORD PHYSPROC PROCESS NAMES ON SPECIFIC NODES NODE_ID Decnet Node Name PROCESS_ID Logical Process Name object_name Decnet Object Name order Redundant or Allocated Process Order F WN EF oO MASTER PRTCNT PRTCNT 0 Prt_Intproc
103. was last obtained for that item and the attempt to modify it One of the fields in the structure which returns data on an item is the last_mod_time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the timestamp associated with the item at the time of the attempted modification then the modification is not performed and a warning returned If the timestamp argument passed to this function is zero the operation is performed without any timestamp checking region_id Region where item last resided required item_id Unique identifier of a Serialized Item optional if reference id specified reference_id Secondary identifier of a Serialized Item optional if item id specified CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F num_atts_ valid item_att list comment user or svc_id Output Arguments retstat Return Value Number of item attributes valid this specifies the number of array elements in the item attribute list that contain valid data Item Attributes pertain to Serialized Items required Comment to be recorded in PRT history log file optional User or service identifier optional Pointer to COR STATUS structure Either COR_SUCCESS COR_WARNING or COR_FAILURE If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR _ STATUS stru
104. with all previous items in that region being overwritten Non serialized items do not have reference ID s so they are moved and not affected by the reference ID Actions triggered by what serialized items exist are If No serialized items are in the source region Then A message is logged warning the user If Multiple serialized items exist at a location Then All items are moved Actions triggered by the handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user GFK 1216F Appendix H Configuring PRT Client Startup H 7 Transition Type 6 Associate Item Type to Item Tracker searches the source region for the item type SUNKNOWN If SUNKNOWN is found the item type is changed to what the user entered Actions triggered by the result of the search for SUNKNOWN are If No items with the SUNKNOWN item type are in the source region Then A message is logged warning the user If The source region is a disperse region Then Only the item with the SUNKNOWN item type will move If Multiple items exist at a location and the source region is not a disperse region Actions triggered by the handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then T
105. zero CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Appendix C PRT Rules and Assumptions General Rules A Tracking Region is delimited by the Region s defined Entry Transition Indicator and the Region s Exit Transition Indicator A Region Entry Exit Indicator consists of an automatic Item identifier an automatic Item Type detector a limit switch a User Interface transaction or an Application Interface message If an Item enters a Region and that Item occupies a location exceeding the capacity of the Region configuration data determines if an Alarm is generated If an Item enters a Combine Items Tracking Region and that Item s presence in the Region exceeds the capacity of a location in the Region configuration data determines if an Alarm is generated A Sequential Tracking Region monitoring the relative sequence of the Items in the region by their unique Item identifiers must have An automatic Item identifier or a User transaction specifying Item ID or Reference ID or An Application Interface message specifying Item ID or Reference ID as a Region Entry Transition Indicator or Be preceded by a Sequential Tracking Region also monitoring the relative sequence of the Items in the Region by their unique Item identifiers A Sequential Tracking Region monitoring the relative sequence of the Items in the Region by their Item type must have An Item type detector or A User transaction
106. 0 RECORD PRT S YSDEF Production Tracking System Definitions H 4 a 4 5 i f sd T 4 API REG PORT api_sync_port apa int_port ic main port ts main port ds throttle port is ink port he auk port 8 10 10 20 20 20 So 10 PRT SERVICE The PRT Service prt_service configuration file is used to identify each Production Tracking Service Each of the fields is described below complete with entry examples and a sample configuration file REQUIRED FILE No Field Name 0 prt_svc_id 1 prt_search_order 2 ext_item_svc_id 3 ext_hold_svc_id 4 det_reg_alrmid 5 region_lock_alrmid 6 region_cap_alrmid 7 loc_cap_alrmid GFK 1216F g size for app interface reguest port quewe size For api synchronous port J size For api interested process port queue size For Data Collector main port gurur size For Data Server main port queue size For Data Server throttle port g size for DS interested process port gutue Size For Gata Collector sux port 10 10 100 20 20 20 50 10 Expanded view of new record Description Specifies the PRT Data Collector Resident Process Service ID This must be identical to the ID in service dat Indicates the order in which this service will be searched for information relative to other configured PRT Services Service ID of the external process providing item tracking data Service ID of the external process providing hold information Al
107. 1 _TOTAL ASMBLYLNEI _STAT 1 OpWks_1 Blank 4 15 44 45 46 47 48 49 2 records created 4 16 Field Name alarm_unknown_type log_unknown_type alarm reg_cap log_reg_cap auto_move_point tran_region_id Description Enable disable 1 0 alarm generation when an unknown item type enters the region Enable disable 1 0 logging when an unknown item type enters the region Enable disable 1 0 alarm generation when the region s configured capacity has been exceeded Enable disable 1 0 logging when the region s configured capacity has been exceeded Text Point ID that displays when an item moved into the region due to a Point based move The Point contains the item ID and optional information depending on the value of the num_setpt_param set in the global parameters files Indicates the transition region ID for a shifting region Configuration File Example pet epi i Hohepa Data Type One byte One byte One byte One byte 55 characters 16 characters chg override al alarm_oos_ region ea dis oof comdition alrm 4 alarm_invsal_ tippe madis invalid item tippe alrm 4 leg iewal type adis ineslid item tope legging bh alarma onkmown type en dis unknows itea type alrm 2 4S leg imknown Type endis unknie iten type logging bi alarm reg cap aadis region capacity alra dF leg Peg cap aadis region capacity logging dh asto move point automa
108. 1 3 TEXT_VALUE_4 RCV_POINT_2 ATT_7 100 OTHER_TEXT_1 REV POINTE 2 ATT 7 101 OTHER TEXT Z REV POINT 2A 7iPLoZ2 OTHER RUTEXT 23 GFK 1216F Appendix F Configurable Tracking Interface F 7 The above records represent the translation that will be performed for various attribute values when they are obtained by CTI from an ANALOG array point Attributes which do not have any translation configured will be converted by CTI into the ASCII character equivalent for the same value An example of what the record stands for follows The point RCV_POINT_2 has an attribute field relationship defined in CTI_ LAYOUT CFG If the field representing the attribute ATT_1 contains the integer value zero CTI will assign the ASCII text value TEXT_VALUE_1 to the corresponding attribute in the PRT data record when an update is performed Since the attributes ATT 3 ATT_4 and ATT_5 and the item status are not specified for this point CTI will translate the integer values for these attributes into their ASCII character equivalents Point Definition File CTI_PT_DEF CFG The configuration file CTI_PT_DEF CFG defines the points which the CTI will use to send and receive data The records in the file contain the following fields RECEIVED POINT ID The name of the CIMPLICITY TEXT or ANALOG point that will be used by CTI to receive data CTI PROCESS ID The process ID as configured in the system configuration files of the CTI process that will handle modi
109. 2 X S2 T S2 3 0 GFK 1216F RL E oh bhi ok gg process First _ptchange orig region id Ib of region item exits dest region id ID of region item enters iten_type_id b gt of type traveling between regions transition ptid ID of transition point between regions eet ptid b gt of point to be set on transition translation id ID to interp type trans indicator transition type code transition indicator type code 1 98 Should we process the first point change REG1 PROJ SRC1 X_S1 T_S1 310 0 1 2 3 4 567 Field Descriptions 0 Source region from which the item will exit 1 Fully qualified path to the project and destination region to which the item will enter 2 Item type ID that will be traveling this route can be left blank if numerous types will be traveling this route 3 Transition Point ID between the two regions Point ID to be set when items transition from the source region to the destination region 5 Translation ID to interpret the type transition indicator field left blank in example Transition type code see Tracking Route PRT_ROUTE for details Process first point change determines whether to process the first point change of a route as a transition point Configuration File Guide 4 39 PRT_Inv_Type Configuration for PRT Client PRT_INV_TYPE Configured to run PRT Client Process pet_inv_type idt Notepad j IDT File generated by IDTPOF utility v1 0 RECORD PRT_ IMU
110. 2001 GFK 1216F GFK 1216F PrtService ItemClassId Property Read Write ccccccccsssssssseeeeeeeeeeees PrtService ItemCount Property Read cccccccceceecceceeeessssseeeeeeeeeeeees PrtService LocatelItem Method ou ceeccceecccesecceesceeecseessseenscseeeseees PrtService Region Function cccccccssceesssssseseeeeeeeecccccsssceeessssseeseeeeeess PrtService RegionCount Property Read cccccccceccecceceeeeesssseeeeeeeeees Appendix F Configurable Tracking Interface About the Configurable Tracking Interface ccccccccccecccseteenssseeeeees CIMPLICITY Environment 2 04 Acsisscsnded incense er e T Oai CIMPLICITY Base System Configuration ccccccccecceceeeeeeesseeeeeeeees SHE COMMS UT AMON eiar a E T A E Configurable Tracking Interface Specific Configuration Files CTI PRT Mapping File CTI_RP CFG eesse Field Layout File CTI_LRP_LAYOUT CFG eee Field Translation File CTI_XLATE CFG cc eee eeees Point Definition File CTI_PT_DEF CFG 00 eee Attribute Template File PRT_SRV_ATTR CFG 0 0 0 CTT Disable Logical reenen a i e e Layout Or Data POMS danie iaa R nastoanossomnbatnadtesstass ApPPicatonr S AUD eere a e E EE SENSA hana A A NA CIMPLICITY tor NT Starup iec arni a tales a PODCUPUAE S ceea e a E Mere nsie ts Transitions Between Regions sssssssssssseeerrrrssssssssssssseerrerrrrrresessssssssses Sal TR COOLS censeo E OE O
111. 2001 GFK 1216F Transition Type 2 Type Detector Tracker cross references the given integer with the item type Important The PRT_TYPE TRN file must be configured to describe the cross reference between the integer entered and the item type to be moved Actions triggered in the region are If The item type is found in the source region Then The item is moved to the destination region If The source region is a disperse region Then Only the item whose item type is cross referenced with the given integer moves If Items exist at a location and the source region is not a disperse region Then All items are moved Actions triggered by the handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user Transition Type 3 Item Identifier Tracker searches for the item with the given item ID in the entire model Actions triggered by Tracker finds in the entire model are If The item is not found Then A message is logged If The source region is a disperse region Then Only the given item is moved If Multiple items exist at a location and the source region is not a disperse region Then All items at the location are moved Actions triggered by the handling of a moved item are If Not handled along the route Then The item moves and A message is logged w
112. 334 PRT_ITEM att_36 name 12 16 1350 PRI TTIEM ett 3 6 value 12 16 1566 PRT TTEM att 37 name 12 16 13382 PRI LTEM act 3 7 vaelire i127 16 2396 PRT_ITEM att_38 name 12 16 1414 PRI TTEM ett 36 value 12 16 1430 PRT_ITEM att_39 name 12 16 1446 PRI TIEBM ect 39 value 12 16 1462 PRT_ITEM att_40 name 12 16 1478 PRT_ITEM att_40 value 12 16 1494 PRT_ITEM comment 12 401 1510 PRT ITEMI user id 12 13211550 PRT_REG event_type 12 14 1582 PRT REGIregion QUILO Iba PRT REG region starcus I2 612 PRT_REG comment 12 40 1620 PRT_REG user_id 12 32 1660 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Appendix H Configuring PRT Client Startup About PRT Client Startup Configuration In order to have the PRT Client application start when CIMPLICITY starts the following configuration files must be modified Each file needs to be changed in the Master directory An example of each file follows showing what needs to be added to that file The files are E PRYSDrOC m LOgproc Node_Logproc Service E Master mcp PRT Client Configuration Files to be Modified PRT Client configuration files to be modified include Physproc Logproc Node_Logproc Service Master mcp GFK 1216F H 1 RECORD 0 1 2 3 Physproc IDEF Tile generated py IDTFOP Utility ysy PHYSPROC PROCESS NAMES ON SPECIFIC NODES NODE_ID PROCESS_ID object_name order Decnet
113. 4 CIMPLICITY HMI Plant Edition Tracker Production Decision Control Operation Manual GFK 1218 CIMPLICITY HMI Plant Edition Tracker Routing Control Objects Operation Manual GFK 1480 CIMPLICITY HMI Plant Edition Base System User s Manual GFK 1180 CIMPLICITY HMI Plant Edition Basic Control Engine Language Reference Manual GFK 1283 CIMPLICITY HMI Basic Control Engine Program Editor Operation Manual GFK 1305 CIMPLICITY HMI Basic Control Engine Event Editor and BCEUI Operation Manual GFK 1282 Contents GFK 1216F Introducing Production Tracking Welcome 16 Production Trackin ekesissan os Production Tracking Concepts ccccccsssssssessssseeeeeeeeceeeeeesaasaessseseeeeeeeees Tracker Server and Display Options ccccccceceececceeeeeeseeeseeeeeeeeeees Tracker TASCA AOI ecsaises carols duns nasseareies T tans Tracker Option Registrati since cassia ania aiecautean Production Tracking Overview ADOUt Production Trac kines citcc cscs tau siteaauuteee Descente a Slate Using the Tracking Model Summary ccccccceeeeeeeeeeeeeees TRAC Kola IRC PIONS 205 tihccucteens ergs sh bannanatnnetatcausonah ss tae acnmamceseacaatel INSSOCLAMMS temis eis cciciccen asta an N eE EERE EEEN ENEE Modifying an Item s Status socivestiscancadoonsitelsiadaddisasawentescovel tereincs Monitoring Sequencess 4 cci aint ae Generating CIMPLICITY Alarms ccccssssssssesseeeeeeeeeeeees Configuring CIMPLICITY
114. 4 9 PRT Standby Process 4 34 PRT Status 4 24 PRT System Definitions 4 8 PRT Window 4 36 prt_assoc 4 23 prt_att_pt 4 27 prt_attributes cfg 4 32 prt_disp_pt 4 26 prt_group 4 12 prt_grp_reg 4 17 prt_intproc 4 11 prt_inv_type 4 22 prt_item_typ 4 18 prt_reg_att 4 30 prt_region 4 13 prt_route 4 19 prt_service 4 9 prt_status 4 24 prt_stnd cfg 4 34 prt_sysdef 4 8 prt_type_trn 4 21 prt_window cfg 4 36 Index i Required 4 2 Reserved characters 4 5 Restrictions 4 6 Configuration validation program Production tracking 4 52 Connect to Multiple Project Production Tracking window 3 10 Connect to remote connection manager 5 84 Contents of the production tracking application subroutine interface 5 1 Continuation Character 4 5 Copy static region information into region structure 5 55 Customizing Production tracking 4 71 Production tracking Alarm move exceptions 4 71 Production tracking Synchronization capability 4 71 D Database Hierarchy 1 4 Delete an Item Production Tracking window 3 22 Delete scrap item from tracking region queue 5 23 Delete scrap items from tracking region queue location 5 26 Delimiter Character 4 5 Disperse items tracking region rules Production tracking C 4 DSP PRT_EXPORT 4 67 E Enable production stop for an item 5 59 Enable disable tracking region setpoints 5 78 Error codes Production tracking A 1 Event codes production tracking About B 1 Region related interested process updat
115. 5 66 Installation Tracker 1 6 Interface to external software Export tracking data 2 11 Import tracking data 2 11 Interface to External Software Production tracking 2 11 Item associations Production tracing 2 4 Item Classes 2 10 Item status Production tracking 2 5 Item Tracking Production Tracking 2 9 L Load serialized item hold data 5 10 Load serialized item tracking data 5 8 Locate an item Production tracking user interface 3 28 Locate serialized item 5 28 Location Add item to region general information 3 17 Methods PRT Prt GetGroupList E 4 Prt GetItemList E 4 Prt GetServiceList E 5 Prt LocateItem E 8 Prt RegionList E 5 PrtCheckRoute E 13 PrtGroup ClearExtHold E 14 PrtGroup GetItemlist E 16 PrtGroup GetRegionList E 16 PrtGroup LocateItem E 19 PrtGroup Modify E 19 PrtGroup SetExtHold E 21 PrtItem Add E 22 PrtItem ClearModifyTime E 24 PrtItem Insert E 31 PrtItem Modify E 34 PrtItem MoveTo E 36 PrtItem ProdStart E 38 PrtItem ProdStop E 39 PrtItem RefId E 40 PrtItem RemoveAttr E 43 PrtItem SetAttr E 44 PrtItem SetStatusBit E 44 PrtItem Status E 45 PrtRegion AdvanceModel E 47 PrtRegion ClearStatusBit E 48 GFK I216F Index PrtRegion DeleteItem E 49 PrtRegion GetData E 50 PrtRegion GetItemList E 51 PrtRegion LocateItem E 55 PrtRegion Modify E 57 PrtRegion Reorder E 59 PrtRegion SetPoints E 60 PrtRegion SetStatusBit E 61 PrtRegion StatusBit E 63 PrtService GetGroupList E 65 PrtService GetItemlist E 66 PrtServ
116. 75 prt_api_check_route Validate Tracking Route Name prt_api_check_route Description This routine provides a mechanism for validating that an ITEM of a specific type is configured to move from a Source Tracking Region to a Destination Tracking Region Route validation is performed locally by the API from configuration information that was read into the API s internal schema during initialization If the function returns COR_SUCCESS the route is valid If some other status is returned the err_code field of the COR_STATUS structure will contain additional information If a valid route does exist between the source and destination regions specified according to the configuration data but the item type specified is not allowed to transition along this route PRTILINVALID_ ROUTE is returned in the err_code field If there are no routes configured between the source and destination regions specified the err_code field is set to PRTI_LNO_SUCH_ROUTE Syntax int prt_api_check_route src_region_id dest_region_id item_type_id retstat char src_region_id PRT_REGION_ID_LEN 1 char dest_region_id PRT_REGION_ID_LEN 1 char item type te PRT ITEM TXAPE ID LEN 3 COR STATUS retsta t Data Structures See Static Information Requirements Input Arguments src_region_id Source region id the starting region of the route required dest_region_id Destination region id the destination region of the route required item_typ
117. ADD INS or MAT records will result in an error being reported to the user CLL Clear Location The Application Interface call for this record type provides a mechanism for deleting or scrapping all items at a given location in a specific Tracking Region The fields in this record are char record_type 3 CLL char region td ir Identifier of the Tracking Region where the Item is to be deleted from the queue COR_I1 disposition Manifest constant specifying the disposition of the item which can be specified as DEL DELETE or SCRAP char comment 41 Comment to be recorded in prt history log file char user or svc_id 33 User or service identifier 4 56 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F DEL Delete a Tracked Item The Application Interface call for this record type provides a mechanism for deleting or scrapping a single Item from all configured PRT services a specific PRT service a specific Tracking Group or a specific Tracking Region The fields in this record are char record type 3 DEL char prt syg 20 33 PRT service identifier Char group sally Identifier of the Tracking Group char region_id 17 Identifier of the Tracking Region where the Item is to be deleted from the queue COR I2 region Loe Region location where the item resides Char stem 1d 21 Unique identifier of a serialized item Kererence zida Secondary identifier of a serialized item char lt
118. AP PEM ROOT ese ep exe 20 1 1 ae S8 SHOR HY SO 2008 10 Sena 12 So 99 999 R99 4 MASTERY PRT_IHT O0SH_EN0T EXE PAT_INTTEFT EXE 20 1 1 88 SH SHdGh Sanaa S A 1H SOp Po Pos Pee 4 o n E MASTER PRT_INT BSM_ROOT EXE PRT_INTTEST EXE 20 1 1 80 50 5000 0 50 2000 1 00 50000I 10 50 99 999 9999 1 Expanded view of record configured for prt_inttest exe 3 For this record you are only concerned with the entries in the first three fields Use the default values for the remaining fields which can be found on the sample configuration Field Field Entry No Name Description Example 0 node_id Node name always MASTER MASTER 1 process_id The name of the process that the PRT_INT program will look to for data 2 image_name The name of the executable image BSM_ROOT EXE Configure as follows PRT_INTTEST EXE Directory_name exe prt_inttest exe Save the file 5 Use the SCPOP Utility to convert file back to binary format CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Step 5 Configure Service J1 Step 5 Configure service 1 Use the IDTPOP Utility to convert the file to ASCII text using the text editor of your choice e g Notepad 2 Press Ctrl End to bring you to the next available line to enter your record see figure Z service_idt Notepad OF x File Edit Search Help IDT file generated by IDTPOP utility v1 6 RECORD SERVICE SERVICE IDENTIFIE
119. AREA E Frck Lead Exit E Tracking TRACKING MIDARES C MIDARER CjhHiddle SCRAP B SCRAP DD Scrap f b GROUP ID i group label 2 group desg J recomrce id Log grp_ medi CIMPLICITY HMI Tracking Operation Manual July 2001 Data Type 16 characters 16 characters 40 characters 16 characters One byte Unique 0 For Tracking Group User defined Tracking Group Label Tracking Group Gegeription Unigee Aesource 0 For Tracking Group Flag For Logging Tracking Group Modifica ection Trackiog TRACKING 1 EASTAREA_B EAST AREA B JEAST AREA B Tracking TRACKING 1 Expanded view of the Entry Example EASTAREA _ B EAST AREA B EAST AREA B Tracking TRACKING Mi E No delimiter character after last field in record GFK 1216F PRT REGION The PRT Region prt_region configuration file is used to define every region in the Tracking Model Each of the fields is described below complete with entry examples and a sample configuration file REQUIRED FILE No Field Name 0 prt_svc_id 1 region_id 2 region_desc 3 region_label 4 tracking_type_id 5 region_cap 6 region_loc_cap 7 oos_cycle_ count g oos_error_code 9 GEF_reserved_1 10 GEF_reserved_2 11 GEF_reserved_3 12 GEF_reserved_4 13 det_region_id GFK 1216F Description Specifies the PRT Data Collector Resident Process Service ID This must be identical to the ID in service dat Unique name for the tracking region Textual d
120. Arguments pet eyed PRT service identifier optional but required if no other arguments specified group_id Identifier of the group optional but required if no other arguments specified region_id Identifier of the region optional but required if no other arguments specified required if region location specified Note At least one of the above three arguments must be specified If not all services will be queried It is possible that a list of items will be collected but not all services will have responded because one or more of them were down Thus the user has a list of valid responses but may not have all the 1tems that should have been returned In this case the function will return COR_WARNING with an err_code of PRTI_NOT_ALL_SVCS_RESPONDED The function returns through an argument passed the number of items actually received This argument will show how many valid items were received region_loc Specific location in the region required If all items within a region are being requested the region_loc must be specified as ALL_LOCATIONS Otherwise a specific location requests items at only that location GFK 1216F Production Tracking Application Interface 5 35 Output Arguments siten count Count of Items returned to schema GeEStac Pointer to COR_STATUS structure Return Value Either COR_ SUCCESS COR_WARNING or COR_FAILURE If the function returns COR WARNING or COR_FAILURE additional err
121. Bit Name item_ status status_bitmask item_id reference_id item_type_id parent_item_id ext_hold_ active group _id int_hold_active int_hold_ reason num_atts_ valid item_att list Production Tracking Application Interface ITEM_STATUS_BIT ITEM_STATUS_BIT ITEM_ID_MOD_BIT REFERENCE_ID_MOD_BIT ITEM_TYPE_ID_BIT PARENT_ITEM_ID_BIT EXT_HOLD_BIT EXT_HOLD_BIT INT_HOLD_BIT INT_HOLD_BIT ATTS_VALID_BIT ATTS_VALID_BIT 5 19 5 20 status _bitmask region_id region_loc item_type_id item status comment user or svc_id int hold active int _hold_reason Output Arguments retstat Return Value See the next chapter for a list of macros that can be used to set the various bits in modify _bitmask to indicate which fields are being modified Note that the item_id and reference_id if both are specified are used to find the item unless either the ITEM_ID_MOD_BIT or REFERENCE_ID_MOD_BIT is set both cannot be set If neither is set the item you are looking to modify will only be found if both the item_id and the reference_id you supply match that of an item already in the production tracking system The item_ids need not match however if the ITEM_ID_MOD_BIT is set and similarly the reference_ids need not match if the REFERENCE_ID_MOD_BIT is set Indicates fields in item status that have been modified optional Region where item last resided required Location in the region where the item reside
122. CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_move_item Move Item To Location In Tracking Region GFK 1216F Name prt_api_move_item Description This routine provides a mechanism for moving an Item from the Tracking Region where it Syntax Ln pr char char COR_I2 CORTZ COR BO char char char char char CORS T currently resides to a new Tracking Region It also permits the movement of an individual Item from one location to another within the same Tracking Region The semantics of this call specify that if neither the item_id reference_id or item type_id is specified all items are moved from the specified source to the specified destination region If neither the item_id or reference_id is specified but the item_type_id is a single item of the specified type is moved from the source to the destination region If we re moving a serialized item the source location need not be given The specification of the destination region location argument is the same as that for the prt_api_add_item function if the insert_flag passed in is FALSE and is the same as that for the prt_api_insert_item function if the insert_flag passed in is TRUE t_api_move_item src_reg_id dest_reg_id Sre reg loc dest_reg_loc insert_flag item_id reference_id item_type_id comment user or svo id retstar src_reg_id PRT_REGION_ID_LEN 1 dest_reg_id PRT_REGION_ID_LEN 1 src_reg_loc dest_reg_loc
123. CITY HMI Tracking Operation Manual July 2001 GFK 1216F Fetching an Item To retrieve an item from one region and move it into the active region use the Fetch Item function uy To retrieve an item and move it into the active region 1 Click File on the menu bar 2 Select Fetch The Fetch Item dialog box opens Faidh liam Places item in the next consecutive region location Enter the ID of the item that you want to retrieve in the Item ID field Enter the reference of the item you want to retrieve in the Reference ID field Indicate the region location where the item is to be placed in the Location field S a Optional Check Fetch to next location to place the item in the next consecutive location Note If you selected an item in the PRT window the location will be automatically filled in GFK 1216F Using the Production Tracking Window 3 23 Example Active Region has the following occupied locations L1 L2 and L3 Each location is capable of holding 2 items Originally the region looks like the following Location ltem L1 Item1 L2 Item2 L3 Item3 Retrieving a new item Item4 into L3 in the region with the Fetch to next location box unchecked would result in the following Location ltem L1 Item1 L2 Item2 L3 Item3 L3 Item4 Item is retrieved into the location to reside with the other item Alternately retrieving a new item Item4 into the region with the Fetch to next location
124. Clear Active Deactivates status by changing from Yes to No 5 Click OK to effect changes to the region status or click Cancel to cancel the operation 3 30 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Auto Locking Regions Regions that are configured to be lockable in the PRT Region Configuration dialog box must have certain status bits set when performing operations on items The Auto Lock feature will automatically lock and retain the status bit settings for you whenever you perform operations on items within the region You must turn on the auto lock feature to enable its functionality See the Tracker Getting Started Guide GFK 1694 for further details on the Auto Lock feature 44 To turn on the auto lock feature Method I Menu option 1 Click Operation on the menu bar 2 Select Auto Lock Method 2 Quickest Click E Do one or the other Click toolbar button Apae ien Help ke BE ea VIBE ic e Reference lD Entry Time Mod Time I F Projects Click Operation and then select Auto Lock to activate feature Fe Locate 7 Quer Tool Loc Default Datasource Thursday June 10 7 Thursday June 1 Reorder Thursday June 10 1 Thursday June 2 Region Status Thursday June 10 1 Thursday June JO O T Thursday June 10 1 Thursday June Filter by Item Class Refresh Regioniist Auto Lock Locations 4 Items 4
125. Count Read eld Read Write ltemCount Read Projectld Read Write RegionCount Read Methods GetGroupList GetltemList GetRegionList eLocateltem Properties eAttrCount Read Comment Read Write eEntryTime Read eExtHold Read Write ExtHoldGroupld Read Write eltemld Read Write eIntHold Read Write eIntHoldReason Read Write eltemTypeld Read Write Modify Time Read eParentld Read Write Projectld Read Write Refld Read Write Regionld Read Write Serviceld Read Write Status Read Write eUserld Read Write CIMPLICITY HMI Tracking Operation Manual July 2001 Methods Add ClearModify Time ClearStatusBit Delete e nsert eModify eMoveTo eProdStart eProdStop eRemoveAttr eSetAttr eSetStatusBit eStatusBit GFK 1216F Prt This can be considered the root object of Production Tracking From the root you can obtain a list of PRT Services a list of PRT Groups a list of PRT Regions and a list of PRT Items Obtaining a list of items would return every item currently in the PRT system You can also locate an item which will return all instances of the item within PRT PrtService This object contains information on a particular PRT Service The object can be obtained from a list of PRT Services obtained from the Prt object or by initializing the object with the appropriate Service ID From a Service Object you can obtain a list of all groups
126. D LEN 1 char item Cype AIP PRI TIEM TYPE TD BEN se LI char comment oC DESCRIPTION LEN e uy char USER Or sve se SHERVLCE LD JN I4 COR STATUS Seteiar Data Structures See Static Information Requirements Input Arguments Serialized Items Only item_id Unique identifier of a Serialized Item optional if reference_id is specified reference_id Secondary identifier of a Serialized Item optional if item_id is specified Both Serialized and Non Serialized Items src_reg_id Source region id region the item is moving out of required src_reg_loc Source region location sequence number of the item in the source tracking region Specified as FIRST EXIT LAST ENTRY or a number from 1 to n where n is the number of items in the queue required for non serialized items optional for serialized items item_type_id Item type identifier required for non serialized items optional for serialized items comment Comment to be recorded in PRT history log file optional user_or_svc_id User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Output Arguments retstat Return Value Pointer to COR STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STA
127. D that will hold the value for an item attribute in a region location This file must be configured when prt_grd is configured Each of the fields is described below complete with entry examples and a sample configuration file OPTIONAL FILE Entry No Field Name Description Data Type Example 0 gd_service_id Unique name of the Process Service ID 32 PRTGRD characters 1 region_id Unique name for the region 16 OVENI characters 2 item_att_name Textual description of the item attribute as 16 ITEM_ID follows characters PRT _ ITEM ID PRT_REFERENCE_ ID PRT ITEM TYPE ID PRT_ITEM STATUS PRT_ASSOC_ITEM Note When using prt_item_status in this field the values in att_start_loc and att_end_loc must both be 0 3 display ptid Unique name of the array point The definition of 55 OVEN1_ the point depends on the item_att_name field characters INDEX as follows PRT ITEM ID Point class must be Text Point type must define a text size of at least 20 PRT _REFERENCE_ID Point class must be Text Point type must define a text size of at least 20 PRT _ ITEM TYPE_ID Point class must be Text Point type must define a text size of at least 20 PRT _ ITEM STATUS Point class must be Analog Point type must be ANALOG_U32 PRT ASSOC Point class must be Text Point type must define a text size of at least 20 User defined Point class must be Text The number of region locations covered by the Point determines the number of elements ne
128. DISABLE is undefined or set to a value other than Yes CTI will process points and perform PRT modifications normally The CTI_DISABLE logical is referenced by CTI whenever a point update is received so CTI does not need to be bounced for the logical to take effect CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Layout of Data Points GFK 1216F The CIMPLICITY points used to receive data are composed of a database key followed by the data for one or more PRT record fields to be modified All PRT attributes are modifiable as well as the following PRT fields Item Status Numeric field Item ID Alphanumeric field Reference ID Alphanumeric field Item Type ID Alphanumeric field Any PRT record field or attribute received by a CTI process may be used in the response point as a response field The CIMPLICITY TEXT points used to receive data must contain the following fields when populated PRT Database key The first 20 bytes of the text point will contain a key into the PRT database either the Item ID or the Reference ID of the item to be modified The key must be identical to the field value used by PRT for that item If the database key is less than 20 bytes the remaining bytes will be padded with spaces PRT Field Data The data for each PRT field to be modified will immediately follow and must be in the same format and order that is configured in the file CTI_LAYOUT CFG The field data items
129. EXE The CIMPLICITY HMI project for which you are checking the configuration must be running This utility may be run interactively Reads PRT configuration files outputting information on a file by file basis about errors and or discrepancies in configuration Note PRT Export does not transfer region validation statistics data Production Tracking Global Section Usage 4 70 This section describes the use of global sections by the PRT processes Global sections are created by the Data Collector process for each PRT service and are mapped onto by the corresponding Data Server Process The backing files are located in SSITE_ROOT LOG The following types of sections are created lt GROUPS gt lt PRT Service Name gt This file is used to maintain Group hold status information lt ITEM_XREFO gt lt PRT Service Name gt This file is used to maintain cross reference information about serialized items to allow fast access to items lt REGION ID gt 0 lt PRT Service Name gt This file is used to maintain item information within a particular region there may be many of this section type per PRT service Where lt PRT Service Name gt is the service name of the Data Collector process and lt REGION ID gt is a configured region identifier for this service It is not necessary to manually delete any of these global sections since data integrity will then become uncertain The exception is if changes are made to any of th
130. FILE Field Name region Description Data Type 16 Entry Example OVENI Name of the region where the operation will reserved fld att_name start_byte end_byte op_code alarm value take place GE Fanuc Reserved Name of the attribute containing the counter Index of the first character of the count within the attribute i e 1 16 A value of 0 indicates use of the entire attribute Index of the last character of the count within the attribute i e 1 16 Operation type code that is to impact the counter as follows I Increment D Decrease P Preset Enter the value that will generate an alarm based on the op_code field as follows I Increment over value will generate alarm D Decrease under value will generate alarm P Preset value is equal to the preset characters 16 characters 16 characters Long word Long word One character Long word Blank ITTEM_COUNT 0 value 4 30 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F 2 records created GFK 1216F Configuration File Example prt_reg_atidt Notepad OF x File Edit Search Help IDT file generated by IDTPOP utility v1 6 RECORD PRT REG AT Attributes of PRT regions REGION PRT Region 1 reserved fld GEFanuc RESERVED 2 att_name Attribute Value Start byte Start byte of counter x 4 end byte End byte of counter 5 op code I INC
131. Fanuc Automation makes no representation of warranty expressed implied or statutory with respect to and assumes no responsibility for the accuracy completeness sufficiency or usefulness of the information contained herein No warranties of merchantability or fitness for purpose shall apply CIMPLICITY is a registered trademark of GE Fanuc Automation North America Inc Windows Windows NT Windows 98 and Windows 2000 are registered trademarks of Microsoft Corporation This manual was produced using Doc To Help by WexTech Systems Inc Copyright 1997 2001 GE Fanuc Automation North America Inc All rights reserved ii CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Preface Contents of this Manual GFK 1216F Chapter 1 Introducing Production Tracking Introduces CIMPLICITY HMI Production Tracking Chapter 2 Production Tracking Overview Provides an overview of Production Tracking capabilities and interface requirements Chapter 3 Using the Production Tracking Window Discusses the options available in the Production Tracking window User Interface Chapter 4 Configuration File Guide Documents the configuration files needed for Production Tracking Chapter 5 Production Tracking Application Interface Provides information on the application subroutine interface for Production Tracking Chapter 6 PRT API Macros Documents the macros available for Production Tracking Appendix A PRT API Error Codes List
132. GFK 1216F ATT A C NO ATT ENG TYPE V8 ATT BRAKES POWER INSAE URZ3CAB ICS 62929720C 2141 9 CAB 2S FE PR ExePOR T ATT STYLE LX ATT COLOR BLUE ALT AVC LES ATT ENG TYPE V6 ATT BRAKES MANUAL INS PV R22 CAB 4 C77 S899O Cl 1535 ICAB TISI EN F PRE EXPORT ATT STYLE SX ATT COLOR BLACK ATTIA CINO ATT ENG TYPE V8 ATT BRAKES MANUAL INSE R2 CABI 5 C42 96590 CI V008 CAB 35 2 PRI 2xPORT ATT STYLE SX ATT COLOR GREEN ATT ASC YES ATT ENG TYPE V8 ATT BRAKES POWER INS EF RZ CAB 6 2996590 CT0943 CAB TISS ETTE PRT EXPORT ATT STYLE LX ATT COLOR DK BLUE ATT A C YES ATT ENG TYPE V6 ATT BRAKES MANUAL INS IE VRZ CAB PCos9e 290 iC loa 7 6 CAB so 12 i PRI EXPORT ATT STYLE SX ATT COLOR YELLOW ATT A C NO ATT ENG TYPE V8 ATT BRAKES MANUAL INS P RZ CAB 36 C6Oc34990 Cl2312 CAB S5 E B PRICE XAPORT ATT STYLE LX ATT COLOR RED WHITE ALT Ay YES ATT ENG TYPE V6 ATT BRAKES POWER INS IE R2 CAB 9 CoLeoo90 CTS 60A CAB 35 2 pF PRA EXPORT ATT STYLE LX ATT COLOR GREY ATT A C YES ATT ENG TYPE V6 ATT BRAKES POWER GFK 1216F Configuration File Guide 4 65 4 66 INGI ERZ CAB LO C3 299590 Cl sss CAB 35 FF PRE EXPORT Region R3_CAR REG FFFF R3 CAR 0 PRT EXPORT ATT S PYLE Sx ATT COLOR RED ATT A C NO ATT ENG TYPE V8 ATT BRAKES
133. HTPROC Interested Process Data provider mapping prt_swe_id PAT Service ID providing info to above 1 IHTFHOC_SUC_ IE Interested Process Service ID Update mack tFull brief all but auto move AFAT GC PRTGAD 1 APAT OC PRT_STHO 4 4 records created HPR T_ C PRTER 1 BPAT SCPRT_STHO 4 APRT_DC PRTGRD 1 g No delimiter character after Expanded view last field in of first record record GFK 1216F Configuration File Guide 4 11 No PRT_GROUP The PRT Group prt_group configuration file is used to define each of the Tracking Groups Every tracking region must belong to a Group Each of the fields is described below complete with entry examples and a sample configuration file REQUIRED FILE 0 group_id 412 group_label Group_desc resource id Log_grp_mod 5 records created Field Name Unique name for the tracking group Text to appear with the tracking region ID Description for user recognition Description of the tracking group Unique name of the resource for the group Flag for logging tracking group modifications 1 e change of hold status on group Configuration File Example D prt_qesap eft Molec Fie Edt Seach Help j IDT File geeerated by IDTROF wtilitg y1 i RECORD PRT GROUP Prodectioa Tracking Gromp E i i E S TARE BJEAST MAREA B Exst trea E TrackingjTRACEIHE i EHTAREA AJEHTAY AREA A Embry Area A Tracking TReCKIMG 1 EXITAREA_EJEXIT
134. Item crosses a PRT Service boundary and the PRT process for the first service is unable to provide the parent Item data for the Non serialized Item A Non serialized Item has an associated parent Item and the Non serialized Item is placed on an Item Carrier with another Item of the same Item Type The concept of Item Hold Specifications apply only to Serialized Items PRT requires positive identification of an Item at the entry to the first region configured for a PRT process i e NODE Positive identification consists of the Item ID or Reference ID for Serialized Items an the Item Type for Non serialized Items Serialized Items may not be child members of an association Sequential Tracking Regions of size one do not detect sequence errors CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F A full complement of the PRT configuration data resides on each Node When a Destination Region has an Item enter the region PRT will ask the Source Region about the Item that just transitioned If the Source Region is a region managed by another PRT process that process will be requested for information on that Item If the Source Region has no information on the Item PRT will request the information from an external process These requests will be continuously made each time the Item moves until a response is available The external process is defined to PRT through configuration data The configuration of an external
135. K 1216F Input Arguments pre ovo id group id region_id item_id reference_id more_data Output Arguments PRT service identifier optional Unique identifier of tracking group optional Unique identifier of tracking region optional Unique identifier of serialized item optional if reference_id specified Secondary identifier of serialized item optional if item_id specified If this flag is set to true by the caller the function attempts to return an item found by a previous call to this function If this flag is set to FALSE any items found by a previous call to this function are deleted and new request s are made to the specified service s PRT_ITEM_STRUCT_PTR item_data Serialized Item Tracking Data more_data xretstat Return Value If only a single item was found this flag is set to FALSE If more than one item was found this flag is set to TRUE Pointer to COR_STATUS structure Either COR_SUCCESS COR_WARNING or COR_FAILURE If the function returns COR_ WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure Error Codes PRIS _NO GLOBAL XREF PRIS REGION NOT DEFINED PRTS_NO_ GLOBAL REGION PRTI _BAD_POINTER PRTI NO MORE _ ITEMS PRTI _SVC_ID_NULL PRTI _SVC_ID_NDEF PRTI REG ID NULL PRII_ REG ID NDEF PRII_GRP_ID NULL PRII_GRP_ID_ NDEF PRI NON SER ID PRTI_SER_NO_ID PRTIL_REG_NOT_IN_GRP PRTI_REG_NOT_IN_SVC No XREF global section available Warn
136. MPLICITY Tracker Getting Started Guide for complete information about configuring Tracker using the Tracker Configuration User Interface Configuration File Acronyms For your reference here is a list of acronyms that are used in this chapter Acronym Meaning ISAM Indexed Sequential Access Method SCPOP System Configuration Population ASCII American Standard Code for Information Interchange GFK 1216F 4 Identify the Configuration Files There are several required ISAM files to configure to run your tracking model as well as several optional files for additional functionality Tracker primarily uses binary coded files to run PRT You can readily identify the files you want to work with by their prt prefix and dat or cfg extension Guidelines for Required Configuration Files The required configuration files must be configured in order to run your tracking model Each file is described in detail below File Name File Definition Description prt_sysdetf PRT System Sets the queue sizes for the ports used Definitions by the Data Collector Data Service prt_service PRT Service Record and Application Interface subsystems Minimum recommended size is 10 for each port Identifies each PRT Service in the tracking model PECLINEpLOC PRT Interested Enables related processes to receive Process Data updates from the tracking model Both Provider Mapping prt_grd and prt_stnd require this file to be configured in order to function
137. Manual July 2001 GFK 1I216F prt_api_unload_itemlist Unload List Of Items Name prt_api_unload_itemlist Description This routine provides a mechanism to unload the list of Items obtained through the prt_api_req _itemlist routine If the request is a success the calling routine will receive back an array populated with the Item Tracking Data information If the request fails the calling routine will receive back status information on the reason for the failure Syntax int prt_api_unload_itemlist list_size item_list retstat COR I4 List size PRT_ITEM_ STRUCT ite list list _ size COR STATUS rerstat Data Structures typedef struct time_t reg_entry_time time _t last_mod_time char region_id PRT_REGION_ID_LEN 1 identifier of the region COR_I2 region_loc S specific location in the region char item_id PRT_ITEM_ID_LEN 1 unique identifier of a Serialized Item char reference id PRT_ ITEM ID LEN 1 secondary identifier of a Serialized Item char item_type_id PRT_ITEM_TYPE_ID_LEN 1 lt item type identifier char parent_item_id PRT_ITEM_ID_LEN 1 pertains only to Non serialized Items COR_U4 item_status item status COR_BOOLEAN int _hold_active if TRUE item held due to internal Mole Char int hold reason SC DESCRIPTION LEN 1 Comment specifying reason for internal hold COR_BOOLEAN ext _hold_active if TRUE item held due to external hold char group_id PRT_REGION_ID_LEN 1
138. N 1 char parent_item_id PRT_ITEM_ID_LEN 1 COR U4 item_status COR BOOLEAN int _hold_active char int hold reason SC DESCRIPTION _LEN 1 COR _BOOLEAN ext_hold_active char group_1d PRIT REGION ID_LEN 1 CORT num_atts valid PRT_ITEM ATT item_att_list PRT_NUM_ATTRIBUTES char comment SC DESCRIPTION EEN 1 3 char ser or SVC 10 SERVICE ID LEN T CORT I action b PRI ITTEM UPDATER STRUCT PRI ITEM UPDATRE lt STRUCT PTR typedef struct COR Il event code char region 10d PRT_REGION_ID LEN Lly COR_U4 region_status char char comment ToC DESCRIPTION LEN P Jus ser or SVC Id SERVICERE ID LUEN 42 ls COR I2 location COR 11 act ron PRI REGTON UPDATE STRUCT PRI REGION _ UPDATE SIRUCT PTR Notes See the next chapter for the list of macros that can be used with the modify bitmask parameter to determine which fields in the PRT_ITEM_UPDATE_STRUCT contain valid data The values supplied which identify region location are in the range FIRST or EXIT LAST or ENTRY and 0 1 2 n O means that the region location is not appropriate l n is the region location FIRST and LAST are first and last to exit respectively In the current implementation of production tracking region_2_id and region_2_loc are not populated in the item update structure These elements are reserved for GE Fanuc use CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F
139. NE ee Bg a E E EE E E E E E E EE GROUP X Specified Resource does not exist XX_FR Jan 22 1991 14 41 51 PRT_REGION Error Report Production Tracking Region File REGION_ID Value Error found TEST_REGION POINT not configured PTPO6_Y TEST_REGION POINT not configured PTPO6_X TEST_REGION Specified Resource does not exist FRX TEST_REGION SERVICE not configured PRT4_DC 4 52 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Production Tracking Import Program PRT_IMPORT This section provides a description of the Production Tracking Import Program PRT_IMPORT It describes the tasks performed by the Import Program and defines Import file record formats for each type of command the Import Program can send to PRT A set of Import record types and their corresponding record formats are defined Each of these record types is associated with a particular PRT function The remainder of the section describes the Import file record formats for each record type and how to invoke the program Program Elements Production Tracking Import Program The Production Tracking Import Program interprets a file to determine the commands to issue It also provides information about the results of the commands issued Process Registration Initialization of the Production Tracking Application Interface Determination of the name of the Import data file to be used The name of the input file is specified on the command lin
140. NO_ROUTE PRTI_EF_CHECK_ERR PRTIITEM_NOT_FOUND PRTIITEM_NOT_FOUND_INC_SRCH PRTI_TOO_MANY_REQ PRTI_LUNKNOWN_INIT_SRC PRTI_NO_SRC_OR_DEST PRTI_NO_SVC_IMPLIED PRTIBAD_SERVER_RESPONSE PRTI_LNO_MORE_ITEMS PRTI_BAD_POINTER PRTI_LUNKNOWN_RESPONDER PRTI_EMPTY_FILE PRTI_BAD_SVC_NAME PRTI_PARTNER_DEAD PRTI_DG_BUF_FULL PRTI_NO_SEGS_RCVD PRTI_API_CANT_RCV PRTIINIT_MSG_RCVD PRTI_PROC_NOT_CONFIGURED PRTI_NOT_ALL_SVCS_RESPONDED CIMPLICITY HMI Tracking Operation Manual July 2001 ext_proc_flag set for non serialized item Serialized item missing both item id and reference id Non serialized item has item id or reference id Invalid Tracking Type not SERIALIZED NON_SERIALIZED Invalid region location External hold specified without Group ID External hold specified for non serialized item Internal hold specified without reason Region not in group specified Region not managed by service specified Group ID inconsistent with service specified No deletes successful to any PRT services Destination region is invalid for item of this type No route exists between src lt region gt dest lt region gt Invalid route 15s gt 15s for item type lt item type gt Parent ID specified for serialized item Group hold specified without reason Non exist route in PRT_INV_TYPE src lt region gt dest lt region gt Can t deny explicit item route src lt region gt dest lt region gt Denied type not on route src lt region gt dest
141. No delimiter after the last field in the record GFK 1216F PRT_ROUTE The PRT Route prt_route configuration file is used to define all of the routes that exist between regions This enables automatic transition of items based on changes in CIMPLICITY Point values Each of the fields is described below complete with entry examples and a sample configuration file REQUIRED FILE Entry No Field Name Description Data Type Example 0 orig_region_id Name of the source region where the item 16 NULL will exit characters 1 dest_region_id Name of the destination region where the 16 SRC1 item will enter characters 2 item type_id Unique name for the item type that may travel 16 NULL between the two regions Use the wildcard characters character to validate all item types through this route 3 transition_ptid Point ID that represents the transition between 55 X_S1 the two regions characters 4 set_ptid Point ID that will display when the item is 55 T_S1 transitioned Must be of class Text and should characters be no more than 36 characters Data is displayed as follows 16 characters Item Type ID 20 characters Item ID when item type is serialized otherwise associated or parent item ID 5 translation_id Depending on Field 6 translation_ 16 NULL type_code configure as follows characters translation_type_code 2 translation to use to interpret this transition indicator translation_type_code 3 4 or 5 Up to 3
142. OLEAN insert_flag item 10 PR ITEM ID LEN ae L3 reference_id PRT_ITEM_ID_LEN 1 item_type_id PRT_ITEM TYPE LCD LEN 1 comment LSC DRSCRIPTION LEN LT user or svo Id SERVICE ID CEN ia hs ALTUS retstart Data Structures See Static Information Requirements Input Arguments Serialized Items Only item_id Unique identifier of a Serialized Item optional if reference_id is specified reference_id Secondary identifier of a Serialized Item optional if item_id is specified Both Serialized and Non Serialized Items src_reg_id Source region id region the item is moving out of required dest_reg_id Destination region id region the item is moving into required Production Tracking Application Interface 5 71 5 72 src_reg_loc dest_reg_loc insert_flag item_type_id comment user or svc_id Output Arguments retstat Return Value Source region location sequence number of the item in the source tracking region Specified as FIRST EXIT LAST ENTRY or a number from 1 to n where n is the number of items in the queue required for non serialized items optional for serialized items Destination region location sequence number of the item in the destination tracking region Specified as FIRST EXIT LAST ENTRY or a number from 1 to n where n is the number of items in the queue required If TRUE the moved item is to be inserted in the Destination Tracking Region queue befo
143. PRI EXPORT PRT IM POR Vaca ito ccncavanccutobanesnatsangce ines masantauhalaubencetoategeeetauns C 11 ERT GR De a vd ae a a a tac enmcnsneaies C 11 Appendix D Using the Global Verifier D 1 About the Global Vonet aE a REENE EA D 1 AV GAO TIS and Repairs seed e e data np Ganka deine ae Gurnsumen eeeehee es D 2 Contents x CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 1 PRY OD ECE INIOGE lacs cstescchein ar Sarat sstaltaceosehs canenat Qonea late ceatioass eovasehu samauaeceabah tad E 1 PRP ODE ANDU Sonnan st exeecte sce eee Behe ain eaiaa AA eee ined eaters E 2 Ger an E EOE er T AE TOR ee eR ne E 3 EUS CLV ACC aa a ed cava A A TG E 3 FAOU ee aa etek eetrenae siete bakt A E A E AA E E 3 Pakes OMG Sprout anes Ueecan te E 3 Pee osana a a isto ce ia esanedtnagta tla canessshes cot ians sud Ae aera cguedesastagaat aunt E 3 FRA UC ay tease azaon cimurieiniciatad a asdes Noda tadenneceeaieindelad eeceu uaseed ea daes E 3 Prt GetGrouplist Method earan et ce taeda saieetenaaeaeteabaene acute sees E 4 Prt Get tem ASt CIVIC UNO oaa a a a a a ators E 4 Prit Getheciontist Ne tnOG nare isis stares addres iniad oe leasay aetna E 5 Pre Gelservicelist CVIEIhOO asan E ee Riera ARRA E 5 Prt Group PnC AON essa a a a E 6 Prt GroupCount Prope iy Redden a E 6 Prem UnC OON hei a a a a behets aise cpehen evant teanacte E 7 PrettemC lassia Property Read
144. Point Updates When CTI is started it will ignore the first point value that is received in response to its on change shopping list for points that are configured to ignore first response in CTI_PT_ DEF CFG When an application requests on change updates from Point Management Point Management will respond with the current value of the point and then send new values whenever the value changes Because the current value of the point may be old it is ignored If a point configured to ignore first response becomes unavailable while CTI is running typically because a device became unavailable CTI will ignore the first value it receives when the point becomes available again because this value may be old as well Transitions Between Regions Points may be configured to move items between PRT regions or insert items into PRT regions A point configured with a Destination Region in the CTI_PT_DEF CFG file will move an existing item to the Destination Region after the item is updated if moves are allowed CTI will only move the item to the Destination Region if is not already in the Destination region and if no Prior Region is configured or if the item is at the head of the configured Prior Region at the time the item is modified If CTI is unable to move the item into the Destination Region or the item is not in the Prior Region the configured Transition Failure Point will be set to 1 It is up to the user to reset this point value If a point is
145. Queue Name prt_api_insert_item Description This routine provides a mechanism to insert an Item into the Tracking Region queue If an Item is to be inserted into the queue at a particular location other than at the head or tail of the queue the region location of the item to be inserted ahead of is specified 1 e specifying region_loc 1 is equivalent to specifying region_loc FIRST Defined constants are provided as a way of indicating that the item is to be inserted either at the head or at the tail of the queue The region location can be specified as FIRST or also as EXIT to insert the item as the first head item in the queue 1 e this item will be the next item to transition out of the queue LAST and ENTRY are provided to insert the item as the last item at the tail of the queue BEHIND all other items Syntax int prt_api_insert_item timestamp ext_proc_flag region_id region_loc item_id reference_id item_type_id parent_item_id item stat s ext_hold active group_id int_hold_active i t hold reason NUM Ares valid item_att_list comment ser or sv 10 retstart time_t timestamp COR_BOOLEAN ext_proc_flag char region_id PRT_REGION_ID_LEN 1 COR L2 region_loc char item id PRI TIEM_ID LEN LI char reference_id PRT_ITEM_ID_LEN 1 char item_type_id PRT_ITEM TYPER ID LEN 1 char parent_item_id PRT_ITEM_ID_LEN 1 COR_U4 item_status COR_BOOLEAN ext_hold_active char Group id PRT REGION
146. RIZREG AT eao nets cute rac E E E assamaoanateeeanes 4 30 PRI ATTRIBUTES CEG zecea toes 4 32 BP RSS NID Gi sincere aa n O AAS 4 34 PROP WINDOW CEG aeciaii nian a a 4 36 PRT Client Routing Items across Project Boundaries cccccccccscssssssessseeeeeeeeeeeeeeeeeeaas 4 39 Automated Region Validation cccccccccccccecccceeeeessesesesseeeceeeeeeeeeeesaaaseeeeseseeeeeeeeeeeeeeeaaas 4 4 Sequence of Events for Region Validation ccccccccsssssssseseeeeeceeeeeeeeeeeaeeeeeeeeees 4 42 Reviewing Different Scenarios for Flow of Control ccccccssssssssssseeeeeeeees 4 44 Accessing Configuration files by the Subsystem ccccccccccccccscsssssssssseeeeeeeeeees 4 46 PU SVE V AU CLs icra edad desc gncpctrno tt nadetvudacdiaws vied sates Sadacmen A dee daacenane 4 47 UNINC Dita sinen E A O A Stenogates 4 48 PRT Region Status BIiSrecsnnennrn eena r en acon EN 4 50 Configuration Validation Program esessssssssssssoeeeeresssssssssssssseeteerersssssssssssessssseeeerreressesss 4 52 Production Tracking Import Program PRT_IMPORT eeeeessesssssssssssssssssseeeeeeeee 4 53 Program Elements Production Tracking Import Program ssesseeeeeeeeees 4 53 Import File Naming Conventions ccccccccccccsccassssseeeeseeecceeeeeeeeeeaasaaessseseeeeeeeess 4 53 apon Pile sP OMA l fssisecennosstemab tea tented EE T 4 54 Running the Import Program ccccccccccsccsssssssssesseseseeecceeeeceeeeeeeeeaeaeeea
147. RS 8 SERVICE ID Service Identifier 1 SUBSYS ID Subsystem Identifier 2 PROCESS ID Process Identifier AHRP AM HRP Expanded view of DL_RP DL DL_RP recorded used to DYNCFG DYNCFG DYNCFG comlgnie 7 prt_inttest exe PRT INT PRT PRT_IWT gt PRT_INT PRT PRT_INT WA 0 1 2 3 Type your record using the following field descriptions Field Field Entry No Name Description Example 0 service_id The name given to this service PRT_INT 1 subsys_id The ID of the subsystem in this case PRT PRT 2 process_id The name of the process that the program PRT_INT will look to for data 4 Save the file 5 Use the SCPOP Utility to convert file back to binary format GFK 1216F Appendix J Troubleshooting J 7 Step 6 Configure Prt_intproc Field Number 0 Description Unique identifier of a PRT service that will provide interested process updates This must be identical to the ID in Data Type 32 characters Field Number 1 Description The name given to this service Data Type 32 characters Field Number 2 Description Specifies the type of updates to be supplied to the interested process Values are 1 Full 0 Brief Data Type Long word J1 Step 6 Configure prt_intproc 1 Use the IDTPOP Utility to convert the file to ASCII text using the text editor of your choice e g Notepad 2 Press Ctrl End to bring you to the next available line to enter your record see figure pat_into
148. RT Server to the PRT Standby Process The PRT Standby Process will produce a PRT import file in the local log directory that contains all the contents of the PRT Server when contact was lost This file is not provided with Tracker and must be manually configured OPTIONAL FILE J4 To configure the prt_stnd cfg file Click Tools on the Workbench menu bar 2 Select Command Prompt A DOS window opens Enter cd master onthe Command Line Press Enter to switch to the Master directory Type notepad prt_stnd cfg where Notepad is the text editor a a a Press Enter A message box displays 7 Click Yes in the message box Result A blank file will display in Notepad called prt_stnd cfg Mf E A BE_APPLIANCE gei CIMPLICITY Woskbench Ele Ed Proect View PESHI CEs E SELE ia Command Fiemel i SA CAWINNT spstem32 cmdexc mA Hicrosoft R Windows MI lt ITM CC Copy i qhi 1 FHS l g i al ii Eo oft no Fp 5 CT WOLAPLIGIIY SHALL peo jects Gh _ Applian ee sed master Ge wi AFGI Gi THAI pro jerte GE Applisance nasterennte pad pre Holepad B pt_sind ctg Notepad Fie Edit Search Helo Cannot find the prt_stnd chg He Dio pou want to create a rew file 8 Type the reserved characters i e delimiter continuation and comment I on the first line in Notepad 9 Press Enter to go to the next line CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F 10 Type RECORD
149. RTI_REG_NOT_IN_GRP PRTI_REG_NOT_IN_SVC PRTIL_GRP_NOT_IN_SVC PRTI_NO_SVC_IMPLIED PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Deleted but not found in xref table Warning Item ID not found Failure Reference ID not found Failure Bad region specified Failure Bad region location specified Failure Specified item not found specified location Failure Must specify region location to delete non serialized item Failure An affected item has changed since the last display Failure Item type identifier NULL Warning Item type identifier not valid Warning Non serialized item has item id or reference id Warning PRT service identifier NULL Warning PRT service identifier not valid Warning Group identifier NULL Warning Group identifier not valid Warning Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning Invalid region location Warning Region not in group specified Warning Region not managed by service specified Warning Group ID inconsistent with service specified Warning No service specified via svc_id group_id region_id Warning Error initializing segment Failure Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd Production Tracking Application Interface 5 25 prt_api_delete_items_at_loc Delete Scrap Items From Tracking Region Queue Location Name prt_api_delete_items_at_loc Descri
150. RT_DSP_NOT_MPTY Expanded view of the first record CIMPLICITY HMI Tracking Operation Manual July 2001 PRT BG jijiji PET_OET_PEC_FIL PRT_ITH_THAU _i i PAT_AEF_EAP j Pe _ et_Lac_trrj FAT_REF O05 PRT CTH UDTE_HL OP RE De TYRE FAT_UH HH_TEFE PAT CMA Db TEN PERT OF WOT Pov CAFi PET AEE LOC CAF Last field blank no delimiter needed after Entry Example PRT REG oos PRT_ITM_ WITH_HLD PRT_INVALID _ TYPE PRT _ UNKNOWN __ TYPE PRT_INVALID _ ITEM PRT_DSP_ NOT_MPTY Blank Continuation character appends next line to record GFK 1216F PRT_INTPROC The PRT Interested Process Data Provider Mapping prt_intproc configuration file is used to map interested processes to the PRT Services This will serve to supply the interested processes with regular updates Each of the fields is described below complete with entry examples and a sample configuration file Entry No Field Name Description Data Type Example 0 prt_svc_id Unique identifier of a PRT service that 32 APRT_DC will provide interested process updates characters 1 intprc_svc_id Unique identifier of an interested process 32 PRTGRD service ID characters 2 update_mask Specifies the type of updates to be Long word 1 supplied to the interested process Values are 1 Full 0 Brief Configuration File Example i pel nip il Riolepad fe E Fis Ede geech Help IOT File generated by DTPOP utility vi RECORD PRT_I
151. S 1 and PRT_ITEM_STATUS 4 are each byte The point RCV_POINT_2 contains data for the item ID attributes ATT_1 ATT_7 and ATT_4 and item status in that order Since RCV_POINT_2 is an analog point the length field will be left empty Field Translation File CTl_XLATE CFG The configuration file CTI_XLATE CFG will define the translation of integer field values to ASCII text values by CTI ANALOG array points received by CTI may have a translation configured for each of the field values stored in the point The CTI will convert the integer value to an ASCII text value if such a translation is configured in this file If no translation is configured the integer field value received will be treated as the ASCII character for the same value The records in this file contain the following fields RECEIVED POINT ID The name of the CIMPLICITY ANALOG array point that will be used by CTI to receive data FIELD ID The ID of a PRT field whose integer value will be translated by CTI This will be the same field identifier that is used in the file PRT APTI H in the structure PRT_ITEM_ STRUCT for that field NUMERIC VALUE The numeric value that will be translated to ASCII text by CTI TEXT VALUE The ASCII text value that corresponds to the above numeric value Examples of records found in the CTI_XLATE CFG file are _ RCV_POINT_2 ATT_1 0 TEXT_VALUE_1 RCV_POINT_2 ATT_1 1 TEXT_VALUE_2 RCV_POINT_2 ATT_1 2 TEXT_VALUE_3 RCV_POINT_2 ATT_
152. Service GetItemList See PrtService ItemClassId for more details Example Dim ServiceA as new PrtService ServiceA Id SERVICE A Get a list of items in the service and display them one by one in a message box ServiceA GetItemList for j 0 to ServiceA ItemCount I MsgBox ServiceA Item j Id next j PrtService GetRegionList Method Syntax PrtService GetRegionList Description Gets a list of Tracking regions contained in the PRT Service Upon return the total region count may be obtained from RegionCount and the individual regions may be accessed via the Region function Example Dim ServiceA as new PrtService ServiceA Id SERVICE_A Get a list of regions in the service and display them one by j one in a message box ServiceA GetRegionList for j 0 to ServiceA RegionCount 1 MsgBox ServiceA Region j Id next Jj E 66 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtService Group Function syntax PrtService Group index Description Returns a group at a specified index from the list which was found by a previous call to GetGroupList Example Dim ServiceA as new PrtService ServiceA Id SERVICE_A Get a list of groups in the service and display them one by j one in a message box ServiceA GetGroupList for J 0 to ServiceA GroupCount 1 MsgBox ServiceA Group j Id next J PrtService GroupCount Property Read GFK 1216F Syntax PrtService GroupCount Desc
153. Subsystem Description Tracker Configuration User Interface Enables configuration and maintenance of Tracking Model data in a graphical user interface Transition Points Moves items from region to region based upon location or identification using CIMPLICITY points Basic Control Engine BCE Write scripts to enable you to perform all of the functions available in PRT Application Programming Interface API Performs all functions available in PRT Graphical User Interface UI Performs all functions available in PRT Production Decision Control PDC Allows complex routing strategies to be developed to control functions of the physical factory using this API based system Configurable Tracking Interface CTT Allows items to be added modified and moved within the PRT Database using only CIMPLICITY points Introducing Production Tracking 1 3 1 4 PRT Database Hierarchy The PRT database supports the Tracking Model and houses all of the tracking and configuration data The following diagram illustrates the hierarchical group scheme represented within PRT PRT CIMPLICITY PROJECT Service Independent PRT process running ina CIMPLICITY project that supports one or more regions Group Item Class Logical space on the Logical grouping of plant floor that holds item types regions Region Represents a physical ltem Type area in the factory and Logical grouping of holds region locations items with similar character
154. TI_READ_PORT_ERR CIMPLICITY HMI Tracking Operation Manual July 2001 Error in ipc_write_port Warn Fail Error initializing segment Failure Error creating segment Failure Error in segment Failure Error in ipc_read_port Failure GFK 1216F prt_api_unload_grouplist Unload List Of Tracking Groups Name prt _api_unload_grouplist Description This routine provides a mechanism to unload the list of Tracking Groups obtained through the prt_api_req_grouplist routine If the request is a success the calling routine will receive back an array populated with the Tracking Group Data If the request fails the calling routine will receive back status information on the reason for the failure Syntax ine prie apt unload Qrouplist ALTS Sire Group L LSE FORSTAL COR T4 list size PRY GROUP SERUCT Group list hlist sire COR_STATUS retstaty Data Structures typedef struct char group_id PRT_REGION_ID_LEN 1 unique identifier of tracking groups COR _ BOOLEAN ext _hold_active TRUE indicates HOLD is active TOL OG LOUN Char ext hold reason SC DESCRIPTION LEN 1 reason for Item HOLDS P PRI GROUP STRUCT gt PRI GROUP STRUCT PIR Input Arguments list_size Number of array elements allocated for region_list array required region list Pointer to a buffer to receive tracking region data required Output Arguments group Ist list size Populated list of groups retstat Pointer to COR_STATUS stru
155. TUS structure Error Codes PRIC_NON_SER_ID PRTC_SER_NO_ID PRTC_UNKNOWN_REGION PRTC_BAD_REG_LOC_SPEC PRTC_ITEM_STAMP_TOO_NEW PRTC_ADD_LOC_TOO_BIG PRTC_ADD_MULTIPLE_SERIAL PRTC_REGION_NOT_LOCKED PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_INVALID_REG_LOC PRTI_ITEM_TYPE_NULL PRTI_INVALID_DEST PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Non serialized item has item or ref id Failure Serialized item missing both item amp ref id Failure Unknown REGION specified Failure Bad region location specified Failure An affected item has changed since the last display Failure Can not add item to unoccupied location inserting Warning Can not have two serialized items at one location Warning Lockable region s not locked cannot perform operation Warning Item type identifier NULL Warning Item type identifier not valid Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning Item type identifier NULL Warning Destination region is invalid for item of this type Warning Error initializing segment Failure Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd GFK 1216F Production Tracking Application Interface 5
156. TY HMI s flexible system architecture and modular design allows you to add on options for enhanced functionality Adding the Production Tracking module to your base system will allow you to track items as they move through your production facility It will also generate alarms to notify you of tracking exception conditions Production Tracking has three points of operator interaction as follows The PRT User Interface for monitoring and controlling your application The Tracker Configuration User Interface for configuring your tracking model data Optional application subroutines for customizing your application GFK 1216F 1 1 1 2 You can use Production Tracking to Receive information on items as they move through the production facility Request information on the contents of regions through which items are being tracked Add new items to be tracked Delete or modify items currently being tracked Locate specific items being tracked Place or remove external holds on tracked items Move items between regions CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Production Tracking Concepts GFK 1216F Production Tracking PRT tracks part assemblies through the production process using a specialized database to support the Tracking Model Within the PRT database Each product is assigned a tracking item that represents its location and associated attributes for example color part n
157. T_IN GE Fanuc Awtomalion j ae l Begonid PauL AEG aul Yin Fiederence ID ExT2 DOOR_LIMT E13 DOOR LIHI SS Ant Mode te Tire Tusa i soe J Read only field that displays the number of successful advances i Tip Use the Ctrl key to select multiple items Continue from Methods 1 amp 2 1 Select the Destination Region from the drop down list or type in the region ID 2 Optional Type any additional notes for the PRT Log file in the Comment box 3 Click Advance to advance the item s to the entrance location of the destination region The number of items successfully advanced will display in the Advances field 4 Click Cancel to close the dialog box Note If there are no items in the Source region or no routes configured for the Source region a Warning message will display GFK 1216F Using the Production Tracking Window 3 27 Finding an Item You can locate an item when you know the item or reference ID using the Find Item function 41 To find an item 1 Click Find 4 The Find Item dialog box opens 2 Provide information in one or both of the following fields ltem ID ID of the item you want to find Reference ID Reference ID of the item you want to find 3 Click OK to locate the item or click Cancel to cancel the operation Note If the item cannot be located a message box displays indicating the error If the item is found the Item Location b
158. WINNT 2 Navigate to the Profiles gt All Users gt Start Menu gt CIMPLICITY HMI workgroup directory BY Exploring C 4 INNT Profiles All Users Start Menu Programs CIMPLICIT Mel Ea File Edit View Tools Help E Hmi Bl Hq Sox tael ca zF Al Fo Folders Contents of CAWINAT SProtiles 4ll Users Start Me ag G Getting Started TKE aa ET Card Configuration 1KB E Login Panel 1KE KA Mitsubishi Serial Diagnost TEE gill MODBUS Plus Diagnostics TEE EA Omron Host Link Diagnos 1KB MME OPC Server TKB I Administra Tools H PCIM Configuration 1KE i Adobe Kerobat 4 0 Point Control Pare TEE A Arn BE Point Cross Reference 1KB te Camre gf Process Control 1KB T S Cfture Express Me Program Editor TEE gt CAPLICIT Pee PAT User Intertace TRE eds ACO Runtime User Intert TRE nempa 4 35 objecti 13 7KB Disk free space 1 1666 TRE l EEEE EEE 4 S 3 Drag the PRT User Interface shortcut icon onto your Windows desktop while holding down the right mouse button A popup menu displays when you release the right mouse button Hove Here Copy Here Create Shortcut s Here Cancel CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F 5 Select Create Shortcut s Here Result The PRT User Interface shortcut displays on your Windows desktop tts PAT User Interace Parameters Set for the PRT User Interface J17 To set parameters for
159. _CNT 0 10 gt 2 F SRC2_CNT4 SRC2 CARRIER CYCLE_CNT 0 10 lt 2 F SRC2_CNT5 SRC2 CARRIER CYCLE_CNT 0 10 lt 2 F SRC2_CNT6 SRC2 CARRIER CYCLE_CNT 0 10 2 F SRC2_CNT7 SRC2 CARRIER CYCLE_CNT 0 10 F SRC2_CNT8 SRC2 CARRIER CYCLE_CNT 0 10 Q 2 3 F SRC2_CNT9 SRC2 CARRIER CYCLE_CNT 0 10 2 3 F SRC2_CNT10 Region DSTI DST1 VEHICLE COLOR 0 10 RED A DST1_CNT1 DST1 VEHICLE COLOR 0 10 gt RED A DST1_CNT3 DST1 VEHICLE COLOR 0 10 lt RED A DST1_CNT5 DST1 VEHICLE COLOR 0 10 R A DST1_CNT7 DST1 VEHICLE COLOR 0 10 A DST1_CNT8 DST1 VEHICLE COLOR 0 10 BLUE RED A DST1_ CNT9 DST1 VEHICLE COLOR 0 10 BLUE RED A DST1 CNT10 DST1 VEHICLE COLOR 0 10 D A DST1_CNT11 Region DST2 DST2 VEHICLE PRT_ ITEM ID 2 2 5 N DST2 CNT1 DST2 VEHICLE PRT_ ITEM ID 2 2 5 N DST2 CNT2 DST2 VEHICLE PRT ITEM ID 2 2 gt 5 N DST2 CNT4 DST2 VEHICLE PRT ITEM ID 2 2 lt 5 N DST2_ CNT5 DST2 VEHICLE PRT ITEM ID 2 2 5 N DST2_ CNT7 DST2 VEHICLE PRT_ITEM ID 2 2 5 N DST2_ CNTS8 DST2 VEHICLE PRT ITEM ID 2 2 5 10 N DST2_ CNT9 DST2 VEHICLE PRT_ITEM ID 2 2 5 10 N DST2_ CNT10 DST2 VEHICLE PRT_ ITEM ID 0 4 D 0 A DST2_ CNT11 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Setting Up Logproc The following idt files need to be modified to have PRTCNT function properly Add records as follows IDT file generated by IDTPOP utility
160. _EXT_HOLD_NO_REASON Group hold specified without reason Warning PRTI_MF_INIT_ERR Error initializing segment Failure PRTI_CRESEG_ERR Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_delete_item Delete Scrap Item From Tracking Region Queue Name prt_api_delete_item Description This function provides a mechanism for deleting or scrapping a single Item from a specific Tracking Region queue The calling routine receives back a status indicating the success or failure of the request Syntax int prt_api_delete_item timestamp prt_svc_id group_id region_id region_loc item_id reference_id item_type_id disposition comment user_or_svc_id retstat time_t timestamp char Presyo TSE VLGr CD LEN P A char Group 1d PRE REGION TD iN a char region_id PRT_REGION_ID_LEN 1 COR TZ region_loc char Peet ic PR eM ID LEN 113 char reference_id PRT_ITEM_ID_LEN 1 char item type IdTERC DIEM TYPE D LEN Lii COR I1 dusposi von char COommentLSC DESCRIPTION LEN L13 char user r Svc 10 SERVICE ID CEN P 1I COR STATUS retstat Data Structures None Input Arguments See SYNTAX for proper order Serialized Items Only item_id Unique identifier of a serialized item optional if reference_id specified reference_id Secondary identifier of a serialized item optional if item_id specified Bot
161. _ID PRT_ITEM_STATUS PRT_ITEM_TYPE_ID If PRT_ITEM_STATUS is used an optional bit offset can be specified using the following format PRT_ITEM STATUS n where n is the bit offset O is the rightmost least significant bit If a bit offset is specified only the particular bit of the item status is changed based on the point value The other bits in the status word remain the same If no bit offset 1s specified then the item status is changed to be the point value received GFK 1216F Appendix F Configurable Tracking Interface F 5 CTI PRT Mapping File CTlL_RP CFG This file contains a single field the name of the Resident Process for the PRT data server that CTI will monitor without the _DS extension In the case that you wish to monitor all data servers leave this field blank The following are examples of the two possibilities For one data server APRT For all data servers Field Layout File CTL RP_LAYOUT CFG The configuration file CTI LLAYOUT CFG defines the layout of specific PRT fields within each point received by CTI The records in the file contain the following fields RECEIVED POINT ID The name of the CIMPLICITY TEXT or ANALOG point that will be used by CTI to receive data ORDER The order in which the PRT fields are stored within the overall text point Values must begin at 1 must be unique and must be monotonically increasing Field 1 is the field that CTI will use to se
162. _NAM_ERR PRTI_ADD_PORT_ERR PRTI WRITE PORT ERE CIMPLICITY HMI Tracking Operation Manual July 2001 Error initializing segment Failure Error creating segment Failure Error in segment Failure Error opening one of the configuration files Failure Configuration file has no records Failure Error reading configuration file Failure Undefined Region in file Failure Undefined Group in file Failure Region does not belong to any group Failure Group does not own any regions Failure Route has no source and no destination region Failure Item type identifier not valid Failure Non exist route in PRT_INV_TYPE Failure Can t deny explicit item route Failure Denied type not on route Failure Undefined Service in file Failure Bad service name no underscore Failure Error in ipc_xlate getting physical addr Failure Error in ipc_aux_nam Failure Error in ipe_add_port Failure Error in ipe_write_port Warn Fail GFK 1216F prt_api_term Terminate PRT_API Interface GFK 1216F Name prt_api_term Description This routine is responsible for de allocating the communication buffers allocated by the prt_api_init routine If the application registered as an interested process to a PRT process it must call the prt_api_term_intproc routine Syntax int prt_api_term retstat COR So TALUS eYEL Stacy Data Structures None Input Arguments None Output Arguments retstat Return Value
163. _id item_ data more_data retstat char rt syo Ado ERVICR IDEEN e ali char group id PRT REGION TD LEN g char region_id PRT_REGION_ID_LEN 1 char item LOTPRT TIEM ID GEN ae char reference_id PRT_ITEM_ID_LEN 1 PRT _ITEM_STRUCT PIR item data COR BOOLEAN more_data COR STATUS Fenstat Data Structures typedef struct tins t reg entry Cime time t last_mod_time char region_id PRT_REGION_ID_LEN 1 identifier of the region CORTZ region boc speciric location in Lhe region char item id PRT_ITEM_ID_LEN 1 unigue identifier of a Serialized Item char reference id PRT_ ITEM ID LEN 1 lt secondary identifier Of a Serialized Item char item_type_id PRT_ITEM_TYPE_ID_LEN 1 item type identifier char parent_item_id PRT_ITEM_ID_LEN 1 pertains only to Non serialized Items COR_U4 item status item status COR BOOLEAN At hold active if TRUE item held due to internal hold Char i1ant hold reason SC DESCRIPTION LEN LL Comment specifying reason for internal hold COR BOOLEAN ext_hold_active if TRUE item held due to external hold char group_id PRT_REGION_ID_LEN 1 identifier of the group COR_I1 num_atts_ valid Number of attributes in the list PRT ITEM ATT item_att_list PRT _NUM_ATTRIBUTES Item Attributes pertain to Serialized Items k RT LEM STRUCI SPRI ILITEM STRUCT PTR CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GF
164. a Tracking Region when an Item sequence error is detected The five configuration options are to Immediately place the item in the corresponding detainment Region Change the Item s status to DELAYED Once the configured number of Items has exited the Region the missing Item is placed in the corresponding detainment Region Scrap the missing Item Change the Item s status to DELAYED Once the configured number of Items has exited the Region the missing Item is scrapped Do nothing sequence monitoring disabled synchronization In the event a sequence error is detected PRT allows resynchronization of the tracking environment which can be done either manually or automatically Further if Automated Region Validation is configured sequence processing occurs when the Items in the Region are reordered You will learn about Manual Resynchronization The tracking environment can be manually resynchronized by reconciling the Tracking Region queues using available functions in the PRT User Interface Available functions are as follows Add Item Delete Item Move Item Fetch Item Advance Item Reorder Region For additional information about these functions refer to Using the Production Tracking Window CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Automatic Resynchronization Automatic resynchronization takes place when a serialized Item exits a Sequential Tracking Region in an
165. aaaeeeesseenees 4 64 Production Tracking Export Program PRT_EXPORT cc cccsssssseeseeeeeeeeeeeeeseaeaas 4 67 Export Input File Formataesi senan un a a a 4 67 Export Ontput Pile Tonna Sretena a a r Aai 4 69 Running the Export Program eessessssessssssseseeerrrerrrerssssssssssssssssecerrerereereessssssssss 4 69 Production Lracking Processes aiiis eE OA E TOENN 4 70 Production Tracking Global Section Usage ccccscssseseececeeeceeceeaaesseeseeeeeeceeeeeeeeeeeaeenags 4 70 PRE St Oat AO Ny oreken r A T E E T E E T 4 71 Synchronization Capability eesseeesessessseseeeeeeeesssssssssssssectrerresssssssssssseeereeeesssssss 4 71 Alarmi MOVE EXCEDUONS esnan a a arr 4 71 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Production Tracking Application Interface 5 1 About the Production Tracking Application Interface ccccccccccecececeeeessessessssesseeeeeeees 5 1 Contents of the Application Subroutine Interface ce eceesseeessseeeceeeeeeeceeeeeasaaeseseeeeeeeeess 5 1 TMCS TCS scoacshctectcanesSnausiies Suienenat O 5 2 Run Time NOs scnives iene ahs Bian anes Bide aah ases 5 2 Applicaton SUDLOUUINES oreen e nats sulb tal oeannie sate a A 5 3 prt_api_init Initialize The PRT_API Interface ccc cceccccccecccceeeeeeeeeeeeeeeeeeeees 5 3 prt_api_term Terminate PRT_API Interface 20 0 0 ceeccccssseeeeeeeeeeeeeeeeaaeeeeeeees 5 5 prt_api_get_req Get Request From External Proc
166. ae i port_index char result str COR DUALBRCT RETURN 3S TRING i Data Structures None Input Arguments input_buffer Buffer returned from ipe_read on primary port port_index Output port index Output Arguments result_str Returned identifying string See cor_dialect h for valid strings returned Return Value None CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PRT API Macros About PRT Macros This chapter includes macros for clearing setting and testing the various bits of the modify bitmask argument used by the prt_api_modify_ item and prt_api_get_intproc_updates functions GFK 1216F The SET macro sets the bit that corresponds to the actual data field in the item information structure The CLR macro clears the bit The IS macro returns a non zero value if the bit is set and zero if the bit is clear SET_ITEM ID MOD BIT x CLR_ITEM_ID_MOD_ BIT x IS_ ITEM ID MOD x SET _REFERENCE_ID_MOD_BIT x CLR_REFERENCE_ID_MOD_BIT x IS_ REFERENCE ID MOD x SET_ ITEM TYPE_BIT x CLR_ITEM TYPE_BIT x IS_ ITEM TYPE x SET _ PARENT _ ITEM BIT x CLR_PARENT_ITEM BIT x IS PARENT ITEM x SET_ITEM STATUS BIT x CLR_ITEM_STATUS_BIT x IS ITEM STATUS x item id reference id item_type_id parent_item_id item status 6 1 6 2 SET INT HOLD BIT x CLR_INT HOLD BIT x int_hold_ active IS_INT HOLD x If int hold active TRUE int hold reason also contains v
167. aken otherwise the rest of the value is taken as an Item Type ID and processing continues as if an Item Type detector was activated Currently the only reserved word is TMOUT and the action taken is to ignore the point Appendix C PRT Rules and Assumptions C 5 Shifting Region Tracking Shifting regions support empty locations intermixed with occupied locations As items are transitioned into a shifting region all items currently in the region are shifted by one location and the item at the head location is transitioned to the Shifting Transition Region Items are always transitioned to the end location of the region not the last occupied location Shifting Region Tracking Configuration To configure a shifting region the corresponding record in the PRT_REGION file should have tracking _type_id SHIFTING tran_region_id region_id of the transition region of shifting region When a new shifting region is configured on the subsequent startup PRT will create blank items automatically for all the locations These blank items are only placeholders they can not be deleted added or moved by the user While configuring item types do not configure any item_type_id as which is a GE Fanuc reserved word for item_type_ids of blank items for the Import Export utilities Shifting Region Operations The following sections detail the functionality of shifting regions Adding an item into a Shifting Region When a new item i
168. alid data SET EXT HOLD BIT x CLR_EXT HOLD BIT x ext_hold active IS EXT HOLD x If ext hold _ active TRUE group_id also contains valid data SET_ATTS VALID_ BIT x CLR_ATTS VALID BIT x not needed when using the IS_ATTS VALID x prt_api_modify item_att function CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Appendix A PRT API Error Codes Error codes Returned by Production Tracking The following error codes are returned by the Production Tracking Application Interface Number 11401 11402 11403 11404 11405 11406 11407 11408 11409 11410 11411 11412 11413 11414 11415 11416 11417 11418 11419 11420 11421 11422 11423 11424 11425 11426 GFK 1216F Defined Constant PRTIL FILE READ ERR PRTI_FILE_OPEN_ERR PRTI_SVC_DEF_MISSING PRTI_REG_ DEF_MISSING PRTI_GRP_DEF_MISSING PRTIXLATE_ERR PRTI_AUX_NAM_ERR PRTI_ADD_PORT_ERR PRTI_READ_PORT_ERR PRTI_WRITE_PORT_ERR PRTI_MF_INIT_ERR PRTI_CRESEG_ ERR PRTIBAD_ MSG PRTI_NOT_STATUS_SEG PRTI_EXTRA_SEGS PRTI_UNEXPECTED_SEG PRTI_LUNEXPECTED_SEG_ TYPE PRTIITEM_TYPE_NDEF PRTIITEM_TYPE_NULL PRTI_LNUM_ATTS_INVALID PRTI_REG_ID_NDEF PRTI_REG_ID_NULL PRTI_GRP_ID_NDEF PRTI_GRP_ID_NULL PRTI_SVC_ID_NDEF PRTI_SVC_ID_NULL Description Error reading configuration file Error opening one of the configuration files Undefined Service in file lt filename gt Undefined Region in file lt filename gt Undefined Group in file lt
169. ame is APRT_DC will be APRT_GRP The tables are independent of one another so only those necessary for the specific data you want logged need to be configured PRT_GRP The PRT_GRP table will contain data logged concerning any PRT Group PRT_ITEM The PRT_ITEM table will contain data logged concerning any PRT Item or Item attribute PRT_REG The PRT_REG table will contain data logged concerning any PRT Region GFK 1216F G 1 G 2 Table Fields PRT GRP PRT_ITEM The following list details the allowed fields which can be logged by PRT to each of the three tables These fields are configured by editing the data_field idt file The logging configuration requires no specific fields so you may use only those fields your application requires Event_Type Text description of the type of event which triggered logging Group_Id Name of the group for which the event occurred Ext_Hold_Active External hold state of the group Ext_Hold_Reason Text description of reason for external hold activation Ext Service_lId Name of the external process which modified the group s status mask Comment Extra data sent to PRT to describe the changes made User _Id Identifies the agent which modified the group s status mask Event_Type Text description of the type of event which triggered logging Entry_Time Time the Item entered the current region Modify_Bitmask Mask whose bits identify which tracking f
170. ample Dim main as new Prtgroup main Id MAIN Get a list of items with an item class id CARRIER from the group MAIN and display them one by one in a message box main ItemClassId CARRIER main GetItemList for j 0 to main ItemCount 1 MsgBox main Item j ItemId next Jj PrtGroup ltemCount Property Read Syntax PrtGroup ItemCount Description Integer property contains the number of items find by a previous Get ItemList or Locateltenm call Example Dim main as new Prtgroup main Id MAIN Get a list of items from group MAIN i and display them one by one in a message box main GetItemList for T 0 bo Mains LEemCoume 1 MsgBox main Item j ItemId next Jj E 18 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtGroup Locateltem Method Syntax PrtGroup LocateItem itemld refld numRetries Description Locates a serialized item within the tracking group Upon return the total item count may be obtained from It emCount and the individual items may be accessed via the Item function Comments Parameter Description itemld String The Item ID to locate may be an empty string if refld is specified refld String The Reference ID of the item to locate may be omitted or an empty string if itemJd is specified numRetries Integer optional The number of times to retry to find the item before failing If an item is in transition from one tracking region to the ne
171. an Item for instructions on moving items across project boundaries Item Status The item status must be identical for items on different projects The item status is a 32 bit number for all projects however if the same bits have different meanings from project to project problems will arise Modify the status using the Status Configuration dialog box in the Tracker Configuration UI on all projects to have identical statuses in order to move items effectively ltem Types In order to move an item between projects the item type must be allowed in the region of the project receiving the item The item class will be as it is configured in the PRT Item Type Configuration dialog box If the item type is not allowed in the recipient project a warning message will display the move will be disallowed CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Adding Inserting or Modifying an Item In order to add insert or modify an item ensure that the active region in the PRT window is the region in which you want to make changes See earlier instructions for displaying a region Because the dialog boxes and procedures for adding inserting and modifying items are so similar following are initial instructions for opening the individual dialog boxes The procedure then continues in Step 4 GFK 1216F Perform Step 1 Step 2 or Step 3 then continue with Step 4 Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Add an item to a regio
172. an item comes to the head of a region PRT is triggered to validate the item If the PRT image matches the reader value then this flag is set to TRUE other wise it is reset to FALSE PRT will reset this flag to FALSE when the head item of the region leaves its location Waiting For Decision Flag After a routing controlling process such as RCO makes a decision on a region it should not make another decision until the current one is executed This may pose a problem in certain routing configurations such as a merge Since merges will have multiple source regions RCO sites will most likely have multiple triggers This will become a problem if two triggers especially heartbeat triggers result in the same decision before the previous one is executed To resolve this repeated decision problem it is proposed to introduce a Waiting For Decision flag that is associated with the region The routing controlling process sets this flag when it makes a decision involving release of an item from that region It is reset when a new item validation trigger is received 4 50 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Deriving Region Status from Validation Process Data The following table lists the region status determination based on the region status variables Waiting for Region Status Valid Flag Decision Startup Condition A Unknown Undefined x x New Item at head and Validated B v v New Item at head and not Validated C x
173. ap Items Move an Item to another region Add or delete Items Reorder Items or Item carriers Advance Items in the Tracking Model Connect to multiple projects Perform all of these functions and much more CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Tracking Items GFK 1216F Production Tracking begins tracking an Item when a production start message is received and stops tracking an Item when it exits the last Region on the production line Serialized Items require an Item ID and non serialized Items require an Item type ID in order to be tracked through the system PRT can begin tracking an Item Through a manual transaction Through a message from a PRT application interface ByaCIMPLICITY Point Non Serialized ltems PRT provides the reserved Item type UNKNOWN which can be associated with a non serialized item at the start of production There are certain guidelines that must be followed when using this association as follows The association can only take place when a non serialized Item passes a transition indicator The transition indicator must be configured as an Item type detector ACIMPLICITY Point must be configured to report positive identification of the Item type An application interface message can associate a non serialized Item with an unknown Item type The Item type of the non serialized item must be identified later in the production proce
174. arch the PRT database and should be either PRT _ITEM_ ID or PRT_REFERENCE_ID The remaining fields are data passed to CTI for updating the Item record once itis found FIELD ID The ID of a PRT field or attribute to be modified This will be the same attribute identifier that is used by PRT FIELD LENGTH For TEXT points the length in characters of the field and attribute data Examples of records found in the CTI_LAYOUT CFG file are _ RCV POINT PRI LTEM 1D 20 RCV_POINT_1 2 ATTI_1 4 REV POINT 10 sy AL T3316 RCV_POINT_1 4 ATT_5 4 REV POUNT SO PRD ITEM STAT U Ss LI RCV POINT 1 6 PRITTEM STATUS 4 1 RCV_POINT_2 1 PRI_REFERENCE ID REV POTN T 2 2 ALL REV OFOTNI 2 55 ALT S RCV_POINT_2 4 ATT_4 RCV POULNT 2 5 PRI ITEM STATUS F 6 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F The above records represent the layout of PRT field data within the points used by CTI to receive data An example of what the record stands for follows The point RCV_POINT_1 contains data for the ITEM_ID field in the PRT record the attributes ATT_1 ATT _3 and ATT_5 and item status bit 1 and item status bit 4 in that order Since RCV_POINT_1 is a text point the length of each attribute must be specified The length of the ITEM_ID data is 20 bytes the length of the ATT_1 data is 4 bytes the length of the ATT_3 data is 6 bytes and the length of the ATT_5 data is 4 bytes The length of PRT_ITEM_STATU
175. arm Shifting Region Tracking Shifting Regions support empty locations intermixed with occupied locations As Items are transitioned into a shifting region all Items currently in the region are shifted by one location and the Item at the head location is transitioned to the Shifting Transition Region Items are always transitioned to the end location of the region not the last occupied location For more information see Appendix C Shifting Regions Normal Tracking A Normal Tracking Region tracks the flow of Items or a group of Items Items can be serialized or non serialized Production Tracking Overview 2 3 Combine Items Tracking A Combine Items Tracking Region allows multiple items to converge into one region location There is only one associated region location associated in the Combine Items Region Disperse Items Tracking A Disperse Items Tracking Regions is the opposite of a Combine Items Tracking Region in that combined items are separated into successive regions There is only one region location associated with the Disperse Items Tracking Region Associating Items Production Tracking permits Item associations to be formed Automatically in a Combine Items Tracking Region By request through a manual transaction or an application interface message Automatic Item Association Automatic Item associations occur in Combine Items Tracking Regions where configuration data specifies the Item types that will p
176. arm ID for items placed in detainment region Alarm ID generated when an item enters IN LOCKED region or exit OUT LOCKED region via a point based move Alarm ID when the maximum number of item carriers in the region are exceeded Alarm ID when the maximum number of items at a single region location item carrier have been exceeded Configuration File Guide No delimiter character after last field in record Data Type 32 characters 1 byte 32 characters 32 characters 32 characters 32 characters 32 characters 32 characters Entry Example APRT DC Blank Blank PRT_DET_ REF_ FULL PRT_ITM _ THRU_LCK PRT_REG CAP PRT_REF __ LOC_CAP 4 9 No 8 12 13 14 4 10 2 records created Field Name seq_err_alrmid item hold alrmid invalid type_ alrmid unknown_type_ alrmid invalid id alrmid region_not_empty_ alrmid Batch_queue Description Alarm ID when an item is out of sequence at a region exit transition indicator Alarm ID when an item arrives in a tracking region and is determined to have an item hold specification Alarm ID when an invalid item type is detected Alarm ID when an unknown item type is detected Alarm ID when a serialized item enters a region and information cannot be retrieved for that item Alarm ID when all items have not left a disperse tracking region and new items have arrived in the region NOT USED Configurati
177. arning Partner dead Warning Ignored extra segments after STATUS_SEG or END_SEG Warning PRTI_NOT_ALL_SVCS_RESPONDED Not all services responded Warning PRI WRETE PORT RR PRTI_MF_INIT_ERR PRTI_CRESEG_ERR PRTI_BAD_MSG PRTI_READ_PORT_ERR Error in ipc_write_port Warn Fail Error initializing segment Failure Error creating segment Failure Error in segment Failure Error in ipc_read_port Failure CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F prt_api_req_itemlist Request List Of Item Tracking Data Name prt_api_ req itemlist Description This routine provides a mechanism to request the Item Tracking Data for one or more Items from the PRT Data Server PRT_DS residing within all configured PRT services a specific PRT service a specific Tracking Group a specific Tracking Region or at a specific location within a specific Tracking Region If the request is a success the calling routine will receive back a count of the number of items returned to the item list If the request fails the calling routine will receive back status information on the reason for the failure syntax ine pre apr reg itemiist prt ove Td Group rid regionida region_loc item_count retstat char Prt Sve tO SERVICE ID LEEN F shi char GrOGp ltd PRT REGION TD GEN L char region_id PRT_REGION_ID_LEN 1 COR T2 region_loc COR_14 1 Lem Count COR_STATUS retstat Data Structures None Input
178. arning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user GFK 1216F Appendix H Configuring PRT Client Startup H 5 Note If the point value begins with a the remainder of the point value is used to identify the item type to move The transition type code becomes a Type Detector at this point Tracker searches for the given item type and moves the item to the destination Again in this case If The source region is a disperse region Then Only the item with the given item type is moved If Multiple items exist at a location and the source region is not a disperse region Then All items at the location are moved Actions triggered by the handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user Transition Type 4 Reference Identifier Tracker searches for the item with a given reference ID in the entire model Actions triggered by what Tracker finds in the entire model are If The item is not found Then A message is logged If The source region is a disperse region Then Only the given item is moved If Multiple items exist at a location and the source region is not a disperse region Then All items at the location are moved Actions triggered by the handling of a moved
179. articipate in an Item association and the role each Item will play in the relationship Each time an Item enters a Combine Items Tracking Region where automatic Item associations occur the Item type is checked to determine if this Item participates in an Item association An automatic Item association takes place when each of the Items in the association have arrived in the Combine Items Tracking Region Parent Child Item Association A Parent Child Item Association requires two Items The first Item must be serialized and is the parent Item in the relationship The second Item must be non serialized and is the child Item in the relationship Once associated the parent and child Items remain logically connected in the production process Tracker allows the parent Item may have more than one associated child Item A parent Item and a child Item can be associated by request whether they reside in the same tracking region or in separate regions The request must specify the Sequential tracking region in which the child Item resides Item type of the child Item non serialized Sequence location of the child Item in the region CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Modifying an Item s Status GFK 1216F A Tracking Region can be configured to affect an Item s status due to Item hold specifications For example a shortage of an Item attribute occurs if a required physical Item attribute for example A C
180. ass id PRI_ ITEM CLASS ID LEN 1 COR_14 item count COR_14 max location COR_STATUS retstat Data Structures None Input Arguments pru sveuid PRT service identifier optional but required if no other arguments specified group_id Identifier of the group optional but required if no other arguments specified region_id Identifier of the region optional but required if no other arguments specified required if region location specified Note At least one of the above three arguments must be specified If not all services will be queried It is possible that a list of items will be collected but not all services will have responded because one or more of them were down Thus the user has a list of valid responses but may not have ALL the items that should have been returned In this case the function will return COR_WARNING with an err_code of PRTI_NOT_ALL_SVCS_RESPONDED The function returns through an argument passed the number of items actually received This argument will show how many valid items were received GFK 1216F Production Tracking Application Interface 5 33 5 34 region_loc Item _class_id Output Arguments item count max_location retstat Return Value Specific location in the region required If all items within a region are being requested the region_loc must be specified as ALL_LOCATIONS Otherwise a specific location requests items at only that location
181. bar to start your project Click Tools on the menu bar 5 Select Command Prompt An MS DOS window opens 6 Type Set PRCNAM PRT_INT on the command line Where PRT_INT is the process ID used in your configuration files 8 Press Enter 9 Type PRT_INTTEST EXE on the command line 10 Press Enter Result The interested process messages generated by PRT operations will output in the Command window 2 Select Command Prompt 1 Click Tools on the menu bar 3 Type Set PRCNAM PRT_INT where PRT_INT is the process ID used in your configuration files press ENTER A TAACKPROW OMPLICITY Wiekbenmct HLH Windows AICLAs Lan pe Li re LYH L R F Fi Bok t ln Pp I SOILAPLICIOY pro ject rathen net PRCHAA FHT _1 HT 4 Type PRT_INTTEST EXE D SCIMPLI CI TY pre jects TrackProj PRT_OKTTEST EXE press ENTER J Sos Lee Tel pim is pi m status H E PF nate Result All interested process t Pectived From Data Server messages generated by PRT Operations are output in the Command window Important In order to run the executable file match the letter case of the arguments on the Command lines shown above GFK 1216F Appendix J Troubleshooting J 9 Index A About Event codes for production tracking B 1 Global verifier for production tracing D 1 Production tracking application interface 5 1 Production Tracking window 3 1 PRT macros 6 1 About the tracking Model Production tracking 2 2 Activate deactive hold
182. bj ect Model e The Model above demonstrates the relationships between the 6 most important objects available for use with the Basic Control Engine in PRT calls In code each arrow above would be replaced with a to allow access to the child objects i e PRT Group 0 Region 3 Item 0 Attr 6 Id GFK 1216F PRT Object Attributes The object attributes for the Basic Control Engine extensions for Production Tracking are Properties GroupCount Read ltemCount Read eProjectid Read Write RegionCount Read ServiceCount Read Methods GetGroupList eGetltemList eGetRegionList eGetServiceList eLocateltem Objects Group eltem eRegion eService Properties eCapacity Read eld Read Write ltemCount Read eltemTypeCount Read eLoc Read eProjectid Read Write Status Read Write StatusPointld Read Totalltems Read TotalltemsPointld Read Write Objects eltem eltemType ee Count Properties eExtHold Read e ExtHoldReason Read eld Read Write ltemCount Read Projectld Read Write RegionCount Read Methods ClearExtHold GetltemList GetRegionList Modify SetExtHold Objects eltem Region eService eAdvanceModel ClearStatusBit Deleteltem GetData eGetltemList eStatusBit eLocateltem eModify eReorder eSetPoints eSetStatusBit Properties eld Read Write Value Read Write Service Properties Group
183. box checked would result in the following Location ltem L1 Item1 L2 Item2 L3 Item3 L4 Item4 Item is retrieved into the next consecutive location 6 Optional Enter any additional notes for the PRT Log file in the Comments field 7 Click OK to move the item into the active region or click Cancel to cancel the operation Note PRT will locate the item in its current region you are not required to know the Region ID 3 24 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Moving an Item To move an item from one region to another region within the same project or across projects use the Move Item function J1 To move an item from the active region to another region 1 Select the item to be moved 2 Click Move gt to open the Destination dialog box Move an item Daslimabon COMBINE DOMBINE Check to insert CE TAM the item into the 4 location clear to ie REE add the item into wes the location PAUL REGI PALL RARER 3 Select the destination region from the Region ID drop down list or type in the region ID or click the Browse button to search for a region See Browse Regions topic at the beginning of this chapter for information on searching and valid criteria 4 Inthe Location field type in where you want the item placed in the destination region Optional Type any additional notes for the PRT Log file in the Comment box Check the Insert box to insert t
184. bsystems Each of the fields is described below complete with entry examples and a sample configuration file REQUIRE FILE Description Sets the queue size for the Application Interface s request port This is used to receive requests for item and item hold data from the PRT data collector s Sets the queue size for the Application Interface s synchronous port This is used to send requests to PRT data collector s and to send requests and receive responses from the PRT data server s Sets the queue size for the Application Interface s interested process port This is used to receive interested process updates from the PRT data server s Sets the queue size for the data collector s main port Sets the queue size for the data server s main port ds_throttle_port Sets the queue size for the data server s throttle port ds_int_port dc_aux_port J a Sets the queue size for the data server s interested process port Sets the queue size for the data collector s auxiliary port Data Type Integer Integer Integer Integer Integer Integer Integer Integer Entry Example 10 10 10 20 20 20 50 10 Important GE Fanuc recommends that the ports in this record be set to a minimum value of 10 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configuration File Example o pol gy erhel T Notepad Fie Ede tesch Helo IDT File generated by IDTPOP utility v1
185. bute array To specify item attribute information see the description of the ATT record type MOD Modify a Tracked Item This command provides a mechanism to do the following Modify Item Tracking Data Associate an Item Type with an unknown Item Associate a Reference ID with an Item ID Associate two Items An unknown Item is assigned an Item Type by modifying the Item Type field to the correct value A Reference ID is associated with an Item ID by modifying the Reference ID for the Serialized Item A Non serialized Item is associated with a Serialized Item by modifying the Non serialized Item to include the new or modified Serialized parent Item ID The fields in this record are Field Description char record_type 3 MOD COR_U4 modify_bitmask Indicates field that has been modified These are codes that can be used to indicate which bits in the modify_bitmask are set SET_ITEM_ID_MOD_BIT result R SET_REFERENCE_ID_MOD_BIT result T SET_ITEM_TYPE_BIT result P SET_PARENT_ITEM_BIT result S SET_ITEM_STATUS_BIT result H SET_INT_HOLD_BIT result E SET_EXT_HOLD_BIT result COR_U4 status_bitmask Indicates fields in item status which have been modified char region_id 1 7 Region where item last resided COR_l2 region_loc Specific location in the region where the no serialized item resides Configuration File Guide 4 59 char item_id char reference_id 21 char item_type_id 17
186. cation and configuration debugging The high level detailed and verbose will print all the available debugging messages intended to be used by developers to debug the programming logic The debugging messages will logged in the file lt PROCESS_ID gt DBG and the logged file will reside in the directory specified by the logical name LOG_PATH The logical must be defined BEFORE the process starts the debug file may be viewed AFTER the process ends Example There is a CTI process configured as CTI_RP_1 If you desire to turn on the high level debugging for the process do the following at the DCL command line before starting the process CTI_RP_1 Add the following line to 3SITE_ROOT data log_names cfg CTI_RP_1 DEBUG P default 10 2 Appendix F Configurable Tracking Interface COR_STATUS Messages The CTI processes may detect some exceptional errors or warning errors and log these errors to the project s standard CIMPLICITY status log file found in SLOG PATH COR_RECSTAT CLG These errors may be detected by the CTI custom software or from API software To view the status log file use the Status Log in the CIMPLICITY menu The CTI messages are reported in COR_STATUS LOG with a source of CTI_SOURCE The messages and suggested corrective actions are described in this section Message Cannot open lt PATH filenames file Record number lt REC_NUM gt of lt FILE NAME gt has too few fields Can not find any field lay
187. ce by search order as configured in the PRT_SERVICE file and return a pointer to this record in svc_rec as well as copying the prt_svc_id Syntax int pre api next Svcs Sve rec pre Syve 1Id struct prt Service ASVO TeC char DEG SVvciO SERV LCE Dm NY a dels Data Structures See Static Information Requirements Input Arguments Svc_rec Pointer to a pointer to a PRT_SERVICE record record in the PRT_API internal schema which contains information on configured PRT services Output Arguments Svc_rec Pointer to a pointer to a PRT_SERVICE record record in the PRT_API internal schema which contains information on configured PRT services Each successive call returns a pointer to a new PRT_SERVICE record pre Sye id PRT Service identifier Return Value Either COR_SUCCESS or COR_WARNING COR_SUCCESS is returned as long as the next service has been found When there are no more services to be returned the entire schema has been run through COR_WARNING is returned GFK 1216F Production Tracking Application Interface 5 81 prt_api_get_item_types Return a list of all configured item types Name prt_api_get_item types Description This routine returns a list of all the configured item types in the PRT system It also returns a counter for the number of items found Syntax int prt_api_get_item_types item_type_ids total retstat Chak xitem_type_ids COR_14 ot Otel es COR_STATUS Sen StL at Data S
188. ce and display them one by j one in a message box ServiceA GetRegionList for j 0 to ServiceA RegionCount 1 MsgBox ServiceA Region j Id next J Appendix E Basic Control Engine Extensions for Production Tracking E 71 Appendix F Configurable Tracking Interface About the Configurable Tracking Interface This appendix provides the information necessary to configure and use the Configurable Tracking Interface CTI CTI lets you perform certain Tracker functions through CIMPLICITY Points rather than through API BCE calls or the User Interface CTI can Add an Item to Tracker Modify an existing Item Move an Item Confirm an Item exits in the system CIMPLICITY Environment The Configurable Tracking Interface application software is compatible with CIMPLICITY NT release 1 0 or later The software was constructed under Windows NT 3 5 Release Candidate 1 using the following CIMPLICITY Point Management API CIMPLICITY Production Tracking API The Configurable Tracking Interface executable exists in sBSM_ROOT EXE on the NT platform for access by run time CIMPLICITY The name of the executable is CTI_RP EXE Note You may need access to the documentation for the APIs listed above GFK 1216F F CIMPLICITY Base System Configuration It is assumed that you will reference the appropriate base system documentation to configure the points to be utilized by the CTI software All CTI input and response po
189. ceceeeeeeeeeeeeeeeeeeeeees 5 37 prt_api_req_regionlist Request List Of Tracking Region Data 00008 5 39 prt_api_unload_regionlist Unload List Of Tracking Region Data 0 5 41 prt_api_req_grouplist Request List Of Tracking Group Data cceeeeeeeeeees 5 43 prt_api_unload_grouplist Unload List Of Tracking Groups eeeeeeeeeees 5 45 prt_api_register_intproc Register As An Interested Process ccceccceeeeeeeeees 5 46 prt_api_dyn_register_intproc Register As A Dynamically Interested Process 5 47 prt_api_intproc_region Receive updates only from specific regions 5 49 prt_api_intproc_retry_connect Send INIT Segment to all data servers 5 50 prt_api_get_intproc_updates Get Interested Process Item Region Tracking Data ETETE i E A E A E A E E A A use tehasuaaten ta cas etan esa 5 51 prt_api_term_intproc Terminate PRT_API Interested Process Interface 5 54 prt_api_static_region_data Copy Static Region Information Into Region SUC UE anona a E A A e A O A sesso esasesauetessauaesatocs 5 55 prt_api_prod_start Initiate Production Start For An Item eeeeeeeeeees 5 56 prt_api_prod_stop Enable Production Stop For An Item ee eeccceeeeeeeees 5 59 prt_api_add_item Add Item To Tracking Region Queue cccccceeeeeeeeeeees 5 62 prt_api_insert_item Insert Item Into Tracking Region Queue ccsssseeeeees 5 66 prt_api_mo
190. ceed with the validation 7 After the validation process is completed PRT updates the results of the process 8 9 and updates some runtime statistics 11 After the validation process is completed the PRT subsystem should provide a mechanism for letting other subsystems know about the completion of the validation process 12 This would help eliminate the timing issues that might arise between the PRT validation process and the processes such as RCO s or an event manager driven routing mechanism that may act on the validity of regions after the validation process has completed Since validation statistics are going to be updated after every validation this point will be used to trigger other processes GFK 1216F Configuration File Guide 4 43 Reviewing Different Scenarios for Flow of Control In this section different plant setup scenarios that will result in different operational behavior are illustrated Setup 1 Flow of Control PRT validation is triggered by the carrier at stop point PRT does its validation and then sets the statistics point which in turn triggers the RCO Carrier at stop Device A Reader Device 4 44 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Setup 2 Flow of Control PRT validation is triggered with the reader point In this case PRT can not catch no read cases The systems relies on the processing performed by the RCO when the carrier sets the carrier at stop po
191. ceeneesssesesseeeeeceeeeeeeeeeeaaaaseeeeeees E 18 PriGroup ltemC ount Property Read sen cintestesindticnonan vehi ae ieee E 18 PriGrouplocateltem Menod ss csicas catatinict a6 a pecan taasemonsiaseeaeet E 19 BriGroupModity Meth sae e a a a SaS E 19 PrtGroup ProjectId Property Read Write joci i na aa e e E E T a a E 20 PriGroup Reson BUNCHON esii E TNA E 20 PitGroup ResionC ount Property R Cad Porsuismansenisn ana o a en E 21 PrtGroup SetExtHold Method Jesii iins a a aaa a aa A E 21 Pakem Add Method hiretrrudnnn nn a E a a a AOTEA E 22 Phen An E ON a a a EA E 23 Piem Attire ount Property Keadran a a a A E E 24 PrtItem ClearModifyTime Method eosina a a iiA E 24 PrtItem ClearStatusBit Property Read Write ciesion N a E 25 Priltem Comment Property Read Write 3 ccc inte Beeson E 26 Prittem Delete Property Read W Ge vsencceeocteas sedans a a N sans E 27 PrtItem EntryTime Property Read ccccccccecccccecccccceeeeeeessseeeeeecceeeeeeeseesaaaaaeesesseseeeeeess E 27 PrtItem ExtHold Property Read Write ccccccccccccccccceeeessesseeeeeeceeeeeeeeeeeeaeaaesseseeeeeeeess E 28 PrtItem ExtHoldGroupId Property Read Write ccccccccccccsssssseesseeeeeecceeeeeeeeeeeaaeseeenenes E 29 Contents Contents Xxi Contents xii Priltem Tt mClassld Property Read Write wise secscocau naii a e a E a a E 29 PreitemAtemid Property Read W mite vied aneen E R E 30 Prtltem Insert Method icivis saves icsteiscl
192. characters that will be attached as a prefix to the Point value prior to processing This allows items with the same ID to be identified in different parts of the factory translation_type_code 1 6 or 7 NOT USED GFK 1216F Configuration File Guide Data Entry No Field Name Description Type Example 6 translation_type_ Unique code to represent the tracking One byte 3 code indicator type as follows 1 Limit switch 2 Type detector integer Point 3 Automatic Item ID displaying Item ID Text Point 4 Automatic Item ID displaying Reference ID Text Point 5 Associated Reference ID to Item Text Point 6 Associated Item Type to Item Integer Point 7 Positive Edge Trigger transition occurs when value changes from zero to nonzero 8 Negative Edge Trigger transition occurs when value changes from nonzero to zero 7 Process_first_ FALSE or undefined transition point O FALSE 0 ptchange ignores the first point change of a route 1 TRUE T prii_mwia ht Holepad TRUE processes the first point change as a transition point Configuration File Example Fie Edi esch Help DT File generated by IDTPOP utility vi a RECORD PRT ROUTE Production Tracking Route orig region id 10 of region iten exits dest region id ID of region item enters item type id transition ptid set_ptid translation id transition type code precess first _ptchange b E b E h h E y ese a i n E a H d ERCI JE SUT Sipyay
193. ck a status indicating the success or failure of the request Syntax int prt_api_modify_item_all timestamp modify_bitmask Status_bitmask region_id region_loc item_id reference_id item_type_id parent_item_id item_status ext nold active group rdr int Nola activ int hold reason num atts valid 1tem att List comment user_or_svc_id retstat time_t timestamp COR _ U2 modify_bitmask COR_U4 status_bitmask char region 1d PRE REGION ITDOLEN e el COR LZ region_loc char icem ATO PRT TEM ID LEN Sh char reference_id PRT_ITEM_ID_LEN 1 char item type idi PRI ITEM TYPE ID LEN F 1L 3 char parent iten IA PRI ITEM_ID OLEN de COR_U4 item_status COR_BOOLEAN ext_hold_active char Group 1d PRT sREGION IDEEN 17 COR BOOLEAN int hold active char int No lo reason SC DESCRIPTION LEN eb a COR_I1 num_atts_valid PRI TEM ATT item att List char comment SC DESCRIPTION GEN L13 char user Or Sve Jd SERVICE TD LEN 11e COR_STATUS retstat Data Structures None Input Arguments See SYNTAX for proper order Serialized Items Only item_id Unique identifier of a Serialized Item optional if reference id specified reference_id Secondary identifier of a Serialized Item optional if item id specified ext_hold_active If TRUE item held due to external hold optional CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F group id Group identifier providing reason for hold
194. configured to allow new items to be added CTI will add a new item to the configured Destination Region CTI will only allow items of the type configured in CTI_PT_ DEF CFG for the point to be added If the Item Type field is left blank in CTI_PT_DEF CFG any item type may be added If CTI is unable to add the item the Transition Failure Point will be set to 0 otherwise it will be set to 1 Stale Records F 16 When CTI receives point updates for an item it first tries to locate the item in the Production Tracking database CTI input points can be keyed by either the Item ID or Reference ID If keyed by one of these fields the other field can be changed by the point value For example if a point value is keyed by the Reference ID the Item ID may be another value in the point If the alternate key field value in the point is different than the current value for this field CTI tries to locate an existing item using the alternate key field value If found this stale record is deleted before the keyed record is updated A message is logged in COR_STATUS LOG indicating that this has happened For example assume that a point value is keyed by Reference ID but also updates the Item ID An item currently exists in Production Tracking with Reference ID 9999 and Item ID 10000 Another item currently exists in Production Tracking with Reference ID 9100 and Item ID 19000 A point value is received by CTI with a Reference ID of 9999 and an Item
195. ction sets this argument to zero regardless of what was actually passed required Item attribute list This argument is the pointer to an array of PRT_ NUM_ATTRIBUTES elements If the pointer is NULL this clearly indicates that no item attributes are being provided along with the item being added If the pointer is non NULL however it must point to an array of exactly PRT_NUM_ATTRIBUTES elements The num_atts_valid argument indicates how many of these elements contain valid data optional Associated serialized item identifier optional The time the item was last moved or modified The timestamp is used to ensure that when attempting to add an item the item s currently at the location where the new item is being added have not moved or been modified between the time when information was last obtained for that item s and the attempt to add a new item at the same location One of the fields in the structure which returns data on an item is the last_mod_time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the timestamp associated with the item s at the location being added to then the add function is not performed and a warning returned If the timestamp argument passed to this function is zero the operation is performed without any timestamp checking Region where the item is to be added to the queue required Production
196. cture Error Codes PRI I_NUM_ATTS_INVALID PRTC_INVALID_ITEM_ TYPE PRTCWCANT MATCH BOTH PRIC 1 TEM NOL FOUND PRIC REE NOT FOUND PRI CG BAD REG 25PEC PRIC ITEM STAMP TOO NEW PRTI_ITEM_TYPE_NDEF PRTI_SER_NO_ID PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Invalid number of item attributes specified Warning Invalid item type specified Warning Item XREF entry mismatch Warning Item ID not found Warning Reference ID not found Warning Bad region specified Warning An affected item has changed since the last display Warning Item type identifier not valid Warning Serialized item missing both item id and reference id Warning Region identifier NULL Warning Region identifier not valid Warning Item type identifier NULL Warning Item type identifier not valid Warning Error initializing segment Failure Error creating segment Failure Production Tracking Application Interface 5 17 5 18 prt_api_modify_item_all Modify Item Tracking Data All Name prt_api_ modify item all Description This routine provides a mechanism to modify all information fields associated with an item both those modifiable by the prt_api_modify item function and for a serialized item the item s attributes also For non serialized items this function does nothing more than the prt_api_modify_item function The calling routine receives ba
197. cture Return Value Either COR_ SUCCESS COR_WARNING or COR_FAILURE If the function returns COR_ WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure Error Codes PRTI_TOO_MANY_REQ Total number in list less than number requested Warning GFK 1216F Production Tracking Application Interface 5 45 5 46 prt_api_register_intproc Register As An Interested Process Name prt_api_register_intproc Description This function provides a mechanism for a process to request to register as an interested process to a PRT process Either this initialization routine must be called by all PRT interested processes prior to calling any other PRT_API interested process utilities or prt_api_dyn_register_intproc The calling routine receives back a status indicating the success or failure of the request This routine is used when you have configured your process as a service and is included in the prt_service dat file If this is not the case then you must use prt_api_dyn_register_intproc Syntax int prt_api_register_intproc intproc_event_flag retstat COR I4 intproc_event_flag COR SIATUS revetacy Data Structures None Input Arguments intproc_event_flag Output Arguments Pers Eat Pointer to COR_STATUS structure Interested process event flag required Return Value Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in
198. d extra segments after STATUS_SEG or END_SEG Warning PRTI_WRITE_PORT_ERR Error in ipe_write_ port Warn Fail PRTI_MF_INIT_ERR Error initializing segment Failure PRTI_CRESEG_ERR Error creating segment Failure PRTI_BAD_MSG Error in segment Failure PRTI_READ_PORT_ERR Error in ipe_read_port Failure Production Tracking Application Interface 5 31 prt_api_unload_groupitemlist Unload List Of Serialized Item IDs in a Tracking Group Name prt_api_unload_groupitemlist Description This routine provides a mechanism to unload the list of Serialized Items obtained through the prt_api_req_groupitemlist routine If the request is a success the calling routine will receive back an array populated with the Serialized Item information If the request fails the calling routine will receive back status information on the reason for the failure Syntax int prt_api_unload_groupitemlist list_size item_hold_list retstat COR_14 Tist saze PRT_ITEM_ HOLD_STRUCT item Nora ist st sirel COR_STATUS retstati Data Structures typedef struct char item_id PRT_ITEM_ID_LEN 1 unique identifier of the Item char grouo 1dIBPRI REGION 1D LEN LI identifier of group responsible for placing a hold on this item COR BOOLEAN ext hold active if TRUE HOLD is activated for Item PRE TERM HOLD STRUCI SPREI TEM HOLD STRUGCT PTR Input Arguments list_size Size allocated for item_hold_list array required item_hold_list Array of
199. d through a manual transaction or an application interface message You can configure your Tracking Model to log the scrap event PRT logs The Item ID and Type for serialized Items The Item Type for non serialized Items Any comments entered for description purposes Generating CIMPLICITY Alarms Production Tracking generates CIMPLICITY alarms when exception conditions are detected during Item tracking You will configure when alarms are to be generated on a region by region basis For example an alarm is generated if a job transitions and does not follow its predefined route Configuring CIMPLICITY Setpoints CIMPLICITY Setpoints can be configured to enhance your Tracking Model There are numerous uses for Setpoints as described below You can configure Setpoints to Specify the status of the Region Indicate the quantity of Items in the Region Calculate the quantity of Items in the Region by Item Type Update when an Item is automatically moved into a Region Point based move Inform when an Item passes a Region transition indicator to include the Item ID for serialized Items and the Item type for non serialized Items Using the PRT User Interface Production Tracking comes complete with a full function user interface to display and manage tracking data for your Regions and Items With the PRT User Interface you can View all the Tracking Regions in a Group Display properties for an Item Scr
200. de identifying the item type to be used internally by PRT item_type_desc Textual description of the item type item_tracking Code identifying the tracking type _type 1 Serialized 2 Non Serialized item_class_id Name of the item class to which this item type belongs Reminder Item Classes are not required but are recommended Feel free to create one Item Class for all of your item types Configuration File Example D mitem ipp et Hotepad fie Eat ssh jjsip Data Type 16 characters Integer 40 characters One byte 16 characters Entry Example COMPRESS 4 Compressor Item Type 1 Refrig IBT File generated by TOTPOF wtility ut o AEDH PAT ITEM OY Production Tracking Item Type fH PTER_TYPE_1 Unique It for ken Tepe q item type code linique cade for Item Type used by FAT ttes_tyupe_dese ten Tepe Oescriptice ites tracking type Trackiog tupe code i ser 2 noneer amp item class ia tem Cisis dened et ier a COMPRESS 4 Conprescae tem Type ijReFAIc 6 Records SHELA jIj Shelving Item Type iB eG PAEAN REFRIG FRARE 2 Refrigerator Frane 4 REGRIG COMPRESS 4 Compressor Item Type 1 Refrig represent a WH HE S Washer Heter tem Tepe 1 ASHER sample of our ELECTOLYW Elechrical term Type e vERSAL Item Types BIH 1S Rin tem Teper 2 URTUER SAL Expanded view of the first new record in the batch CIMPLICITY HMI Tracking Operation Manual July 2001 i
201. der value region image is assumed invalid Region s invalid count is set to this value This count shows the number of consecutive good reads that is necessary to make the region valid again Control_With_Track This value is used when backing files are created for the first time Use_OOS If the region image does not match the read and the item that should have been at the head of the region is not at the head but it is in the same region Automated Region Validation will move the items that are in front of the identified item to the detainment region of the region The move is done as item moves if this flag is set to 0 Otherwise if it is 1 out of sequence processing feature of PRT will be used to determine how those items will be treated prt_svc_val cig GFK 1216F The following table gives the layout of this text file Service specific configuration is done with this file Command_point and response_point will be used to expand the functionality of PRT without changing the interface to it Command point has the following general format lt REFERENCE gt lt COMMAND gt lt PARAMETER LIST gt Where lt REFERENCE gt is copied back to the response point and can be used by the clients to match the responses to the command that they have sent The following 1s the list of commands supported and their formats lt REFERENCE gt S RESET_ STATS lt REGION_ID gt S ALL lt INDEX gt lt REFERENCE gt SRESET_PREV_RD lt
202. der values These points are then converted to ASCII for internal processing using a region specific C formatting string supplied in the configuration This derived point will be the mechanism to manually enter the correct reader values if necessary After giving the system enough time to get the complete read in to the device point a trigger lets the PRT subsystem be aware of a new item at the head of the region 3 This is usually a limit switch at the head of the region which acts at carrier at head indicator This trigger is copied into a derived point similar to the reader point 4 This will provide a mechanism to re trigger the PRT validation process again The components and their relations to each other in the proposed solution to Control with tracking are 4 42 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F pei Carrier at stop Device Carrier at stop EQ w override 4 An A 4 1 r Control w Track Reader Device E f Repeat Prevention Reader EQ w override r a N Region Status 4 4 4 7 P Ka Pr Statistics such as e Current Invalid Count i Total Reader Mismatch Consecutive Reader Mismatch Total No Read Consecutive No Read Statistics Array Point Changes in the derived trigger point will be triggering PRT 5 When that happens PRT retrieves the latest value of the reader 5 and the configuration for the region on how to pro
203. dify_region Modify Tracking Region Data cccsneeeeeeeeees 5 70 prt_api_move_item Move Item To Location In Tracking Region 06 5 71 prt_api_move_item_to_detain Move Item To Detainment Region 5 74 prt_api_check_route Validate Tracking Route cccccsseeeecceeeeeeeeeeeeeeeeeeeeees 5 76 prt_api_advance_model Advance Tracking Model ccccccceeeeeeeeeeeesseeeees 5 77 prt_api_region_setpoints Enable Disable Tracking Region Setpoints 5 78 prt_api_reorder_region Reorder locations within Tracking Region 5 79 prt_api_next_svc Return each successive configured PRT Service 006 5 81 GFK 1216F Contents Contents ix prt_api_get_item_types Return a list of all configured item types 0 5 82 prt_api_get_item_tracking_type Return the tracking type for a specific item 5 83 prti_get_RCMconnection Connect to Remote Connection Managet 5 84 prti_term_RCMconnection Disconnect from Remote Connection Manager 5 85 Process INES yc MEOMIZ AMON wcnaies nn saacawendocaseed ee n ea ana Oraon Eoas 5 86 PRT API Macros 6 1 PADOUL PRAY MACO oeae E EEEE EEEE 6 1 Appendix A PRT API Error Codes A 1 Error codes Returned by Production Tracking corsara EE RAON AAE A 1 Appendix B Event Codes for Interested Process Updates B 1 ADON why 81H C OUES arena en SRT AT DT re eA eT re B 1 keni R
204. difying items moving items and modifying Region and Group tracking information Using the API requires you to do the following Understand the subroutine interfaces and system capabilities provided by CIMPLICITY HMI software s Production Tracking System These functions are documented below Understand the configuration requirements for the Production Tracking System The Production Tracking configuration data is described in the previous chapter Code appropriate applications programs Compile and link the programs as explained in this section Contents of the Application Subroutine Interface GFK 1216F This section describes the contents of the Production Tracking Application Program Interface These files can be used to write applications that interface with the Production Tracking system and can also be used to compile and link a demonstration program The following is a list of all files distributed with the Production Tracking Application Interface utilities BSM_ ROOTS is the directory where the CIMPLICITY HMI software is installed Include Files BSM_ ROOT S include PRT_API H Library Files SBSM ROOT EXE PRT API DLL BSM ROOT S LIB PRT_API LIB 5 1 Include Files The following header files contain definitions used by Production Tracking procedures they therefore must be included in an application program that interfaces with Production Tracking include include include include include
205. e for example prt_import lt filename gt The input file is assumed to have prtmas a filename extension If a filename is not specified on the command line the program prompts for it Opening of the Import data file Reading of Import file records Parsing of Import file records to determine applicable PRT Application Interface routine to call Further parsing of Import file record to obtain the arguments to be included to the PRT Application Interface call Call to appropriate PRT Application Interface routine Reporting of any errors returned by the Application Interface Termination of the Application Interface Reporting of command totals for each type of command total records processed etc Import File Naming Conventions GFK 1216F The file naming conventions are Input Files lt filename gt PRTX Output Files lt filename gt PRTM Where lt filename gt for input is used to create output Configuration File Guide 4 53 4 54 Import File Format The Import program reads a series of records from the Import file Each record begins with a 3 character command Valid commands are as follow ADD Add item to be tracked ADV Advance item along specified route ATT Add item attribute CLL Clear location DEL Delete tracked item DSP Print message to terminal HLD Apply group hold to item INS Insert item to be tracked MAT Modify item attribute MOD Modify tracked item MOV Move item from
206. e allowed TRANSITION FLAG Flag indicating what types of transitions are allowed This flag indicates if new items can be added to the destination region and if existing items should be moved to the destination region when updated 1 Only adds are allowed 2 Only moves are allowed 3 Adds and moves are allowed Other Adds and moves NOT allowed ITEM TYPE A value representing the type of item that may be created when the New Item Allowed field is set to 1 If this field is left blank any item type may be created TRANSITION FAILURE POINT The name of the CIMPLICITY Digital point that is used to represent the success or failure of an item moving into or being added to the configured PRT Destination Region The point will be set to 1 if the move is successful and O if the move is unsuccessful IGNORE FIRST VALUE A value that specifies whether or not CTI will ignore the first point update received for an item A value of 1 specifies that the CTI will ignore the first value received for a point A value of O specifies that CTI will respond to the first value received for a point An ANALOG response point must have integer values configured for both the SUCCESS VALUE and FAILURE VALUE fields A TEXT response point will have alphanumeric values configured for the SUCCESS VALUE and FAILURE VALUE fields GFK 1216F Appendix F Configurable Tracking Interface F 9 Examples of records found in the CTI_PT_DEF CFG file are
207. e button on the PRT window to select a region from the list to display or to reduce the number of regions listed by entering criteria to display a select group From the selected group you can then choose the region you would like to view To browse for a region 1 Onthe PRT window click By next to the Region ID field to open the Browse Regions dialog box Browse Regions Fa Region Id i Cancel Browse D Region Name a COMBINE COMBINE Fl DETAIN DEW DISPERSE FAUL_REGI PAllL RFG Browse results 2 Do one of the following to select a region for viewing A Inthe Region Id field type the region name or B Select a region from the list 3 Click OK to view the region in the PRT window Using the Production Tracking Window 3 7 Procedure to Modify Criteria for Browsing Regions J17 To reduce list of regions 1 Click BI next to the Region ID field to open the Browse Regions dialog box in the PRT window 2 Enter criteria to reduce the list of Region Names in the Region Id field Tip Use the wildcard character to increase search result Example R displays all regions ending in R displays all regions beginning with an S T displays all region with a T in the name displays all available regions Click Browse to display the search results 4 Select a region from the group Click OK to view the region in the PRT window CIMPLICITY HMI Tracking Operation Manual July 2001 GFK
208. e following configuration files PRT_SERVICE PRT_REGION PRT_GROUP and PRT_ITEM_TYP Global memory corruption may occur if changes are made to this configuration data and new backing files are not created when PRT is rebooted At startup Production Tracking will delete the cross reference file ITEM_XREFO lt PRT Service Name gt then reconstruct it based upon the contents of the region files that are available This allows the system manager to eliminate the contents of certain regions CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F without affecting the other regions in the service or performing an export edit import function To do this the following steps must be performed Terminate both the PRT data collector and server Delete the appropriate region files Restart the PRT data collector This ensures that the cross reference file will be deleted then reconstructed Restart the PRT server Note The regions are pre allocated to a configuration based size If items are to be added to a region that is full the contents of the head location are moved to the full region s detainment region If the full region is a detainment region or there is no detainment region configured for the full region the contents of the head location are deleted PRT Customization PRT customization includes Synchronization capability Alarm move exceptions Synchronization Capability The auto_move_point field
209. e is identical to the format of the Import program s Input file See the section above for the exact format of this file Note A region may be a member of more than one group Thus the dumping of two different groups could include the same region twice However this does not result in the region being dumped each time it is encountered either as a member of a different group or because the region was explicitly dumped The first time the region is encountered all information on it is dumped the region status and information on all items within the region Subsequent encounters with the same region result in a comment record being written into the output file specifying the region name and indicating that the region had previously been dumped and appears earlier in the output file The same holds true for all similar circumstances 1 e a service is dumped and then a group or region within that service is explicitly dumped or vice versa No groups or regions will be dumped more than once All subsequent appearances of a group or region will be indicated by the insertion of a comment record in the output file Running the Export Program GFK 1216F To run the Export program first open a command prompt window This can be done from the program manager window or a better alternative is from your CIMPLICITY HMI project window This is better because your path to sBSM_ROOTS will be set automatically for you Change directories to where
210. e text value SUCCESS4 for a successful transaction or the text value FAILURE4 for an unsuccessful transaction Items not found in inventory will NOT be added Existing items will be updated and moved to the R1I_ BOX region only if they are at the head of the 6_DROP_BOxX region The first response received when CTI_2_RP is started and when RCV_POINT_4 transitions from unavailable to available will be ignored Attribute Template File PRT_SRV_ATTR CFG The configuration file CTI_ATTRIBUTES CFG defines the attribute templates that CTI will use when updating PRT for each item type The records in the file will contain a PRT Item Type ID followed by the attribute names to be configured for that item type An empty item type field indicates that the record should be used as the default attribute template if no record is defined for an item type Note that all attributes listed in a default template will be created updated for ANY item type not otherwise defined in this file replacing existing attribute values and that this will occur whenever CTI is asked to locate an item regardless of whether the input point is configured to input values When an item is updated by CTI CTI will create an attribute record for each attribute in the template If a specified attribute already exists for the item or is defined by the point update the value will be stored otherwise the attribute value will be set to NULL Any existing attributes that are not
211. e your path to 3BSM_ROOTS will be set automatically for you Change directories to where the import file resides Then enter the following command to run the program PRT_IMPORT lt filename gt PRTM lt prt_system gt lt prt_node gt Where lt filename gt PRTM is the import file lt prt_system gt is the prefix of the PRT data server you wish to import to Specify ALL if all data servers should be connected lt prt_node gt is the node where the PRT servers are running Specify LOCAL if they are on the same node If you don t specify any of the parameters on the command line you will be prompted Example Import File x x Region R1 _BOX REG FFFF R1_BOX 0 PRT_EXPORT ENS TE Ri BOX REARBOX S3 F TEI PRE BXPORT ENS Ro BOXx 2I REARBOX i Sock ER PRE EXPORT ENS e Ri BOX Si REARBOX 33 EEI TENERE EXPORT INS F RL BOX 4 REARBOX I3 LE eo PRE BxXPORT INSIEIRIL BOXI S IREARBOX ITIS 8 LEI PR EXPORT g Regioni R2 CAB REG FFFF R2_CAB 0O PRT_EXPORT ALT SUE X ATT COLOR ORANGE ATT A C YES ATT ENG TYPE V6 ATT BRAKES POWER ENS IF IRZ CAB CS 9490 FCT 5650 CAE 3 5 Fy Le EPRTAEXPORTE AA eS Ese Ee ATT COLOR WHITE ATT A C YES ATT ENG TYPE V6 ATT BRAKES MANUAL ENS U RZ CAB 2 Cas 22790 CTSS MH CABIR SIELE T LPRI EXPORT ALT STYLEISX ATT COLOR RED CIMPLICITY HMI Tracking Operation Manual July 2001
212. eTo method E 36 PrtItem ParentId property read write E 37 PrtItem ProdStart method E 38 PrtItem ProdStop method E 39 PrtItem ProjectId property read write E 40 PrtItem Refld property read write E 40 PrtItem RegionId property read write E 41 PrtItem Regionloc property read write E 42 PrtItem RemoveAttr method E 43 PrtItem Serviceld property read write E 43 PrtItem SetAttr method E 44 PrtItem SetStatusBit method E 44 PrtItem Status property read write E 45 PrtItem StatusBit function E 45 PrtItem Userld property read write E 46 PrtRegion AdvanceModel method E 47 PrtRegion Capacity property read E 47 PrtRegion ClearStatusBit method E 48 PrtRegion DeleteItem method E 49 PrtRegion GetData method E 50 PrtRegion GetitemList method E 51 PrtRegion Id property read write E 52 PrtRegion Item function E 52 PrtRegion ItemCount property read E 53 E 57 PrtRegion ItemType function E 54 PrtRegion ItemTypeCount property read E 54 PrtRegion Loc property read write E 56 PrtRegion Locateitem method E 55 PrtRegion Modify method E 57 PrtRegion ProjectId property read write E 58 PrtRegion Reorder method E 59 PrtRegion SetPoints method E 60 PrtRegion SetStatusBit method E 61 PrtRegion Status property read write E 62 PrtRegion StatusBit method E 63 GFK 1216F PrtRegion StatusPointId property read E 64 PrtRegion Totalltems property read E 64 PrtRegion TotalltemsPointId property read write
213. e_id Item type identifier required Output Arguments retstat Pointer to COR_STATUS structure Return Value Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTI_REG_ID_NULL Region identifier NULL Warning PRTI_REG_ID_NDEF Region identifier not valid Warning PRTI_ITEM_TYPE_NULL Item type identifier NULL Warning PRTI_ITEM_TYPE_NDEF Item type identifier not valid Warning PRTI_NO_SRC_OR_DEST Route has no source and no destination region Warning PRTI_INVALID_ROUTE Invalid route for item type Warning PRTI_NO_SUCH_ROUTE No route exists between src dest regions Warning 5 76 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_advance_model Advance Tracking Model GFK 1216F Name prt_api_advance_model Description This routine provides a mechanism for advancing the next Item Carrier to leave a Source Tracking Region to a Destination Tracking Region Note This call moves all items at the FIRST EXIT location in the source region to the LAST ENTRY location in the destination region Syntax int prt_api_advance_model src_reg_id dest_reg_id comment USEr2 Or svc id r etstat Char sre reg 1d PRT REGION IDEN 1 char dest_reg_id PRT_REGION_ID_LEN 1 char Comment SC DESCRLP TION LEN 112 char user or svo 1 0 SERVICE LD LEN 4 1L COR_STATUS retstat Data Structure
214. eckRoute method E 13 PrtGroup object description Basic control engine E 3 PrtGroup ClearExtHold method E 14 PrtGroup ExtHold property read E 15 PrtGroup ExtHoldReason property read E 15 PrtGroup GetItemList method E 16 PrtGroup GetRegionList method E 16 PrtGroup Id property read write E 17 PrtGroup Item function E 17 PrtGroup ItemCount property read E 18 PrtGroup LocateItem method E 19 PrtGroup Modify method E 19 PrtGroup ProjectId property read write E 20 PrtGroup Region function E 20 PrtGroup RegionCount property read E 21 PrtGroup SetExtHold method E 21 prti_get_RCMconnection 5 84 Index vi CIMPLICITY HMI Tracking Operation Manual July 2001 PrtItem object description Basic control engine E 3 PrtItem Add method E 22 PrtItem Attr function E 23 PrtItem AttrCount property read E 24 PrtItem ClearModifyTime method E 24 PrtItem ClearStatusBit property read write E 25 PrtItem Comment proeprty read write E 26 PrtItem Delete property read write E 27 PrtItem EntryTime property read E 27 PrtItem ExtHold property read write E 28 PrtItem ExtHoldGrouplId property read write E 29 PrtItem Insert method E 31 PrtItem IntHold property read write E 32 PrtItem IntHoldReason property read write E 33 PrtItem ItemId property read write E 30 PrtItem ItemTypeld property read write E 7 E 18 E 29 E 34 E 53 E 69 PrtItem Modify method E 34 PrtItem ModifyTime property read E 35 PrtItem Mov
215. ed COR_FAILURE is returned if we cannot disconnect from the remote system Production Tracking Application Interface 5 85 5 86 Process Resynchronization The use of the cor_dialect_check function provides a convenient means for the user application to synchronize resynchronize with the appropriate PRT processes When an INIT_SEG is received by the application and invoking the cor_dialect_check function returns the PRT subsystem string the user has the following options Ifthe application is an Interested Process the prt_api_register_intproc function should be called Ifthe application is an API client the prt_api_init function should be called Ifthe application is both Interested Process and API client both functions should be called These routines provide the user with a consistent means for synchronizing with PRT processes when the application program is initializing and resynchronizing with PRT processes after they have been stopped and restarted In order to use the cor_dialect check function the cor_dialect h header file must be included in your source code file You must manage your primary port and call cor_dialect_check with the buffer returned from the ipc_read on the primary port The application must also include BSM_ROOT api 1lib corutil 1ib in the link command file The calling sequence is as follows Syntax void cor_dialect_check input_buffer port_index result_str IPCDG anput butter
216. eded Use this formula to calculate the number of elements end_loc start_loc 1 GFK 1216F Configuration File Guide 4 27 Entry No Field Name Description Data Type Example 4 start_loc First location in the region covered by this Integer 1 Point If this value is 2 then the Point displays data from the last lt n gt items in the region where lt n gt is the number of elements in the Point 5 end_loc Last location in the region covered by this Integer 25 Point Due to a restriction on Point size one Point may not be able to cover an entire region in which case the region must be broken into subsets Each subset as defined by a starting and ending location is covered by a single Point 6 att_start_loc First location in the attribute to parse when Integer 0 setting value of display _ptid The default value is Q See Note 7 att_end_loc Last location in the attribute to parse when Integer 0 setting value of display _ptid The default value is Q See Note 8 item_class_id Name of the item class that can provide 16 DRYER values for this Point If a class is not characters specified any item type will provide data If more than one item matches the item filtering the value of the Point is indeterminate Note The value of att_end_loc att_start_loc 1 can be no greater than the data length of display_ptid When using the default value 0 in either the att_end_loc or the att_start_loc field the entire at
217. eeeeeeeeeeaeeeeees AWO LOCKING RE GIONS ranore a TOE aet P intine Reports screena e E ei Contents vii Contents viit Configuration File Guide 4 1 A outthe C ONMMSUE AN OM Plessens A EE 4 Identity thie C Oni GULAC oM F eS 5 6 ant ccesscexcanatenccdnatenenauabbnaceneut Ea 4 2 Use the MDT POP UOTI stot sti aac a ARS 4 4 About Configuration File SEU sch srscusstiadawaradinss at aennatensasca tag avennd nealeenacanaussntzeadenoadahannasbonansosanies 4 5 Conti guration File Definitions vscnccssdunvesteunoosangaadscasndensveuvaddesaeenunecndacdvondeusevaaduuadvemesnandeadenbaies 4 7 PR SYS DET carene taeaheatdeatauch ycianan aie een taadahs Saad on and cemenasbaneeaelaaaSunesoaraics tenmanestees 4 8 PRI SERVICE i senas dau ateysaalrosonsten naa tet aa deals cuenta teaalveas areas 4 9 Pe SIN OG Sroa E sate gy taneetnan ncgunnes anes eau 4 11 ERT GROC 26 cect E E E E el coenetivenmmnstatace 4 12 PRI REGION cie caccanstacsasauizaaehcntcndeadaaeaintansasartuniaanagsexanatont acess rasangninesonstancesen 4 13 PRT GRF REG aie sc cadtosas aiieods haadeonoc aatatees E a 4 17 PREH ey A cpa vchseantes cenaratin alasertes hecee arta tsad A Adan ated 4 18 PRT ROUTE cieee soe ceaneltca sata aad on nates E un seneencaatnek diet 4 19 PRA GEE TRN corae e r onuateqowonudenets 4 21 PRT INV TYPE keinen a r e a anv Se eeluonweeanceees 4 22 PRE ASSOC kecer r T miesnoessanagees 4 23 PRESTATU e E EE E OS 4 24 PR SOUS PE PI oi E 4 26 PROT SAPD PI one e a N 4 27 P
218. ees H 5 Transition Type 4 Reference Identifier isi sccaveisrccatanconctaeeaseadoonadeienecaderdieeliabeoseuleawed H 6 Transition Type 5 Associate Reference ID to Item nnnssoossssoooessoeeeereessssssssses H 7 Transition Type 6 Associate Item Type to Item cecccccccceeeeeeeessesseeeenees H 8 Transition Type 7 Positive Edge Trigger cccsssseesesseeeeeeeeceeeeeeeeeeeaaeeeeeeeeeeees H 8 Transition Type 8 Negative Edge Trigger sseseeeeeeeeeececcsseeeeeessseeseees H 9 Appendix Attribute Counts by Region l 1 About Attribute Counts by Region ccccccccccccccccccccceeesssseseseeececcccesesseaaaaeausseeeeeeeeeseeeqaaas I COMM CUPALION PIES icno an a tienen edataneiacdwehele a Menanasseaeeteh yaosuaSaneeind ae I 3 SOUS I Wi sievasiadutigenns cepansteadu inst e de necte seed ydaedics r N ai once nesiaa amend tuaraeeeee eet I 5 POE OG oria taben anes occas tee etaah aceasta aban anah silat E I 5 TN SSS INOS chase ae cle Sse ge tanatte cerca oan a duc ae Saeco Byaaisere enc N I 5 PASS EOC sci cectacesbatdeacasensnanscauiace oes bencsactleanaieieennantisack span betcaduanctbasnatelunncaseusacsanat etednents 1 6 Prt Wat R OC cig 2 ries ssatcics a whos cata cee sauce au eenenta E 1 6 SEN teense naed O T E A seen te ataen guar deennet ass I 6 MaS le FNS Pa ete greenery vets E dated distanced ede oarsans nae nm ae omuaevaaaers aatcants 1 6 Appendix J Troubleshooting J 1 TROUDIESHOOMMS OV Cr V1
219. eference_id Secondary identifier of a serialized item optional if item_id specified Production Tracking Application Interface 5 59 5 60 Both Serialized and Non Serialized Items timestamp region_id region_loc item_type_id comment user or svc_id Output Arguments retstat Return Value The time the item was last moved or modified The timestamp is used to ensure that when attempting to transition the specified item out of the production tracking system the item referred to has not moved or been modified between the time when information was last obtained for that item and the attempt to stop it One of the fields in the structure which returns data on an item is the last_mod_time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the timestamp associated with the item at the time of the attempted production stop then the modification is not performed and a warning returned If the timestamp argument passed to this function is zero the operation is performed without any timestamp checking Identifier of the Tracking Region where the Item is to be deleted from the queue required Region location where the non serialized item resides required for non serialized items optional for serialized items Item type identifier required for non serialized items Comment to be recorded in PRT history log file opti
220. egion Loc 4 Loc Tail Item New Item A After Item transitioned moved added inserted s into Shifting CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Deleting or Moving an Item from a Shifting Region If an item is deleted or moved out from a shifting region all items from that location to end location are shifted by one location towards the head location and a blank item is added at the end location A Delete by the user is not allowed for a blank item Shifting Region Transition Region Loc 3 Loc Tail empty empty Item deleted moved out from the region Shifting Region Transition Region Loc 2 Loc Tail empty empty After item deleted moved out from region GFK 1216F Appendix C PRT Rules and Assumptions Shifting Region Destination Region Loc Tail empty Item transitions out of the Shifting Region Shifting Region Destination Region Loc Tail Item A After Item transitions out of the Shifting Region Modifying an Item from a Shifting Region Blank items can not be modified by the user However data can be corrected by editing an export file and importing the corrected data The export file contains one record for each blank location in the shifting region designated with a reserved item_type_id of S SGEF BLK ITMSS No two records having this item_type_id can have the same location number even if the location can contain multiple items Routing
221. egion Item 0 Setattr SRCS amp DSUFS DATES Region leemt0 lt Setatter SRCs G TSUFS TIMES Region Item 0 Modify CO Region Item Moveto DESTREGIONS RegionLOC 0 Prtltem SetStatusBit Method Syntax PrtItem SetStatusBit Bit Description Sets a specific bit 0 through 31 of the Status Mask for an Item Example Dim CurPrt as new prtregion CurPrt Id EXITREGION CurPrt GetItemList Get a list of items in a region check each one s status bit A then set it if it s not already set If CurPrt Item 0 StatusBit J FALSE Then CurPrt Item I SetStatusBit J CurPrt Item I Modify End If E 44 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prtltem Status Property Read Write Syntax PrtItem Status Description Long property to get or set the Status Mask of the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupiId Groupnames NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM IntHold false NEWITEM ExtHold false NEWITEM ItemTypelId TYPES NEWITEM Status 0 Upload to Tracking Database NEWITEM Add Prtltem StatusBit Function Syntax PrtItem StatusBit bit Description Retrieves the setting of a specific status bit Comments Parameter Description bit Integer 0 31 bit position to return Example Dim CurPrt as new prtregion Cur Prt 1d EXT TREGION CurPrt GetItemList Get a
222. eiscansadisieihveberrsscaotaciavebsce as Gas aky ve beavashavtabiavensavesteeaeen E 31 PrtItem IntHold Property Read Write ccccccccccssssssseseeseeecceeeeeeeeeeeeaeaesseseeseeeeeeeeeeeeeeaeaas E 32 PrtItem IntHoldReason Property Read Write cccccccceccceeeeececeeeeaseeeeesseseeeeeeeeeeeeeeeaaas E 33 PrtItem ItemTypeld Property Read Write ccccccssssssssseeeeeceeeceeeeeeaeeaeeeesseeeeeeeeeeeeeeeeaaas E 34 Prien Modit Meth OG asarei a A tas aicanul a E 34 PrtItem ModifyTime Property Read breserien i a EEE SE a E 35 Pitlitem Move TO Method j irrorata as oe a a aO ra aS E 36 Prtitem Parentid Property Read Write eriari a a E 37 PrtitemProdStart Method eccora A eh ae ees E 38 Prem Prod Slop Memhod nisaar e EE E AERE EEE E 39 Pitlt m ProjectId Property Read Write isoiset ea eoi naaa aE E 40 Priltem Refld Property Read Write Jeremiae a a E 40 PrtItem RegionId Property Read Write sessscsssavancseesasecisssseeettaenordassctoti ei teeuaiendeweroresneanonsss E 41 PrtItem RegionLoc Property Read Write cccccccccsssssessseeeeeeeceeeeeeeeeaaseeseeseeeeeeeeeseeeeeeeaaas E 42 PrtItem RemoveAttr Method 5 sasesd cess catesocascbucedaseien des berncasa ate ssw eucbucebacalnadvelevacasagalesavemtucesart E 43 PrtItem Serviceld Property Read Write cccccccsssssssessseeececeeeeeeeeeecaaaseeeeseeeeeeceeeeeeeeeeaaas E 43 Prtltem SetAttr Method cirereta a a vaskautubravensabesteeeabenee E 44 Priim SetS
223. elated Event OCS ronnie a ies ie ecen sa E aieatanen B 1 Region related Interested Process Updates cccccesssseecceeeeeeeeeeeaeaseeessseeeeeeeeeees B 4 Appendix C PRT Rules and Assumptions C 1 General RUNES occa scirit ac acutctin sence cuca eile sstanteladlaevagsacadcadusitvaan E C 1 Combine Items Tracking Region Rules cccccccccccscsssssssseseeeeseeeeceeeeeeeeeeesaaaaassseeseeeseeeeees C 3 Disperse lems Trackine Rec 1On RUGS srining ena a o ea ira EE E I AES C 4 Shtune Region Tracking incremen e cesses iestedisokad dete S C 6 Shifting Region Tracking Configuration sseeeeessssssssssssseeterreresrressssssssssssseeeerees C 6 SHINS RESON Operations seserinis aa E Ea E eE a e C 6 Adding an item into a Shifting Region eeesesssssssssseeeeerrsserssssssssssssssseerrereeesessesssss C 6 Inserting an Item into a Shifting Region seeseeeeeeeenesssesssssssssssssseeerereeesssssssssssss C 7 Moving an Item into a Shifting Region 0 0 ceeccsessseeeeeeeeeececeeeeeeeeeeeeeeeaaaaeeeeeees C 8 Deleting or Moving an Item from a Shifting Region eeeeseeeeeeeeeeenneteeees C 9 Modifying an Item from a Shifting Region cccccccceeccceeeeeeeeeeeeeaeeeeseseeeeeeeees C 10 PSG GUN Orcs ads oscsarie ess paces E ees set EE EE E E E E abeeas aaa C 10 Shitting Resion Process Be aviOr s imersar a E E a C 11 PR Toeren a E C 11 GEB NV ERF Y orean n Aar A a tosanataaoee C 11 PRT Ulee a a E EN C 11
224. enerated Item Update m reg_entry_time m event_code 7 modify_bitmask m region l id m region LOC m region_2_id m region_2_loc z item_tracking_type a item_id 7 reference _id z item_type_id Region Update event_code region_id region_status comment user_or_svc_id location action parent_item_id item status int _hold_active item hold _reason ext hold_active group_id num_atts valid item_att list comment user or svc_id action Error Response status err_code err_ref err_msg CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configuring the PRT Interested Process Utility The six files needed to configure the PRT Interested Process Utility prt_inttest exe can be found in the Master directory of CIMPLICITY The files are in binary format and must be converted to ASCII text using the IDTPOP Utility Also files that have overlapping fields for example process_id must have identical values in order to run the utility Sample configuration files are provided for your reference in this section See Configuration Requirements chapter for instructions on using the IDTPOP Utility The required configuration files are physproc dat logproc dat node_logproc dat service dat prt_intproc dat The following steps provide instruction on configuring prt_inttest exe Step 1 Open Tracker project in Workbench Step 2 Configure physproc Step 3 Configure log
225. entifier of a serialized item secondary identifier of a serialized item Item type identifier associated serialized item identifier Item status If TRUE item held due to external hold Identifier of the Tracking Group providing the reason for the hold If TRUE item held due internal hold Comment specifying reason for internal hold Comment to be recorded in prt history log file User or service identifier If no Item Attribute information is to be specified for this Item the INS record need not be preceded by any ATT records for filling in elements within the Item Attribute array To specify Item Attribute information see the description of the ATT record type CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F MAT Modify an Item s Attributes The application interface call for this record type provides a mechanism for modifying Serialized Item Attribute data The fields in this record are char record_type 3 MAT char regen Tap Unique identifier of the tracking region where the item resides char rem 10 Unique identifier of a Serialized Item char reterence 1d 21 Secondary identifier of a Serialized Item char comment 41 Comment to be recorded in prt history log file char user_or_svc_id 33 User or service identifier The purpose of this call is to modify an item s attributes the MAT record must be preceded by one or more ATT records for filling in elements within the Item Attri
226. er ID to place into PRT log file Example Dim Region as new PrtRegion Region Id Schedule Determine if there are any items in the region and advance the first one if there are Region GetItemList If Region ItemCount gt 0 then Region AdvanceModel Production End If PrtRegion Capacity Property Read Syntax PrtRegion Capacity Description Integer property to return the region capacity Example Dim Prt as new Prt Prt GetRegionList FOr 2 0 ce Prt Req ronCount I msgbox Prt Region i Capacity Next i GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 47 PrtRegion ClearStatusBit Method Syntax PrtRegion ClearStatusBit b Description Clears a particular status bit in the regions status mask Comments To obtain the region s status mask use the PrtRegion GetData method To update the Region s status mask to PRT use the PrtRegion Modify Bits 0 15 are for User Use Bits 16 31 are for GE Fanuc use The following constants may be used to access GE Fanuc specific bits Constants Description PRT_REGION_FULL Region Full Bit PRI REGION EXT HOLD Region External Hold Bit PRT REGION_IN LOCK Region in Lock Bit PRI REGION OUT LOCK Region Out Lock Bit PRT REGION OUT OF SEQ Region Out of Sequence Bit PRT REGION CAP EXCEEDED Region Capacity Exceeded Bit PRT REGION NORMAL Region Normal Bit Example Dim Prt as new Prt ns 17 Get a list of items from PRT and i
227. er of items and locations associated with the region Note The columns you see in this window are configurable and are explained in the Configuration Requirements chapter PRT Toolbar The buttons on the PRT toolbar provide one click access to the most commonly used functions They are described as follows oad J Q a b c d e f g h i Adds a new item location to the selected item Inserts a new item in front of the selected item Modifies the selected item s properties Deletes selected item from inventory Moves selected item from current region to another region Finds region where item is located Searches PRT database for an item Refreshes PRT DV regions Auto locks the status bits in the region when configured as such Using the Production Tracking Window 3 3 Procedure to Set Information Parameters When you initially access the Production Tracking window PRT User Interface all of the regions in the current project are displayed by default You have the option of setting parameters to customize the information you want to display when you open the PRT window Start by placing a shortcut for the PRT_UI on your Windows desktop 3 4 di Do the following Create a shortcut Set parameters Procedure to Create a Shortcut for PRT User Interface To create a shortcut for the PRT User Interface 1 Open Windows Explorer 2 Expand the Windows folder e g
228. eral Infomation Attributes Mem Status Activates status Status is active CES delayed of selected item iter hk Clears status of mena hold selected item Status is inactive nomns 2 Select a status item in the list 3 Do one of the following to set the status of the item Click To change the status to Set Active Yes activates item status Clear Active No deactivates item status 4 Click OK to effect Item Status change s or click Cancel to cancel the operation Note The status list is configurable See Configuring your Tracking Model in the Tracker Getting Started Guide GF K 1694 for complete details GFK 1216F Using the Production Tracking Window 3 2 Deleting an Item 41 To delete an item from a region 1 Select the item in the list to be deleted 2 Click the Delete button aj The Delete Item dialog box opens Do one or the other Delete Item ig Are you sure you want to delete these tems item ID DOOR_LIMO To scrap the item check f 7 option and Serap ltem sl click OK OF Cancel To delete the item do not check Scrap option click OK 3 Do one of the following Option I Delete the item A Clear the Scrap Item s checkbox B Click OK The item is deleted Option 2 Scrap the item A Check the Scrap Item s box B Click OK The item is scrapped Option 3 Cancel the operation Click Cancel 3 22 CIMPLI
229. erted into the queue at a particular location other than at the head or tail of the queue the Region location of the Item to be inserted ahead of is specified i e specifying regionLoc 1 is equivalent to specifying regionLoc PRT_FIRST Comments Parameter ext_proc_flag Example dim NEWITEM as new prtitem Tnitialize the new item structure NEWITEM NEWITEM NEWITEM NEWITEM Upload NEWITEM ItemId IDNUMS Groupld Groupnames RegionId Regnames RegionLoc 3 NEWITEM NEWITEM NEWITEM NEWITEM IntHold false ExtHold false LEemlypeld TYPES Status 0 to Tracking Database Insert Description Boolean External process flag if set to TRUE get all information from an external process If not provided defaults to FALSE Appendix E Basic Control Engine Extensions for Production Tracking E 31 Prtitem IntHold Property Read Write E 32 Syntax PrtItem IntHold Description Boolean property to set or get the state of Internal Hold on the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupiId Groupnames NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM IntHold false NEWITEM ExtHold false NEWITEM ItemTypelId TYPES NEWITEM Status 0 Upload to Tracking Database NEWITEM Add CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prtitem IntHoldReason Property Read Write
230. es B 4 Export tracking data Interface to external software 2 11 F Fetch an Item Production Tracking window 3 23 File Format Configuration files 4 7 File naming conventions PRT_IMPORT 4 53 Find an Item Production Tracking window 3 28 Index ti CIMPLICITY HMI Tracking Operation Manual July 2001 Functions PRT Prt Group E 6 Prt Item E 7 Prt Region E 9 Prt Service E 10 PrtGroup Item E 17 PrtItem Attr E 23 PrtItem StatusBit E 45 PrtRegion Item E 52 PrtRegion ItemT ype E 54 PrtService Group E 67 PrtService Item E 68 PrtService Region E 70 Funtions PRT PrtGroup Region E 20 G General information Add item to region Location 3 17 General rules Production tracking C 1 Get interested process item region tracking data updates 5 51 Get request from external process 5 6 Global section usage Production tracking 4 70 Global verifier About for production tracking D 1 Validations and repairs D 2 GRP PRT_EXPORT 4 68 H How to Open the PRT Window Production Tracking Window 3 2 How to Set Parameters Production Tracking window 3 4 IDTPOP Utility 4 4 Import file format PRT_IMPORT 4 54 Import tracking data Interface to external software 2 11 Include files Production tracking application interface 5 2 Initialize the PRT_API interface 5 3 Initiate production start for an item 5 56 Input file format PRT_EXPORT 4 67 Insert an Item Production Tracking window 3 13 GFK 1216F Insert item into tracking region queue
231. escription of the region Text to display with the region for user recognition Primary tracking region type Pool Sequential or Shifting Maximum number of available physical region locations Maximum number of items that can reside at a single region location Be sure to include all serialized and non serialized items Number of items allowed to exit out of sequence from a tracking region Indicates the action to be taken when an item does not arrive at the region exit transition indicator as expected Use one of the following DETAIN Move to detainment region SCRAP Scrap delete item DLY_DTN Allow item to be out of sequence using the oos_cycle_ count condition then move to detainment region DLY_SCRP Allow item to be out of sequence using the oos_cycle_count condition then scrap delete GE Fanuc Reserved GE Fanuc Reserved GE Fanuc Reserved GE Fanuc Reserved Unique name of the detainment region where items are sent when out of sequence Configuration File Guide Data Type 32 characters 16 characters 40 characters 16 characters 16 characters Integer Integer Integer 8 characters 8 characters 8 characters 8 characters 8 characters 16 characters Entry Example APRT_ DC ASMBLY LNE1_NOR Assembly Line 1 Normal Region AssmblyLnel Nor SEQUENTIAL 15 DLY_DTN Blank Blank Blank Blank DETAINMNT A 4 13 14 15 16 17
232. ess ccccccccceeeeeeeeeeeesseeeeees 5 6 prt_api_load_item Load Serialized Item Tracking Data eeseeeeeeeeeeees 5 8 prt_api_load_item_hold Load Serialized Item Hold Data eeeeeeees 5 10 prt_api_send_resp Send Response To Production Tracking ccccceeeseeeeeeees 5 12 prt_api_modify_item Modify Item Tracking Data cccccccccccssesseeeeeeeeeeees 5 13 prt_api_modify_item_att Modify Item Tracking Data Attributes 0 5 16 prt_api_modify_item_all Modify Item Tracking Data AI eeeeeeeeees 5 18 prt_api_group_hold Activate Deactivate Hold Specification for a TEAC K INS Grou Dinn ss svaeucd varoate Ned a aes sostuates av eaeadianectonnonsant 5 22 prt_api_delete_item Delete Scrap Item From Tracking Region Queue 5 23 prt_api_delete_items_at_loc Delete Scrap Items From Tracking Region Queue LOCAU ON isn Cos oie acess E T A 5 26 prt_api_locate_item Locate Serialized Item cccccccsseeeeeeececeeeeeeeeeeeeeeeeeees 5 28 prt_api_req_groupitemlist Request List Of Serialized Item IDs in a Trackin GOUD siede a E A E E 5 31 prt_api_unload_groupitemlist Unload List Of Serialized Item IDs in a Tracking GOUD seee E e a r E 5 32 prt_api_req_class_itemlist Request List Of Item Tracking Data 00 5 33 prt_api_req_itemlist Request List Of Item Tracking Data eeeeeeeeeeees 5 35 prt_api_unload_itemlist Unload List Of Items cc ececccce
233. ess_id The name of the process that the PRT_INT program will look to for data 1 process_type_id Process type ID usually RESIDENT RESIDENT process 2 pm_flags Use default value 1 1 3 description Description of the process PRT Interested Test 4 Save the file Use the SCPOP Utility to convert the file back to binary format GFK 1216F Appendix J Troubleshooting J 5 Step 4 Configure Node_logproc J1 To configure node_logproc 1 Use the IDTPOP Utility to convert the file to ASCII text using the text editor of your choice e g Notepad 2 Press Ctrl End to bring you to the next available line to enter your record see figure 0 recat bia oa H Aleppo Mis ES Fle Ext Seach Help RECORD REDE LiGPROC PROCESSES OF SPECIFIC MDE a m HOPE ID Decnet Hode Hamr 1 PA CESS 1D Precess Identifier 2 image name Executable Image mame 3 priority Process Priority h base guan Hace quantity Bax qan Hax Quaetity E 6 astinm AST Limit ff bilm Bi Limit H bytim BYTE Limit Y cpulm CPU Limit a 8 diols HO Limit 41 englnm EMG Limit 42 Film Fil Limit 13 pgFlqeota Page File quota 1h prem PRELM Field name is a type a 15 tgyela TOELM a 16 widefault Working set thefault 417 woextent Working set extet 78 wiquota Working set quota a 49 sus priv mask bysten wide process privilege mack E MASTER AMRP YESH ROOT exe amr p cwe 201 1 80 50 50800 ajsa 2080 00sen Fajr P99 9095 4 MASTER OL_
234. et the Item Class ID in the PrtService object Used in conjunction with the PrtService GetItemList method to retrieve a list of all items of a particular item class in a Tracking Service Example Dim ServiceA as new PrtService ServiceA Id SERVICE A ServiceA ItemClassId CARRIER Get a list of items with an item class id CARRIER from the service SERVICE_A and display them one by one ina message box ServiceA GetItemList for j 0 to ServiceA ItemCount 1 MsgBox ServiceA Item j Id next Jj PrtService ltemCount Property Read Syntax PrtService ItemCount Description Integer property to get the number of items find by a previous Get ItemList or Locateltenm call Example Dim ServiceA as new PrtService ServiceA Id SERVICEHA DC Get a list of items in the service and display them one by l one in a message box ServiceA GetItemList for j 0 to ServiceA ItemCount 1 MsgBox ServiceA Item j Id next J GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 69 PrtService Locateltem Method Syntax PrtService LocateItem itemld refld numRetries Description Locates a serialized item within the tracking service Upon return the total item count may be obtained from ItemCount and the individual items may be accessed via the Ttem function Comments Parameter Description itemld String The Item ID to locate may be an empty string if refld is specif
235. etServiceList method E 5 Prt Group function E 6 Prt GroupCount property read E 6 Prt Item function E 7 Prt ItemCount property read E 8 Prt LocateItem method E 8 Prt ProjectId property read write E 9 Prt Region function E 9 Prt RegionCount property read E 10 Prt Service function E 10 Prt ServiceCount property read E 11 prt_api_add_item 5 62 prt_api_advance_model 5 77 prt_api_check_route 5 76 prt_api_delete_item 5 23 prt_api_delete_items_at_loc 5 26 prt_api_dyn_register_intproc 5 47 prt_api_get_intproc_updates 5 51 prt_api_get_item_tracking_type 5 83 prt_api_get_item_types 5 82 prt_api_get_req 5 6 prt_api_group_hold 5 22 prt_api_init 5 3 prt_api_inset_item 5 66 prt_api_intproc_region 5 49 prt_api_intproc_retry_connect 5 50 prt_api_load_item 5 8 GFK I216F Index prt_api_load_item_hold 5 10 prt_api_locate_item 5 28 prt_api_modify_item 5 13 prt_api_modify_item_all 5 18 prt_api_modify_item_att 5 16 prt_api_modify_region 5 70 prt_api_move_item 5 71 prt_api_move_item_to_detain 5 74 prt_api_next_svc 5 81 prt_api_prod_start 5 56 prt_api_prod_stop 5 59 prt_api_region_setpoints 5 78 prt_api_register_intproc 5 46 prt_api_reorder_region 5 79 prt_api_req_class_itemlist 5 33 prt_api_req_groupitemlist 5 31 prt_api_req_grouplist 5 43 prt_api_req_itemlist 5 35 prt_api_req_regionlist 5 39 prt_api_send_resp 5 12 prt_api_static_region_data 5 55 prt_api_term 5 5 prt_api_term_intproc 5 54 prt_api_unload_groupitemlist 5 32 p
236. exist at a location Then All items are moved Actions triggered by the specified handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user Akk l Guidelines for Negative Edge Trigger include 1 The transition point may be an integer or character string point 2 The item transitions when the point goes from high integer non zero character string non null string to low integer 0 character string null string 3 The first 36 characters of a setpoint if configured are First 16 characters Item type Next 20 characters Either the tem ID for a serialized item Associated or parent item ID for a non serialized item GFK 1216F Appendix H Configuring PRT Client Startup H 9 Appendix Attribute Counts by Region About Attribute Counts by Region Production Tracking counts PRT items based on Region s Item class Various item attributes criteria An item is included in a count if its attribute matches a configured set of criteria In order for an item to be included in the count the attribute value must be compared against a user defined value The comparison can use any of the following user defined operators Equals Not Equals lt Less Than lt Less Than Or Equal gt Greater Than gt Greater
237. expand the Runtime folder 3 Expand the Production Tracking folder 4 Double click the Production Tracking UI icon Workbench directory MME Classes H A Foints Fl Equipment E Security B J Status Logs Expand Runtime fe Slam Viewer Point Control Panel a a Alarm Sound Manager Expand er 9 reduction Tracking Double click gt a Production Tracking Ll te ACO Runtime Ul J Advanced H E Basic Control Engine ee Database Logger oe 2 Routing Control Objects a GPE Result Using either method the PRT_UI window opens The Region Id field indicates the active region in the window and the item count is displayed on the status bar 3 2 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Ee ny Active region displayed in the window Use drop Browse button to Drop down list of the search for and limit configured views for this regions window Ul bE Famn Aulos Menu bar and toolbar Pe pasion Yew Help ality oe aa ea down list to switch to Aeration eae Tone a another region f FRM ke a h h P A eE ma GFK 1216F No SACI Ho SACI No SACS koncian Dintran Zi l Monday Ocoee 12 Hodiy Horsen Mande Dobi barlan A cree Monday Oribe 2 12 Horda Mowers Monday Ociober 95 12 Horda Horeba _ Honds October 25 12 Horde Mowember _ Monday Ochober 25 12 Monday Mowarbe mee a Fede SD Li sared a Blr ere aa j a a Numb
238. f the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure Error Codes PRIS REGION NOT DEP TNED PRIS GROUP _NOT_ DEFINED PRIS NO REGIONS MAPPED PRIS NO T NEO PRTS_NO_GLOBAL REGION PRTI_SVC_ID_NULL PRTI_SVC_ID_NDEF PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTI_REG_NOT_IN_GRP PRTI_REG_NOT_IN_SVC PRI LL GRP NOT ENS VC PRIT UNEXPECTED SEG TYPE PRII_PARTNER_DEAD PRTI_EXTRA_SEGS Region not configured Warning Group not configured Warning No regions attempted were mapped Warning No information available due to unknown reason Warning No global section available for Region Warning PRT service identifier NULL Warning PRT service identifier not valid Warning Region identifier NULL Warning Region identifier not valid Warning Group identifier NULL Warning Group identifier not valid Warning Region not in group specified Warning Region not managed by service specified Warning Group ID inconsistent with service specified Warning Unexpected segment type from PRT_DS Warning Partner dead Warning Ignored extra segments after STATUS_SEG or END_SEG Warning PRTI_NOT_ALL_SVCS_RESPONDED Not all services responded Warning PRE WRITE PORT ERE PRTI_MF_INIT_ERR PRTI_CRESEG_ERR PRTI_BAD_MSG PRTI_READ_PORT_ERR CIMPLICITY HMI Tracking Operation Manual July 2001 Error in ipc_write_port War
239. fication requests through the received point RESPONSE POINT ID The name of the CIMPLICITY TEXT or ANALOG point that will be used by CTI to send its response PRT FIELD NAME The name of a field in the PRT record that will be sent as part of the response typically this is the item ID This must be one of the fields that is defined in the CTI_LAYOUT CFG file for this point The value returned will be that sent to CTI via the received point not one returned from tracking If this field is left blank the response point will not contain any field value SUCCESS VALUE A value sent as part of the response that will be used to indicate a successful transaction FAILURE VALUE A value sent as part of the response that will be used to indicate an unsuccessful transaction DEST REGION If the item is not found in PRT inventory this region is the region that the item will be added to if adds are allowed for this point If the item already exists in inventory this will be the region that the item will be moved to after it has been modified if moves are allowed F 8 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PRIOR REGION The PRT region that an item will be moved from when it is modified If a region is specified the item must be at the head of this region for an item to be updated and moved to the destination region If no region is specified the item will always be moved to the destination region if moves ar
240. function sends a zero to the Data Collector for this argument regardless of what was actually passed Item Attributes pertain to Serialized Items required Pointer to COR STATUS structure Either COR_SUCCESS COR_FAILURE or COR_WARNING If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR_STATUS structure If no more item information will fit in the datagram buffer the function returns COR_WARNING with the COR_STATUS err_code set to PRTI_DG_BUF_FULL Error Codes PRTI_API_CANT_RCV PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTI_EXT_HOLD_NO_GRP PRTI_INT_HOLD_NO_REASON PRT I_NUM_ATTS_INVALID PRTI_DG_BUF_FULL PRTI_CRESEG_ERR GFK 1216F PRT Application not initialized to receive asynch messages Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Item type identifier NULL Warning Item type identifier not valid Warning Group identifier NULL Warning Group identifier not valid Warning External hold specified without Group ID Warning Internal hold specified without reason Warning Invalid number of item attributes specified Warning Datagram buffer full Warning Error creating segment Failure Production Tracking Application Interface 5 9 prt_api_load_item_hold Load Serialized Item Hold Data
241. ge an error is generated Prototype 2 This function returns the Item Attribute associated with the specified PRT Attribute or an empty string if the Item does not have the Attribute Example Dim prt as new Prt Get a list of items from PRT and display each of their attributes one by one in a message box prt GetItemList FOr a 0 To rus pemeoune a For 4 0 1O pre Peem s ArerCoume 1 MsgBox prt ltvem 1 Attr lt 1d g amp prt Item i Attr j Value Next Jj Next i Get a list of items from PRT again but display their COLOR only For a 0 oO Det PeemCount For J t lt 0 TO pri LeeMm CL ApweCoune ta MsgBox pri Trem 1 lt Avlcr COLOR Next Jj Next i Appendix E Basic Control Engine Extensions for Production Tracking E 23 Prtitem AttrCount Property Read Syntax PrtItem AttrCount Description Integer property contains a count of the number of Attributes for the Item Example Dim prt as new Prt Get a list of items from PRT and display each of their attributes one by one in a message box prt GetItemList For 2 Or Vo pre PeemCounte 1 For J 0 Lo pre Lven lt AcerCount L MsoBOx Prie LlCEmIVeACLE JJe ie a e PEES Lrem 2 s ACCIr Tke Varus Next Jj Next i Get a list of items from PRT again but display their COLOR only POR U EO prt TeemCount a For J 0 IO pre teen ACErCoune 1 MsgBox prt Item i Attr COLOR Next Jj Ne
242. gion Item Class Attrib Name Start Char Length Operator Value Compare type Point Id Name of the region s where the items reside separate multiple regions by commas Item class of the items to be included Name of the attribute whose value is to be compared Starting character within the attribute value Allows comparison of substrings Number of characters to include in the comparison The type of the comparison to be performed between the attribute and the user specified value gt gt lt lt exists contains between Value to be compared against attribute value For alphanumeric comparisons this value can contain the wildcard character For operators separate two 2 values with a comma Type of Comparison N Numeric integer A Alphanumeric and F real Attribute will be converted to this type before comparison Id of CIMPLICITY analog non array point which will hold the count Appendix I Attribute Counts by Region Following is a listing of a sample configuration file Sample configuration file _ PRICNT RESET Multiple Region Counts SRC1 SRC2 DST1 DST2 VEHICLE COLOR 0 10 BLUE A BIG_CNT1 SRC1 SRC2 DST1 DST2 CARRIER CYCLE CNT 0 10 2 F BIG_CNT2 Region SRC2 SRC2 CARRIER CYCLE_CNT 0 10 2 F SRC2_CNT1 SRC2 CARRIER CYCLE_CNT 0 10 2 F SRC2_ CNT2 SRC2 CARRIER CYCLE_CNT 0 10 gt 2 F SRC2 CNT3 SRC2 CARRIER CYCLE
243. gion Item i ItemTypelId MARKVII then Region Item i DeleteItem i PRI_DELETE Obsolete Type End If Next I See Also PrtRegion Loc Appendix E Basic Control Engine Extensions for Production Tracking E 51 PrtRegion Id Property Read Write Syntax PrtRegion Id Description String property to get or set the Region ID of the object Example Dim Region as new PrtRegion Region Id PRODUCTION Region GetItemList Get all items in a region and delete those items with a specific ItemTypeld For 1 0 to Region ItemCount 1 If Region Item i ItemTypeId MARKVII then Region Item i DeleteItem i PRI DELETE Obsolete Type End If Next i PrtRegion ltem Function Syntax PrtRegion Item index Description Returns Prt Item To return a specific item by index from a previous call to GetItemList Example Dim Region as new PrtRegion Region Id PRODUCTION Region GetItemList Get all items in a region and delete those items with a specific ItemTypeld For 1 0 to Region ItemCount 1 If Region Item i ItemTypeId MARKVII then Region Item i DeleteItem i PRI DELETE Obsolete Type End If Next I E 52 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtRegion ItemClassid Property Read Write Syntax PrtRegion ItemClassId Description String property to set or get the Item Class ID in the PrtRegion object Used in conjunction with the PrtRegion GetItemList method to
244. h timestamp The time the item was last moved or modified The timestamp is used to ensure that when attempting to delete an item the item has not changed or moved between the time when the time when information was last obtained for that item and the attempt to delete it One of the fields in the structure which returns data on an item is the last_mod_time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the item s current timestamp then the deletion is not performed and a warning returned If the timestamp argument passed to this function is zero the operation is performed without any timestamp checking GFK 1216F Production Tracking Application Interface 5 23 prt_svc_id PRT service identifier optional group_id Identifier of the Tracking Group optional region_id Identifier of the Tracking Region where the Item is to be deleted from the queue required for non serialized items optional for serialized items Note For serialized items at least one of the above three arguments must be specified region_loc Location in the region where the item resides required For non serialized items a specific region location must be specified For serialized items the constant ALL_LOCATIONS may be used This indicates that the item may reside at any location in the region item_type_id Item type identifier required for non serialized items
245. hat Equation with override derived point is only applicable to numeric points Class_id Class Id to use for matching used if multiple item per location configured and if only one item type is being identified For example PRT can be configured to contain 2 items per location one carrier and one buck and the readers in the system read the id s of carriers In this case the user configures PRT so that carrier item types and buck item types are in different classes and uses carrier class in this field 4 46 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Validation_trigger When received depending on the next field used to trigger the validation process This field is ignored if the next field is Use_Reader Validation_trigger_ Validation trigger types are t ype 1 Transition_high 2 Transition_low 3 Limit_switch 4 Use_Reader_point Statistics_point_id Point id to put the run time statistics It should be a DWORD array of 9 elements but if it is less than 9 only a portion of the statistics will be written Reader_format It is a C print formatting string It should be in quotes For string points use variations of s for analog points use variation of ld If empty s or ld depending on the point type is used Reader values are formatted with this string before trying to match it to the head item s item_id or reference_id Invalid _reset_value When a region has a mismatch with rea
246. he PRT Validation process s capability to determine no read conditions Users can still configure reader value points as PRT validation trigger points If users will be allowed to force validation it is suggested to use an equation with override derived point which will be fed from the real trigger point GFK 1216F Configuration File Guide 4 5 Configuration Validation Program The Configuration Validation Program can be run to produce a report if errors are found in the configuration In order to run the program Open a DOS window and change directory to the data directory for your project and then execute the program by typing the following command at the prompt PRTV lt filename gt Where lt filename gt is the error report file name You will receive one of the following two messages No errors found Errors found report in file lt filename gt Sample reports are found below an asterisk in the error line means that the error is fatal Jan 22 1991 14 41 51 PRT_SERVICE Error Report Production Tracking Service Identification File PRT_SVC_ID Value Error found PRT3_DC xlat no known translation srv gt ext_hold_svc_id node gt obj gt PRT3_DC xlat no known translation srv gt ext_item_svc_id node gt obj gt PRT3_DC xlat no known translation srv gt PRT3_DC node gt obj gt Jan 22 1991 14 41 51 PRT_GROUP Error Report Production Tracking Group File GROUP_ID Value Error found KE EEN N ENEE ENE EE
247. he item into the location clear to add the item to the location GFK 1216F Using the Production Tracking Window 3 25 Example Destination Region has three 3 locations known as L1 L2 and L3 Each location is capable of holding 2 items Originally the region looks like the following Location ltem L1 Item1 L2 Item2 L3 Item3 Moving a new item Item4 into L2 in the region with the Insert box checked would result in the following Location ltem Ll Item1 L2 Item4 Item is inserted into the location in place of item L3 Item3 Alternately moving a new item Item4 into the region with the Insert box cleared would result in the following Location ltem L1 Item1 L2 Item2 L2 Item4 Item is added to the location L3 Item3 7 Click OK to move the item to the destination region or click Cancel to cancel the operation 3 26 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Advancing an Item To advance an item or multiple items from the active region s exit location to the entrance location for a region along a specified route use the Advance function J1 To advance an item s from the active region to another region Method I Quick keys 1 Select the item or items to be advanced 2 Press Ctrl V Method 2 Menu option 1 Select the item or items to be advanced 2 Click File on the menu bar 3 Select Advance The Advance Model dialog box opens Advance an item ase PRA
248. he item is deleted and A message is logged warning the user Transition Type 7 Positive Edge Trigger Tracker checks the first location of the source region for items Actions triggered by what items exist are If No items are in the source region Then A message is logged warning the user If Multiple items exist at a location Then All items are moved Actions triggered by the specified handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user H 8 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Akk l Guidelines for Positive Edge Trigger include 1 The transition point may be an integer or character string point 2 The item transitions when the point goes from low integer 0 character string null string to high integer non zero character string non null string 3 The first 36 characters of a setpoint if configured are First 16 characters Item type Next 20 characters Either the tem ID for a serialized item Associated or parent item ID for a non serialized item Transition Type 8 Negative Edge Trigger Tracker checks the first location of the source region for items Actions triggered by what items exist are If No items exist in the source region Then No items are moved If Multiple items
249. he number of slots Make number of elements to be the number of slots in use None None None None None Set the number of items to zero and the location list to empty Make the count zero None None None None None Make the count be the number of items in the serialized item list Make the count be the number of items in the non serialized item list Make the pointer point to the end of the location list None None None None GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking PRT Object Model The CIMPLICITY API for Production Tracking PRT has been implemented using an object model approach to allow the user to manipulate PRT information in a logical and consistent manner This section is intended to provide the user with an overview of the PRT object hierarchy and an explanation of the objects functions gt PrtRegion gt gt Prtltem Attr gt PrtGroup Pritem gt Attr PrtService PrtRegion c gt Prilem gt Attr m Prtltem c Attribute gt Prilttem gt Attr PrtRegion _ PrtGroup o Prtltem gt Attribute PRT PrtRegion Tra Prtltem m Attribute CONTAINS _ Prtltem Attribute PRT O
250. he region It is not required that all Items arrive at the region before the carrier exits the region The Items that arrived at the carrier before a transition out of the region is detected are the Items that moved together with that carrier A Combine Items Tracking Region is a region in which greater than one Entry Transition Indication is received before an Exit Transition Indication is received Appendix C PRT Rules and Assumptions C 3 Disperse Items Tracking Region Rules C 4 A Disperse Items Tracking Region is a region in which a single Item Carrier entered the region carrying multiple Items but multiple Item Carriers or equivalent will exit the region carrying one or more of the Items which resided on the entry Item Carrier A single region Entry Transition Indication is required Multiple region Exit Transition Indications are allowed The region must be configured to have a region capacity of one Ifaregion Exit Transition Indicator has blanks specified for the type of Item that may exit that point all Items are tracked through that exit Ifa region Exit Transition Indicator has configured a specific Item Type for that exit only Items of that type are dispersed from the group of Items Positive Item Type identification is required for individually dispersed Items If any of the items in a disperse region is serialized it must be moved before the other items are dispersed from the region If the s
251. hold items required Output Arguments item_hold_list Populated array of hold items retstat Pointer to COR_STATUS structure Return Value Either COR_ SUCCESS COR_FATILURE or COR_WARNING If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTI_TOO_MANY_REQ Total number in list less than number requested Warning 5 32 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_req_class_itemlist Request List Of Item Tracking Data Name prt_api_req class_itemlist Description This routine provides a mechanism to request the Item Tracking Data for one or more Items of a particular Item Class from the PRT Data Server PRT_DS residing within all configured PRT services a specific PRT service a specific Tracking Group a specific Tracking Region or at a specific location within a specific Tracking Region If the request is a success the calling routine will receive back a count of the number of items returned to the item list If the request fails the calling routine will receive back status information on the reason for the failure Syntax Rat sore api r g Olaso 2eemuars te pre Sve 1G Group icy region_id region_loc item Class id ite m COUNT max location retstat char Dee SVG O S ERV LCE ID CLEN 2 ahs char group 1d PRT REGION ID LEN 21 char region_id PRT_REGION_ID_LEN 1 COR LZ region_loc char item _ cl
252. hold_active group_id iit Dold active dic nolo reason num atts valid item att list comment user_or_svc_id retstat ext_proc_flag regron 1d PRT O REGION LDO CLEN F I item 1d PRT_ ITEM IDEN TJ reference_id PRT_ITEM_ID_LEN 1 item type TOP RT TT TEM TYPE TD LEN ye parent_item_id PRT_ITEM_ID_LEN 1 item status ext hold active group_id PRT_REGION_ID_LEN 1 ii Nodd ae tae int_hold_reason num_atts_valid xitem att rist comment SC DESCRIPTION EEN 113 user or svc Td SERVICE TD LEN ols xretstat Information Requirements Input Arguments Serialized Items Only ext_proc_flag External process flag if TRUE get all information from external process required item_id Unique identifier of a Serialized Item optional if reference_id specified reference_id Secondary identifier of a Serialized Item optional if item_id specified ext_hold_active If TRUE item held due to external hold required group_id Group identifier providing reason for hold required if ext_hold_active TRUE 5 56 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F num_atts valid item_att list Non Serialized Items Only parent_item_id Both region_id item_type_id int _hold_active int _hold_reason comment user_or_svc_id Output Arguments retstat Return Value Number of item attributes valid This specifies the number of array elements in the item
253. i_term_intproc Description This routine is responsible for deallocating all memory allocated by the PRT_API interested process routines and for terminating any services to other application programmer interfaces Syntax int prt_api_term_intproc retstat CORUSTATUS retstat Data Structures See Static Information Requirements Input Arguments None Output Arguments retstat Pointer to COR_STATUS structure Return Value None 5 54 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_static_region_data Copy Static Region Information Into Region Structure Name prt _api_ static region data Description This function copies the static part of the region information into the region structure supplied by the application Note that only region configured capacity status and quantity points are returned If an invalid region is supplied the region_id field is not populated Syntax int prt api static region Gata region Struct eg ron 1d PRI REGION STRUCT egion List Tlist sizel char regionu rd Data Structures typedef struct ehar region_id PRT_REGION_ID_LEN 1 unique identifier of tracking region COR_U4 region_status region status COR_I4 total_items total number of items in region COR_I2 region_cap number of item carriers in region char SEeb peid POINT TD LEN t Status pornk 2denltrtfirer char icem gty pElcd POINT ID LEN 1 item quantity p
254. ice GetRegionList E 66 PrtService LocateItem E 70 Modify all item tracking data 5 18 Modify an Item Production Tracking window 3 13 Modify item tracking data 5 13 Modify item tracking data attributes 5 16 Modify tracking region data 5 70 Move an Item Production Tracking window 3 25 Move item to detainment region 5 74 Move item to location in tracking region 5 71 Move Items between Projects Production Tracking window 3 12 O Operations Production tracking C 6 Optional Configuration Files 4 3 Output file format PRT_EXPORT 4 69 P Print preview Production Tracking window 3 32 Print Reports Production Tracking window 3 32 Print setup Production Tracking window 3 32 Process resynchronization Production tracking application interface 5 86 Processes Production tracking 4 70 Production Tacking What it does 2 1 Production tracking About event codes B 1 Alarms 2 8 CIMPLICITY software component interface requirements 2 12 Combine items tracking region rules C 3 Configuration validation program 4 52 Index iii Customizing 4 71 Disperse items tracking region rules C 4 Error codes A 1 Export program 4 67 General rules C 1 Global section usage 4 70 Import program 4 53 Item associations 2 4 Item status 2 5 Locate an item 3 28 Operations C 6 Processes 4 70 Sequence monitoring 2 6 setpoints 2 8 Shifting Region Tracking C 6 User interface 2 8 Welcomes 1 1 Production Tracking About the tracking model 2 2 Database hierarchy 1 4
255. idations and Repairs Below is a list of the validations that are performed and the repairs that can be made D 2 Problem Cross reference element count larger than slots Cross reference element count larger than number of slots in use More locations are configured than allocated More locations are occupied than allocated Fewer items in the region than locations are occupied More items in the region than possible for the occupied locations More items in the region than item slots are allocated The number of items in the region is not consistent with the start and or end of the location list Count of an item type is negative Count of all item types does not match the total of items in the region A region location index is out of range Location list is circular An entry of the location list is marked as not being used An item index is out of range The count of serialized items does not match the number of items in the serialized item list The count of non serialized items does not match the number of items in the non serialized item list Location list end is at a different spot than is pointed to An item is linked into the region twice An entry on the item list is marked as not being used An item is on the wrong type of list An item is in the cross reference but not in the region CIMPLICITY HMI Tracking Operation Manual July 2001 Repair Made Make number of elements be t
256. ied refld String The Reference ID of the item to locate may omitted or an empty string if itemId is specified NumRetries Integer optional The number of times to retry to find the item before failing If an item is in transition from one tracking region to the next there is a small period of time when it doesn t appear in either regions tracking queue Defaults to 3 if not specified Example Dim ServiceA as new PrtService ServiceA Id SERVICEA_ DC Get a single item from a region with its ReflId and display its ItemId in a message box ServiceA LocateItem REFNUMS MsgBox ServiceA Item 0 ItemId PrtService Region Function E 70 syntax PrtService Region index Description Returns a region at the specified index from the list which was found by a previous call to GetRegionList Example Dim ServiceA as new PrtService ServiceA Id SERVICEA_ DC Get a list of regions in the service and display them one by A one in a message box ServiceA GetRegionList for j 0 to ServiceA RegionCount 1 MsgBox ServiceA Region j Id next Jj CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtService RegionCount Property Read GFK 1216F Syntax PrtService RegionCount Description Integer property to get a count of the number of Tracking Regions found by a prior GetRegionList call Example Dim ServiceA as new PrtService ServiceA Id SERVICEA DC Get a list of regions in the servi
257. ields for this Item were modified CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F Region_1_ld Name of exited region in the case of a move otherwise name of region which contains modified Item Region_1_Loc Location of Item in exited region in the case of a move otherwise location in region of modified Item Region_2_ld Name of entered region in the case of a move Region_2_Loc Location of Item in entered region in the case of a move ltem_Tracking_Type Types Serialized Non serialized item_id Item modified Reference_Id ReflId of the modified Item ltem_Type_lId Item type of the modified Item Assoc_ltem_lId Id of serialized item with which this Item is associated ltem_Status Items status mask Int_Hold_Active Internal Hold State Int_Hold_Reason Text Description of reason for internal hold activation Ext_Hold_Active External hold state Appendix G PRT Logging Configuration G 3 PRT REG Group_Id Name of group associated with activating external hold Num_Valid_Atts Number of valid Item attributes Att_ lt x gt _Name lt x gt 1 to Num _ Valid Atts Names of each valid attribute Att_ lt x gt _Value lt x gt to Num _ Valid Atts Values of each valid attribute Comment Extra data sent to PRT to describe the changes made User _Id Identifies the agent which modified the Item Event_Type Text description
258. ier CAB 11 2 WEWICLE CAR TO 2 SEH ICLE DOOR _LIMO S 1 CARRIER l l Expanded view of record ELFO 1 1 CARRIER Expanded view of record EHTA AA ELFOJ 1 CARRIER GHTAOO PAIHT 9 1 CARRIER CAB 11 2 VEHICLE HOOD LIMO 6 1 CARRIER PALHT 3 1 CARRIER PARTS 4 1 UERTELE Pe 0T I Records with values in each field as they correspond to the above comments Field 4 Item Class Identifier Field 3 Tracking Type Code Field 2 Blank Field 1 Item Type Code Field 0 Item Type ID Configuration File Definitions A definition is provided for each configuration file to include field name description data type and an entry example Use the definitions to edit configuration files as needed for your Tracking Model The following configuration file definitions are covered PRT_Sysdef PRT_Inv_Type PRT_Service PRT_Assoc PRT_Intproc PRT_Status PRT_Group PRT_Disp_Pt PRT_Region PRT_Att_Pt PRT_Grp_Reg PRT_Reg_At PRT_Item_Typ PRT_Attributes cfg PRT_Route PRT_Stnd cfg PRT_Type_Trn PRT_Window cfg GFK 1216F Configuration File Guide 4 7 2 4 8 ON nr HB W PRT SYSDEF Field Name api_req port api_sync_port api_int_port dc_main_port ds_main_port The PRT System Definitions prt_sysdef configuration file is used to define the queue sizes for the ports used by the Data Collector Data Server and Application Interface su
259. ill return COR_WARNING with an err_code of PRTI_NOT_ALL_SVCS_RESPONDED The function returns through an argument passed the number of items actually received This argument will show how many valid items were received Output Arguments group_count Count of Groups returned to schema retstac Pointer to COR STATUS structure Return Value Either COR_ SUCCESS COR_WARNING or COR_ FAILURE If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure GFK 1216F Production Tracking Application Interface 5 43 5 44 Error Codes PRTS_GROUP_NOT_DEFINED PRTS_NO_INFO PRTS_NO_GLOBAL_GROUP PRTI_SVC_ID_NULL PRTI_SVC_ID_NDEF PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTIL_GRP_NOT_IN_SVC PRTI_UNEXPECTED_SEG_TYPE PRTI_PARTNER_DEAD PRTI_EXTRA_SEGS Group not configured Warning No information available due to unknown reason Warning No GROUPS global section available for Warning PRT service identifier NULL Warning PRT service identifier not valid Warning Group identifier NULL Warning Group identifier not valid Warning Group ID inconsistent with service specified Warning Unexpected segment type from PRT_DS Warning Partner dead Warning Ignored extra segments after STATUS_SEG or END_SEG Warning PRTI_NOT_ALL_SVCS_RESPONDED Not all services responded Warning PRTI _WRITE_PORT_ERR PRTI_MF_INIT_ERR PRTI_CRESEG_ERR PRTI_BAD_MSG PR
260. ill immediately follow the PRT Record field in the point The CIMPLICITY ANALOG array points used to send a response must contain the following fields when populated PRT Field Value Status Value The first element of the array point will contain the translated value of the PRT record field that is defined in the file CTI PT DEF CFG The ASCII Text string representing a successful or failed transaction will immediately follow the PRT Record field in the point The Success Failure strings are defined in the file CTI_PT_DEF CFG CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Application Startup System Startup Whenever the system is started rebooted logical names should be defined at the system level for use by the CTI software For CIMPLICITY HMI for Windows NT logicals are defined in the sSITE_ROOT data log_names cfg file Datagram Queue Size Logical CTI_LDGQ_SIZE may be defined to set the size of the datagram queue If this logical is not defined the default datagram queue size of 10 will be used This logical may be defined in the SSITE_ROOT data log_names cfg file CIMPLICITY for NT Startup GFK 1216F In order for CTI to start automatically with the other CIMPLICITY processes it must be configured in the LOGPROC NODE_LOGPROC PHYSPROC SERVICE and MASTER MCP files as specified in the Site Configuration section of this document Appendix F Configurable Tracking Interface F 15
261. in one or more records from an input file These records specify which groups and regions of the specified service are to be dumped all information associated with the groups and or regions specified and complete information on all the items within the group or region are written to the output file The first field in each record in the Export file specifies the command described below These commands are described by denoting the literal characters to be placed in the first field of each input file record Subsequent fields in the record are delimited by a field delimiter character usually which is defined on the very first line of the Export file Comands are Command Function ALL Dumps all tracking data DSP Prints to the terminal GRP Dumps all tracking data in a specified Group REG Dumps all tracking data in a specified Region SVC Dumps all tracking data for a specified service or services ALL Specifies that everything is to be dumped for all services This record should be the first and only record in the file If there are any subsequent records in the file they will be ignored i e processing will terminate upon completion of the complete dump of everything If the ALL appears after some other record type it will be ignored DSP Prints out the fields following the DSP field one field per line For example DSP Production start for item XYZ GFK 1216F Configuration File Guide 4 67 GRP Specifies the gro
262. ing Region not configured Warning No global section available for Region Warning Pointer to data structure is NULL Warning No more items available Warning PRT service identifier NULL Warning PRT service identifier not valid Warning Region identifier NULL Warning Region identifier not valid Warning Group identifier NULL Warning Group identifier not valid Warning Non serialized item has item_id or reference id Warning Serialized item missing both item_id and reference_id Warning Region not in group specified Warning Region not managed by service specified Warning Production Tracking Application Interface 5 29 5 30 PRTIL_GRP_NOT_IN_SVC PRTI_UNEXPECTED_SEG Group ID inconsistent with service specified Warning Unexpected segment type Warning PRTI_ITEM_NOT_FOUND_INC_SRCH Item not found some service s down PRTI_ITEM_NOT_FOUND PRTI _WRITE_PORT_ERR PRTI_MF_INIT_ERR PRTI_CRESEG_ERR PRTI_BAD_MSG PRTI_BAD_SERVER_RESPONSE PRTI_UNKNOWN_RESPONDER Warning Item not found Warning Error in ipe_write_port Warn Fail Error initializing segment Failure Error creating segment Failure Error in segment Failure PRT Data Server returned bad error response Failure Response received from unknown service Failure CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F prt_api_req_groupitemlist Request List Of Serialized Item IDs in a Tracking Group GFK 1216F
263. ing in elements within the Item Attribute array To specify item attribute information see the description of the ATT record type 4 62 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F STP Initiate a Production Stop The application interface call for this record type provides a mechanism for removing an Item from the Production Tracking system as the result of its exiting out of a region along a route that has no destination region The specified Item must currently reside at a source region associated with such a route If the Item cannot legitimately transition out of the system along such a route an error is returned The fields in this record are char record_type 3 STP Cher regron LALE Identifier of the Tracking Region where the Item to exit the system is located COR CTA region_loc Specific location in the region where the Item is to be added Char item _td 21 Unique identifier of a serialized item Char rteterence 1d 27 Secondary identifier of a serialized item char item type 1d 17 item type identifier char comment 41 Comment to be recorded in prt history log file Char user or svo idos User or service identifier Configuration File Guide 4 63 4 64 Running the Import Program To run the Import program first open a command prompt window This can be done from the program manager window or a better alternative is from your CIMPLICITY HMI project window This is better becaus
264. int In the case of manual intervention setting the correct reader value the RCO can be triggered by the user or the RCO can be configured to re trigger automatically Automatic Triggers timed Setup 3 Flow of Control In this configuration there is no carrier at stop point The system relies on the readers being correct most of the time Reader Device Reader EQ w override GFK 1216F Configuration File Guide 4 45 Setup 4 Flow of Control This is a combination of Configuration and 2 Handling of the No Read cases for the regions are handled in PRT The RCO is then triggered independently with a heartbeat This automatic trigger can be combined with the validation triggers Note that because of multiple regions some of the items shown in the previous configurations are eliminated to make the figure more readable Accessing Configuration files by the Subsystem This section describes any files accessed by the subsystem and provides specifics about how this data is used prt_reg_val ctg The following table gives the layout this text file Region specific configuration is done with this file Description Region_id Region id Item_or_ref Type of matching to perform Valid values are 1 match item_id 2 match reference_id Reader_point_id Reader values are provided with this point It can be a string or numeric point The reason that we are providing a numeric point as reader point is t
265. ints must be configured as either text or analog array points All CTI Transition failure points must be configured as a single element digital point Site Configuration The CTI application must be configured using a text editor directly in the following process configuration files SERVICE IDT LOGPROC IDT NODE_LOGPROC IDT PHYSPROC IDT MASTER MCP SERVICE IDT The fields of each service data record are Service Identifier Subsystem Identifier Process Identifier An example of the data records in the SERVICE IDT file follows Ce RP ke TE PG er REI CLLR aie Gor ae RP F 2 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F LOGPROC IDT The fields of each data record are Process Identifier Process Type PM Flags Description The final field in each record of this file is a description of the process This field may be filled in as the user chooses An example of these data records follows CTI_RP_1 RESIDENT 1 Configurable Tracking Interface Data Monitor CTI_RP_2 RESIDENT 1 Configurable Tracking Interface Data Monitor NODE_LOGPROC IDT For CIMPLICITY HMI for Windows NT only the first three fields of this file are used Use the standard values for other processes in the CTI records The first field indicates the node that the CTI Resident process will run on The second field in the file is the Process ID of the process as configured in the logproc idt file The third fie
266. ion process Also provided with Tracker is the PRT User Interface which provides a view of all the regions and corresponding data You can perform a wide variety of functions from the User Interface giving you increased control over your tracking model 2 12 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Using the Production Tracking Window About the Production Tracking Window The Production Tracking Window user interface is a runtime window that enables you to view and manage production tracking data Using the menu options and toolbar you can perform a variety of functions that allow you to control production flow on the factory floor GFK 1216F The PRT_UI is designed to simplify management of your PRT data with an easy to use graphical interface The PRT_UI is displayed on a Windows platform enabling flexibility in performing functions through menus toolbar buttons quick keys and popup menus You can do all of the following from the PRT_UI Display and browse for regions Connect to multiple projects Move items between projects Add insert delete fetch and advance items Find items Reorder items And much much more 3 1 Procedure to Open the PRT Window J1 To open the PRT window Method 1 1 Run your Tracker project 2 Click Start on the Windows task bar 3 Select Programs gt CIMPLICITY gt HMI gt PRT User Interface Method 2 1 Run your Tracker project 2 Inthe Workbench directory
267. istics Region Location Physical space on the plant floor that holds one or more items ltem Physical Product Carrier Item Attribute Data field associated with an item CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Tracker Server and Display Options When you install the Tracker module on a Server or Development Viewer the two following options are available Option Installs the Tracker Entire Tracker option including the Tracker Display Tracker Display Tracker Display only Note The Tracker Display only is available for the Runtime Viewer The Tracker Option enables you to Access to the Tracker Configuration User Interface Make changes to the PRT database Use all of the functions available in the PRT User Interface View runtime data via CimView screens and scripts Activate alarming The Tracker Display Option enables you to Use all of the functions available in the PRT User Interface View runtime data via CimView screens and scripts Respond to alarm conditions HHI Server Options EJ Provides complete Select the components you want to install clear the components you do not want to install functionality PRT file configuration Components changes to the PRT HM Server Base 178895 K datapase and Tracker Jig Application Options 96975 K Spay Communications 23047 K Tracker Tracker Display System Utilities 212K Dema 64513 K
268. item Warning Internal hold specified without reason Warning Non serialized item has attribute s Warning Invalid number of item attributes specified Warning Region identifier NULL Warning Region identifier not valid Warning Error initializing segment Failure Error creating segment Failure GFK 1216F prt_api_prod_stop Enable Production Stop For An Item GFK 1216F Name prt_api_prod_stop Description This API provides a mechanism for removing an Item from the Production Tracking system as the result of its exiting out of a region along a route that has no destination region The specified Item must currently reside at a source region associated with such a route If the Item cannot legitimately transition out of the system along such a route an error is returned to the calling routine Syntax int prt_api_prod_stop timestamp region_id region_loc item_id reference_id item_type_id comment utser Or Syo Ird restat j time_t timestamp char regi om 10 PRT REGION 1D heN F LI3 COR IZ region LOC char Litem 10 PRT TTEM TD LEN 4 T 3 Chiat reference_id PRT_ITEM_ID_LEN 1 char item_type_id PRT_ITEM TYPE TD LEN 1 char comment SC DESCRIPTION LEN se 13 char user Or svo 10 SERVICE TD TaN oo ey COR STATUS retstat Data Structures None Input Arguments Serialized Items Only item_id Unique identifier of a serialized item optional if reference_id specified r
269. item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user Note If the point value begins with a the remainder of the point value is considered the item type to move The transition type code becomes a Type Detector at this point Tracker searches for the item with the given item type and moves it to the destination CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Again in this case If The source region is a disperse region Then Only the given item is moved If Multiple items exist at a location and the source region is not a disperse region Then All items at the location are moved Actions triggered by the specified handling of a moved item are If Not handled along the route Then The item moves and A message is logged warning the user If Not allowed in the destination region Then The item is deleted and A message is logged warning the user Transition Type 5 Associate Reference ID to Item Tracker checks the first location of the source region for items Tracker moves all serialized items in the location to the destination region gives each serialized item a reference ID of the point Important Reference ID s are unique Therefore if multiple serialized items are moved the last serialized item will exist at the destination region
270. item for an impending Modify or Add The comment is written to the PRT log file as the modifications are sent to the object Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupiId Groupname NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM IntHold false NEWITEM ExtHold false NEWITEM ItemTypelId TYPES NEWITEM Status 0 NEWITEM Comment New item created Upload to Tracking Database NEWITEM Add CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prtitem Delete Property Read Write Syntax PrtItem Delete disposition comment Description Deletes the item from the tracking model A disposition must be supplied and a comment is optional Comments Parameter Description disposition Integer Reason for deleting See table below for manifest constants comment String optional The optional comment to send to the log file Disposition Description PRT_SCRAP Scrap the item PRT_DELETE Delete the item PRT_NO_CHECK_SCRAP Scrap the item overriding region locking status PRT_NO_CHECK_DELETE Delete the item overriding region locking status Example Dim prt as new Prt Get a single item from PRT with its ReflId and delete it PRT LocateItem REFNUMS prt Item 0 Delete PRT_NO_CHECK_DELETE Item Removed Prtitem EntryTime Property Read Syntax PrtItem EntryTime Description Date property contains the date a
271. item is to be moved in the field Example In the Edit Location box enter 18 to move the selected item to location number 18 7 Click OK 8 Inthe Comment field type any additional notes to be saved to the PRT Log file 8 Click OK to return to the PRT window and view changes or click Cancel to exit without making any changes GFK 1216F Using the Production Tracking Window 3 29 Updating a Region s Status You can set the status bits for an entire region using the Region Status option Region status fields are configured in the Tracker Configuration User Interface gt PRT gt Advanced gt Status Codes See the Tracker Getting Started Guide GFK 1694 for information on status bits J17 To set the status bits for a region 1 Click Operation on the menu bar 2 Select the Region Status The Region Status dialog box opens Active region Item count in the displayed region Aag Sfaluc bamia a bk Cipi dec iag haad waki ehara hold im a ni kk reid id ket ma cd an eng bor oer 3 To change the settings for a region select the status bit from the list Click the appropriate button to set the status as needed Changes status from No to Yes Changes status from Yes to No Current settings for the status bits in the active region Item list for the active region Refreshes data in the window Button To Set Active Activate status by changing from No to Yes
272. ived from unknown service Warning PRTI_INIT_MSG_RCVD Init segment received from Data Collector Warning PRTI_UNEXPECTED_SEG Unexpected segment type Warning PRTI_EF_CHECK_ERR Error checking event flag Failure PRTI_BAD_MSG_MSG Error in segment Failure PRTI_READ_PORT_ERR Error in ipec_read_port Failure Production Tracking Application Interface 5 7 5 8 prt_api_load_item Load Serialized item Tracking Data Name prt _api_load_item Description This PRT_API routine is used to load the answer for a PRT request for Serialized Item Tracking Data into a response buffer The calling routine receives back a status indicating the success or failure of the request This function can be called multiple times to load multiple responses into the response buffer If the buffer becomes full the return status will be unsuccessful and additional error information will be found in the COR_STATUS structure The PRT_API routine prt_api_send_resp must be called to send the response buffer to the appropriate PRT process Syntax int prt_api_load_item data_valid_flag item_id reference id item type id item status ext_hold_active group_id int hold actives int Bold reason n m atts valid item att Listy retstat COR BOOLEAN data_valid_flag char item 1d PRI ITEM TD TEN 13 Char reference_id PRT_ITEM_ID_LEN 1 char item_type_id PRT_ITEM IYPE ID LEN 1 COR_U4 item_status COR_BOOLEAN ext_hold_active char group
273. l Bit used by PRT to ident this status CTRLWTRK O control w track 22 Expanded view of the first record 4 25 PRT DISP PT The PRT Display Point prt_disp_pt configuration file is used to define the Item Type quantity in a region to be displayed through a setpoint This file must be configured when prt_grd is configured Each of the fields is described below complete with entry examples and a sample configuration file OPTIONAL FILE Entr No Field Name Description Data Type Sak 0 region_id Unique name for the tracking region 16 RINSE1_NOR characters 1 item_type_id Unique name for the item type 16 WSH_FRAME characters 2 qty_ptid Unique name for the setpoint to display the 55 R1_CTQ item type quantity in the region characters 2 records created 4 26 Configuration File Example A pr_desp pt idt Notepad Fie Ed Searcy Hels j 10T File generated by IDTPOP utility vi o REGIAO PRT_DISP_PT Prod Tr Region tem Type Display Point region id 4 item type id 2 qty ptid CIMPLICITY HMI Tracking Operation Manual July 2001 RIASE RORY YSH FRAME AI C19 RIHSE HOR WSH_BASE R1_Ccg Tracking Regiom ID Item Type ID point ID set to E of Item Type RINSE1_NOR WSH_FRAME R1_CTQ Expanded view of the first record No delimiter needed after last field GFK 1216F PRT_ATT_PT The PRT Region Item Attribute Display Point prt_att_pt configuration file is used to define the setpoint I
274. l be used in the data fields The first character defines the delimiter This character will be used to separate fields in the record In the example below the vertical bar is used for a delimiter The second character is used to show a continuation of a record When a record exceeds the length of one line this character is used to append the next line to the record In the example below the hyphen is used for a continuation character The third character identifies the comment character When the comment character is used before text it is not recognized as part of the record but rather additional information for the user In the example below the asterisk is used for a comment character Reserved characters delimiter continuation and comment j prt_region idt Notepad by IDTPOP utility v1 6 oduction Tracking Region p Resident Proces REGION ID Tracking Regio region desc Tracking Regio region label User defined T tracking type id Region tracking POOL SEQUEHTIAL 5 region cap Hax physical available Configuration File Guide 4 5 4 6 Example of Delimiter Continuation and Comment Characters IDT file in text editor o mt_region idi Mer niepad Fie Edt esch Hep 43 log inval_ type alarm_unknown type 45 log unknown type alarm reg_cap log reg cap auto move point tran_region id WpTpapapapay yy PRT_D DEV Dew DEV SEQ EMT Law 20
275. ld is the name of the executable to be run This is typically BSM_ROOT exe cti_rp exe unless you have placed the executable in a different location An example of these data records follows NODE_1 CTI_RP_1 BSM_ROOT exe alpha cti_rp exe 4 1 1 80 36 S0000 kO V0 2000 100 S00001 10 50 3 00 S072 76s sL NODE_1 CTI_RP_2 BSM_ROOT exe alpha cti_rp exe 4 1 1 60 S650000 kO 25 02 270 0 0 T00 S0000 LOT S0300 S07 2 7268 1 PHYSPROC IDT The Process ID and the object name are the same for ease of use Since the object name has a ten character restriction the process id is ten characters as well as the Subsystem ID and the Service ID The fields of each data record are Node name Process Identifier Object Name Redundant or allocated process order always 0 An example of the entries for the CTI subsystem follows NODE_1 CTI_RP_1 CTI_RP 0 NODE LICEI RP 2 eas RPS GFK 1216F Appendix F Configurable Tracking Interface F 3 F 4 MASTER MCP This is a text only configuration file which does not need to be converted using SCPOP It contains the list of processes to be started automatically when the CIMPLICITY project starts If you wish CTI to start automatically simply list the name of the CTI process you have configured in the previous four files as the last line of this file An example MASTER MCP file follows MASTER UR KP AMRP MASTER_PTMO_RP PLA RE DL RP DYNCEG MASTER_PTDP_RP
276. le Example D piim Wps wk Hepa j IDT File gemerated by IDTROP wtility vi RECORD PRT MU TYRE Production Tracking Route Invalid Type a B rig region id ID oF region iter exits 1 g st region id 10 oF region item enters 2 item type_id 10 oF type inwalid between these regdens 9 transition ptid ID oF transition paint beteeen regions a PIICLAE 1 Ae ACASE AOR WSH_MTR PLI_RS1_TRAHS PROC LAE BOR jATHSE1 HOR OY PTR PLI AST _TRAHS PROCLNE1_NOR RINSE1_NOR WSH_MTRIPL1_RS1_TRANS 2 records created Expanded view No delimiter of first record needed after last field 4 22 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PRT_ASSOC The PRT Item Association prt_assoc configuration file is used to define a parent child association between a serialized and non serialized item Configure one record for every parent child association to be made during production Each of the fields is described below complete with entry examples and a sample configuration file OPTIONAL FILE Entr No Field Name Description Data Type Senne 0 region_id Name of the region in which the parent child 16 PROCLNE2 association will take place characters _COM 1 item type_id Unique name of the item type that will enter the 16 WSHR_FRAME above region can be serialized or non serialized characters 2 role code Code indicating the role of the item type as One byte 3 records created GFK 1216F follows 1 Pare
277. list of items in a region check each one s status bit then s t it if 1S not already ser If CurPrt Item 0 StatusBit J FALSE Then CurPrt Item I SetStatusBit J CUrPrt LEem 1 Moduzy Bnd If GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 45 Prtitem Userld Property Read Write E 46 Syntax PrtItem UserId Description String property to set or get the User ID associated with the Item The User ID is recorded into the PRT log when an Item is modified Example Dim prt as new Prt ns 17 Get a list of items from PRT and initialize a particular status bit for each one setting the object to log the user id performing the action prt GetItemList fOr F UO tO prt lbemCoune 1 prt Item j ClearStatusBit n prt Item j UserId ADMINISTRATOR prt Item j Modify next J CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtRegion AdvanceModel Method Syntax PrtRegion AdvanceModel destRegionld comment userId Description Advances the next Item Carrier to leave the region to a destination region Note This call moves all items at the FIRST EXIT location in the source region to the LAST ENTRY location in the destination region Comments Parameter Description destRegionld String Destination Region ID region the item is moving into comment String Optional Comment to place in PRT log file userld String Optional Us
278. mation you want to print from the View drop down list 2 Click File on the menu bar Select Print Setup The Print Setup dialog box opens Prim Setup m Parte gt Hame E i arhan Click to adjust the printer s properties Stet Fash Type HP LaserJet 4000 Emis PEL Where by compube noon Comment HP Lacerle 4000 Seneq FEL G gt Sizer Letter u Click appropriate radio l button to set the p gt jame iadi Select as cape orientation of your printed page 4 Set up the printer and page properties as follows Click Properties to set the printer properties Select the Size of the paper from the drop down list Select the Source of the paper supply from the drop down list Click Network to configure printer network options Check either the Portrait or Landscape radio button to set the orientation of the printed page 5 Click OK to effect changes or click Cancel to cancel the operation CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Procedure to Preview a Printed Report 441 To preview a printed report L 2 Click File on the menu bar Select the Print Preview option to see how the printed report will look Function buttons Left to Right Prints report as you see it Scrolls to the next page in the report _Enlarges the report on screen by percentages Reduces the report on screen by percentage
279. ms gt CIMPLICITY gt HM I gt Millar GE The CIMPLICITY Registration program begins 3 Enter the serial number for each Tracker option Result Tracker options are now registered and software is fully functional HHI Server Options Installs complete functionality PRT file configuration changes to the PRT database and Tracker Display HMI Server Base 178895 K Application Options 96975 K Communications P3047 K Tracker AMS KE 3 C Tracker Display 1784 K HHI Viewer Development Op aystem Utilities 212k Demo 7529K HMI Server Base Application Options Communications Tracker Tracker Display System Utilities Demo Installs Tracker Display only 1 8 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Production Tracking Overview About Production Tracking GFK 1216F Production Tracking PRT monitors the progress of Items as they move through a factory production process Information about an item s location and status is collected as it enters and exits the Tracking Regions PRT analyzes and updates this information maintains a log of each item s tracking data and generates CIMPLICITY alarms to give notification of tracking exception conditions Tracking Items are identified by Item IDs Automatic Item type detectors Manual transactions Application processes interfacing with PRT 2 1 2 2 Using the Tracking Model Summary har The PRT
280. must be contiguous and blank padding will be used when necessary The CIMPLICITY ANALOG array points used to receive data must contain the following fields when populated PRT Database Key The first element of the array point must contain a value representing the numeric field value to be used as a database key usually the Item ID or Reference ID of the item to be modified This integer value will be translated into an ASCH character string equivalent by CTI For example the integer value 4731 would be translated to the ASCII value 4731 PRT Field Data The remaining elements of the array point must contain values representing each PRT field to be modified in the order that they are configured in the file CTI_ LAYOUT CFG The CTI may translate these integer values into ASCII text values if this is defined in the file CTI_XLATE CFG The CIMPLICITY TEXT points used to send a response must contain the following fields when populated Appendix F Configurable Tracking Interface F 13 F 14 PRT Record Field Status Value The first field of the text response point will contain the value of the field that is configured in the file CTI_PT_ DEF CFG for that response point The length of the field will be the maximum length that is defined in the file PRT_API H in the structure PRT_ITEM STRUCT for that field The ASCII Text string representing a successful or failed transaction that is configured in the file CTI_PT_DEF CFG w
281. n Insert an item in a region Modify an item in a region Continue procedure from Steps 1 2 and 3 Set Attributes for item View and modify item status Using the Production Tracking Window 3 13 Step 1 Add an Item to a Region uy Step 1 Add an item to a region 1 Do one of the following Method I Menu option A Click File on the menu bar B Select the Add option Method 2 Quickest Click on the toolbar The Add Item dialog box opens when you use either method Example using menu option Fite PHI Ll GE Farr Aubomaiion Click Select 2 Go to Step 4 3 14 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Step 2 Insert an Item in a Region uy Step 2 Insert an item in a region 1 Do one of the following Method I Menu option A Click Operation on the menu bar B Select the Insert Before Location option Method 2 Quickest Click cea on the toolbar The Insert Item dialog box opens when you use either method Insert an item zt PRT_UI GE Fanuc Automation Insert Ctrl Insert tem 2 Go to Step 4 GFK 1216F Using the Production Tracking Window 3 15 3 16 Step 3 Modify an Item in a Region uy Step 3 Modify an item in a region 1 Do one of the following Method I Menu option A Inthe PRT window select the item in the list B Click Operation on the menu bar C Select the Modify Item option Method 2 Quickest A Select the item in the
282. n Fail Error initializing segment Failure Error creating segment Failure Error in segment Failure Error in ipc_read_port Failure GFK 1216F prt_api_unload_regionlist Unload List Of Tracking Region Data Name prt_api_unload_regionlist Description This routine provides a mechanism to unload the list of Tracking Regions obtained through the prt_api_req_regionlist routine If the request is a success the calling routine will receive back an array populated with the Tracking Region Data This array contains a pointer to another array allocated by the application interface routine which contains an element for each type of item in the region and the total number of items of that type in the region The caller is responsible for de allocating the PRT_ITEM_COUNTS array when it is no longer needed If the request fails the calling routine will receive back status information on the reason for the failure Syntax int prt_api_unload_regionlist list_size region_list retstat COR I4 Tirst 3126 PRE REGION STRUCT zegion J Sells s126 COR_STATUS APeLSpac Data Structures typedef struct COR_I4 item_type_count number of items of that type in region char item_type_id PRT_ITEM_ TYPE ID LEN item type identifier PRT ITEM COUNTS typedef struct char region_id PRT_REGION_ID_LEN 1 unique identifier of tracking region COR_U4 reglon status region status COR_I4 total items total number of items i
283. n in the Group 16 AsmblyLnel characters 2 region_seq Sequence number of the region in this Group Integer 1 Optionally use this field to represent the physical order of the regions in a production line or in the group used for display purposes only Configuration File Example mt_gp_egidt Motepad Fie Eot Seach Help j IDT File generated by IDTPOP utility vi RECORD PRT GRE REG Prod Tracking Croup Tracking Region group id Tracking Group I i REGION ID Tracking Region ID 2 region seg Display order of Region in Group Entarean Asnblylnet 4 EnthreaA AsmblyLnez 2 TtAeaAAsmblyLne1 1 EntareoA toboti 3 Eastaresd Proclie1 4 14 Records Eastareal Qualtkt 5 created to tie Eas threat Qualeke 11 Tracking Regions Midareal Rinset j to Groups Midareal Rinse 7 Midareal Oven jE Midareal ven Midareat Proclme jit Scrap0 Scrapt 1 Exitareae Robot 13 Exitarege Packingt 14 Expanded view of the No delimiter after first new record in the the last field in the batch record GFK 1216F Configuration File Guide 4 17 olg 4 18 PRT_ITEM_TYP The PRT Item Type prt_item_typ configuration file is used to define all of the item types that the Tracking Model is responsible for monitoring Each of the fields is described below complete with entry examples and a sample configuration file REQUIRED FILE Field Name Description item_type_id Unique name for the item type item_type_code Unique co
284. n region COR_I2 region cap number of item carriers in region char Stat_ptid POINT_ID_LEN 1 status point identifier char ibemgqtry ptid POINT LD LEN 1 ttem quantity point id COR_I2 total_item_counts tells how many PRT_ITEM_COUNTS elements are in the array pointed to by ype totals PRI ITEM COUNTS type_totals pointer to array of PRT_ITEM_COUNTS structures array must be deallocated by the user F PRIREGION STRUCT PRIA REGLON sSTRUCTOP IR Input Arguments list_size number of array elements allocated for region_list array required region_list Pointer to a buffer to receive tracking region data required Output Arguments region_list populated array of Tracking Region Data retstat pointer to COR_STATUS structure GFK 1216F Production Tracking Application Interface 5 4 Return Value Either COR_ SUCCESS COR_WARNING or COR_FAILURE If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure Error Codes PRTI_TOO_MANY_REQ Total number in list less than number requested Warning The following code example shows how to deallocate the user memory PRT REGION STRUCT region Struct region Struct pcr COR Ss fATUS retstat if prt_api_unload_regionlist 1 amp region_struct amp retstat COR SUCCESS TeGIion SerUCE PLL Crego SLE UCL Deallocate PRT ITEM COUNTS structure Me regi n struct per total item coun
285. n the total number of items in the region or an empty string if the ID is not configured Example Dim Region as new PrtRegion Region Id PRODUCTION Get the name of a region s Total Item point and display its i contents in a message box TotPtIdsS Region TotaliItemsPointIld if TotPtIdS lt gt then msgbox Total Items amp PointGet TotPtId Else nsgoex SNO pOtme CON ioured t End If PrtService GetGroupList Method Syntax PrtService GetGroupList Description Gets a list of groups contained in the PRT Service Upon return the total group count may be obtained from GroupCount and the individual groups may be accessed via the Group function Example Dim ServiceA as new PrtService ServiceA Id SERVICE A Get a list of groups in the service and display them one by l one in a message box ServiceA GetGroupList for J 0 to ServiceadA GroupCount 1 MsgBox ServiceA Group j Id next J Appendix E Basic Control Engine Extensions for Production Tracking PrtRegion TotalltemsPointld Property Read Write E 65 PrtService GetltemList Method Syntax PrtService GetItemList Description Gets a list of all items for the tracking service Upon retrun the total item count may be obtained from ItemCount and the individual items may be accessed via the Item function To get the item list for a particular item class set Prt Service ItemClassId to the desired item class id before calling Prt
286. nd time at which the item entered the current region Example Dim Region as new prt Region Region Id Detainment Get a list of items in a region and display their entry times i one by one in a message box Region GetItemList For j 0 to Region ItemCount 1 msgbox Region Item j EntryTime Next Jj GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 27 Prtltem ExtHold Property Read Write E 28 Syntax PRTItem ExtHold True False Description Boolean property to set or get the state of External Hold for the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupiId Groupname NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM IntHold false NEWITEM ExtHold false NEWITEM ItemTypelId TYPES NEWITEM Status 0 Upload to Tracking Database NEWITEM Add CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prtltem ExtHoldGroupld Property Read Write syntax PrtItem ExtHoldGroupId Description String property to set or get the Group ID which has placed an External Hold on the item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupiId Groupnames NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM NEWITEM NEWITEM Upload NEWITEM IntHold false ExtHold true sBREHOlLAGrOuUpIa SHIPPING
287. nfiguration File Example O ot eerie el Hepi je OT file geeerated by 1OTPOR utility vi RECORD PAT WINDOW PAT COHFICIARAELE FIELO HARES name of he regimen 6 Firid type 1 prt Field 7 prt_labe 3 field size fisplaged Hir ALL T O PAT TEM IDjlten ID amp O PAT TEM TYPE Item Type i O PAT REFERENCE ID Reference ID 7 O PRT_EMTRY_TIMEJEntry Time 28 OB PAT_ MOG _TIiMl Hod Time yse ID EFAULT VITE MPAT_ITEH_TVPE Type of Then 12 O PRT_ EFEREMCE 10 Reference d PAT _ GROUP Gramp 10 12 ID FECLOM BOT 4 MPAT_ITEH_ID Applicance 1b 12 O PAT TEM TYPE appliance Typey i will apply to that regims Labels are cosFigurable by region Preceed the configuration fer a region with a record specafying the keyword REGION and the ECG IOR RDG1 for che region ALG 611 recerds following amtil the next RECIOH khegeerd is Found The Beyword REFAULT may be weed instead of a REGIOK record bo define labels For all regions wot listed in this File Type of Field internal attribute 2 status PEGDUCTIOH TRACHIHE FIELD LeBELS USES FOR FET FIELDS Hambeer of Characters For the width oF The Field DEFAULT VIEW1 O PRT_ITEM_TYPE Type of Item 12 O PRT_REFERENCE_ID Reference 6 O PRT_GROUP Group ID 12 REGION ROBOT1 O PRT_ITEM_ID Appliance ID 12 O PRT_ITEM_TYPE Applicance Type 12 CIMPLICITY HMI Tracking Operation Manual July 2001 Expanded view of the Common view rec
288. ng PRTI_CANT_MOD_ITEM_WOUT_REF Must specify ref id to modify item id Warning PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTI_EXT_HOLD_NON_SER PRTI_INT_HOLD_NO_REASON PRTI_ REG ID _NULL PRTI_REG_ID_NDEF PRTI_INVALID_REG_LOC PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_SER_PARENT PRTI _NUM_ATTS_INVALID PRTI _MF_INIT_ERR PRTI_CRESEG_ERR Item type identifier NULL Warning Item type identifier not valid Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Group identifier NULL Warning Group identifier not valid Warning External hold specified for non serialized item Warning Internal hold specified without reason Warning Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning Item type identifier NULL Warning Item type identifier not valid Warning Parent ID specified for serialized item Warning Invalid number of item attributes specified Warning Error initializing segment Failure Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd Production Tracking Application Interface 5 21 5 22 prt_api_group_hold Activate Deactivate Hold Specification for a Tracking Group Name prt _api_group_hold Description This routine provides a mechanism to
289. ning CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_INVALID_REG_LOC PRTI_ITEM_TYPE_NULL PRTI_INVALID_DEST PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning Item type identifier NULL Warning Destination region is invalid for item of this type Warning Error initializing segment Failure Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd Production Tracking Application Interface 5 73 5 74 prt_api_move_item_to_detain Move Item To Detainment Region Name prt _api_move_item to detain Description This routine provides a mechanism for moving an Item from the Tracking Region where it currently resides to the detainment region of that region This function checks that a detainment region exists for the source region and then calls prt_api_move_item to actually complete the work Syntax ine pri apt Move iren tO Celaim t SPO reg Id sre Teg 1 66 item_id reference_id item_type_id comment user_or_svc_id retstat char sre reg Id PRT REGION CID LEN a 1i lt COR LZ sro req Ioc char item oe PRE TERME ID LEN SL lke char rererence 1d PRT LTEM I
290. nitialize a particular t status bit for each one Prt GetRegionList Lor J U BO PrUsTLemCount 1 Prt Region j ClearStatusBit n Prt Region j Modify next J E 48 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtRegion Deleteltem Method GFK 1216F Syntax PrtRegion DeleteItem regionLoc disposition comment Description Deletes an item from the tracking region at a specified region location Comments Parameter Description regionLoc Integer The location of the item in the region disposition Integer The disposition of the deleted item See table below comment String Optional an optional comment to place in the PRT log Disposition Description PRT SCRAP Scrap the item PRT DELETE Delete the item PRT NO CHECK_SCRAP Scrap the item overriding region locking status PRT NO CHECK_DELETE Delete the item overriding region locking status Example Dim Region as new PrtRegion Region Id PRODUCTION Region GetItemList Get all items in a region and delete those items with a specific ItemTypeld For 1 0 to Region ItemCount 1 If Region Item i ItemTypelId MARKVII then Region Item i DeleteItem i PRI_DELETE Obsolete Type End If Next i Appendix E Basic Control Engine Extensions for Production Tracking E 49 PrtRegion GetData Method syntax PrtRegion GetData Description Returns region information such Status TotallItems Capacity StatusPointId and TotalItemsPoin
291. ns comment User or svo id retstat char region_id PRT_REGION_ID_LEN 1 COR I2 reorder lest num l ocations l COR I2 naim Locations char comment LSC DESCRULPTTLON GEN 113 char user or Svo 1 0 SERVICED LEN ae ce 3 COR_STATUS retstat Data Structures See Static Information Requirements Input Arguments region_id Tracking Region identifier required reorder_list Pointer to an array consisting of region locations These location numbers 1 to num_locations specify the new region location for items residing in their current location e g the locations the items are to be moved to The reorder_list array index implicitly identifies the current location number i e the first element in the reorder_list array reorder_list 0 refers to the items that currently reside in region location The value of reorder _list 0 specifies the region location where the items currently in region location are to be moved to This array must include elements for each location currently occupied in the region num_locations The number of locations in the region which currently are occupied This number must match what the Data Collector thinks are the number of locations currently occupied or else the Data Collector will return an error err _code PRTC_REORDER_MISMATCH and the operation will not be performed Failure to allocate the reorder list array with num_locations elements is bad comment Comment to be recorded
292. nt item serialized 2 Child item non serialized item 3 Bystander no association will take place Configuration File Example H prt_ageec idt Notepad Fie Edi Geach Heip IDT File generated by IDTPOP utility v1 6 RECORD PRT_ASSOC Prod Tracking Region Item Association ial B regiam id Tracking Region If 4 ites_type_id Item Type ID a Frole_code Item role deparent echild debystander PROCLHE COM WSHR FRAME 4 BOCLHE COM LID 2 PROCLHE COM PALLET JI PROCLNE2_ COM WSHR_FRAME 1 Expanded view of the first record Configuration File Guide 4 23 No 0 4 24 Field Name status _ code code_type code desc code label bit set PRT_STATUS The PRT Status prt_status configuration file is used to assign a status code for each valid region status for example capacity sequential error invalid or unknown type etc Similarly a record is configured for each valid item status for example hold no hold delayed etc A number of statuses have predefined records and you may configure additional records to define other status types Each of the fields is described below complete with entry examples and a sample configuration file OPTIONAL FILE Description Data Type Unique code to identify the status of the region 8 or item characters Unique code representing what you are One byte defining a status code for as follows 0 Region Status Code 1 Item Status Code 2 Reserved
293. nts configured in the PRT tracking route records These points are set by PRT when an Item transitions into the configured destination region enable Boolean TRUE or FALSE Example Dim Region as new PrtRegion Region Id PRODUCTION GE LIME gt DbeO0S00 or TIME x 6200200 then Region SetPoints False Else Region SetPoints True End If E 60 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtRegion SetStatusBit Method GFK 1216F Syntax PrtRegion SetStatusBit b Description Clears a particular status bit in the regions status mask Comments To obtain the region s status mask use the Prt Region GetData method To update the Region s status mask to PRT use the PrtRegion Modify Bits 0 15 are for User Use Bits 16 31 are for GE Fanuc use The following constants may be used to access GE Fanuc specific bits Constants Description PRI REGION FULL Region Full Bit PRI REGION EXT HOLD Region External Hold Bit PRT REGION_IN LOCK Region in Lock Bit PRI REGION OUT LOCK Region Out Lock Bit PRT REGION OUT OF SEQ Region Out of Seq Bit PRT REGION CAP EXCEEDED Region Capacity Exceeded Bit PRT REGION NORMAL Region Normal Bit Example Dim Prt as new prt Prt GetRegionList Get a list of regions in PRT check each one s first status l bit then set it if it s not already set FORN Jo 10 EO PITER GLONN COUN If Prt Region J StatusBit 0 FALSE Then CurPrt Item I SetStatusBit 0 CurPrt I
294. o JSRC2J IX S2UT 5211310 P AD PRUL REGE JX _23jjjajo Four records created DST JSRCIj D_x sijoi T_n Ib of type traveling between regions ID of transition point between regions oF point to be set on transition 10 to interp type trans indicator transition indicator type code 1 8 Should we process the First point change 4 20 Expanded view of the first record No delimiter after last field CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PRT TYPE TRN The PRT Item Type Translation prt_type_trn configuration file is used to translate item type codes received from detection equipment into item type IDs Once translated Tracker recognizes the IDs via the PRT database Configure this file when your prt_route records have a translation type code of 2 Each of the fields is described below complete with entry examples and a sample configuration file OPTIONAL FILE Entr No Field Name Description Data Type SE 0 translation_id Unique name of the item type translation 16 NOCHANGE characters 1 input_code Unique code received from detection Integer 10 equipment signaling the item type 2 item type_id Unique name of the item type that is to be 16 WSHR_ translated using the input code from the characters MOTOR detection equipment Configuration File Example Mi E cut_type a Notepad Fie Edi Search Help j IOT File generated by IDTPOP utility wi RECORD PRT TYPE_TRH Pred Tracking I
295. obtained for that item and the attempt to modify it One of the fields in the structure which returns data on an item is the last_mod_time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the timestamp associated with the item at the time of the attempted modification then the modification is not performed and a warning returned If the timestamp argument passed to this function is zero the operation is performed without any timestamp checking Indicates fields that have been modified required Ifa bit in the bitmask is set the corresponding argument provided to this function is required If a bit is clear the corresponding argument is not accessed in any way The following fields are potentially modifiable and have a corresponding bit in the modify _bitmask Field Name Bit Name Item_ status ITEM_STATUS_ BIT status_bitmask ITEM_STATUS_ BIT item_id ITEM_ID_MOD_BIT reference _id REFERENCE_ID_MOD_BIT item_type_id ITEM_TYPE_ID_BIT parent_item_id PARENT_ITEM_ ID _ BIT ext hold active EXT_HOLD_BIT group_id EXT_HOLD_BIT int_hold_active INT_HOLD_BIT int_hold_reason INT_HOLD_ BIT See the next chapter for a list of macros that can be used to set the various bits in modify _bitmask to indicate which fields are being modified Note The item_id and reference_id if both are specified are used to find the item unless either the ITEM_ID_MOD_BIT
296. odified Statistics array point s value at index 5 has been modified Statistics array point s value at index 6 has been modified Statistics array point s value at index 7 has been modified Statistics array point s value at index 8 has been modified Read is ignored reserved read starting with a Statistics point has been reset Item not found in the current PRT Service and a new item has been created Region has been validated by reordering the region Region has been validated by moving an item from another region 4 49 PRT Region Status Bits Region status bits include Control with Track Flag Validation Status Waiting For Decision Flag Deriving Region Status from Validation Process Data PRT Validation completed trigger Reader Value PRT Validation trigger Control with Track Flag If set to TRUE when there is a no read it tells the validation process to trust the PRT image of the region if the region is valid This is useful in cases such as region validity is not being mission critical and having a bad reader The Control with Track flag is initialized with the value in prt_reg_val cfg when the tracking image is created the first time when they do not exist It can be changed dynamically with an API call Since it will be maintained in the region status bits its value will be maintained when PRT is restarted and when PRT import export utilities are run Validation Status When
297. ogging whenever an item s tracking data is modified Enable disable 1 0 logging when tracking of an item starts in this region Enable disable 1 0 logging when tracking of an item stops after this region Point ID that displays the total number of items contained in the region must be of type INT or UINT Point ID that represents the region s status must be of type DIUNT Secondary tracking region type Use the following codes 1 Normal 2 Combine 3 Disperse Note If a Combine or Disperse region region_cap field must be set to 1 and region_loc_cap must be greater than L Indicates 1f items are automatically associated in this region must be of secondary region type Combine Yes No 1 0 Uniquely identifies the resource against which the alarm will be generated at the tracking region level Note If a resource is not designated here the alarm will be generated against the default SYSTEM GE Fanuc Reserved Enable disable 1 0 alarm generation when an out of sequence condition occurs Enable disable 1 0 alarm generation when an invalid item type enters the region Enable disable 1 0 logging when an invalid item type enters the region Configuration File Guide Data Type One byte One byte One byte One byte One byte One byte 55 characters 55 characters Integer One byte 16 characters One byte One byte One byte One byte Entry Example 1 0 0 ASMBLYLNEI
298. ointe id COR_I2 total_item_counts tells how many PRI ITEM COUNTS elements are in the array pointed to by type_totals PRI ITEM COUNTS type totals pointer Lo array orf PRT _ ITEM COUNTS structures array must be deallocated by the user PRE REGION STRUCT SPRI REGION STRUCT PIR Input Arguments region_struct Pointer to a buffer to receive tracking region data required region_id Character string identifying the region of interest Output Arguments region_struct Populated tracking region data Return Value If the region_id field in the region_struct buffer contains the supplied region_id then the configured region quantity in the region_cap field the status point in the Stat_ptid field and the item quantity point in the item_aqty_ptid field are all populated with valid data otherwise the region could not be found and the fields contain invalid data GFK 1216F Production Tracking Application Interface 5 55 prt_api_prod_ start Initiate Production Start For An Item Name prt_api_prod_start Description This routine provides a mechanism to initiate production start for an Item in a Tracking Region syntax int prt_api_prod_start ext_proc_flag region_id item_id COR_BOOLEAN Chad Ghar Ghar Ghar char COR_U4 COR_BOOLEAN char COR_BOOLEAN char COR gt fd PRT_ITEM_ATT char char COR STATUS Data Structures See Static reference_id item_type_id parent_item_id item_status ext_
299. on Gets a list of the configured PRT services After calling this method the total number of services can be obtained from ServiceCount and the individual services may be accessed via the Service function Example Dim prt as new Prt Get a list of services from PRT and display them one by one in a message box prt GetServiceList for J O O pre Servicecount 1 MsgBox prt Service j Id next J Appendix E Basic Control Engine Extensions for Production Tracking E 5 Prt Group Function Syntax Prt Group index Description Returns a group at a specified index from the list was found by a previous call to GetGrouplList Example Dim prt as new Prt Get a list of groups from PRT and display them one by one in a message box prt GetGroupList EO Js O0 Oo pat GroupC oun 2 MsoBox DrtueGroup 7 22d next jJ Prt GroupCount Property Read E 6 Syntax Prt GroupCount Description Contains the number of Groups found by a prior call to GetGroupList Example Dim prt as new Prt Get a list of groups from PRT i and display them one by one in a message box prt GetGroupList ftor J 26 gt PEL GroupCcounk l MsgBox prt Group 7 420 next gJ CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prt ltem Function Syntax Prt Item index Description Returns an item at the specified index from the list which was found by a previous call to GetItemList Example
300. on then the head item first location in the region is moved to the configured transition region if not configured it is deleted and all items are shifted one location towards the head location Shifting Region Detainment Region Loc Last Loc Tail Item A empty Item inserted added moved into the region Shifting Region Detainment Region Loc 2 Loc 3 Loc Last Loc Tail Empty Item New Item B Item A After Item Inserted Added moved into region Appendix C PRT Rules and Assumptions C 7 C 8 Moving an Item into a Shifting Region When a new item is moved into a shifting region and its new location is other than the end location then the last item in the region is moved to the configured detainment region if not configured it is deleted and all the items from the added location to the end location are shifted one location towards the end location If the last item was a blank item then it gets dropped instead of moving into the detainment region However if a new item is moved to transitioned to the end location then the head item first location in the region is moved to the configured transition region if configured otherwise it is deleted and all items are shifted one location towards head A move by the user is not allowed for a blank item Shifting Region Transition Region Loc Tail empty Item transitions moves added inserted into the Shifting Shifting Region Transition R
301. on File Example E a DE eS BF ES ot PRRPHRHREERrFER RE eee ee for each PRT Service O pur irit ui Aer Fee iS imc Hain DET Fils gerarastri a MOMO PAT SESUICE Pradsction Tratking Service DESNE PRE juc_Ib prt_searoh_order eet item wer id ext bold wore id det reg_alraad Peden iori aliradi Feglen_cap_salraid Lec cap_alensd _erer_4alraid Liem fold aired 18 Llimalld tye alr mid qi ammin type ami 1 immalid id sirnid 10 regien sgt empty aloe 14 Gateb cae PAT 2 PST_OEN_ BEG FWLLIPRU ITH THAU Lem PaT AEF PAT_REF 0h PET_ITH_W APRT DC 1 PRT_DET REG FULL PRT_ITM_THRU_LCK PRT_REF_CAP PRT_REG_LOC_CAPI PRT_IHUALIE_ITEN PET_ BRT REF _OOS PRT_ITM_WITH_HLD PRT_INVALID_TYPE PRT_UNKNOWN_TYPE OTPOF utility wi B Becident Process parels Ii Search eder oF PRET seradces for infa Liem data greaiger Service Ti libram Gold data provider Service 18 Selalemnt Mijin Alara iP enteywfeeit DHIMT LOHEN region flare 10 eee ram lten Caeriers 2ceeded Alare ID mae ltem at Carriage epecerdrd blarnm ID hem diil oF teqeemete Alara 10 tem ef bem Mold arrives Alara 18 invalid oem Type detecte Alara If ining bee Tape detected lare Ji Bn pravider ints Far ser ites flare IG Gdaperee Jkem Evgion mat mtg Alarm ID Data Type 32 characters 32 characters 32 characters 32 characters 32 characters 32 characters Not used Batch grit aie by Chit proetess PRT_INVALID_ITEM P
302. on the reason for the failure Syntax Orte api reg regronlriste pre sve Group 1G region rd item_count retstat char Prl SvVc 1d SERVICE ITD ENS 15 char Group PRE REG DON T LEN Ses LI char region_id PRT_REGION_ID_LEN 1 COR_ 14 ATES Count COR STATUS vetstet Data Structures None Input Arguments prt sve_id PRT service identifier optional but required if no other arguments specified grouped d Tracking group identifier optional but required if no other arguments specified region_id Tracking region identifier optional but required if no other arguments specified Note At least one of the above three arguments must be specified If not all services will be queried It is possible that a list of items will be collected but not all services will have responded because one or more of them were down Thus the user has a list of valid responses but may not have all the 1tems that should have been returned In this case the function will return COR_WARNING with an err_code of PRTI_NOT_ALL_SVCS_RESPONDED The function returns through an argument passed the number of items actually received This argument will show how many valid items were received Output Arguments item_count Count of regions returned to schema kxretstat Pointer to COR _STATUS structure GFK 1216F Production Tracking Application Interface 5 39 5 40 Return Value Either COR_SUCCESS COR_WARNING or COR_FAILURE I
303. onal User or service identifier optional Pointer to COR _STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRIC_XREF NOF IND PRIC TTEM NOL FOUND PRIC_REFE NOT FOUND PRTC BAD REG SPEC PRTC UBAD REG TOG SPEC PRTC_NO_ITEM_AT_LOC PRTC_NO_REG_LOC_SPEC Deleted but not found in xref table Warning Item ID not found Failure Reference ID not found Failure Bad region specified Failure Bad region location specified Failure Specified item not found specified location Failure Must specify region location to delete non serialized item Failure CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F PRTC TTEM STAMP TOO NEW PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI REG ID NULL PRTI_REG_ID_NDEF PRTI_INVALID_REG_LOC PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Plus all error codes returnable by prt_api_send_cmd An affected item has changed since the last display Failure Item type identifier NULL Warning Item type identifier not valid Warning Non serialized item has item id or reference id Warning Serialized item missing both item id and reference id Warning Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning Error initializing segment Failure Err
304. one of the above three arguments must be specified region Loc Location in the region where the items reside required 5 26 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F disposition comment user_or_svc_id Output Arguments retstat Return Value Either COR_SUCCESS COR_WARNING or COR_FAILURE Disposition of item to be deleted values are SCRAP NO_LOCK_CHECK_SCRAP DELETE NO_LOCK_CHECK_ DELETE Valid required Causes the item to be scrapped Causes the item to be scrapped overriding region locking status Causes the item to be deleted Causes the item to be deleted overriding region locking status Note It may be necessary to force the deletion of the item regardless of the region s lock status while using the PRT API functions to delete items in a region To do this use the NO_LOCK_CHECK_ versions of SCRAP and DELETE above Comment to be recorded in prt history log file optional User or service identifier optional Pointer to COR STATUS structure If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure Error Codes PRTC BAD REG SPRG PRTC_BAD REG LOC_SPEC PRTC_NO_ITEM_AT_LOC PRTC_NO_REG_LOC_SPEC PRTC_ITEM_STAMP_TOO_NEW PRTI_REG_ID_NULL PRTI_REG_ID_NDEF PRTI_INVALID_REG_LOC PRTI_NO_SVC_IMPLIED PRTI_MF_INIT_ERR PRTI_CRESEG_ERR Bad region specified Failure Bad region location
305. or information can be found in the COR_STATUS structure Error Codes PRTS_NO_GLOBAL_XREF No XREF global section available Warning PRTS_REGION_NOT_DEFINED Region not configured Warning PRTS_NO_GLOBAL_REGION No global section available for Region Warning PRTS_NO_ITEMS_AT_LOCATION There are no items at location specified Warning PRTI_SVC_ID_NULL PRT service identifier NULL Warning PRTI_SVC_ID_NDEF PRT service identifier not valid Warning PRTI_REG_ID_NULL Region identifier NULL Warning PRTI_REG_ID_NDEF Region identifier not valid Warning PRTI_INVALID_REG_LOC Invalid region location Warning PRTI_GRP_ID_NULL Group identifier NULL Warning PRTI_GRP_ID_NDEF Group identifier not valid Warning PRTI_REG_NOT_IN_GRP Region not in group specified Warning PRTI_REG_NOT_IN_SVC Region not managed by service specified Warning PRTI_GRP_NOT_IN_SVC Group ID inconsistent with service specified Warning PRTI_UNEXPECTED_SEG_TYPE Unexpected segment type from PRT_DS Warning PRTI_PARTNER_DEAD Partner dead Warning PRTI_EXTRA_SEGS Ignored extra segments after STATUS_SEG or END_SEG Warning PRTI_NOT_ALL_SVCS_RESPONDED Not all services responded Warning PRTI_WRITE_PORT_ERR Error in ipe_write_port Warn Fail PRTI_MF_INIT_ERR Error initializing segment Failure PRTI_CRESEG_ERR Error creating segment Failure PRTI_BAD_MSG Error in segment Failure PRTI_READ_PORT_ERR Error in ipec_read_port Failure 5 36 CIMPLICITY HMI Tracking Operation
306. or REFERENCE_ID_MOD_BIT is set both cannot be set If neither is set the item you are looking to modify will only be found if both the item_id and the reference_id you supply match that of an item already in the production tracking system The item_ids need not match however if the ITEM_ID_MOD_BIT is set and similarly the reference_ids need not match if the REFERENCE_ID_MOD_BIT is set Indicates fields in item status that have been modified optional Region where item last resided required CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F GFK 1216F region_loc item_type_id item_status comment user or svc_id int _hold_active int _hold_reason Output Arguments retstat Return Value Location in the region where the item resides required For non serialized items a specific region location must be specified For serialized items the constant ALL_LOCATIONS may be used This indicates that the item may reside at any location in the region Item type identifier required for non serialized item optional for serialized items Item status optional Comment to be recorded in prt history log file optional User or service identifier optional If TRUE item held due to internal hold optional Comment specifying reason for internal hold required for activate does not apply to deactivate Pointer to COR STATUS structure Either COR_SUCCESS COR_WARNING or COR_FAILURE
307. or creating segment Failure a prt_api_check_route except PRTI_INVALID_ROUTE Production Tracking Application Interface 5 61 prt_api_add_item Add Item To Tracking Region Queue Name prt _api_add_item Description This routine provides a mechanism to add an individual Item at the same location where another Item currently resides Defined constants are provided as a way of indicating that the item is to be added either at the head or at the tail of the queue The region location can be specified as FIRST or also as EXIT to add the item to the first head location in the queue i e this item is being added to a location where one or more other items already currently reside although no more than one serialized item may reside at a region location at any one time These items will be the next items to transition out of the queue LAST and ENTRY are provided to add the item to the last location in the region the last location which currently has one or more items residing in it These items will be the last items to transition out of the region of all the items currently in the region Syntax int prt_api_add_item time _t COR_BOOLEAN char COR TZ char char char char COR_U4 COR_BOOLEAN char COR_BOOLEAN char COR Ld PRI CTEM ATLI char char COR STATUS Data Structures timestamp ext proc tlag region id region_loc item_id reference_id item_type_id parent_item_id item Status ext
308. or misread It also creates an enhanced self healing capability without the need for single Carrier virtual regions at the head of each region with a reader this setup was used to utilize the positive ID transitions that made sure that the tail of the destination region was corrected The components of the system are Region Carrier at stop Device Carrier at head Reader Reader Device System Configuration Operation Status Operation Statistics An overview of the system and its components is shown above In general terms the following is a list of major components and their roles Reader Shown with a triangle The carrier IDs are read by the reader and are put in to a reader point Carrier at head Shown with a circle This is a trigger that tells PRT that a carrier has just come to the head of the region and the reader point should contain the ID of the carrier This trigger is usually a limit switch at the head of the region indicating that there is a carrier present Notice that the Reader point should not be used for this trigger if the user wants no read cases to be detected by this system Manual Entry 1 Correct Reader Value If the reader has a no read or the PRT does not match the read and the region can not be validated Then the solution should provide a way of manually entering the correct read GFK 1216F Configuration File Guide 4 4 Manual Entry 2 Re irigge
309. or seat style required is shown as being in short supply in a Region on the production line An Item s status can be modified by An external process A manual transaction An external process Can modify an Item s status to Hold when shortage attributes exist Is configured to provide Item hold information for Serialized Items Enables PRT to modify the status of all Items residing in a Tracking Group Modifies the status to Hold for each new Item entering the Tracking Group Can be configured to generate a CIMPLICITY alarm when an Item s status is modified to Hold Can deactivate Item hold status on all affected Items in a Tracking Group Will not impact a Hold placed by a manual transaction Monitors the Item s status and if capable physically holds the item at a pre configured point on the production line A manual transaction Can be executed to modify an Item s status to Hold Can have comments attached to describe the reason for the Hold Is held separately from a Hold placed by an external process Can deactivate Item hold status on all affected items Will not impact a Hold placed by an external process Production Tracking Overview 2 5 Monitoring Sequences A sequence error may be detected at the exit transition indicator of a Sequential Tracking Region when an Item does not arrive at the transition indicator in the expected order You will configure the action to be taken in
310. ord This view can be selected in the PRT window in the View drop down list Expanded view of the Region view record This view will impact the ROBOT1 region only GFK 1216F PRT Client Routing Items across Project Boundaries The PRT Client application allows Tracking items to be routed across project boundaries in the same manner in which items are routed between regions within the same project In order to facilitate routing across project boundaries you must configure both the PRT_ROUTE and PRT_INV_TYPE configuration files The dest_region_id field must fully qualify spell out the project and region name and be less than 16 characters in keeping with the standard for the field Note that the PRT Client process will ignore the record if the dest_region_id field is not fully qualified A sample of the configuration needed to run the PRT Client process is detailed using both the PRT_ROUTE and PRT_INV_TYPE configuration files See Tracking Route PRT_ROUTE and Tracking Route Invalid Type PRT_INV_TYPE sections for further details about the fields in these configuration files PRT_Route Configuration for PRT Client PRT_ROUTE Configured to run PRT Client Process A pat_route ict Notepad Fie Eot Search Help j 107 file generated by IDTPOP utility w1 6 al RECORD PRT ROUTE Production Tracking Route k H H REG Y PROJYSACA X_S51 T_S1 310 REG PROJ SRC
311. ource region is not a disperse region the exit transition will move all items at the source location Otherwise only the specified item is moved PRT determines what Item to move to a Destination Region by using these two rules If positive identification of the Item either ID or type is made available to PRT through information provided by the Transition Indicator the Item or Item Type identified is moved from the Source Region to the Destination Region If positive identification is not provided to PRT from a Transition Indicator e g limit switch the information PRT maintained about the Item s in the Source Region will be used A Tracking Region designated to execute automatic Item Associations must be a Combine Items Tracking Region Item Associations can be specified at run time via Application Interface messages The message will provide the child Item Type and the region ID where that Item is the next Item to exit the region and the Item ID of parent Item Serialized Item the child Serialized or Non serialized Item is to be associated with The association of a Non serialized Item to a Serialized parent Item can become corrupted or lost in the three ways specified below PRT has no way of re associating the Items when an association is lost except through a manual user transaction Ifa sequence error is detected for a Non serialized Item in a Tracking Region where the Item has an associated parent Item Ifa Non serialized
312. out for this process Can not find any field layout for point id lt POINT_ID gt Can not find the keyword for point id lt POINT_ID gt in field layout point id lt POINT_ID gt is not configured in base CIMPLICITY point id lt POINT_ID gt is not a valid point type unexpected datagram received unexpected point lt POINT_ ID gt received Point lt POINT_ID gt is unavailable Fails to allocate dynamic memory Required field is missing on record d of s Fail to set response point s CTI Q sort Stack overflow Point lt POINT_ID gt not found in the Point Definition table Fatal problem using PRT_API Item lt ITEM_KEY gt was not found in the PRT database F 18 CIMPLICITY HMI Tracking Operation Manual July 2001 Suggested Corrective Action Configuration error The filename does not exist or it is not in the directory specified by the PATH Configuration error The specified record contains an invalid number of fields for the specified configuration file Refer to the Configuration File section of this manual for a description of the fields required for each Configuration file Configuration error There must be at least 1 field layout for this CTI process Configuration error There must be at least 1 field layout for each lt POINT_ID gt Configuration error Make sure that there is a keyword specified in the field layout for this lt POINT_ID gt Configuration error Add this lt POINT_ID gt into the
313. out of sequence condition and is then resynchronized in the destination region PRT will process the Item according to the configuration for detected sequence errors in the Region See figure PRT will Ensure the serialized Item is correctly identified in the queue of the destination region Assume the sequence of the Items in the source region is incorrect until the missing Item is scrapped or the delayed Item is removed Identify the item in the destination region when it is removed from the detainment region and placed in the destination region ALARM Oven1 Region has an out of sequence condition Scrap Item 2 Rinse1 Region Synchronize items New Order 1 3 4 5 BRE ye ne es rae ee Items are scanned by the sensor and positively identified in the PRT Database Sensor Source Region Sequential Tracking Destination Region Sensor Rinse 1 3 1 ltem 2 is scrapped by the Items are automatically resynchronized in the operator causing an out of destination region The Tracking Model sequence condition recognizes the new order and arranges them accordingly in queue Note Regions configured with Automated Validation will potentially resynchronize every Item as they enter the head location For additional information see Automated Region Validation GFK 1216F Production Tracking Overview 2 7 Items Scrapped Production Tracking allows Items to be scrappe
314. ox opens showing read only information about the item Pit PRT UI GE Fanuc Agiomaleon ltem Lor wid PAT_Ul GE Fanuc Automation Fie Qretation View Help ame aa Begonid DEV jl o Sw Fields are read only Eriry Time 1 E1 GMT EUU P hrsda dir 1 CAR Thrureday Jur l ELPL murada Sete Ri ELPO Thursday Jun GHTaO0_P Thursday Jun Click to display the item in the region in the PRT window Item located in the region 4 Click OK to exit the window or Go To to display the item in the region in the PRT window 3 28 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Reordering Items You can reorder items in the active region using the Reorder Region function J17 To reorder items in a region 1 Click Operation on the menu bar 2 Select Reorder to open the Reorder Region dialog box Fiender Ragen Function buttons Top to bottom Moves selected item up in the list Moves selected item down in the list Launches the Edit Location dialog box Effects changes made Cancels operation Edt Locate 3 Select the item to be moved in the list and proceed as follows Click Move Up to move the item up in the list or Click Move Down to move the item down in the list 4 Select the item in the list to move an item to a specific location or over a greater distance Click Edit Loc to open the Edit Location box Enter the location number where the
315. pecified based on the prt_system argument in the prt_api_init and prt_api_dyn_register_intproc calls The information received by the interested process includes updates for Serialized and Non serialized Items as well as region related updates There are currently two types of updates that an interested process may receive from PRT An item has been modified or moved the manifest constant for this update type is PRT_INTPROC_ITEM_UPDATE The event_code field in the PRT_ITEM_UPDATE_STRUCT indicates the exact nature of the update The items in a region have been reordered the manifest constant for this update type is PRT_INTPROC_REGION_UPDATE With both types of update structure the action field contains the same value as the update_type argument returned to the calling program The caller allocates storage for both item update and region update structures When the call returns update_type will be set to PRT_INTPROC_ITEM_UPDATE if the item update structure has been filled in with item information If the region update structure has been filled in update_type will be set to PRT_INTPROC_REGION_UPDATE If a Data Server process which the interested process is configured to receive interested process updates from terminates or some other error occurs the interested process will be notified by receiving a message with update_type set to PRT_ERROR_RESP In this case the service id of the associated Data Collector process will be placed in
316. ple Dim main as new PrtGroup main Id MAIN Get a list of regions from a PRT group and display them one by one in a message box main GetRegionList Lor 4 0 CO Malm ReglonCoune 1 MsgBox main Region j Id next J E 20 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtGroup RegionCount Property Read Syntax PrtGroup RegionCount Description Integer property contains a count of the number of Tracking Regions found by a prior GetRegionList call Example Dim main as new PrtGroup main Id MAIN Get a list of regions from a PRT group and display them one by one in a message box main GetRegionList for J 0 to main RegionCount 1 MsgBox main Region j Id next J PrtGroup SetExtHold Method Syntax PrtGroup SetExtHold reason Description Sets an External Hold for this tracking group The setting will be updated to PRT after a call to Modify Comments Parameter Description reason String The reasons for placing the group on hold Example Dim prt as new Prt RISOS SSS n Get a list of groups from PRT i and initialize their External Hold status bits and Reasons prt GetGroupList EO J TO POE SG rOoupeCounte J prt Group j SetExtHold Reasons amp amp 47 prt Group J Modify next J GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 21 Prtltem Add Method Syntax PrtItem Add extProcFlag Descri
317. pplication Interface 5 83 5 84 prti_get_RCMconnection Connect to Remote Connection Manager Name prti_get_RCMconnection Description In order to connect to the data server on a remote node this function must first make sure the remote node is active Once we know it is active and we have initialized with RCM RCM will handle the connections later Syntax int prti_get_RCMconnection cimp_sys retstat char CLMp sys COR STATUS retstats Data Structures None Input Arguments cimp_sys Pointer to a null terminated string containing the project or node name of the remote system to connect to Output Arguments retstat Pointer to COR_STATUS structure Return Value Either COR SUCCESS or COR_ FAILURE COR_SUCCESS is returned if the remote system is active COR_FAILURE is returned if we cannot connect to the remote system CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prti_term_RCMconnection Disconnect from Remote Connection Manager GFK 1216F Name prti_term_RCMconnection Description This function breaks the connection to the remote connection manager that was made by prti_get_RCMconnection Syntax int prti_term_RCMconnection retstat COR GLATUS sretstat Data Structures None Input Arguments None Output Arguments retstat Pointer to COR_STATUS structure Return Value Either COR_SUCCESS or COR_FAILURE COR_SUCCESS is returned if the remote system is disconnect
318. proc Step 4 Configure node_logproc Step 5 Configure service Step 6 Configure prt_intproc Step 1 Open Tracker Project in Workbench J4 Step 1 Open Tracker project in Workbench 1 Click Start on the Windows task bar 2 Select Programs gt CIMPLICITY gt HMI gt Workbench The Workbench window opens Click File on the Workbench menu bar 4 Select Open the Open dialog box opens 5 Navigate to and click your Tracker project 6 Click Open to open your project in the Workbench window i Tip To open a project quickly create a shortcut for the project on your Windows desktop and double click the icon GFK 1216F Appendix J Troubleshooting J 3 Step 2 Configure Physproc J4 Step 2 Configure physproc Use the IDTPOP Utility to convert the file to ASCII text using the text editor of L your choice e g Notepad Press Ctrl End to bring you to the next available line to enter your record see figure physproc idt Notepad IOJ File Edt Search Help IDT file generated by IDTPOP utility v1 6 RECORD PHYSPROC PROCESS HAHES ON SPECIFIC HODES NODE ID PROCES _ ID object name order Oe Ok OR OR Rast M me Decnet Node Name Logical Process Name Decnet Object Name Redundant or Allocated Process Order MASTER SPC_SPCCFG1 SPCCFG1 6 MHASTER UR_RP MAC UR 9 HASTER PRT_INT PRT_INT 8 4 3 Field No 0 1 AR WN MASTER PRT_INTIPRT_INT O Type your record
319. properly prt_group PRT Group Identifies the Groups in your tracking model Because every region must belong to a group this file must be configured prt_region PRT Region Identifies the regions in your tracking model their primary and secondary types and other important information prt_grp_reg PRT Group Ties the tracking regions to their Tracking Region tracking groups prt_item_typ PRT Item Type Defines the item types classes and parent child relationships between items prt_route PRT Route Identifies routes between regions and associations with transfer points prt_attributes cfg PRT Attribute Configures a set of attributes for all Labels items or for items in a specific class This is not a required file but is recommended Note All of the above files have a dat extension with the exception of the last one which has a Cfg extension Files with a dat extension are binary files with a cfg extension are in text format CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Akk l Guidelines for Optional Configuration Files The optional configuration files are not required to run a basic tracking model However the configuration of your tracking model may require some or all of these files in order to provide you with the kind of information you want to collect Each file is described in detail below File Name prt_type_trn prt_inv_type prt_assoc prt_status prt disp pE prt_att_pt prt_reg_at
320. ption Adds an individual item at the same location where another item currently resides The PrtItem RegionLoc indicates the location at which the item will be added The RegionLoc can be specified as PRT_FIRST PRT_LAST or a valid region location within the region Comments Parameter ext_proc_flag Description Boolean External process flag if set to TRUE get all information from an external process If not provided defaults to FALSE If the new item is not being copied from a previously created item the following PRTItem object methods must be set for the add to be successful RefId or ItemId if this is a serialized item ItemType RegionId Status IntHold usually false ExtHold usually false RegionLoc Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM GroupiId Groupname NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM IntHold false NEWITEM ExtHold false NEWITEM ItemTypelId TYPES NEWITEM Status 0 Upload to Tracking Database NEWITEM Add CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prtltem Attr Function GFK 1216F Syntax PrtItem Attr index PrtItem Attr attrib Description Prototype 1 Returns an Item Attribute at the specified index from the list which was found by a previous call to Get ItemList The index must be in range from 0 to Att rCount If the index is out of ran
321. ption This function lets users delete or scrap all Items at a location in a specific Tracking Region queue The calling routine receives back a status indicating the success or failure of the request Syntax int prt_api_delete_items_at_loc timestamp region_id regqron lOC disposi tron comment User or svc 1d ret stat time _t timestamp char region_id PRT_REGION_ID_LEN 1 COR I2 region_loc COR 11 Cis OS eons char comment SC DESCRIP LION LEN 4113 char user OF SVC Id SERVICE LD_ GEN LIF COR_STATUS retstat Data Structures None Input Arguments See SYNTAX for proper order timestamp The time the item was last moved or modified The timestamp is used to ensure that when attempting to delete an item the item has not changed or moved between the time when the time when information was last obtained for that item and the attempt to delete it One of the fields in the structure that returns data on an item is the last_mod_time field which indicates the time at which the item was last moved or modified If the timestamp argument provided to this function is older than the item s current timestamp then the deletion is not performed and a warning returned If the timestamp argument passed to this function is zero the Operation is performed without any timestamp checking region_id Identifier of the Tracking Region where the Items are to be deleted from the queue Note For serialized items at least
322. r Description sourceRegionld String The source region of the item destRegionld String The destination region of the item itemtypeld String The item type ID Example RtFail 0O On Error goto RouteFail PrecCheckRoute Schedule Production MARKV If RtFail 0 then msgbox Item Type Valid for this Route If RtFail 1 then msgbox Item Type Invalid for this Route Regie Cup RouteFail RtFail 1 Resume Next Appendix E Basic Control Engine Extensions for Production Tracking E 13 PrtGroup ClearExtHold Method Syntax PrtGroup ClearExtHold Description Clears an external hold for this tracking group This setting will be updated to PRT after a call to Modify Example Dim prt as new Prt Get a list of groups from PRT and clear each one s External Hold status bit prt GetGroupList Lor 7 O Co pri GroupCount 1 ptt Group Ceark lt b Heb PruseGroup 7 Modiry next J E 14 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtGroup ExtHold Property Read Syntax PrtGroup ExtHold Description Boolean property contains the setting of External Hold for the Tracking Group Example Dim prt as new Prt Get a list of groups from PRT and display their External Hold i status bits one by one in a message box prt GetGroupList BO GF Or 6 pres Groupeoune 1 MsgBox pri Group 7 Exc Hold next Jj PrtGroup ExtHoldReason Property Read GFK 1216F Syntax P
323. r information can be found in the COR_STATUS structure Error Codes IPC _ERR_PARTDEAD PRTI_UNKNOWN_INIT_SRC PRI UNEXPEC TED SEG PRTI_BAD_MSG PRTI_READ_PORT_ERR PRTI_EF_CHECK_ERR Partner Dead Warning MF_INIT segment received from unknown service Warning Unexpected segment type Warning Error in segment Failure Error in ipc_read_port Failure Error checking event flag Failure Production Tracking Application Interface 5 49 5 50 prt_api_intproc_retry_connect Send INIT Segment to all data servers Name prt_api_intproc_retry connect Description This function provides a mechanism for a process to send an INIT segment to all data servers we are interested in This routine allows the user to easily reestablish the connection to a data server when the connection has been broken Syntax COR_BOOLEAN prt_api_intproc_retry_connect Data Structures None Input Arguments None Output Arguments None Return Value Either TRUE or FALSE If the function returns TRUE then this means that an INIT segment was sent to at least one data server Error Codes None CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_get_intproc_updates Get Interested Process ltem Region Tracking Data Updates Name prt_api_get_intproc_updates Description This routine provides a mechanism for an application to receive interested process updates from all data servers which have been s
324. range number of copies Option not available Use the default printer or select another printer from the Name drop down list 4 Indicate the Print range as follows A Click All to print the entire report B Click Pages and type the page range in the from and to boxes C Click Selection to print data previously selected in the PRT window Note that this button is disabled when no data has been selected 5 Indicate the Number of copies to print by typing in the number or by using the arrows to increase or decrease the number 6 Click OK to print the indicated print range and number of copies or click Cancel to cancel the operation 3 34 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configuration File Guide About the Configuration Files This section is devoted to providing our customers with information and detailed instructions for using the Configuration Files Before the implementation of the Tracker Configuration User Interface the Tracking Model was configured using ASCII text files The need for this has been eliminated however for the convenience of our customers who are accustomed to editing these files all of the information you need is included herein Handling configuration files includes the following Identify the configuration files Use the IDTPOP utility Understand configuration file format and restrictions Edit Configuration files based on provided definitions See the CI
325. re the item located at the specified destination region location unless the manifest constant LAST ENTRY is specified in which case the item is inserted after behind the last item currently present in the region required Item type identifier required for non serialized items optional for serialized items Comment to be recorded in PRT history log file optional User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Pointer to COR STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRIC_NON_SER_ID PRTC_SER_NO_ID PRTC_UNKNOWN_REGION PRTC_BAD_REG_LOC_SPEC PRTC_ITEM_STAMP_TOO_NEW PRTC_ADD_LOC_TOO_BIG Non serialized item has item or ref id Failure Serialized item missing both item amp ref id Failure Unknown REGION specified Failure Bad region location specified Failure An affected item has changed since the last display Failure Can not add item to unoccupied location inserting Warning PRTC _ADD MULTIPLE SERIAL Can not have two serialized items at one location PRTC_REGION_NOT_LOCKED PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF Warning Lockable region s not locked cannot perform operation Warning Item type identifier NULL Warning Item type identifier not valid War
326. rec iit Hotepad Ey E3 Ele Edt Seuch Hee s IDT File generated by IDTPOP utility v1 6 F RECORD PRT_IHNHTPROC Interested Pro c zas bata provider mapping a prt suc id i IMTPROC SUC ID 2 update mask PRT Service ID providing info to above Interested Process Service ID 1 Full 8rief all but auto move E Eg PAT _OG PRT_GRD 1 Expanded view PAT OC PRT S THR 1 of record used to configure PHT BDC PRT CHT 1 prt_inttest exe PRT DC PRT_INT 1 0 1 2 3 Type your record using the following field descriptions Field Field Entry No Name Description Example 0 prt_svc_id Unique identifier of a PRT service that PRT_DC will provide interested process updates 1 intproc_svc_id The name given to this service This must PRT_INT be identical to the ID in service dat 2 update_mask Specifies the type of updates to be l supplied to the interested process Values are 1 Full 0 Brief 4 Save the file A Use the SCPOP Utility to convert file back to binary format CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Running the PRT Interested Process Utility Once all of the appropriate files have been configured you can run the prt_inttest exe and view the output in a Command window J17 To run prt_inttest exe 1 If running stop your project in the Workbench 2 Click hit on the Workbench toolbar to perform a Configuration Update Click on the Workbench tool
327. red PRT service 5 81 Return the tracking type for a specific item 5 83 GFK I216F Index Running PRT_EXPORT 4 69 PRT_IMPORT 4 64 Run time Notes Production tracking application interface 5 2 S Scrapping Items Sequence monitoring 2 8 Send init segement to all data servers 5 50 Send response to production tracking 5 12 Sequence monitoring Automatic resynchronization 2 7 Production tracking 2 6 Sequence Monitoring Scrapping items 2 8 Setpoints Production tracking 2 8 Shifting Region Tracking Production tracking C 6 SVC PRT_EXPORT 4 68 Synchronization capability Customizing production tracking 4 71 T Terminate PRT_API interested process interface 5 54 Terminate the PRT_API interface 5 5 Tracker Installation 1 6 Registering option 1 8 Tracking Regions Production Tracking 2 3 U Unload list of items 5 37 Unload list of serialized item ids in a tracking group 5 32 Unload list of tracking groups 5 45 Unload list of tracking region data 5 41 User interface Production tracking 2 8 V Validate tracking route 5 76 Validations and repairs Global verifier D 2 View Drop Down List Production tracking window 3 32 Index vii W Welcome Production tracking 1 1 What Production Tracking Does 2 1 Index viii CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F
328. regions and items contained within the service You can also locate an item which will return all instances of the item within PRT Service PrtGroup This object contains information on the groups configured in your PRT System Groups may be places on or off hold via this object A group object may obtained from a Prt or PrtService List or by initializing the ID GroupId property of the object From a group object you can obtain a list of all region and items contained within the group You can also locate an item which will return all instances of the item within PRT Group PrtRegion This object contains a configured PRT region Region status capacity etc may be found in this object A region object may be obtained from a list created by a Prt PrtService or PrtGroup object or by setting the ID to a known group ID From a region object you can obtain a list of all items within the region You can also locate an item which will return all instances of the item within PRT Region Priltem This object contains a configured PRT Item Item status and attributes may be accessed via this object PrtAttribute This object contains an attribute for a PRT Item GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 3 Prt GetGroupList Method Syntax Prt GetGroupList Description Gets a list of all PRT groups After calling the method the GroupCount and Group routines may be used to access the
329. retrieve a list of all items of a particular item class in a Tracking Region Example Dim Region as new Prtregion Region Id PRODUCTION Region ItemClassId CARRIER Region GetItemList Get a list of items with an item class id CARRIER from the region PRODUCTION and display them one by one in a message box Region ItemClassId CARRIER Region GetItemList for j 0 to Region ItemCount 1 MsgBox Region Item j ItemId next J PrtRegion ltemCount Property Read syntax PrtRegion ItemCount Description Integer property to get the number of items find by a previous Get ItemList or Locateltenm call Example Dim Region as new PrtRegion Region Id PRODUCTION Region GetItemList Get all items in a region and delete those items with a specific ItemTypeld For 1 0 to Region ItemCount If Region Item i ItemTypeId MARKVII then Region Item i DeleteItem i PRI_DELETE Obsolete Type End If Next i GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 53 PrtRegion ltemType Function Syntax PrtRegion ItemType index PrtRegion ItemType itemTypeld Description Returns an Prt ItemType object accessed by a particular index or itemItemId The Region ItemType index object supports the properties Id and Count Example Dim Region as new PrtRegion Region id Schedule Display Id and Number for all Item Types in a region EO Jy S U
330. ring the validation process In case the region validation process fails this will probably be as a result of bad read or no read the solution should provide a way of forcing the system to validate itself again This is usually needed in combination with the Manual Entry 1 The mechanism can either be automatic via a heartbeat or manual If the users confidence in readers are high or they are planning a different behavior in case of a no read users can set up the system so that reader value can play the role of validation trigger as well In this case it is users responsibility make sure that no read cases are handled Sequence of Events for Region Validation An assumption for this system is that there can only be one carrier between the reader and the head of the region when PRT is triggered for the existence of a carrier at the head of that region This will eliminate the timing problems that can arise in different circumstances Please refer to Figure 2 while the events in this section are described A carrier passes by the reader at the head of a region The value of the read if there is any is copied to a device point configured for that reader 1 This value is then copied into a derived point of type Equation with override for the reader 2 At this point please note that equation with override derived point types are only available for analog points This design allows the users to configure analog points for the rea
331. ription Integer property to get the number of Groups found by a prior call to GetGroupList Example Dim ServiceA as new PrtService ServiceA Id SERVICE_A Get a list of groups in the service and display them one by i one in a message box ServiceA GetGroupList for j 0 to ServiceA GroupCount 1 MsgBox ServiceA Group j Id next jJ Appendix E Basic Control Engine Extensions for Production Tracking E 67 PrtService Id Property Read Write Syntax PrtService Id Description String property to get or set the Service ID associated with the object Example Dim ServiceA as new PrtService ServiceA Id SERVICEA DC Get a list of groups in the service and display them one by one in a message box ServiceA GetGroupList Lor Fq S 0 tO Servi ceA GroupCount 1 MsgBox ServiceA Group j Id next J PrtService ltem Function Syntax PrtService Item index Description Returns an Item at the specified index from the list which was found by a previous call to GetItemList Example Dim ServiceA as new PrtService ServiceA Id SERVICEA DC Get a list of items in the service and display them one by f one in a message box ServiceA GetItemList for j 0 to ServiceA ItemCount 1 MsgBox ServiceA Item j Id next J E 68 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtService ltemClasslid Property Read Write Syntax PrtService ItemClassIid Description String property to set or g
332. rocess CTI_RP to receive updated PRT data The point RSP_POINT_2 will be used to send responses The response point will contain the value of the PRT REFERENCE _ID field as well as either the text value SUCCESS2 for a successful transaction or the text value FAILURE2 for an unsuccessful transaction Items not found in inventory which have an item type of 25 will be added to the R1_BOX region No moves are allowed on existing items The first response received when CTI_RP is started and when RCV_POINT_2 transitions from unavailable to available will be ignored The point RCV_POINT_3 will be used by the CTI process CTI_RP to receive updated PRT data The point RSP_POINT_3 will be used to send responses The response point will contain the value of the PRT_ITEM_ID field as well as either the text value SUCCESSS for a successful transaction or the text value FAILURES for an unsuccessful transaction Items not found in inventory will NOT be added Existing items that are not already in the R1_BOX region will be moved to the R1_BOX region The first response received when CTI_RP is started and when RCV_POINT_3 transitions from unavailable to available will be ignored F 10 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F The point RCV_POINT_4 will be used by the CTI process CTI_2_RP to receive updated PRT data The point RSP_POINT_4 will be used to send responses The response point will contain either th
333. roviding an Item s location data Except for production start and production stop Tracking Regions the exit transition indicator for one Region must always be configured to be the entry transition indicator for the destination Region in the production line An Item tracked by PRT must always reside in a Tracking Region Each tracking region must be associated with a primary and a secondary type The following Region types are supported Primary Region Types secondary Region Types Pool Tracking Normal Tracking Sequential Tracking Combine Items Tracking Shifting Tracking Disperse Items Tracking Primary Region TypesSecondary Region TypesPool Tracking A Pooled Tracking Region does not process Items in any particular order The first item into the region is not necessarily the first item out Items must be positively identified in order to be tracked through a Pool Tracking Region Configured Tracking Regions may or may not map directly to physical locations on the factory floor If a void exists between two configured Regions in the factory a Pool Tracking Region must be configured to exist between those two Regions Note Regions of tracking type DETAINMENT are treated as Pool Regions Sequential Tracking A Sequential Tracking Region maintains the relative sequence of the Items within the Region Therefore the first Item into the Region must be the first Item out otherwise a tracking exception condition occurs generating an al
334. rt an Item to be Tracked This command provides a mechanism for inserting an Item into the Tracking Region queue If an Item is to be inserted into the queue at a particular location other than at the head or tail of the queue the region location of the Item it is to be inserted ahead of is specified i e specifying region_loc 1 is equivalent to specifying region_loc FIRST Defined constants are provided to indicate that the item is to be added either at the head or at the tail of the queue The region location can be specified as FIRST or also as EXIT to insert the Item as the first head Item in the queue i e this Item will be the next Item to transition out of the queue LAST and ENTRY are provided to insert the Item as the last Item at the tail of the queue BEHIND all other Items The fields in this record are char record_type 3 COR_BOOLEAN ext_proc_flag char region_id 17 COR_I2 region_loc char item_id 21 char reference_id 21 char item_type_id 17 char parent_item_id 21 COR_U4 item_status COR_BOOLEAN ext_hold_active char group 10 a7 COR_BOOLEAN int_hold_active char int_hold_reason 41 char comment 41 char user_or svc_id 33 INS If TRUE get all info from ext process for serialized item Region where the item is to be added to the queue or production start is to begin Location of the Item that the inserted item is to be inserted in front of nearer to exiting the queue Unique id
335. rtGroup ExtHoldReason Description String property contains the reason for setting External Hold for this Tracking Group Example Dim prt as new Prt Get a Laist Of groups from PFRI sand display their External Hold status bit Reasons one by one in a message box prt GetGroupList LOG J e 30 Or pee sGroupCoume 1 MsgBox prt Group j ExtHoldReason next J Appendix E Basic Control Engine Extensions for Production Tracking E 15 PrtGroup GetltemList Method Syntax PrtGroup GetItemList Description Gets a list of all items in the Tracking Group On return the total item count can be obtained from PrtGroup ItemCount and the individual items may be accessed via the Prt Group Item function To get the item list for a particular item class set PrtGroup ItemClassId to the desired item class id before calling PrtGroup GetItemList See PrtGroup ItemClasslId for more details Example Dim main as new Prtgroup Mein Ld MAIN Get a list of items from group MAIN and display them one by one in a message box main GetItemList FOr FT U LO Main PbemCount 1 MsgBox main Item j ItemId next J PrtGroup GetRegionList Method Syntax PrtGroup GetRegionList Description Gets a list of Tracking regions contained in the Tracking Group On return the total number of regions can be obtained from Prt Group RegionCount and the individual items may be accessed via the Prt Group Region function Example
336. rtItem RegionId Description String property to set or get the Region ID of the Item Setting the Region ID is not updated into PRT until the Item is modified Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM RefId RefNUMS NEWITEM NEWITEM NEWITEM NEWITEM Upload NEWITEM Appendix E Basic Control Engine Extensions for Production Tracking ItemId IDNUMS Groupld Groupnames RegionId Regnames RegionLoc PRT_LAST NEWILTEM NEWITEM NEWITEM NEWITEM IntHold false ExtHold false ItemTypelId TYPES Status 0 to Tracking Database Add E 41 Prtltem RegionLoc Property Read Write E 42 Syntax Point RegionLoc Description Integer property to set or get the location of the Item in the region Setting does not update PRT until the Modify method is invoked Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM NEWITEM Upload NEWITEM CIMPLICITY HMI Tracking Operation Manual July 2001 ItemId IDNUMS RefId RefNUMS Groupld Groupnames RegionId Regnames RegionLoc PRT_LAST Inc OwG renee ExtHold false ItemTypeId TYPE NEWITEM Status 0 to Tracking Database Add GFK 1216F Prtltem RemoveAttr Method Syntax PrtItem RemoveAttr attrib Description Removes an Attribute from the Item If the Attribute is not found
337. rt_api_unload_grouplist 5 45 prt_api_unload_itemlist 5 37 prt_api_unload_regionlist 5 41 prt_assoc 4 23 prt_att_pt 4 27 prt_attributes cfg 4 32 prt_disp_pt 4 26 PRT_EXPORT 4 67 ALL 4 67 DSP 4 67 GRP 4 68 Input file format 4 67 Output file format 4 69 REG 4 68 Running 4 69 SVC 4 68 prt_group 4 12 prt_grp_reg 4 17 PRT_IMPORT 4 53 ADD 4 55 Add an item attribute 4 56 Add an item to be tracked 4 55 ADV 4 55 Advance an item along a specified route 4 55 Apply a group hold on an item 4 57 ATT 4 56 Clear location 4 56 CLL 4 56 DEL 4 57 Delete a tracked item 4 57 DSP 4 57 Index v Enable disable region setpoint 4 61 File naming conventions 4 53 HLD 4 57 Import file format 4 54 Initiate a production start 4 62 Initiate a production stop 4 63 INS 4 58 Insert an item to be tracked 4 58 MAT 4 59 MOD 4 59 Modify a tracked item 4 59 Modify an item s attributes 4 59 Modify region status 4 61 MOV 4 60 Move an item from source to destination region 4 60 Print message to terminal 4 57 Program elements 4 53 PTS 4 61 REG 4 61 Running 4 64 STP 4 63 STT 4 62 prt_intproc 4 11 prt_inv_type 4 22 prt_item_typ 4 18 prt_reg_att 4 30 prt_region 4 13 prt_route 4 19 prt_service 4 9 prt_stnd cfg 4 34 prt_sysdef 4 8 prt_type_trn 4 21 prt_window cfg 4 36 PrtAttribute object description Basic control engine E 3 PrtAttribute Id property read write E 11 PrtAttribute Value property read E 12 PrtCh
338. rty contains the attribute name of an Item ID Example Dim prt as new Prt Get a list of items from PRT and display the first item s i attribute names and values one by one in a message box prt GetItemList for 7 0 gO pre feem 0 ACCC Count 1 MsgBox prt Item 0 Attr j Id amp amp prt Item 0 Attr j Value next J Appendix E Basic Control Engine Extensions for Production Tracking PrtAttribute Value Property Read Syntax PrtAttribute Value Description String property contains the attribute value of an Item ID Example Dim prt as new Prt Get a list of items from PRT and display the first item s attribute names and values one by one in a message box prt GetItemList for FT 0 LO pre vem 0 ACCECoune al MsgBox pri lt DLem 0 ALTLr 7 1d 6 prix tiem 0 ALCI 7 Value next J E 12 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F PrtCheckRoute Method GFK 1216F Syntax PrtCheckRoute sourceRegionld destRegionld itemtypeld Description Validates that an Item of a specific type is configured to move from a Source Tracking region to a Destination Tracking Region Route validation is performed locally by the API from configuration information that was read into the API s internal schema during initialization If success the routine returns If failure an error is generated and should be caught using the on error goto syntax Comments Paramete
339. ry depending on the file being edited enter values appropriate for the file Cannot exceed the specified size of the field Do not support embedded spaces use underscore _ character instead Exception Text or description fields support embedded spaces Empty fields are supported but must be delimited in the record Must be less than or equal to 2000 characters Includes all continued lines in the record Character fields are blank padded automatically when the value is less than the field size Numeric fields are zero filled automatically when the value is less than the field size Physical line length Must be less than or equal to 250 characters CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configuration File Format When the ASCII text version of the file is viewed in a text editor you will notice that they all have the same basic format The example below provides a detailed look at the format of a configuration file Name of the record Reserved characters Comments that describe delimiter continuation amp each field in sequential comment order in the record pet_Htem_typ ict Notepad IDT F a generated f i Ji TECHED PRT ITEN T F Production Tracking ITEM_T YPE_IDB Unique ID for Item Type item type code Unigue code for Item Type used by PRT item type desc Item Type Description item tracking type Tracking type code i ser 2 nenser item class id Item Class Identif
340. s Scrolls to the previous page inthe report Closes the print preview window Previews two pages of the report ane PRT LI bE Fanuc Aabomahon Mode ALGELLS1 Region DEV Mum Berns 4 Location Mod Tine 1 6039 1358 21 1 BASS 1358 21 2 6039 1459 10 3 BASS 13 59 24 tem ID term Type Reference IO Eniry Time GK TEDD PAINT BOSS 1458 71 CAR BOSS 1397 59 ELPU BASS 135910 BHW 1359 24 3 The button bar at the top of the window performs the following functions Click To Print Print out the report as it is displayed in view Next Page Go to the next page of the report Prev Page Go to the previous page in the report Two Page View two pages in the viewing area Zoom In Enlarge the view on screen Zoom Out Reduce the view on screen Close Exit print preview and return to the PRT window i Tip If there is too much or not enough information in the report use the View drop down list to select another file configuration If the information is not displayed properly or the way you want it go to Print Setup to adjust the settings GFK 1216F Using the Production Tracking Window 3 33 Procedure to Print a Report 44 To print a report 1 Click File on the menu bar 2 Select Print option to open the Print dialog box ki WALEDEVO2 abel by computer room Propast Hesdy HF Lesat 4000 Senses POLE by compia oom c T C Paps pow 1 kl Select appropriate Specify the print
341. s See Static Information Requirements Input Arguments Src reg 1d Source region id region the item is moving out of required dest_reg_id Destination region id region the item is moving into required comment Comment to be recorded in PRT history log file optional user_or_svc_id User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Output Arguments retstat Pointer to COR_ STATUS structure Return Value Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes All error codes returnable by prt_api_move_item Production Tracking Application Interface 5 77 5 78 prt_api_region_setpoints Enable Disable Tracking Region Setpoints Name prt _api_region_setpoints Description This routine provides a mechanism for enabling and disabling the Item transition setpoints configured in the PRT Tracking Route records These points are set by PRT when an Item transitions into the configured destination region Syntax int prt_api_region_setpoints region_id enable_setpt_flag comment UuSer oT svc 7d retstat char region_id PRT_REGION_ID_LEN 1 COR_BOOLEAN enable _setpt_flag char comment LSC DESCRIPTLON LEN t 113 char user OF Svc 10 SERVICE LD_ EN F LIF COR_STATUS retstat Data Structures See Sta
342. s required For non serialized items a specific region location must be specified For serialized items the constant ALL_LOCATIONS may be used This indicates that the item may reside at any location in the region Item type identifier required for non serialized item optional for serialized items Item status optional Comment to be recorded in PRT history log file optional User or service identifier optional If TRUE item held due to internal hold optional Comment specifying reason for internal hold required for activate does not apply to deactivate Pointer to COR STATUS structure Either COR_SUCCESS COR_WARNING or COR_FAILURE If the function returns COR WARNING or COR _ FAILURE additional error information can be found in the COR_ STATUS structure Error Codes PRTC_INVALID_ITEM_TYPE PRTC_CANT_MATCH_BOTH PRTC_ITEM_NOT_FOUND PRTC_REF_NOT_FOUND PRTC_BAD_REG_SPEC PRTC_BAD_REG_LOC_SPEC PRTC_ITEM_STAMP_TOO_NEW Invalid item type specified Warning Item XREF entry mismatch Warning Item ID not found Warning Reference ID not found Warning Bad region specified Warning Bad region location specified Warning An affected item has changed since the last display Warning CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F PRTC_NO_ITEM_AT_LOC Specified item not found specified location Warning PRTI_CANT_MOD_ITEM_REF_IDS Can t modify both item amp ref ids Warni
343. s Top to bottom ae PAT_UI GE Farnwe Aubhomation gan a soi to the configuration Deletes a project from the configuration Closes the dialog box Fie Bip i J Dy gt vit J s j Pigac ei abe TAACKFAO ACTIVE PE ACTIVE Regen Sbatu Filter bee Narn D Important If you want to move items across project boundaries you have to do additional PRT startup configuration See the appendix Configuring PRT Client Setup in this manual for details CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F Procedure to Add a Project J4 To add a project to the PRT L Click Add The Add Project dialog box opens Add a project Progeacis Banis B Add Piga Marne Pigeg Siaha TAACKIPAO ACTIVE Delete PE ACTIVE Hild Piopect POWERLINE S000 H ESOO Select the project you want to add from the Project Name drop down list Click OK to accept or Cancel to cancel the operation Click Close in the Projects dialog box A message box will display asking if you want to save your changes Click Yes to save your changes in a file and proceed to the Save As dialog box Note Click No to cancel the operation Navigate to the appropriate directory in the Save As dialog box Click Save to save your configured file Result The project is added to your configured file Using the Production Tracking Window 3 11 Procedure to Delete a Project
344. s added to a shifting region and its location is other than the end location then the last item in the region is moved to the configured detainment region if not configured it is deleted All the items from the added location to the end location are shifted one location towards the end location If the last item was a blank item then it gets dropped instead of moving into the detainment region If the configured detainment region is a shifting region then the item at the last location _is not moved to detainment region but is deleted A configured detainment region should never be a shifting region However if a new item is added at the end location then the head item first location in the region is moved to the configured transition region if not configured it is deleted and all items are shifted one location towards the head location C 6 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Inserting an Item into a Shifting Region GFK 1216F When a new item is inserted into a shifting region and the insert location is other than the end location then the last item in the region is moved to the detainment region if configured otherwise it is deleted and all the items from the inserted location to the end location are shifted one location towards the end location Jf the last item was a blank item then it gets dropped instead of moving into the detainment region However if a new item is inserted at the end locati
345. s been modified Unique identifier of the tracking region Tracking Region status code e g IN LOCKED OUT LOCKED FULL OUT OF SEQ Comment to be recorded in prt history log file User or service identifier 4 61 STT Initiate a Production Start Provides a mechanism to initiate a production start for an item in a tracking region The fields in this record are char record_type 3 STT BOOLEAN ext_proc_flag If TRUE get all info from extprocess for serialized item char region Gadafi Region where the item is to be added to the queue or production start is to begin Char 1cemo1d 21 Unique identifier of a serialized item char 2eferen e 1d 21 Secondary identifier of a serialized item char item type idir Item type identifier char parent_item_id 21 Associated serialized item identifier COR_U4 item_status Hexadecimal representation of desired item status COR_BOOLEAN ext_hold_active If TRUE item held due to external hold ehar group_1d 17 identifier of the Tracking Group providing the reason for the hold COR BOOLEAN int hold ative If TRUE item held due to internal hold char int_hold_reason 41 Comment specifying reason for internal hold char comment 41 Comment to be recorded in prt history log file Chay User or sve 10 33 User or service identifier If no Item Attribute information is to be specified in the production start for an item the STT record need not be preceded by any ATT records for fill
346. s the error codes returned by Production Tracking Appendix B Event Codes for Interested Process Updates Documents the event codes available for interested process updates Appendix C PRT Rules and Assumptions Documents the general rules and combined and dispersed items tracking region rules Appendix D Using the Global Verifier Instruction for using the global verifier to validate and repair global sections used by Production Tracking Appendix E Basic Control Engine Extensions for Production Tracking Discusses the Basic language extensions available for Production Tracking in the Basic Control Engine Appendix F Configurable Tracking Interface Details the information necessary to configure and use the Configurable Tracking Interface CTI Appendix G PRT Logging Configuration Documents the configuration for ODBC data logging of PRT information iii Appendix H Configuring PRT Client Startup Documents the configuration files that must be modified in order to have the PRT Client application start when CIMPLICITY starts Appendix I Attribute Counts by Region Provides a sample Attribute Counts configuration file Appendix J Troubleshooting Describes the PRT Interested Process Utility CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Related Publications GFK 1216D 3 Contents For more information refer to these publications CIMPLICITY HMI Plant Edition Tracker Getting Started Guide GFK 169
347. s_arc Datoh pr 7d Glome EA table_type space_rollover gated_rollover redund_ rollover rollover dev rollover_space gate_point gate_condition rollover units rollover_period rollover_time rollover_export rollover_purge rollover_exec export_file purge_file export_format purge_format export range purge_range sql_command OnNnaA oF WNEF OO WWWWWWNNNNNNNNNNFF FFF FF FFF Gi Bs UNEBPEeEODOLR RPLON CAUA od INS I We 300 sd GS Oe BS UNEO log file name Owner service max size of a max number of threshold for id for the file record in bytes records before rollover alarm generation number of records to keep on rollover TRUE rollover TRUE rollover TRUE add time on number of records logged on time_of_day sync time stamp to each log entry DOS cmd to execute on rollover TRUE rollover on timed basis periodic two character archive id TRUE compress archive file batch point id associated with log file Database in DBMS DEF file one of A D G X indicating log type TRUE 32C roblover on disk 2a TRUE 28 FOlbOver On Qigital porn TRUE 26 rollover omn redundant Cransiti10n device to eneck tor disk iui Kimie ae KD for disk full rollover point to gate rollover 1 HIGH 2 LOW 3 TRANSITION 5 DAYS 4 HOURS 3 MINUTES frequency for periodic rollover time Lor synch rollover in min from 0020 O none l all 2 count 3 time O none l all 2 count 3 time 5 exptal O none 1 SQL 2 DO0OS 3 both export
348. sage box Dim DestRegion as new PrtRegion DestRegion Id Region_Name Replace Region Name DestRegion GetData If DestRegion StatusBit PRT_REGION_FULL Then MsgBox Region Full Else MsgBox Region Not Full Bod LT GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 63 PrtRegion StatusPointid Property Read Syntax PrtRegion StatusPointId Description String property to get the Point ID configured to contain the status point for the region or an empty string if the status point is not configured for the region Example Dim Region as new PrtRegion Region Id PRODUCTION Get the name of a region s status point and display its contents in a message box StatPtIds Region StatusPointId Et State telco Ao 4 Ener msgbox Status amp PointGet StatPtId Else MSD NO pOLme COnN toured End If PrtRegion Totalltems Property Read Syntax PrtRegion TotalItems Description Integer property to get the total number of items in the region Example Dim Region as new PrtRegion Region Id PRODUCTION Get a region s data and display the total number of items it i contains in a message box Region GetData msgbox Region amp Region id amp contains amp Region TotalItems amp items E 64 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F syntax PrtRegion TotalItemsPointIid Description String property to get the Point ID configured to contai
349. seeeeeeeeeeeeeeeaas E 57 Prekecion Moddiy Method ecrane A tassauanet nasteanaesoneet E 57 PrtRegion ProjectId Property Read Write ccccccesssssssssseeeeeceeeeeeeeeaaaaeesseeeeeeeceeeeeeeeeeaaas E 58 PreRee ons Reorder UVC HOG Teaia a A a eases E E 59 PriResion SetPoints Method Kisise on E E 60 PtResion SetStams Bit Method iana r a E E A E E AE AE E 61 PrtRegion Status Property Read Write 0 0 cccccccccssssssesseseeecceeeeeeeeeeeaaassseeseneeeeeeeeeeeeeeeaaaas E 62 PAReSioOn S s BIC MEMO ariaa in e E EEEa E 63 PrtRegion StatusPointId Property Read cccesssessssseeeececeeeeeeeeeaeaeesessseeeeeeeeeeeeseeeeeanaas E 64 Prikesion I otalltems Property Read svsstsvcsisescascantatrsattenlenshote ee nonsiawabar testes sas veabutagsvenoesies E 64 PrtRegion TotalltemsPointId Property Read Write cccccccccssssssssesseeeeceeeeeeeeeseeeeaaas E 65 Prtservice GetGroupkist Method naasna ra a Maletncieadaiteneseducomece E 65 PriService Gete mk 160 Method We sissies eo sen das a E yew ue cased atv oseatend oad vee meatier E 66 Priservice GetRecionlast Mein saiisine areni sacs aa aae aeeai E 66 PrtService Group FUNGON saersi rieni eean EEE AR EEE Eaa i E 67 Priservice GroupC ount Property Read sess sescacundacsateaxcncasttcadvasnaves naine A E IREE E 67 PrtServyice Id Property Read Write enina e aieiessaadonieatvaess E 68 PrtService ltem Funcion ened ae a T A a a a E 68 CIMPLICITY HMI Tracking Operation Manual July
350. specifically the region status Syntax int prt_api_modify_region status_bitmask region_id region_status comment user Or svo id retcstar COR U4 status_bitmask char region_id PRT_REGION_ID_LEN 1 COR UA region_status char comment SC DESCRIPTION EEN P leis Char user Or Sve 10 SERVICE TD DEN LIS COR STATUS retstat Data Structures See Static Information Requirements Input Arguments status_bitmask Indicates the bit positions in the region_status that are to be modified required region_id Region identifier required region_status Tracking Region status code e g IN LOCKED OUT LOCKED FULL OUT OF SEQ optional comment Comment to be recorded in PRT history log file optional user_or_svc_id User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Output Arguments retstat Pointer to COR_STATUS structure Return Value Either COR_SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTC_BAD_REG_SPEC Bad region specified Warning PRTI_REG_ID_NULL Region identifier NULL Warning PRTI_REG_ID_NDEF Region identifier not valid Warning PRTI_MF_INIT_ERR Error initializing segment Failure PRTI_CRESEG_ERR Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd 5 70
351. specified Failure Specified item not found specified location Failure Must specify region location to delete non serialized item Failure An affected item has changed since the last display Failure Region identifier NULL Warning Region identifier not valid Warning Invalid region location Warning No service specified via region_id Warning Error initializing segment Failure Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd GFK 1216F Production Tracking Application Interface 5 27 5 28 prt_api_locate_item Locate Serialized Item Name prt_api_locate_item Description Syntax This API provides a mechanism for locating a Serialized Item within all configured PRT services a specific PRT service a specific Tracking Group or a specific Tracking Region If the Item is located the Item Tracking Data is returned to the calling routine with a return status of COR_SUCCESS If the item was located in more than one tracking region the first location is returned in the initial call Successive calls to this routine return the item s additional locations When the list of locations is complete the routine returns COR _WARNING with the additional information in the COR _STATUS structure If the Item was not located the calling routine receives back a status indicating the request failed int prt_api_locate_item prt_svc_id group_id region_id item_id reference
352. ss Production Tracking Overview 2 9 Serialized Items When a serialized Item is started through the production process PRT requests the Item type status and attribute data Once the Item is started through the production process tracking data is then collected and logged PRT will process Items differently depending on the method used to start production If production start is originated by a CIMPLICITY Point configuration data determines if Production Tracking will request an external process for additional information Manual transaction or an application interface message additional tracking data may be included in the message Also an external process may be queried for additional information The following guidelines apply to serialized Items Each serialized item is assigned a unique Item ID They can also be identified and tracked by a reference ID A reference ID acts an alternate key to locate the Item and Item ID The reference and Item IDs can be automatically associated through configuration data Reference and Item IDs can only be associated when an Item is positively identified by a transition indicator ACIMPLICITY Point must be configured to report the reference ID through the transition indicator Reference and Item IDs can also be associated through an application interface message Using Item Classes Item classes are a way of grouping together item types in order to further
353. ss just completed Details of the bits are given in the following table Number of times the region validation is triggered Current Region Invalid count Region is Invalid if this count is greater than 0 Number of times the region has become invalid Number of times the region is double triggered Triggered multiple times with the same read while the head is validated Number of times head of the region did not match the reader value Consecutive mismatch count Number of times region validation is triggered with no new read Consecutive no read count GFK 1216F GFK 1216F MODIFY_MASK Bits The first element of the statistics point contains information about the validation process just performed This information is in the form of bits that are described below Bit 0 27 28 29 30 31 Field HEAD_ITEM_ VALID TOTAL_VALIDATIONS_ MOD INVALID_ COUNT_MOD TOTAL_BECOMING_INVALID_MOD TOTAL_DOUBLE_TRIGGERS_MOD TOTAL_MISMATCH_MOD CONSECUTIVE MISMATCH _MOD TOTAL_NOREAD_MOD CONSECUTIVE NOREAD MOD RESERVED_READ STATS RESET NEW_ITEM REORDER MOVE Configuration File Guide Description The Head Item of the region was valid when the point was set Statistics array point s value at index has been modified Statistics array point s value at index 2 has been modified Statistics array point s value at index 3 has been modified Statistics array point s value at index 4 has been m
354. ssage box Region GetItemList EO FJ 0 Tto Region TbemCoune 1 MsgBox Region Item j ItemId next J PrtRegion Modify Method GFK 1216F Syntax PrtRegion Modify comment userld Description Sends the modified status mask to PRT Comments Parameter Description comment String Optional A comment to be written to the PRT log file userld String Optional The User ID to be written to the PRT log file Example Dim Prt as new Prt ns 17 Get a list of items from PRT and initialize a particular status bit for each one Prt G amp etRegionList tor J 0 TO prt eemC ounit 1 Prt Region j ClearStatusBit n Prt Region j Modify next jJ Appendix E Basic Control Engine Extensions for Production Tracking E 57 PrtRegion Projectid Property Read Write syntax PrtRegion ProjectId Description String property to set the project that subsequent Production Tracking extensions will communicate with Example dim prt as new PrtRegion Get a list of services from PRT and display them one by one f in a message box ortProJectrid TAyprojecti prt GetItemList for 7 0 Go pre leemeount 1 MsgBox prt Item j ItemId next J E 58 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtRegion Reorder Method Syntax PrtRegion Reorder reorderArray comment userld Description Reorders the locations within a tracking region This has the effect of moving all the i
355. sted and the event flag remains low The messages which are read are placed into one of two lists one containing errors messages and the other containing valid requests If there are any messages in the error message list these are always returned before the valid requests Syntax int prt_api_get_req req_type req_info retstat GOR U2 req type PRT REO INFO_PTR reg info COR STATUS retstat Data Structures typedef struct char Del SVe6r3 0 SERV LCE LD LEN f TE PR 2ery nee id char group id PRT REGION TD LEN fF TJ Group 2d char Liem Ia PRT TTEM ID LEN FP Li Iten ad char reference id PRT ITEM ID LEN 1 reference id COR _ BOOLEAN ext _hold_active TRUE if HOLD active k JPR REO TNE O PRI REO INFO PTR Input Arguments None CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F GFK 1216F Output Arguments req_type Request type req_info Information contained in request retstat Pointer to COR_STATUS structure Return Value Either COR_ SUCCESS COR_FAITLURE or COR_WARNING If the function returns COR WARNING or COR_FAILURE additional error information can be found in the COR STATUS structure If there are no requests pending the function returns COR_WARNING with the COR_STATUS err_code set to PRTI_LNOTHING_PENDING Error Codes PRTI_NOTHING_PENDING No requests pending Warning IPC_ERR_PARTDEAD Partner Dead Warning PRTI_UNKNOWN_INIT_SRC MF_INIT segment rece
356. t for each one prt GetItemList Ome i 0 tOo pre lcemnCount 1 prt Item j ClearStatusBit n Pre eem 4 Modify next J E 34 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prtitem ModifyTime Property Read GFK 1216F Syntax PrtItem ModifyTime Description Date property contains the time at which the Item was modified When the user modifies the Item PRT checks this modify time against the last modify time of the Item If the modify time is older than the current modify time of the Item in PRT PRT will not allow the user to change the Item This is to prevent two processes from modifying an Item without each being aware of the other s modification To override this behavior call ClearModifyTime which will disable this checking Example Dim Region as new prt Region Region Id Detainment Get a list of items in a region and display their modify times l one by one in a message box Region GetItemList For j 0 to Region ItemCount msgbox Region Item j ModifyTime Next Jj Appendix E Basic Control Engine Extensions for Production Tracking E 35 Prtltem MoveTo Method Syntax PrtItem MoveTo destRegionld destLoc insertFlag comment Description Moves an item from its current location to a new location in a region could be the same region Comments Parameter Description destRegionld String Destination Region ID The source Region ID is contained in the item object
357. t to run the PRT_UI Note All of the above files have a dat extension with the exception of the last two which have a cfg extension Files with a dat extension are binary files with a cfg extension are in text format GFK 1216F Configuration File Guide 4 3 Use the IDTPOP Utility In order to edit the binary coded configuration files they must be converted to a format that can be edited The IDTPOP Utility enables you to convert the binary code to ASCII format and edit using the text editor of your choice J17 To convert files to ASCII format using IDTPOP 1 Click Tools on the CIMPLICITY Workbench menu bar Select Command Prompt to open a DOS window On the Command line type cd master Press ENTER to switch to the Master directory Type idtpop lt filename gt e g idtpop prt_region Press ENTER Result An indication of the number of records processed will display and the file will be converted to ASCII text ov at a oe Project Workbench i GE_APPLIANCE get CIMPLICITY Workbench aS 4 a 1 cor lt P an MS DOS Window n Ein Loa HA Ponts COMIN T gehen J2 ai a See icregok tH Windows MICTA2 J aoup C2 Copyright TFH S 199h Aicroteafet Corp m Chali eter tha eee i ae eee C APLICITY AAI projectsGE_Appliance Yed Aude uaj ohare Del AFGI CGI T YAA pro jects YGF Appliances tes idt pep pet _Pe al ee i ie ie a ee Ef arate loading rec definition PHT_REGI OR reanucet
358. tHold E 32 PrtItem IntHoldReason E 33 PrtItem Itemid E 30 PrtItem ItemTypeid E 7 E 18 E 29 E 34 E 53 E 69 PrtItem ModifyTime E 35 PrtItem ParentId E 37 PrtItem ProjectId E 40 PrtItem RegionId E 41 PrtItem RegionLoc E 42 PrtItem Serviceld E 43 PrtItem Userld E 46 PrtRegion Capacity E 47 PrtRegion Id E 52 PrtRegion ItemCount E 53 E 57 PrtRegion ItemT ypeCount E 54 PrtRegion Loc E 56 PrtRegion Status E 62 PrtRegion StatusPointId E 64 PrtRegion Totalltems E 64 PrtRegion TotalltemsPointId E 65 PrtRegionProjectId E 58 PrtService GroupCount E 67 PrtService Id E 68 PrtService ItemCount E 69 PrtService RegionCount E 71 PRT Attribute Labels 4 32 PRT Display Point 4 26 Index iv CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PRT Group 4 12 PRT Group Tracking Region 4 17 PRT Interested Process 4 11 PRT Invalid Type 4 22 PRT Item Association 4 23 PRT Item Type 4 18 PRT Item Type Translation 4 21 PRT macros About 6 1 PRT object attributes Basic control engine extensions E 2 PRT object model Basic control engine extensions E 1 Prt object description Basic control engine E 3 PRT Region 4 13 PRT Region Attribute Counter Definitions 4 30 PRT Region Item Attribute Display Point 4 27 PRT Route 4 19 PRT Service 4 9 PRT Standby Process 4 34 prt status 4 24 PRT Status 4 24 PRT System Definitions 4 8 PRT Window 4 36 Prt GetGroupList method E 4 Prt GetItemList method E 4 Prt GetRegionList method E 5 Prt G
359. tId which then become available through the object Example Example of PrtRegion StatusBit Function using a constant to f get the Region Full status bit and display it s status in i a message box Dim DestRegion as new PrtRegion DestRegion Id Region_Name Replace Region Name DestRegion GetData If DestRegion StatusBit PRT_REGION_FULL Then MsgBox Region Full Else MsgBox Region Not Full End If E 50 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F PrtRegion GetltemList Method GFK 1216F syntax PrtRegion GetItemList Description Retrieves a list of items for the current region Comments If you call PrtRegion GetItemList before setting PrtRegion Loc you get the item list for all locations To get the item list for a current region location set PrtRegion Loc to that location number before calling PrtRegion GetItemList If you want to get the item list for all locations and Prt Region Loc currently contains a location number set Prt Region Loc to PRT_ALL_LOCATIONS before calling PrtRegion GetItemList To get the item list for a particular item class set PrtRegion ItemClassTId to the desired item class id before calling PrtRegion GetItemList See PrtRegion ItemClassId for more details Example Dim Region as new PrtRegion Region Id PRODUCTION Region GetItemList Get all items in a region and delete those items with a specific ItemTypeld For 1 0 to Region ItemCount 1 If Re
360. tatusBt Method kea na E E tas EE AA eA ERANI E 44 Pril Status Property Read Write canissuswentescacesPaanainsseecadeuiadebnas En ine A E Ea E 45 Prie Sta BIENON a a e Sine E T E 45 PrtItem Userid Property Read Write Janien aen e aa a eat E 46 PrtRegion AdvanceModel Method ccccccccsccssssssesseeeeeeceeeeeeeeeeeaaeessesseeeeeeeeeeeeeeeeeeaas E 47 PreRevion Capacity RrOperty RAG anoen a SaonSuaiaesaaieh enamasncd aveceh bcondeaieacenehleonanates E 47 PriKesion C learStatusBit Method seiss ciiiorn vei bconintavienoaanieeas E 48 Prekesion Delete ltemy Method eiee a a aar A ss taste E Ea E 49 Prikesion GetData Method j rriren AE e E E EAE EREE E 50 PrReo1on Getiteml 1st C VICIhOG koison a AT E 51 PreResion id Property Read Write Jebedo TE A TN E 52 PrtRKecion Hem PUNCUON eieiei e r a a euseate naam ieanics E 52 PrtRegion ItemClassId Property Read Write cccccssssseceeceeeeeeceecaeeeeesseeeeeeeceeeeeeeeeeaaas E 53 PreResion temCount Property Read waste txicacampscwsiaryciasyatsaswsieh a eile hu eee getieweind Meomanatos E 53 Pr Resion Item ype FUNCTION arais cl taveb wedi a a E E E 54 PrtRegion ItemTypeCount Property Read six cavtecdsccosslehcwvdacarssbekechewansisiaciolereveiest eatebeiees E 54 Prikesion Locateltenr Method Jaise e E E A A A E 55 Pa Resion Loe Property Read Write heasnoreirnedo ao o E era Eea E 56 PrtRegion MaxLocation Property Read ccccccccccsssssssssseeececeeeeeeeceeeaaeeeesssee
361. te an error is returned to the calling routine Example Dim Region as new prt Region Region Id Detainment Get a list of items in a region and remove each of them from i tracking one by one Region GetItemList For 7 0 to Region ItemCount 1 Region Item j ProdStop Next Jj Appendix E Basic Control Engine Extensions for Production Tracking E 39 Prtltem Projectid Property Read Write Syntax PrtItem ProjectId Description String property to set the project with which subsequent Production Tracking extensions will communicate Example Dim prt as new PrtItem Get a list of services from PRT and display them one by one f in a message box prtaProJectid Tiyprojecti for J 0 foc 19 indexo Co LR prt SetAttr NAME amp indexS Val amp indexs next J Prtitem Refld Property Read Write Syntax PrtItem Refid Description String property to set or get the Reference ID of the Item Example dim NEWITEM as new prtitem Initialize the new item structure NEWITEM ItemId IDNUMS NEWITEM RefId RefNUMS NEWITEM GroupId Groupname NEWITEM RegionId Regname NEWITEM RegionLoc PRT_LAST NEWITEM NEWITEM NEWITEM NEWITEM Upload NEWITEM IntHold false EXtHold false ItemTypelId TYPES Status 0 to Tracking Database PLOCStarc CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Prtltem Regionld Property Read Write GFK 1216F Syntax P
362. tem Type Trantlation E Do TRARS LAT aL 1 tem Type Translation Id 4 input code code sent by tem type detection equip 2 itm typt id tem Type 10 for type detected HOCHAMGE j 10 WSHR_MIE 3 records created HOCHAHGE 270 YSHA_FRAPE HOCHAHGE 18 IRYER_MTR NOCHANGE 10 WSHR_MTR E Expanded view of the No delimiter first record needed after last field GFK 1216F Configuration File Guide 4 21 PRT INV TYPE The PRT Invalid Type prt_inv_type configuration file is used to specify when a configured item type is not valid for a tracking route Recall that you can use the wildcard character in the prt_route configuration file to identify the item types When the wildcard character is used you can use this file to eliminate the invalid item types from the route Each of the fields is described below complete with entry examples and a sample configuration file OPTIONAL FILE Entry No Field Name Description Data Type Example 0 orig_region_id Unique name of the region from which the item 16 PROCLNE1 type will exit characters _NOR l dest_region_id Unique name of the region where the item 16 RINSE1_NOR type may enter characters 2 item type_id Unique name of the item type that is not 16 WSH_MTR allowed to travel between the regions in characters other words the invalid item type 3 transition_ptid Point ID that represents the transition 55 PL1_RS1 between the two regions characters _TRANS Configuration Fi
363. temld String The Item ID to locate may be an empty string if refId is specified refld String The Reference ID of the item to locate may omitted or an empty string if itemId is specified NumRetries Integer optional The number of times to retry to find the item before failing If an item is in transition from one tracking region to the next there is a small period of time when it doesn t appear in either regions tracking queue Defaults to 3 if not specified Example Dim prt as new Prt Get a single item from PRT with its Reflid and display its ItemId in a message box PRT LocateItem REFNUMS MsgBox prt Item 0 ItemId E 8 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Prt Projectid Property Read Write syntax Prt Projectid Description String property to set the Project which subsequent Production Tracking extensions will communicate with Example Dim prt as new PRT Get a list of services from PRT and display them one by one in a message box PrecProvecrtia oro7ece prt GetServiceList f r J Q GO pre seervicecoune 1 MsgBox prt Service j Id next J Prt Region Function GFK 1216F Syntax Prt Region index Description Returns a region at the specified index from the list which was found by a previous call to GetRegionList Example Dim prt as new Prt Get a list of groups from PRT and display them one by one in a message box prt GetRegionList
364. tems are moved to the detainment region Enable disable 1 0 logging when a disperse tracking region is not empty and new items have arrived in the region Enable disable 1 0 logging when an item enters an IN LOCKED region or exits an OUT LOCKED region Enable disable 1 0 logging when the number of items at a single region location exceeds the configured maximum Enable disable 1 0 logging when an item enters a region with an attribute that matches an item hold specification Enable disable 1 0 logging when information cannot be retrieved for a serialized item CIMPLICITY HMI Tracking Operation Manual July 2001 Data Type One byte One byte One byte One byte One byte One byte One byte One byte One byte One byte One byte One byte One byte One byte One byte Entry Example 0 GFK 1216F No Field Name 29 log_item_scrapped 30 log_item_entry 3 log_item_exit 32 log_item_mod 33 log_prod_start 34 log_prod_stop 35 item qty_ptid 36 stat_ptid 37 region_type 38 auto_assoc_region 39 resource_id 40 cfg_override 41 alarm_oos_region 4 alarm_inval_type 43 log_inval_type GFK 1216F Description Enable disable 1 0 logging when an item has been scrapped deleted from the tracking region s queue Enable disable 1 0 logging whenever an item is entered into queue Enable disable 1 0 logging whenever an item exits the tracking queue Enable disable 1 0 l
365. tems at each location in the region to another possibly the same location in the region Comments Parameter reorderArray comment Userld Example Dim Region as new PrtRegion Region id OUTPUT Invert the items in a region Dim Array 99 as integer For x 0 to 99 Array x 100 x Next x Region Reorder Array GFK 1216F Description Array integer An integer array consisting of region locations These location numbers 1 to num_locations specify the new region location for items residing in their current location that is the locations the items are to be moved to The reorderArray array index implicitly define the current location number For example the first element in the array reorderArray 0 refers to the items that currently reside in region location 1 The value of reorderArray Q specifies the region location where the items currently in region location 1 are to be moved to This array must include elements for each location currently occupied in the region String Optional A comment to be recorded into the PRT history log file String Optional This is used for logging purposes and is optional If not supplied the host process name is used from first to last Appendix E Basic Control Engine Extensions for Production Tracking E 59 PrtRegion SetPoints Method Syntax PrtRegion SetPoints enable Description Enables or disables the item transition setpoi
366. terface The CTI received an error while attempting to obtain the logical lt LOGICAL_NAME gt Verify that the specified logical is configured properly Unexpected run time error Save the COR_STATUS LOG file and bring it to the attention of GE FANUC The specified POINT_ID is has too few elements for the field layout that is configured The field layout for response points is defined in the file CTI_PT_DEF CFG The field layout for received points is defined in the file CTI_LAYOUT CFG Fields that are specified as response point fields must be one of the fields that is defined to be received by CTI for that point F 19 Appendix G PRT Logging Configuration About PRT Data Logging PRT data logging uses the ODBC Data source configured for CIMPLICITY alarm logging Configuration consists of editing your project s datalog idt and data_field idt files see Configuration Requirements for directions on this process to create the tables and table fields necessary for the PRT attributes you wish to log PRT Logging Format The following topics cover the PRT logging format Tables The following three tables will be used to hold any logged PRT data They must be configured in the datalog idt file in order for any of their fields to be logged In application each table name will have PRT replaced with the base name of the particular PRT Service whose attributes are being logged for example PRT_GRP for a PRT system whose service n
367. the COR_STATUS structure Error Codes PRTI_PROC_NOT_CONFIGURED Process is not configured as network process Failure PRTI_FILE_OPEN_ERR PRTI_SVC_ID_NDEF PRTI_FILE_READ_ERR PRTI_EMPTY_FILE PRTI_AUX_NAM_ERR PRTI_ADD_PORT_ERR PRTI_READ_PORT_ERR PRTI_MF_INIT_ERR PRTI_CRESEG_ERR PRTI_BAD_MSG PRTI_BAD_SVC_NAME PRTI_XLATE_ERR PRTII_WRITE_PORT_ERR Error opening one of the configuration files Failure PRT service identifier not valid Failure Error reading configuration file Failure Configuration file has no records Failure Error in ipc_aux_nam Failure Error in ipe_add_port Failure Error in ipec_read_port Failure Error initializing segment Failure Error creating segment Failure Error in segment Failure Bad service name no underscore Failure Error in ipe_xlate getting physical addr Failure Error in ipe_write_ port Warn Fail CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_dyn_register_intproc Register As A Dynamically Interested Process GFK 1216F Name prt_api_dyn_ register _intproc Description This function provides a mechanism for a process to request to register as an interested process to a PRT process Either this initialization routine must be called by all PRT interested processes prior to calling any other PRT_API interested process utilities or prt_api_ register_intproc The calling routine receives back a status indicating the success or failure of
368. the user_or_svc_id field of the PRT_ITEM UPDATE STRUCT structure When prt_api_get_intproc_updates is called it empties the datagram receive buffer of all messages that have arrived since the last call to prt_api_get_intproc_updates or since the process registered as an interested process via successive reads until a read is posted and the event flag remains low The messages which are read are placed into one of two lists one containing errors messages and the other containing valid interested process update messages If there are any messages in the error message list these are always returned before the real updates Syntax int prt_api_get_intproc_updates update_type item_info reg_info retstat COR UZ update_type PRIT_ITEM UPDATE STRUCT eC CMm nios PRI REGION UPDATE STRUCT reg Iinio COR STATUS retstat GFK 1216F Production Tracking Application Interface 5 51 5 52 Data Structures typedef struct char char att_name PRT_ATTRIBUTE_LEN 1 item attribute name att_value PRT_ATTRIBUTE_LEN 1 item attribute value PRT_ITEM_ATT typedef struct long reg_entry_time COR I 2 event_code COR U2 modify_bitmask char region_1l_id PRT_REGION_ID_LEN 1 COR I2 region 1 TGG char reg ionm 2_41d PRT REGION ID LEN 1 4 COR 12 region 24 1oc COR IT item_tracking_type char item id PRI ITEM ID LEN LL char reference_id PRT_ITEM_ID_LEN 1 char item_type_id PRT_ITEM_TYPE_ID_LE
369. the PRT User interface 1 Right click the PRT User Interface shortcut on the Windows desktop A popup menu displays 2 Select Properties The PRT User Interface Properties dialog box displays 3 Select the Shortcut tab 3 Enter the switch and parameter to customize the PRT User Interface when opened In the Target field Use the following switch options Switch Parameter R lt region name gt where lt region name gt is a valid region name Displays information for a specific region S lt prtsystem gt where lt prtsystem gt is the PRT server to connect to in the project Enables use of a particular PRT service If none is specified all regions on any PRT system are displayed N lt node project gt where lt node project gt specifies the node or project name with which to connect Enables connection to the named node or project If none is specified the connection is made to the local project P lt path gt where lt path gt is the path name where the configuration files are loaded This option must be used if accessing a remote project I lt file path gt where lt file path gt is the name of the file used to connect to multiple projects 4 Click OK Result Parameters indicated in the Target field will be triggered when the PRT User Interface is accessed Note If you are viewing the PRT User Interface from a Viewer you do not have to use the N switch on the command line to connect to a remote project
370. the request This routine is used when you have not configured your process as a service and is not included in the prt_service dat file Otherwise you must use prt_api_register_intproc Syntax int prt_api_dyn_register_intproc intproc_event_flag prt_system cimp_sys retstat COR_I4 intproc_event_flag char Spr system char imp Sys COR STATUS Fevstac Data Structures None Input Arguments intproc_event_flag PEL system cimp_sys Output Arguments retstat Return Value Interested process event flag required Prefix of PRT data server s to connect to Name of project or node where prt data server resides Pointer to COR STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRT PROC NOT CONE PGURED PRTI_FILE_OPEN_ERR PRTI_SVC_ID_NDEF PRTI_FILE_READ_ERR PRTI_EMPTY_FILE PRTI_AUX_NAM_ERR PRTI_ADD_PORT_ERR PRTI_READ_PORT_ERR Process is not configured as network process Failure Error opening one of the configuration files Failure PRT service identifier not valid Failure Error reading configuration file Failure Configuration file has no records Failure Error in ipc_aux_nam Failure Error in ipc_add_port Failure Error in ipc_read_port Failure Production Tracking Application Interface 5 47 PRTI_MF_INIT_ERR Error initializing segment Failure
371. tic Information Requirements Input Arguments region_id Tracking Region identifier required enable_setpt_flag If TRUE enable the region item transition setpoint If FALSE disable it required comment Comment to be recorded in PRT history log file optional user_or_svc_id User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Output Arguments Kets tat Pointer to COR_STATUS structure Return Value Either COR_SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTC_BAD_REG_SPEC Bad region specified Warning PRTI_REG_ID_NULL Region identifier NULL Warning PRTI_REG_ID_NDEF Region identifier not valid Warning PRTI_MF_INIT_ERR Error initializing segment Failure PRTI_CRESEG_ERR Error creating segment Failure Plus all error codes returnable by prt_api_send_cmd CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F prt_api_reorder_region Reorder locations within Tracking Region Name prt _api_reorder_region Description This routine provides a mechanism to completely reorder the locations within a tracking region This has the effect of moving all the items at each location in the region to another possibly the same location in the region Syntax int prt_api_reorder_region region_id reorder_list hum Locatio
372. tic iten misr setpoint w 4 tran_regien id Tracking Begien s Tramsitiaon hegian T Entry Example 1 Blank Blank Miis E GEFFAHUC Beserved cfg overrides glb mer APART OC ASMELYLHET HOR Assembly Line 1 Ahermal AegionjAcmlyLmed Mor SEQUENT TAL 15 SAP OLY_ BTA PREP RT RAT APO TALS APT APT ay Sp A aL ay a ay a ay ey By ASPELYLHET TOTAL ASMBL YL RET STAY T H 0ps TP ap Tap ay a a el APAT OC PROT 1 OOM Robot 1 Coabise Begios Aoboet Comt NWCH IAL 1 jagi jigi PONT ere AomOT 1 TOTAL AomOT TUR RR LL i STAD Uahthevice UIA Aj APRT_DC ASMBLYLNE1_NOR Assembly Line 1 Normal Region AsmblyLne1 Nor SEQUENTIAL 15 3 1 DLY_ DTN DETAINMNT_A 0 1 0 0 1 11111 11110 0 1 1 1 111 1 0 0 0 ASMBLYLNE1_ TOTAL AMBLYLNE1_STAT 1 0 OpWks_1 11111111110 0 Expanded view of the first record CIMPLICITY HMI Tracking Operation Manual July 2001 Last field blank no delimiter needed after Continuation character appends next line to record GFK 1216F PRT GRP REG The PRT Group Tracking Region prt_grp_reg configuration file is used to tie Regions to Groups Each of the fields is described below complete with entry examples and a sample configuration file REQUIRED FILE Data No Field Name Description Type Entry Example 0 group_id Unique name for the Group responsible for the 16 EntAreaA corresponding region see Field 1 characters 1 region_id Unique name for the regio
373. tribute will be transferred to display_ptid and no parsing will take place 4 28 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Configuration File Example D pit_att_ptidt Notepad ala ES El Edt Seach Help IDT File generated by IDTPOP utility vi RECORD PAT_ATT_PT Pr Tr Region Item Attr Display Point i 8 ED SERVICE ID Unique ID for Graphic Display process 4 regien id Iracking egion 10 item tt name Item attribute Hame 3 display_ptid Array Point I0 for displaying attributes start loc First location covered by this point end lot Last location covered by this point 6 att_start_loc First location in the paint for this att 7 att_end loc Last location in the point for this attr 8 item_class id tem Class Identifier i PRTERD OVEA ITEH_ID O0VEHI_IHDEX 4 25 0 0 DRYER e rOcOrOS elect ETGRD PACKIHGIJ ITEN_ID FACEIKE1_ INDEX 1 106 0j 0 E PRTGRDJ OVEN1 ITEM_ID OVEN1_INDEX 1 25 0 0 DRYER Expanded view of No delimiter needed the first record after last field GFK 1216F Configuration File Guide 4 29 olg PRT REG AT The PRT Region Attribute Counter Definitions prt_reg_at configuration file is used to define counters in item attributes This will in turn trigger the action taken when an item containing the defined attribute enters the region Each of the fields is described below complete with entry examples and a sample configuration file OPTIONAL
374. tructures None Input Arguments None Output Arguments item_type_ids Pointer to a pointer to list of item ids total Pointer to an integer with the total number of item ids in the item_type_ids list Return Value Either COR SUCCESS or COR _ WARNING COR_SUCCESS is returned as long as the list exists COR_WARNING is returned if no list exists 5 82 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F prt_api_get_item_tracking_type Return the tracking type for a specific item Name prt _api_get_item tracking type GFK 1216F Description This function returns the tracking type for a specific item id A value of 1 is returned if the item id is a serialized item otherwise the value 2 is returned Syntax int prt eos er char COR_I1 COR_STATUS Data Structures None Input Arguments item_tracking_type item_type_id tracking_type retstat LUCeM by pe 1d tracking_type retstat item_type_id Pointer to a null terminated string containing a valid Output Arguments item type id tracking_type Pointer to a 1 byte integer specifying the tracking retstat Return Value type A value of 1 is a serialized item a value of 2 is a non serialized item Pointer to COR STATUS structure Either COR_SUCCESS or COR_WARNING COR_SUCCESS is returned if the item id has been found COR_FAILURE is returned if the item id can not be found in any tracking region Production Tracking A
375. ts gt U cor mires region struct ptr gt type totals O J3 5 42 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F prt_api_req_grouplist Request List Of Tracking Group Data Name prt_api_req grouplist Description This routine provides a mechanism to request Tracking Group Data for one or more Tracking Groups residing within all configured PRT services a specific PRT service or a specific Tracking Group If the request is a success the calling routine will receive back a count of the number of Tracking Groups returned to the group list If the request fails the calling routine will receive back status information on the reason for the failure Syntax int pri api req Group list prt sve id Group id group county Petsteal char Prt Sve 1d SERVICE 1D LEN FIG char Group 1d PRT REGION TD LCEN 1L COR_I4 OTOU Count COR_STATUS retstat Data Structures None Input Arguments pre SVC 10 Service identifier optional if group_id is specified group_id Tracking group identifier optional if prt_svc_id is specified Note At least one of the above arguments must be specified If not all services will be queried It is possible that a list of items will be collected but not all services will have responded because one or more of them were down Thus the user has a list of valid responses but may not have all the items that should have been returned In this case the function w
376. ueue required Item type identifier required Item status required If TRUE item held due to internal hold required Production Tracking Application Interface 5 67 5 68 int _hold_reason comment user or svc_id Output Arguments retstat Return Value Comment specifying reason for internal hold required if int_hold_active TRUE Comment to be recorded in PRT history log file optional User or service identifier This is used for logging purposes and is optional If this pointer is NULL the host process id is used optional Pointer to COR _STATUS structure Either COR SUCCESS or COR_FAILURE If the function returns COR FAILURE additional error information can be found in the COR_STATUS structure Error Codes PRTC NON SER _ID PRTC_SER_NO_ID PRTC_UNKNOWN_REGION PRTC_BAD_REG_LOC_SPEC PRTC_INS_IN_OCC_NON_NORMAL PRTC_ITEM_STAMP_TOO_NEW PRTC_ADD_LOC_TOO_BIG PRTC_ADD_MULTIPLE_SERIAL PRTC_NO_DETAINMENT_CFG PRTI_ITEM_TYPE_NULL PRTI_ITEM_TYPE_NDEF PRTI_NS_EXT_PROC_INVALID PRTI_NON_SER_ID PRTI_SER_NO_ID PRTI_SER_PARENT PRTI_GRP_ID_NULL PRTI_GRP_ID_NDEF PRTI_EXT_HOLD_NON_SER PRTI_INT_HOLD_NO_REASON PRTI_NON_SER_ATTS Non serialized item has item or ref id Failure Serialized item missing both item amp ref id Failure Unknown REGION specified Failure Bad region location specified Failure Attempt to Insert in occupied COMBINE DISPERSE region Failure
377. umber entry time etc Physical areas of the factory bounded by signal devices are assigned regions A product s physical location corresponds to its tracking item s location defined within PRT by its region and region location Products and areas are often associated in some physical or logical fashion on the factory floor a concept represented within PRT by a hierarchical grouping scheme PRT allows for one or more items to exist in a single Region Location These items can be associated with one another to represent the progress of a group of items through the factory In turn each Region can contain one or more of these locations representing for example bins conveyors and workstations on the factory floor that are in physical or logical proximity to one another At the next level in the hierarchy is the Group that can hold one or more Regions based on physical location or function At the highest level of the hierarchy it is possible to have multiple copies of the PRT process running simultaneously each with a unique object name called PRT Services Each Service can support an independent list of one or more Groups and Regions This grouping scheme allows you to expediently search for items or groups of items based on multiple criteria Tracker Subsystems Tracking Items can be Added Deleted Moved Advanced or Modified within the PRT database using one of the available subsystems all of which are listed below
378. up identifier of a group to be dumped This record causes all information on all regions and items within the group to be dumped The format for the record is GRP group_identifier or GRP group_id_1 group_id 2 The limit on the number of group identifiers that can be specified within a single GRP record is limited by the IDT routines that read and parse the input records The current limits are 100 fields per record and 1000 characters per record REG Specifies the regions by region identifier which are to be dumped The format is REG region_identifier or REG region_id_1 region_id 2 The limit on the number of region identifiers that be specified within a single REG record is limited by the IDT routines that read and parse the input records The current limits are 100 fields per record and 1000 characters per record SVC Specifies the service ID of the PRT service to be dumped This record causes all information on all groups regions and items within the service to be dumped The format for the record is SVC service_identifier or SVC svc_id_1 svc_id 2 The limit on the number of service identifiers that can be specified within a single SVC record is limited by the IDT routines that read and parse the input records The current limits are 100 fields per record and 1000 characters per record 4 68 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Export Output File Format The format for this fil
379. urrent tracking data for a single PRT process to a file This function can be used if static configuration data must be modified for example PRT is shutdown to add or delete a tracking Region The current Tracking Region and Item tracking data is exported to create a file that can be edited to match the modified static configuration data Import Tracking Data Using the IMPORT TRACKING DATA function the edited files can be reloaded into the tracking queues without manual entry of the data for each queue The IMPORT TRACKING DATA function copies exported Tracking Region and Item tracking data from the export file to the tracking queues configured for the current PRT process The import and export tracking data functions can be used to modify the tracking queues for a PRT process without shutting it down that is as long as PRT static configuration data is not modified between the export of the file and the import of the edited file Production Tracking Overview CIMPLICITY Software Component Interface Requirements Production Tracking interfaces with a number of systems to provide increased functionality PRT interfaces with CIMPLICITY HMI Base System Point Management CIMPLICITY HMI Base System Alarm Management CIMPLICITY HMI Application Processes PRT User Interface Point Management Process to PRT Process PRT interfaces with CIMPLICITY HMI s Point Management module in order to receive CIMPLICITY Point data values PRT
380. using the following field descriptions Field Name Description node_id Node name always MASTER process_i1d The name of the process that the program will look to for data object_name Object name same as Process ID order Use default value 0 Save the file Use the SCPOP Utility to convert file back to binary format CIMPLICITY HMI Tracking Operation Manual July 2001 Expanded view of record configured for ort_inttest exe Entry Example MASTER PRT_INT PRT_INT GFK 1216F 14 Step 3 Configure logproc 1 Use the IDTPOP Utility to convert the file to ASCII text using the text editor of your choice e g Notepad 2 Press Ctrl End to bring you to the next available line to enter your record see figure H bog di Aap equal IDT file generated by IDTPOP utility vi RECORD LOGPROC LOGICAL PROCESS IBERTIFIERS O PROCESS ID Process Identifier 1 process type id Process Type Identifier 2 pm flags Bits last 5 AP CASTAL LO HOAL WT 2 description Process Description AHRP RESIDEHT 1 Alara Hanagenent DL RP RESIDENT 1 Bata Logging pre aced viewot OVHCFG BESIDENT ijoynanic Director record configured EM RF RESIDENT 1JEvent Hanager RP for prt_inttest exe PRT_IMTJRESIDENT VIPRT Interested Test PRT_INT RESIDENT 1 PRT Interested Test 0 1 2 3 3 Type your record using the following field descriptions Field Field Entry No Name Description Example 0 proc
381. v Item at head Validated and used D v x To help understand the values of these status flags based on the events the following state diagram is provided PRT Validation Completed Trigger In order to avoid timing issues the routing process and the PRT validation should not both be triggered by the same trigger Since the validation statistics will be updated after validation is completed this point can be used to trigger the routing process This will help minimize the configuration requirements as well Reader Value This is how PRT will retrieve the latest read from the reader at the head of the region Since the PRT item id or reference id is a string of 16 characters it is recommended to configure at least a string point Even though there are not any size constraints it is suggested to use a string type with less than 16 characters If the region validation is configured with items containing a region specific prefix this prefix is added to the front of the reader value before it is used to match head item s item id reference id If users will be allowed to correct reader values in case of a no read or bad read it is suggested to use an equation with override derived point which will be fed from the real reader point PRT Validation Trigger This point will be used to trigger PRT to validate the new head item in the region Even though using Reader Value point for this purpose may seem logical this would eliminate t
382. w or by Region This feature comes in handy for printing reports and for customizing a screen to display only the information needed by a technician Further this file can be used to configure different views for each of your designated PRT Services or views to run across all PRT Services OPTIONAL FILE A View record Is common to all regions Specifies what information displays Arranges information in the display Customizes labels column headings Uses the keyword DEFAULT in the first line A Region View record Impacts a specific region Specifies what information displays Arranges information in the display Customizes labels column headings Overrides other views Uses the keyword REGION in the first line 41 To configure the prt_window cfg file Click Tools on the Workbench menu bar 2 Select Command Prompt A DOS window opens Type cd master on the Command Line Press Enter to switch to the Master directory Type notepad prt_window cfg where Notepad is the text editor se er Press Enter The default record for prt_window cfg will display in the text editor 7 Do one of the following Option I A To create a common view for all of your regions type DEFAULT B Type the delimiter e g C Type aname for the view e g VIEW 1 4 36 CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1216F Option 2 A To create a view for a specific region type REGION B Type
383. xt there is a small period of time when it doesn t appear in either region s tracking queue Defaults to 3 if not specified Example Dim main as new PrtGroup main Id MAIN Get a single item from PRT with its Reflid and display its ItemId in a message box PRT LocateItem REFNUMS MsgBox prt Item 0 ItemIid PrtGroup Modify Method Syntax PrtGroup Modify Description Updates the PRT Tracking Group with the current contents of this object Used to set or clear External Hold Example Dim prt as new Prt Get a list of groups from PRT i and clear each one s External Hold status bit prt GetGroupList Lor J 0 CO pre GroupCoune Pre lt Group lt Cl e arexecHold pre Group Modify next J GFK 1216F Appendix E Basic Control Engine Extensions for Production Tracking E 19 PrtGroup Projectid Property Read Write Syntax PrtGroup Projectid Description String property to set the project that subsequent Production Tracking extensions will communicate with Example Dim prt as new PrtGroup Get a list of services from PRT i and display them one by one in a message box Ort ProJecCtId MyrprogJscti prt GetRegionList TOE Fj 0 GO pres Region ount 1 MSGBOX PI Ca REGIONI Te next j PrtGroup Region Function Syntax PrtGroup Region index Description Returns a region at the specified index from the list that was found by a previous call to GetRegionList Exam
384. xt i Prtitem ClearModifyTime Method E 24 syntax PrtItem ClearModifyTime Description Clears the modify time on the object When calling Modify PRT will reject the request if the item s last modify time is less than the current modify time of the item in PRT Calling ClearModifyTime overrides this behavior This should be used with care since you may overwrite properties of the object that the user may have manipulated through PRT_UI etc Example Dim prt as new Prt Get a list of items from PRT i and initialize the modify time for each prt GetItemList for J S 0 CO Pru LECmCoume I prt Item j ClearModifyTime Oresteen e Moar Ey next Jj CIMPLICITY HMI Tracking Operation Manual July 2001 GFK 1I216F Prtltem ClearStatusBit Property Read Write GFK 1216F Syntax PrtItem ClearStatusBit Bit Description Clears the specified bit 0 through 31 of the status mask Comments Parameter Description Bit Integer The bit position O 31 to clear Example Dim prt as new Prt ns 17 Get a list of items from PRT and initialize a particular i status bit for each one prt GetItemList for 0 GO pri t bemeour L prt Item j ClearStatusBit n prt Item j Modify next J Appendix E Basic Control Engine Extensions for Production Tracking E 25 Prtltem Comment Property Read Write E 26 Syntax PrtItem Comment Description String property to set or get the comment associated with the
385. you want the output file to be placed Then enter the following command to run the program PRT_EXPORT lt filename gt PRTX lt prt_system gt lt prt_node gt Where lt filename gt PRTX is an input file that specified what is to be dumped to the export file lt prt_system gt is the prefix of the PRT data server you wish to export from Specify ALL if all data servers should be connected lt prt_node gt is the node where the PRT servers are running Specify LOCAL if they are on the same node If you don t specify any of the parameters on the command line you will be prompted Example Input File _ REG R1_BOX REG R2_CAB REG R3_CAR The program will create an output file called lt filename gt PRTM Where lt filename gt is the same as that of the input file A sample output file is provided in the section Running the Import Program Configuration File Guide 4 69 Production Tracking Processes This section identifies each of the processes within Production Tracking that implement the functions of the Production Tracking Subsystem Special notes for running these processes are included Production Tracking Data Collector PRTC EXE Process ID must terminate with DC for interprocess communication to work properly Production Tracking Data Server PRTS EXE Process ID must terminate with DS for interprocess communication to work properly Production Tracking Configuration Validation Program PRTV
386. ype_id parent_item_id item_status ext_hold_active group_id int pold actives int hold reason comment user_or_svc_id retstat timestamp modify_bitmask status_bitmask region_id PRT_REGION_ID_LEN 1 region_loc item_id PRT_ITEM ID LEN 1 reference id PRT_ITEM ID _ LEN 1 item_type_id PRT_ITEM TYPE_ID_LEN 1 parent _i1tem_id PRT_ITEM 1D LEN 1 item_status ext hold active group_id PRT_REGION_ID_LEN 1 int holed active int MOLE reason SC DESCRIPTION LEN F 113 comment LoC DESCRIP T PON GEN 13 user Or svc 10 SERVICE ID EBEN F IT retstat Data Structures None Input Arguments See SYNTAX for proper order Serialized Items Only item_id reference_id ext_hold active group id Non Serialized Items Only parent_item_id Unique identifier of a Serialized Item optional if reference id specified Secondary identifier of a Serialized Item optional if item id specified If TRUE item held due to external hold optional Group identifier providing reason for hold required if ext_hold_active TRUE Item ID of associated serialized Item optional Production Tracking Application Interface 5 13 Both timestamp modify_bitmask status _bitmask region_id The time the item was last moved or modified The timestamp is used to ensure that when attempting to modify an item the item has not changed or moved between the time when information was last

CIMPLICITY HMI Tracking Operation Manual

Contents

Download Pdf Manuals

Related Search

Related Contents