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.