NAME

       ms_srcname - Determine source names using the SEED naming nomenclature.

SYNOPSIS

       #include <libmseed.h>

       char  *ms_recsrcname ( char *record, char *srcname, flag quality );

       char  *msr_srcname ( MSRecord *msr, char *srcname, flag quality );

       char  *mst_srcname ( MSTrace *mst, char *srcname, flag quality );

DESCRIPTION

       These  routines  generate  a source name using the SEED naming nomenclature in the format:
       'NET_STA_LOC_CHAN' and stores it in the buffer provided at srcname.  If the  quality  flag
       is  true  the  data  quality  character will be appended to the source name resulting in a
       format of: 'NET_STA_LOC_CHAN_QUAL'.

       The memory pointed to by srcname must have enough room for the resulting  string.   As  of
       SEED  2.4 this is a maximum of 18 characters including the terminating NULL.  The MSRecord
       and MSTrace structs are capable of producing a source name of 42 characters (including the
       terminating NULL) and libmseed commonly allocates 50 characters for the srcname buffer.

       ms_recsrcname  generates  a source name string for the SEED data record at record.  If the
       quality flag is true the quality character will be appended.

       msr_srcname generates a source name string for the  specified  MSRecord  struct.   If  the
       quality flag is true the quality character will be appended.

       mst_srcname  generates  a  source name string in for the specified MSTrace struct.  If the
       quality flag is true *and* mst->dataquality is not zero  the  quality  character  will  be
       appended.

LOCATION IDS AND SPACES

       The  source name produced by these routines never include spaces.  The fixed format nature
       of SEED data records leads to blank or unused location IDs represented  by  spaces.   Such
       blank location IDs will be collapsed to nothing in the resulting sources names.

RETURN VALUES

       The routines return a pointer to the resulting string or NULL on error.

AUTHOR

       Chad Trabant
       IRIS Data Management Center