Lawson Insight Technical Documentation

Generated by:
Documentation generated by Decision Analytics

ERDs Tables Conditions Elements Libraries APIs Forms

ICI1


ICI1.1 - Unit Of Measure Routines

ICI1 is an invoked program which contains routines to perform various
functions involving units of measure in the Lawson procurement applications.

What follows is an excerpt taken from program code to describe its purpose:

          "THIS PROGRAM IS DESIGNED AS A "FUNCTION OBJECT" AND IS
           INVOKED BY ICUOM71CP.  PROGRAMMERS USE THIS FUNCTION BY
           FILLING INPUT FIELDS AND "PERFORMING" THE 2000-ICUOM-OBJECT
           ROUTINE, WHICH IS LOCATED IN ICUOM71CP.

           SEE THE DOCUMENTATION IN THE HEADER OF ICUOM71CP FOR A FULL
           DESCRIPTION OF USAGE AND REQUIREMENTS.

           THIS PROGRAM IS NOT MEANT TO BE USED AS A STAND ALONE
           PROGRAM BUT A TOOL FOR PROGRAMMERS TO PERFORM UNIT OF
           MEASURE FUNCTIONS BASED ON ITEM INFORMATION PASSED FROM
           ICUOM71CP.  FOR TESTING PURPOSES ICI1 MAY BE RUN BY ITSELF
           WITH THE USER MANUALLY FILLING IN ITEM INFORMATION TO THE
           SCREEN FIELDS."

In normal programming use, the information within the "Unit of Measure
Information" box would be passed to this routine by the calling program either
manually or by using companion APIs to retrieve this item information which
originates in the itemmaster record.

However, in order to successfully process routines using the ICI1 screen,
because  this program does not read itemmaster records directly, the fields in
the  "Unit of Measure Information" box must be filled manually.

One caveat to entering this information manually on this screen is that when
UOM information is normally entered on the item master update screen, editing
is done to ensure accurate entry.  A suggestion for testing this screen with
valid item information is to run the IC11 Item Master screen. Inquire on an
item and then switch to the UOM tab.  Use the information from the IC11 table
to fill the table on ICI1.

CONVERT
    This function takes an input UOM or input UOM multiplier, and a quantity
and converts them to an alternate UOM that you specify in the sub function
code.

    REQUIRED INPUT
        UOM or multiplier to convert from
        Quantity to convert from
        To UOM or To Multiplier required for the ALT sub function only

    OPTIONAL INPUT
        Unit Cost to convert from

    OUTPUT
        UOM converted to
        Multiplier converted to
        Quantity converted to
        Unit cost converted to if a unit cost was entered in input
        A CRT-ERROR if one occurred

    SUB FUNCTIONS
        STOCK    Convert to stock unit of measure (default)
        ALT      Convert to the alternate unit of measure or multiplier
                 described in the TO UOM or TO MULTIPLIER fields
        TRANS    Convert to the default trans UOM for this item
        SELL     Convert to the default sell UOM for this item
        SELL-PRI Convert to the default sell pri UOM for this item
        BUY      Convert to the default buy UOM for this item

DEFAULT
    This function returns the default unit of measure and multiplier for the
specified sub function.  The defaults are determined by the flags set in the
UOM table.
    For example, under the buy column there is a flag which describes how the
unit of measure in the UOM column is to be treated in the Inventory Control
application.  A "1" indicates that this unit of measure is valid and that it
is the default (only a single "1" may exist under the buy column for any
item), "2" indicates a valid buy unit of measure, and a space means that this
is an invalid buy unit of measure.

    REQUIRED INPUT
        A sub-function to describe which default to return

    OUTPUT
        The default unit of measure requested in sub-function
        The corresponding multiplier for the default unit of measure

    SUB FUNCTIONS
        TRANS    Return the default trans UOM and multiplier
        SELL     Return the default sell UOM and multiplier
        SELL-PRI Return the default sell price UOM and multiplier
        BUY      Return the default buy UOM and multiplier

VALIDATE
    This function takes a input unit of measure and validates it according to
the specified sub function, using the flags in the UOM information table for
that item.
    For example, to validate that the UOM "EACH" is a valid buy unit of
measure the routine looks at the value in the buy flag field for the unit of
measure "EACH".  If this value is a "1" or a "2", this indicates a valid buy
unit of measure.  If the entered unit of measure is not valid, then an error
message is sent.

    REQUIRED INPUT
        A sub function to describe the type of validation (alt is default)
        An input UOM to be validated

    OUTPUT
        An error message (number and category) is returned if the unit of
        measure is invalid
        If the unit of measure is valid, then a multiplier is returned

    SUB FUNCTIONS
        ALT      Validate that the UOM is an alternate UOM (default)
        ALT-STK  Validate that the UOM is an alternate stock UOM
        TRANS    Validate that the UOM is a trans UOM
        SELL     Validate that the UOM is a sell UOM
        SELL-PRI Validate that the UOM is a sell price UOM
        BUY      Validate that the UOM is a buy UOM

QUERY
    This function is a unit of measure query that will return a value of TRUE
or FALSE in the QUERY-FL field.  The goal of the query is described by the sub
function.

    REQUIRED INPUT
        A sub function to describe the query

    OUTPUT
        The query flag is set to either true or false

    SUB FUNCTIONS
        ALT-STK    Inquire whether this item has alternate stock units of
                   measure other than the stock unit of measure itself.
                   Meaning, is the tracking flag set on any other UOM.

Updated Files

    CKPOINT    -


Referenced Files

    ICCOMPANY  -

    ITEMLOC    -

    ITEMMAST   -

    POITEMVEN  -

    PROCUREGRP -


Calling Programs

    AP251
    AP26
    AP27
    AP30
    BL200
    BL21
    BL29
    BL30
    BL31
    BL32
    BL40
    BL45
    BL46
    BL47
    BL850
    BL90
    BL92
    CXCP
    IC100
    IC12
    IC202
    IC21
    IC22
    IC235
    IC240
    IC253
    IC26
    IC28
    IC293
    IC31
    IC381
    IC40
    IC42
    IC44
    IC45
    IC510
    IC628
    IC72
    IC74
    IC81
    IC822
    IC830
    IC90
    ICI4
    ICI5
    ICI6
    ICI7
    ICI8
    ICIC
    MA538
    MA600
    MA61
    MA63
    MA65
    MA66
    MA67
    MA70
    MA75
    MA80
    MAI1
    OE10
    OE11
    OE139
    OE14
    OE30
    OE540
    OE81
    OE900
    PC20
    PO135
    PO157
    PO160
    PO20
    PO21
    PO226
    PO237
    PO250
    PO26
    PO290
    PO305
    PO310
    PO32
    PO33
    PO34
    PO35
    PO36
    PO38
    PO39
    PO44
    PO50
    PO52
    PO630
    PO64
    PO67
    PO943
    POCP
    POI3
    POI7
    POID
    POIE
    POIH
    POII
    POIJ
    RQ10
    RQ11
    RQ12
    RQ13
    RQ350
    RQ39
    RQ40
    RQ41
    RQ42
    RQ44
    RQ50
    RQIC0
    RQID
    RQIF
    RQIG
    RQIH
    RQIJ
    WH200
    WH252
    WH30
    WH31
    WH32
    WH33
    WH34
    WH40
    WO200
    WO30
    WO32
    WO35
    WO40
    WO41
    WO42
    WO45
    WOEX
    WOSP