B Classified List of Routines

B.1 Creating and Deleting Groups

GRP_DELET( IGRP, STATUS )
    Delete a group
GRP_COPY( IGRP1, INDXLO, INDXHI, REJECT, IGRP2, STATUS )
    Create a new group containing a copy of a section of an old group
GRP_NEW( TYPE, IGRP, STATUS )
    Create a new, empty group
GRP_PURGE( IGRP1, IGRP2, STATUS )
    Remove duplicate entries from a group, putting the results in a new group
GRP_REMOV( IGRP1, NAME, IGRP2, STATUS )
    Remove all occurrences of a given name from a group, putting the results in a new group

B.2 Enquiring Group Attributes

GRP_GETCC( IGRP, CCLIST, CC, STATUS )
    Return control characters for a given group
GRP_GETCS( IGRP, SENSIT, STATUS )
    Determine if a group is case sensitive or not
GRP_GRPSZ( IGRP, SIZE, STATUS )
    Return the current size of a group
GRP_GTYPE( IGRP, TYPE, STATUS )
    Return the type string stored with a group
GRP_HEAD( IGRP1, IGRP2, STATUS )
    Find the group at the head of an owner-slave chain
GRP_OWN( IGRP1, IGRP2, STATUS )
    Return the identifier of the group which “owns” a specified group
GRP_SLAVE( IGRP1, IGRP2, STATUS )
    Return the identifier of the group which is owned by a specified group
GRP_VALID( IGRP, VALID, STATUS )
    Check if a group identifier is valid

B.3 Setting Group Attributes

GRP_DELET( IGRP, STATUS )
    Delete a group
GRP_PTYPE( IGRP, TYPE, STATUS )
    Store a new type string with a group
GRP_SETCC( IGRP, CCLIST, CC, STATUS )
    Set up new control characters for a group
GRP_SETCS( IGRP, SENSIT, STATUS )
    Establish a group as case sensitive or case insensitive
GRP_SETSZ( IGRP, SIZE, STATUS )
    Reduce the size of a group
GRP_SOWN( IGRP1, IGRP2, STATUS )
    Establish one group as “owner” of another group

B.4 Enquiring Name Attributes

GRP_INDEX( NAME, IGRP, START, INDEX, STATUS )
    Find the index of a given name within a group
GRP_INFOC( IGRP, INDEX, ITEM, VALUE, STATUS )
    Return an item of character information relating to a specific name
GRP_INFOI( IGRP, INDEX, ITEM, VALUE, STATUS )
    Return an item of integer information relating to a specific name

B.5 Retreiving Names

GRP_GET( IGRP, INDEX, SIZE, NAMES, STATUS )
    Retrieve names from a group
GRP_INFOC( IGRP, INDEX, ITEM, VALUE, STATUS )
    Return an item of character information relating to a specific name
GRP_LIST( PARAM, INDXLO, INDXHI, COMNT, IGRP, STATUS )
    Write all the names in a group out to a text file specified by the environment
GRP_LISTF( FILENM, INDXLO, INDXHI, COMNT, IGRP, STATUS )
    Write all the names in a group out to a text file specified by the calling application
GRP_MSG( TOKEN, IGRP, INDEX )
    Assign a group element to a message token

B.6 Storing Names

GRP_COPY( IGRP1, INDXLO, INDXHI, REJECT, IGRP2, STATUS )
    Create a new group containing a copy of a section of an old group
GRP_GROUP( PARAM, IGRP1, IGRP2, SIZE, ADDED, FLAG, STATUS )
    Add names obtained from the environment into a group
GRP_GRPEX( GRPEXP, IGRP1, IGRP2, SIZE, ADDED, FLAG, STATUS )
    Add names specified by a given group expression into a group
GRP_PUT( IGRP, SIZE, NAMES, INDEX, STATUS )
    Store a list of explicit names in a group
GRP_PUT1( IGRP, NAME, INDEX, STATUS )
    Store a single name in a group

B.7 Deleting Names

GRP_COPY( IGRP1, INDXLO, INDXHI, REJECT, IGRP2, STATUS )
    Create a new group containing a copy of a section of an old group
GRP_PURGE( IGRP1, IGRP2, STATUS )
    Remove duplicate entries from a group, putting the results in a new group
GRP_REMOV( IGRP1, NAME, IGRP2, STATUS )
    Remove all occurrences of a given name from a group, putting the results in a new group
GRP_SETSZ( IGRP, SIZE, STATUS )
    Reduce the size of a group

B.8 Creation and Control of Identifiers

GRP_DELET( IGRP, STATUS )
    Delete a group
GRP_COPY( IGRP1, INDXLO, INDXHI, REJECT, IGRP2, STATUS )
    Create a new group containing a copy of a section of an old group
GRP_NEW( TYPE, IGRP, STATUS )
    Create a new, empty group
GRP_PURGE( IGRP1, IGRP2, STATUS )
    Remove duplicate entries from a group, putting the results in a new group
GRP_REMOV( IGRP1, NAME, IGRP2, STATUS )
    Remove all occurrences of a given name from a group, putting the results in a new group
GRP_VALID( IGRP, VALID, STATUS )
    Check if a group identifier is valid

B.9 ADAM Parameter System Routines

GRP_GROUP( PARAM, IGRP1, IGRP2, SIZE, ADDED, FLAG, STATUS )
    Add names obtained from the environment into a group
GRP_LIST( PARAM, INDXLO, INDXHI, COMNT, IGRP, STATUS )
    Write all the names in a group out to a text file specified by the environment

B.10 Debugging Routines

GRP_ALARM( IGRP, EVENT, STATUS )
    Notify the user of an event in the life of a watched group
GRP_WATCH( IGRP, STATUS )
    Watch for events in the life of a specified group