Meter Reading interface for JD Edwards
About the Meter Reading interface
The Meter Reading interface allows the entry or update of meter information about equipment.
This functionality is used to monitor equipment use and trigger maintenance tasks that are based on accumulated statistical units, such as miles. Maintenance can be scheduled for a machine or piece of equipment based on mileage, elapsed time (hours), fuel consumption, cycles, or tonnage. Many accounts can be defined for statistical units; however, only three types of statistical units can be used to trigger maintenance. These three types of statistical units are odometer, fuel, and hours.
This interface calls the BD3N1204 business function to retrieve the processing options from the interactive program, P12120.
| Name | Function Name | Description |
|---|---|---|
| DD3N2120 | dcLINK Meter Reading Data Structure | |
| ND3N2120 | dcLINKMeterReading | dcLINK Meter Reading |
| DD3N1204 | PO Retrieval Meter Reading Data Structure | |
| BD3N1204 | PORetrievalMeterReading | PO Retrieval Meter Reading |
This guide applies to the newest version of the ERP.
Corresponding EnterpriseOne application
In EnterpriseOne, the application you would run to launch Meter Reading is P12120. The menu to find Equipment Information->Meter Reading is G1311.
Processing options
This interface requires processing options from the P12120 program. A version will default to ZJDE0001 if not otherwise specified in the parameter list on the call.
Defaults tab
-
Meter Display (Odometer) (po_cOdometerDisplay_EV01) - This field indicates whether to display the odometer reading. Valid values are: blank - Do not display, or “1” - Display.
-
Meter Display (Fuel) (po_cFuelDisplay_EV01) - This field indicates whether to display the fuel reading. Valid values are: blank - Do not display, or “1” - Display.
-
Meter Display (Hours) (po_cHourDisplay_EV01) - This field indicates whether to display the hour reading. Valid values are: blank - Do not display, or “1” - Display.
-
Responsible Business Unit (po_szCostCenter_MCU) - This field specifies the default business unit to use.
-
Location (po_szCostCenterLocation_LOC) - This field specifies the default location to use.
-
Equipment Status (po_szEquipmentStatus_EQST) - This field specifies the default equipment status to use.
-
Company (po_szCompany_CO) - This field specifies the default company to use.
Edits tab
-
Required Equipment (po_cRequireEquipment_REQEQ) – This option specifies if an equipment number is required for the entry.Valid values are: blank - Equipment Number is not required, “1” - Equipment Number required.
-
Required Caller Number (po_cRequireCaller_REQCA) - This option specifies whether a number is required for the entry. Valid values are: blank - Caller Number not required. “1” - Caller Number required.
Categories tab
-
Major Accounting Class (po_szMajorClass_ACL1) - This field specifies the default major accounting class to use.
-
Major Equipment Class (po_szSubClass_ACL2) - This field specifies the default major equipment class to use.
-
Manufacturer (po_szClassCode3_ACL3) - This field specifies the default Category Code 3 to use.
-
Model Year (po_szClassCode4_ACL4) - This field specifies the default Category Code 4 to use.
-
Usage Miles or Hours (po_szClassCode5_ACL5) - This field specifies the default Category Code 5 to use.
-
Category Code 6 (po_szClassCode6_ACL6) - This field specifies the default Category Code 6 to use.
-
Category Code 7 (po_szClassCode7_ACL7) - This field specifies the default Category Code 7 to use.
-
Category Code 8 (po_szClassCode8_ACL8) - This field specifies the default Category Code 8 to use.
-
Category Code 9 (po_szClassCode9_ACL9) - This field specifies the default Category Code 9 to use.
-
Rate Group (po_szRateGroup_ACL0) - This field specifies the default Category Code 10 to use.
Process tab
-
Update Children Current Meters (po_cUpdChildCurrentMeter_EV01) – This field indicates whether to update the current meters for children. Valid values are: blank - Do not update, or “1” - Update.
-
Update Children Original Meters (po_cUpdChildOriginalMeter_EV01) - This field indicates whether to update the original meters for children. Valid values are: blank - Do not update, or “1” - Update.
Versions tab
-
Update PM Schedule (R12807) Version (po_szVersion_VERS) – This field indicates the version to use for updating PM schedules. Valid values are: blank - Do not update PM schedules, or the specific version of the Update PM Schedule program to use.
-
Cost Summary (P122101) Version (po_szP122101Version_VERS) - This field specifies which version of the Cost Summary program to use. If blank, the Version will default to “ZJDE0002”.
Edits tab
-
Tolerance Level (po_mnPercent01001_PCT1) - This field specifies the tolerance level to use in determining whether to display a warning message. Valid values are: blank - Do not check for tolerance levels, or a specific percentage to use.
Processing option data structure
The following processing options are available for the DD3N1204 data structure.
The interface retrieves these parameters by calling BD3N1204.They are passed back in the following data structure.
| Type | Description | Parameter |
|---|---|---|
| Char | po_cUpdChildCurrentMeter_EV01 | Output |
| Char | po_cUpdChildOriginalMeter_EV01 | Output |
| String | szVersion_VERS | Input |
| Numeric | po_mnPercent01001_PCT1 | Output |
| Char | po_cOdometerDisplay_EV01 | Output |
| Char | po_cFuelDisplay_EV01 | Output |
| Char | po_cHourDisplay_EV01 | Output |
| String | po_szCostCenter_MCU | Output |
| String | po_szCostCenterLocation_LOC | Output |
| String | po_szEquipmentStatus_EQST | Output |
| String | po_szCompany_CO | Output |
| String | po_szMajorClass_ACL1 | Output |
| String | po_szSubClass_ACL2 | Output |
| String | po_szClassCode3_ACL3 | Output |
| String | po_szClassCode4_ACL4 | Output |
| String | po_szClassCode5_ACL5 | Output |
| String | po_szClassCode6_ACL6 | Output |
| String | po_szClassCode7_ACL7 | Output |
| String | po_szClassCode8_ACL8 | Output |
| String | po_szClassCode9_ACL9 | Output |
| String | po_szRateGroup_ACL0 | Output |
| Char | po_cDisplayChildren_EV01 | Output |
| Char | po_cDisplayDisposed_EV01 | Output |
| String | po_szP122101Version_VERS | Output |
| String | po_szVersion_VERS | Output |
Processing
The characteristics of an item determine which processing fields are required by the interface.
Some characteristics are set at the item master level, and some are set at the item/branch level. The item/branch level always takes precedence over the item master. Refer to the Special Processing Interface Usage Guide for more information.
| Action Code | Advanced Inventory Action Code | Description |
|---|---|---|
| 0 | This field unconditionally defaults to "0" | |
| 1 | This field defaults to "1", if not passed in |
Required fields
BF cActionCode = ‘1': Add Service Order Maintenance Record
Required fields:
-
BF mnInputAssetNumber_NUMB
-
BF mnOdometerOrignlReading_BMOWM
-
BF mnFuelMeterOrignlReading_BMOWM
-
BF mnHourMeterOrignlReading_BMOWM
Verifying the processing
To verify that the interface processed correctly, complete the following steps.
-
In the Equipment Information menu (G13111), choose Meter Inquiry.
-
Enter Equipment Number and a valid date range, and then click Find to display the record to ensure that the entry or update completed.
Input data structure
The following table describes the input data structure for DD3N2120.
In the following table, r indicates Required, o indicates Optional, c indicates Conditional, and x indicates that the item is Required but will default in if not passed.
| Name | Default Value | R/O | Alias | Notes |
|---|---|---|---|---|
| cdcLINKActionCode_EV01 | 0 | X | EV01 | This field unconditionally defaults to “0”. |
| cActionCode_ACTION | 1 | X | ACTION | This field defaults to “1”, if not passed in. |
| jdDateUpdated_UPMJ | Current Date | X | UPMJ | This field is retrieved from GetAuditInfo. |
| mnTimeUpdated_TDAY | Current Time | X | TDAY | This field is retrieved from GetAuditInfo. |
| szUserId_USER | Current User | X | USER | If this field is not passed in, a value is retrieved from GetAuditInfo. |
| szWorkStationId_JOBN | Current Workstation | X | JOBN | This field is retrieved from GetAuditInfo. |
| mnJobnumber_JOBS | O | JOBS | ||
| szProgramId_PID | ND3N2120 | X | PID | This field defaults in the program if not passed in. |
| szVersion_VERS | ZJDE0001 | X | VERS | If not passed in, the ZJDE0001 version is used. |
| cSuppressErrorMessage_EV01 | O | EV01 | ||
| cErrorCode_ERRC | X | ERRC | This is a returned value. “1” = warning, “2” = error. | |
| szErrorMessageKey_EKEY | X | EKEY | This value is returned and contains the alias of the error message. | |
| iDebugLevel_INT01 | O | INT01 | If this field value is greater than zero, the M&D Debug statements are displayed. | |
| cdcLINKActionCode_EV01 | 0 | X | EV01 | This field unconditionally defaults to “0”. |
| cActionCode_ACTION | 1 | X | ACTION | This field defaults to “1”, if not passed in. |
| jdDateUpdated_UPMJ | Current Date | X | UPMJ | This field is retrieved from GetAuditInfo. |
| mnTimeUpdated_TDAY | Current Time | X | TDAY | This field is retrieved from GetAuditInfo. |
| szUserId_USER | Current User | X | USER | If this field is not passed in, a value is retrieved from GetAuditInfo. |
| szWorkStationId_JOBN | Current Workstation | X | JOBN | This field is retrieved from GetAuditInfo. |
| mnJobnumber_JOBS | O | JOBS | ||
| szProgramId_PID | ND3N2120 | X | PID | This field defaults in the program if not passed in. |
| szVersion_VERS | ZJDE0001 | X | VERS | If not passed in, the ZJDE0001 version is used. |
| cSuppressErrorMessage_EV01 | O | EV01 | ||
| cErrorCode_ERRC | X | ERRC | This is a returned value. “1” = warning, “2” = error. | |
| szErrorMessageKey_EKEY | X | EKEY | This value is returned and contains the alias of the error message. | |
| iDebugLevel_INT01 | O | INT01 | If this field value is greater than zero, the M&D Debug statements are displayed. | |
| szDescriptionSkipTo_DL01 | O | DL01 | ||
| jdDatePeriodThru_DTHRU | O | DTHRU | ||
| szBusinessUnit_MCU | O | MCU | ||
| szBusinessUnitLocation_LOC | O | LOC | ||
| szEquipmentSkipTo_ASII | O | ASII | ||
| szEquipmentStatus_EQST | O | EQST | ||
| szCompany_CO | O | CO | ||
| szInventoryNumber_UITM | O | UITM | ||
| cDisplayOdometer_EV01 | O | EV01 | ||
| cDisplayFuelMeter_EV01 | O | EV01 | ||
| cDisplayHourMeter_EV01 | O | EV01 | ||
| cDisplayChildren_CHDOW | O | CHDOW | ||
| cDisplayDisposed_DSOW1 | O | DSOW1 | ||
| szMajorAccountingClass_ACL1 | O | ACL1 | ||
| szMajorEquipmentClass_ACL2 | O | ACL2 | ||
| szManufacturer_ACL3 | O | ACL3 | ||
| szModelYear_ACL4 | O | ACL4 | ||
| szUsageMilesorHours_ACL5 | O | ACL5 | ||
| szCategoryCode6_ACL6 | O | ACL6 | ||
| szCategoryCode7_ACL7 | O | ACL7 | ||
| szCategoryCode8_ACL8 | O | ACL8 | ||
| szCategoryCode9_ACL9 | O | ACL9 | ||
| szRateGroup_ACL0 | O | ACL0 | ||
| mnInputAssetNumber_NUMB | R | NUMB | ||
| szInputUnitNumber_APID | O | APID | ||
| szInputSerialNumber_ASID | O | ASID | ||
| mnOdometerNewReading_BALNEW | O | BALNEW | ||
| mnOdometerNetIncrease_NIOWM | O | NIOWM | ||
| mnOdometerOrignlReading_BMOWM | O | BMOWM | ||
| mnFuelMeterNewReading_BALNEW | O | BALNEW | ||
| mnFuelMeterNetIncrease_NIOWM | O | NIOWM | ||
| mnFuelMeterOrignlReading_BMOWM | O | BMOWM | ||
| mnHourMeterNewReading_BALNEW | O | BALNEW | ||
| mnHourMeterNetIncrease_NIOWM | O | NIOWM | ||
| mnHourMeterOrignlReading_BMOWM | O | BMOWM | ||
| cSubledgerType_SBLT | O | SBLT | ||
| szSubledger_SBL | O | SBL | ||
| mnOdometerCurrentRead_BALOW | O | BALOW | ||
| mnFuelMeterCurrentRead_BALOW | O | BALOW | ||
| mnHourMeterCurrentRead_BALOW | O | BALOW | ||
| szNERCompany_CO | O | CO | ||
| szNERSavedCompany_CO | O | CO | ||
| mnNERF0911Job_JOBS | O | JOBS | ||
| szNERUserId_USER | O | USER | ||
| szNERBatchType_ICUT | O | ICUT | ||
| mnNERBatchNumber_ICU | O | ICU | ||
| jdNERBatchDate_DGL | O | DGL | ||
| mnNERDocumentNumber_DOC | O | DOC | ||
| cNERF0911ErrorFlag_EV01 | O | EV01 | ||
| jdNERFCDatePeriodThru_DTHRU | O | DTHRU | ||
| szNERMeterExplanation_VC30A | O | VC30A | ||
| Globally Unique Identifier (GUID) Fields | GUID fields are all optional unless a business must comply with FDA 21 CFR Part 11 auditing requirements. Refer to Special Processing Interface Usage Guide for GUID Input Data Structure details. |
Transaction test scenarios
The following test scenarios demonstrate a variety of ways in which this interface could be used, and the fields that would be passed for each scenario. The data structure fields are in the left column, and the corresponding values for each scenario are listed by column.
| Field Name | Create Meter Reading Record |
|---|---|
| BF cActionCode | 1 |
| BF mnInputAssetNumber_NUMB | 1018 |
| BF mnOdometerOrignlReading_BMOWM | 12000 |
| BF mnFuelMeterOrignlReading_BMOWM | 1111 |
| BF mnHourMeterOrignlReading_BMOWM | 1323 |
Common error messages
The following common error messages can be generated by this BF. This table includes descriptions for each error.
| Error Message | Description |
|---|---|
| 0002 | Record Invalid This error is returned when an error has been detected from one of these three business functions: dcLINK Set User ID, dcLINK Utility Set Audit Info, or dcLINK Utility Write Signature Capture Record. |
| 3773 | Asset Number Invalid This is set when the Work Order Number invalid”. |
Loading...
There was a problem loading this topic