/SAPAPO/OM_RESOURCE_CHANGE - Creates, Changes, or Deletes Resources in liveCache

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Functionality

You can use this function module to create new resources in liveCache or to change or delete existing resources in liveCache.

The information about the resources is specified in the import tables IT_RESOURCE, IT_CHARACT_LINE_REF, and IT_BUCKET_PROFILE.

IT_RESOURCE contains a row for each resource:

• RESID: Internal API key (GUID) for the resource.

• SHARED_TSTREAMID: Internal APO key (GUID) for the reference time stream (can be used by multiple resources).

• PRIVATE_TSTREAMID: Internal APO key (GUID) for the resource-specific (private) time stream.

• SHARED_SETUP_MATRIX: Internal APO key (GUID) for the reference setup matrix (can be used by multiple resources).

• PRIVATE_SETUP_MATRIX: Internal APO key (GUID) for the resource-specific (private) setup matrix.

• BUFFER_TIME: Resource-dependent material staging time. If an activity/operation is to be startedfor the resource RESID at time t1, then the scheduling forces the required materials to be staged for the activity/operation at time t0, where t0 = t1 - BUFFER_TIME.

• RESOURCE_TYPE: What type does the resource RESID have?

• RESOURCE_TYPE = GC_RESOURCE_SINGLE : RESID is a single activity resource.

• RESOURCE_TYPE = GC_RESOURCE_MULTI : RESID is a multi-activity resource.

• RESOURCE_TYPE = GC_RESOURCE_BUCKET: RESIID is a bucket resource.

• RESOURCE_TYPE = GC_RESOURCE_SINGLE_MIX: RESIID is a bucketed single activity resource.

• RESOURCE_TYPE = GC_RESOURCE_MULTI_MIX: RESIID is a bucketed multi-activity resource.

• RESOURCE_TYPE = GC_RESOURCE_SINGLE_LINE: RESIID is a single activity resource for repetitive manufacturing.

• RESOURCE_TYPE = GC_RESOURCE_SINGLE_MIX_LINE: RESIID is a bucketed single activity resource for repetitive manufacturing.

• The following are suitable for bucketed planning:

GC_RESOURCE_BUCKET

GC_RESOURCE_SINGLE_MIX

GC_RESOURCE_MULTI_MIX

• The following are suitable for line planning:

GC_RESOURCE_SINGLE_LINE

GC_RESOURCE_SINGLE_MIX_LINE

• The following are suitable for continuous planning:

GC_RESOURCE_SINGLE

GC_RESOURCE_MULTI

GC_RESOURCE_SINGLE_MIX

GC_RESOURCE_MULTI_MIX

GC_RESOURCE_SINGLE_LINE

GC_RESOURCE_SINGLE_MIX_LINE

• FINITE_PLANNING: Is the resource RESID planned as finite?

• FINITE_PLANNING = GC_TRUE: RESID is planned as finite.

• FINITE_PLANNING = GC_FALSE: RESID is planned as infinite.

• IS_BOTTLENECK: Is the resource RESID a bottleneck resource?

• IS_BOTTLENECK = GC_TRUE: RESID is a bottleneck resource.

• IS_BOTTLENECK = GC_FALSE: RESID is not a bottleneck resource.

• OVERLAP_BUCKETS: Relevant for bucketed plannable resources.

• OVERLAP_BUCKETS = GC_TRUE: Activity for RESID can overlap bucket limits.

• OVERLAP_BUCKETS = GC_FALSE: Activity for RESID must be in a single bucket.

• CLOSE_GAPS: Relevant for continuously plannable resources only.

• CLOSE_GAPS = GC_TRUE: RESID is to be planned without gaps.

• CLOSE_GAPS = GC_FALSE: RESID is not to be planned without gaps.

• ALERTS_MIN_OVERLAP: Minimum overlap for activities for creating alerts (tolerance limit).

• ALERTS_MIN_OVERLOAD: Minimum overload (%) for bucket for creating alerts (tolerance limit).

• BUCKET_DIMENSION: Relevant for bucketed plannable resources.

• BUCKET_DIMENSION = GC_DIM_AMOUNT_HOURS: Bucket vector has dimension "Quantity * Time Unit".

• BUCKET_DIMENSION = GC_DIM_AMOUNT_HOURS: Bucket vector has dimension "Quantity".

• BUCKET_DIMENSION = GC_NO_BUCKET_DIMENSION: Default value for non-bucketed resources.

• LINE_PROC_TIME: Relevant for line resources only.

• LINE_PROC_TIME_MODE: Relevant for line resources only. How is the lead time scheduled?

