GRP_LISTF - Write names to a specified text file

Description:

A text file is created with the specified name. The supplied comment is written to the file as the first record (so long as it is not blank), using the groups current comment character (see routine GRP_SETCC). All the names stored within the specified group section are then written to the file, one name per record. If the group is case insensitive (as set up by a call to routine GRP_SETCS) then the names are written out in upper case, otherwise they are written out as supplied.

The routine GRP_LIST can be used if the file name is to be obtained through the parameter system.

Invocation:

CALL GRP_LISTF( FILENM, INDXLO, INDXHI, COMNT, IGRP, STATUS )

Arguments:

FILENM = CHARACTER $*$ ( $*$ ) (Given)

The name of the text file to be created.

INDXLO = INTEGER (Given)

The low index limit of the group section. If both INDXLO and INDXHI are zero, then the entire group is used.

INDXHI = INTEGER (Given)

The high index limit of the group section.

COMNT = CHARACTER $*$ ( $*$ ) (Given)

A comment line to form the first record in the file. The text is prefixed with a the groups current comment character before being written to the file.

IGRP = INTEGER (Given)

The GRP identifier for the group to be listed.

STATUS = INTEGER (Given and Returned)

The global status.