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.