# PetscObjectGetNewTag

Gets a unique new tag from a PETSc object. All processors that share the object MUST call this routine EXACTLY the same number of times. This tag should only be used with the current objects communicator; do NOT use it with any other MPI communicator.

### Synopsis

    #include "petscsys.h"
    PetscErrorCode PETSC_DLLEXPORT PetscObjectGetNewTag(PetscObject obj,PetscMPIInt *tag)

Collective on PetscObject

### Input Parameter

obj -the PETSc object; this must be cast with a (PetscObject), for example, PetscObjectGetNewTag((PetscObject)mat,&tag);

### Output Parameter

tag -the new tag

### See Also

PetscCommGetNewTag()

Level:developer
Location:src/sys/src/objects/tagm.c
Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages