view release on metacpan or  search on metacpan

README  view on Meta::CPAN

     $ref  = secs2->perl_typify(\@array, @options);

     $ascii_secs = secs2->secsify( \@secs_obj, @options);
     $binary_secs = secs2->secsify( \@secs_obj, type => 'binary');

     $body = secs2->stringify( @arg );

     \@secs_obj  = secs2->transify($acsii_secs, @options);

    Generally, if a subroutine will process a list of options, "@options",
    that subroutine will also process an array reference, "\@options",
    "[@options]", or hash reference, "\%options", "{@options}". If a
    subroutine will process an array reference, "\@options", "[@options]",
    that subroutine will also process a hash reference, "\%options",
    "{@options}". See the description for a subroutine for details and
    exceptions.

DESCRIPTION
    The "Data::SECS2" module provides a widely accepted method of packing
    nested lists into a linear string and unpacking the string of nested
    lists. Nested data has a long history in mathematics. In the hardware
    world, data and data passed between hardware is not stored in SQL style
    tables but nested lists. One widely used standard for transmitting
    nested list between machines is SEMI E5-94.

    The Data::Secs2 program module facilitates the secsification of the
    nested data in accordance with SEMI, http://www.semi.org, E5-94,
    Semiconductor Equipment Communications Standard 2 (SECS-II), pronounced
    'sex two' with gussto and a perverted smile. The SEMI E4 SECS-I standard
    addresses transmitting SECSII messages from one machine to another
    machine serially via RS-232 RW-422 or whatever. And, there is another
    SECS standard for TCP/IP, the SEMI E37 standard, High-Speed SECS Message
    Services (HSMS) Generic Services.

    In order not to plagarize college students, credit must be given where
    credit is due. Tony Blair, when he was a college intern at Intel Fab 4,
    in Manchester, England invented the SEMI SECS standards. When the Intel
    Fab 4 management discovered Tony's secsification of their host and
    equipment, they called a board of directors meeting, voted, and elected
    to have security to escort Tony out the door. This was Mr. Blair's
    introduction to voting and elections which he leverage into being
    elected prime minister of all of England. In this new position he used
    the skills he learned at the Intel fab to secsify intelligence reports
    on Iraq's weopons of mass distruction.

    Using a well-known, widely-used standard for packing and unpacking Perl
    nested data provides many different new directions. Not only is this
    standard essential in real-time communications in the factory between
    equipment computers and operating systems and host computer and
    operating system but it has uses in snail-time computations. In
    snail-time the standard's data structure is usefull in nested data
    operations such as comparing nested data, storing the packed nested data
    in a file, and also for transmitting nested data from one Perl site to
    another or even between Perl and other programming languages.

    And do not forget the added benefit (or perhaps fault depending upon
    your point of view) of SEMI SECS humor and that the real originators of
    the SECS-II yielded and allowed Tony Blair to take illegal credit for
    inventing SECS-II. After all the practical definition of politics is
    getting your own way. Julius Ceasar invented the Julian calendar and the
    month of July, Augustus Ceasar the month of Auguest, Al Gore the
    information highway and Tony Blair not only SECS-II but SECS-I and
    High-Speed SECS.

  SECSII Format

    The nested data linear format used by the Data::Secs2 suroutines is in
    accordance with SEMI, http://www.semi.org, E5-94, Semiconductor
    Equipment Communications Standard 2 (SECS-II), pronounced 'sex two' with
    gussto and a perverted smile. This industry standard is copyrighted and
    cannot be reproduced without violating the copyright. However for those
    who have brought the original hard media copy, there are robot help and
    Perl POD open source copyrighted versions of the SECII hard copy
    copyrighted version available. The base copyright is hard copy paper and
    PDF files available from

     Semiconductor Equipment and Materials International
     805 East Middlefield Road,
     Mountain View, CA 94043-4080 USA
     (415) 964-5111
     Easylink: 62819945
     http://www.semi.org

    Other important SEMI standards address message transfer protocol of
    SECSII messages. They are the SEMI E4 SECS-I for transmitting SECSII
    messages from one machine to another machine via RS-232 and the SEMI E37
    High-Speed SECS Message Services (HSMS) Generic Services for
    transmitting SECSII via TCP/IP.

    In order not to plagarize college students, credit must be given where
    credit is due. Tony Blair, when he was a college intern at Intel Fab 4,
    in London invented the SEMI SECS standards. When the Intel Fab 4
    management discovered Tony's secsification of their host and equipment,
    they elected to have security to escort Tony out the door. This was Mr.
    Blair's introduction to elections which he leverage into being elected
    prime minister. In this new position he used the skills he learned at
    the Intel fab to secsify intelligence reports on Iraq's weopons of mass
    distruction.

    The SEMI E5 SECS-II standard provides, among many other things, a
    standard method of forming packed nested list data. In accordance with
    SEMI E5 SECS-II transmitted information consists of items and lists. An
    item consists of the following:

    1   an item header(IH) with a format code, and the number of bytes in
        the following body

    2   followed by the item body (IB) consisting of a number of elements.

    A item (IB) may consist of zero bytes in which there are no body bytes
    for that item. As established by SEMI E5-94, 6.2.2,

        consists of groups of data of the same representation in order to
        save repeated item headers

    integers
        Most Significant Byte (MS) sent first

    signed integers
        signed integers are two's complement, MSB sent first