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

    None.


Referenced Files

    ICCOMPANY  -

    ITEMLOC    -

    ITEMMAST   -

    POITEMVEN  -

    PROCUREGRP -


Calling Programs

    AP201
    AP21
    AP23
    AP25
    AP26
    AP27
    AP30
    API1
    BL200
    BL21
    BL297
    BL30
    BL31
    BL32
    BL40
    BL45
    BL46
    BL47
    BL850
    BL90
    BL92
    CXCP
    IC12
    ICI42
    ICI5
    ICI6
    ICI7
    ICI8
    ICIC
    MA418
    MA43
    MA53
    MA600
    MA61
    MA63
    MA65
    MA66
    MA67
    MA68
    MA70
    MA75
    MA80
    MAI1
    PD10
    PD200
    PO135
    PO159
    PO160
    PO200
    PO21
    PO226
    PO237
    PO244
    PO25
    PO26
    PO27
    PO287
    PO290
    PO305
    PO310
    PO32
    PO33
    PO34
    PO35
    PO36
    PO38
    PO39
    PO44
    PO50
    PO52
    PO630
    PO64
    PO67
    PO943
    POCP
    POI3
    POI7
    POID
    POIH
    POII
    POIJ
    RQ10
    RQ11
    RQ12
    RQ13
    RQ355
    RQ39
    RQ44
    RQ50
    RQIC0
    RQID
    RQIF
    RQIG
    RQIH
    RQIJ
    WH200
    WH252
    WH30
    WH31
    WH32
    WH33
    WH34
    WH40
    WH830