Skip to content

/AWS1/IF_BTC=>CREATEQUOTASHARE()

About CreateQuotaShare

Creates an Batch quota share. Each quota share operates as a virtual queue with a configured compute capacity, resource sharing strategy, and borrow limits.

Method Signature

METHODS /AWS1/IF_BTC~CREATEQUOTASHARE
  IMPORTING
    !IV_QUOTASHARENAME TYPE /AWS1/BTCSTRING OPTIONAL
    !IV_JOBQUEUE TYPE /AWS1/BTCSTRING OPTIONAL
    !IT_CAPACITYLIMITS TYPE /AWS1/CL_BTCQUOTASHARECAPLIMIT=>TT_QUOTASHARECAPACITYLIMITS OPTIONAL
    !IO_RESOURCESHARINGCONF TYPE REF TO /AWS1/CL_BTCQUOTASHARERESHRC00 OPTIONAL
    !IO_PREEMPTIONCONFIGURATION TYPE REF TO /AWS1/CL_BTCQUOTASHAREPMTCONF OPTIONAL
    !IV_STATE TYPE /AWS1/BTCQUOTASHARESTATE OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_BTCTAGRISTAGSMAP_W=>TT_TAGRISTAGSMAP OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_btccrequotasharersp
  RAISING
    /AWS1/CX_BTCCLIENTEXCEPTION
    /AWS1/CX_BTCSERVEREXCEPTION
    /AWS1/CX_BTCCLIENTEXC
    /AWS1/CX_BTCSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_quotasharename TYPE /AWS1/BTCSTRING /AWS1/BTCSTRING

The name of the quota share. It can be up to 128 characters long. It can contain uppercase and lowercase letters, numbers, hyphens (-), and underscores (_).

iv_jobqueue TYPE /AWS1/BTCSTRING /AWS1/BTCSTRING

The Batch job queue associated with the quota share. This can be the job queue name or ARN. A job queue must be in the VALID state before you can associate it with a quota share.

it_capacitylimits TYPE /AWS1/CL_BTCQUOTASHARECAPLIMIT=>TT_QUOTASHARECAPACITYLIMITS TT_QUOTASHARECAPACITYLIMITS

A list that specifies the quantity and type of compute capacity allocated to the quota share.

io_resourcesharingconf TYPE REF TO /AWS1/CL_BTCQUOTASHARERESHRC00 /AWS1/CL_BTCQUOTASHARERESHRC00

Specifies whether a quota share reserves, lends, or both lends and borrows idle compute capacity.

io_preemptionconfiguration TYPE REF TO /AWS1/CL_BTCQUOTASHAREPMTCONF /AWS1/CL_BTCQUOTASHAREPMTCONF

Specifies the preemption behavior for jobs in a quota share.

Optional arguments:

iv_state TYPE /AWS1/BTCQUOTASHARESTATE /AWS1/BTCQUOTASHARESTATE

The state of the quota share. If the quota share is ENABLED, it is able to accept jobs. If the quota share is DISABLED, new jobs won't be accepted but jobs already submitted can finish. The default state is ENABLED.

it_tags TYPE /AWS1/CL_BTCTAGRISTAGSMAP_W=>TT_TAGRISTAGSMAP TT_TAGRISTAGSMAP

The tags that you apply to the quota share to help you categorize and organize your resources. Each tag consists of a key and an optional value. For more information, see Tagging your Batch resources in Batch User Guide.

RETURNING

oo_output TYPE REF TO /aws1/cl_btccrequotasharersp /AWS1/CL_BTCCREQUOTASHARERSP

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->createquotashare(
  io_preemptionconfiguration = new /aws1/cl_btcquotasharepmtconf( |string| )
  io_resourcesharingconf = new /aws1/cl_btcquotasharereshrc00(
    iv_borrowlimit = 123
    iv_strategy = |string|
  )
  it_capacitylimits = VALUE /aws1/cl_btcquotasharecaplimit=>tt_quotasharecapacitylimits(
    (
      new /aws1/cl_btcquotasharecaplimit(
        iv_capacityunit = |string|
        iv_maxcapacity = 123
      )
    )
  )
  it_tags = VALUE /aws1/cl_btctagristagsmap_w=>tt_tagristagsmap(
    (
      VALUE /aws1/cl_btctagristagsmap_w=>ts_tagristagsmap_maprow(
        key = |string|
        value = new /aws1/cl_btctagristagsmap_w( |string| )
      )
    )
  )
  iv_jobqueue = |string|
  iv_quotasharename = |string|
  iv_state = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_string = lo_result->get_quotasharename( ).
  lv_string = lo_result->get_quotasharearn( ).
ENDIF.