Ansicht
Dokumentation

/SAPAPO/OM_PEG_CAT_GET_ORDERS - Get Order Data for I/O Nodes in Pegging Area

BAL Application Log Documentation   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.

Further information

@0P@liveCache Pegging Area

Functionality

This module gets the I/O nodes that are in the specified pegging areas, determines the orders to which they belong, and gets their data.

It works by performing the following three steps:

1. Get the I/O nodes by using OM_PEGID_GET_IO.
2. Determine the orders to which these I/O nodes belong.
3. Extract the associated order data by using OM_ORDER_GET_DATA.

If you do not need the complete order data, and only the keys (GUIDs) of the orders, we recommend that you use OM_PEGID_SELECT_ORDERS instead.

The export tables for getting the order data and the import parameters IV_GET_FIX_PEG_ONLY, IS_EXCLUDE_EXPORTS, and IS_EXCLUDE_FIELDS for selecting the required data are documented in the module OM_ORDER_GET_DATA.

The import parameters for selecting the I/O nodes are explained in OM_PEGID_GET_IO.

Additional selection options

The import structure IV_ADDITIONAL_SEL_OPTIONS contains multiple components that influence the procedure for selecting the orders of the selected I/O nodes. In regular usage, these components should always contain initial values.

The component PLANNING_TYPE enables you to filter the orders by planning type.

If a selected I/O node belongs to a suborder, you can use theADD_TOPORDERS switch to also request data from its top order:

• ' ' = gc_om_suborders_only:
  The entire order data for the suborder is returned.

• 'X' = gc_om_add_toporder_info:
  As well as the entire order data of the suborder, the header data of the top order is returned in the table ET_ORDERS and the associated ORDKEY and ORDMAP data records.

• 'T' = gc_om_toporder_complete:
  The top order of the I/O node is determined, not the suborder. The entire data of the top order is returned, including the data of all its suborders.

• 'O' = gc_om_toporders_only:
  This setting is currently only permitted by the module OM_PEGID_SELECT_ORDERS. It indicates that only the key of the top order is returned, and not the key of the sub order.

If you choose the switch setting 'T' = gc_om_toporder_complete, the subsequent selection options are applied to the top order, and not to the suborder.

When you activate the switch SEL_BY_SUBORDER_REQUESTED_TIME, only those orders are returned whose requested time (REQUESTED_TIME) overlaps the time interval [IV_START_TIME, IT_END_TIME]. Any orders with the correct requested time, but whose I/O nodes do not have suitable times, would not be selected in this case. This means you can use the field TOLERANCE_TIME to add a tolerance time to the time interval for the I/O node times. In this case, those orders with the correct requested time and at least one I/O node with a time in the interval [IV_START_TIME-TOLERANCE_TIME, IT_END_TIME+TOLERANCE_TIME] are returned.

You can use the flag ANY_ACT_IN_INTERVAL to restrict the order selection to those orders that have an activity in the specified interval. Since this check requires all activities of the order to be examined, this filter can have a severe effect on the performance of the module.

The switch SEND_GUIDS_ONLY, which specifies that only the keys of the orders are returned (instead of the entire order data), is not currently implemented. You can use the module OM_PEGID_SELECT_ORDERS instead.

Notes

Error Handling and Troubleshooting

Possible return codes:

• 38 = om_invalid_pegarea: The specified pegging area does not exist in liveCache.

Parameters

ET_ACTIVITIES
ET_CAP_REQS
ET_CHARACT_REQ_INPNODE
ET_CHARACT_VAL_ACTS
ET_CHARACT_VAL_OUTNODE
ET_EXTERN_CONSTRAINTS
ET_EXT_INPUTS
ET_EXT_OUTPUTS
ET_INPNODE_RELATIONS
ET_INPUTS
ET_INTERN_CONSTRAINTS
ET_MODES
ET_ORDERS
ET_ORDKEYS
ET_ORDMAPS
ET_OUTNODE_RELATIONS
ET_OUTPUTS
ET_PEG_INPNODE
ET_PEG_OUTNODE
ET_POSITIONS
ET_PRODFLOW
ET_RC
IS_EXCLUDE_EXPORTS
IS_EXCLUDE_FIELDS
IS_GEN_PARAMS
IT_CATEGORY
IT_CHARACT_REQ_OUTNODE
IT_CHARACT_VAL_INPNODE
IT_EXT_FIXED
IT_ORDER_REQTIME
IT_ORDER_STATUS
IT_ORDER_TYPES
IT_PEGID
IT_TOPORDER_EXCLUDES
IV_ADDITIONAL_SEL_OPTIONS
IV_END_TIME
IV_GET_FIX_PEG_ONLY
IV_GET_PHANTOMS
IV_IONODE_PEG_SEL
IV_SIMSESSION
IV_START_TIME

Exceptions

LC_APPL_ERROR
LC_COM_ERROR
LC_CONNECT_FAILED

Function Group

APO/SAPLOM_PLANNING

RFUMSV00 - Advance Return for Tax on Sales/Purchases   CPI1466 during Backup  
This documentation is copyright by SAP AG.

Length: 6041 Date: 20240425 Time: 074311     sap01-206 ( 108 ms )