• LINE_PROC_TIME_MODE = GC_RATE_INDEPENDENT: Rate-independent scheduling of lead time.

• LINE_PROC_TIME_MODE = GC_RATE_DEPENDENT: Rate-dependent scheduling of lead time.

• LINE_PROC_TIME_MODE = GC_NO_LINE_PROC_TIME_MODE: Default value for non-line resource.

• BUCKET_METHOD: Relevant for bucketed resources.

• How is the bucket profile specified in IT_BUCKET_PROFILE for the resource RESID?

• BUCKET_METHOD = GC_NEW: The bucket profile from RESID is replaced by the bucket profile for RESID specified in IT_BUCKET_PROFILE.

• BUCKET_METHOD = GC_CHANGE: The bucket profile for RESID is changed in accordance with the bucket profile in IT_BUCKET_PROFILE. (The bucket profile RESID in IT_BUCKET_PROFILE represents a delta.)

• CHARACT_METHOD: How is the character vector for the resource ID specified in IT_CHARACT_LINE_REF processed?

• CHARACT_METHOD = GC_NEW: A new characteristic vector is created (the existing old characteristic vector from RESID is overwritten).

• CHARACT_METHOD = GC_DELETE: The characteristic vector is deleted.

• METHOD: How is the resource RESID processed?

• METHOD = GC_NEW: A new RESID is created. This processing mode requires the following conditions to be met by the above parameters:

* The resource RESID cannot exist yet in liveCache.

* The time stream TSTREAMID must be specified and exist in liveCache. (A resource must have a time stream.)

* A bucket aggregation profile AGOID must be specified. If specified, it must exist in liveCache.

* The parameters BUFFER_TIME, RESOURCE_TYPE, FINITE_PLANNING, and IS_BOTTLENECK must be specified.

• METHOD = GC_CHANGE: Changes RESID.

* The resource RESID must exist in liveCache. This processing mode requires the following conditions to be met by the above parameters:

* The time stream TSREAMID, the bucket aggregation profile AGOID, BUFFER_TIME, FINITE_PLANNING, IS_BOTTLENECK, and IT_BUCKET_PROFILE can be changed (i.e. specified).

* RESOURCE_TYPE cannot be changed.

• METHOD = GC_DELETE: Deletes RESID.

* The resource RESID must exist in liveCache.

IT_BUCKET_PROFILE contains information about the bucket profile for resources from IT_RESOURCE. For a single resource, the information is located in multiple sequential rows. Each row defines a bucket.

• RESID: Internal API key (GUID) for the resource.

• BUCKET_START: Start time of the bucket.

• CAPA_SUPPLY: Capacity supply of this bucket.

• CAPA_INIT_USED: Initial capacity supply of this bucket.

IT_CHARACT_LINE_REF contains information about the characteristics and their validity for resources from IT_RESOURCE.

• RESID: Internal API key (GUID) for the resource.

• STARTTI: Start time of the characteristic container CHARACT_CONT_ID.

• CHARACT_CONT_ID: Internal APO key (GUID) of the characteristic container.

The export table ET_RC contains resource-related return codes that indicate processing errors for resources.If an entry of this type exists in ET_RC for the resource RESID, then the required processing step was not performed for RESID.

Example

Notes

Return codes to be queried:

• Export table ET_RC:

• om_invalid_resource: Resource does not exist in liveCache.

• om_invalid_timestream: Time stream does not exist in liveCache.

• om_invalid_ago: Bucket aggregation profile does not exist in liveCache.

• om_resource_already_exists: The resource already exists in liveCache and cannot be created again.

• om_invalid_resource_type: Invalid resource type.

• om_resource_type_not_changeable: The type of a resource cannot be changed.

• Return code lv_rc:

• om_invalid_bucket_profile: Unsuitable bucket profile.

Further information

Parameters

ET_CHANGED_ORDERS
ET_RC
ET_RESNET_ID
IT_BUCKETVECTOR_CHARACT
IT_BUCKETVECTOR_HEADER
IT_BUCKET_PROFILE
IT_CHARACT_LINE_REF
IT_PPDS_BUCKET_PROFILE
IT_RESOURCE
IT_STORAGE_PROFILE
IV_DONT_SET_NETCHG_FLAG
IV_SIMSESSION

Exceptions

LC_APPL_ERROR
LC_COM_ERROR
LC_CONNECT_FAILED

Function Group

APO/SAPLOM_RESOURCE

RFUMSV00 - Advance Return for Tax on Sales/Purchases   TXBHW - Original Tax Base Amount in Local Currency  
This documentation is copyright by SAP AG.


Length: 11703 Date: 20120525 Time: 051136     triton ( 225 ms )