# tibemsCollection_GetFirst

Function

## Purpose

Get the first object in a collection.

## C Declaration

    tibems_status tibemsCollection_GetFirst(
        tibemsCollection collection,
        collectionObj* object);

## COBOL Call

    CALL "tibemsCollection_GetFirst"
     USING BY VALUE collection,
           BY REFERENCE obj,
           RETURNING tibems-status
    END-CALL.

Note: `collection` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`collection` | Get the first object in this collection.
`object` | The function stores the first object in the collection in this location.

## Remarks

This function must be called before any calls to `tibemsCollection_GetNext`.

Copyright © Cloud Software Group, Inc. All rights reserved.