next up previous 204
Next: GRP_OWN - Returns the identifier of the group which owns the specified group
Up: Routine Descriptions
Previous: GRP_LISTF - Write names to a specified text file


GRP_NEW - Create a new empty group

Description:
A new empty group is created and an identifier to it is returned in IGRP. The string supplied in TYPE is stored with the group, and should be used to store a description of the contents of the group (see also routines GRP_GTYPE and GRP_PTYPE).

The created group has the default control characters described in routine GRP_SETCC, and has no "owner" group (see GRP_OWN).


Invocation:
CALL GRP_NEW( TYPE, IGRP, STATUS )

Arguments:

TYPE = CHARACTER $*$ ( $*$ ) (Given)
A descriptive string to be associated with the group. The maximum length for a TYPE string is given by GRP__SZTYP. Supplied characters beyond this length are ignored.
IGRP = INTEGER (Returned)
An identifier for the created group. GRP__NOID is returned if an error occurs.
STATUS = INTEGER (Given and Returned)
The global status.



next up previous 204
Next: GRP_OWN - Returns the identifier of the group which owns the specified group
Up: Routine Descriptions
Previous: GRP_LISTF - Write names to a specified text file

GRP Routines for Managing Groups of Objects
Starlink User Note 150
D.S. Berry
21st October 2009
E-mail:ussc@star.rl.ac.uk

Copyright © 2009 Science and Technology Facilities Council