The DELGROUP service deletes SCLM-controlled database components associated with a specified group or groups matching a specified pattern. You can delete a member or members and all associated SCLM accounting information and build map records whose names match the selection criteria. You can further specify whether you want everything deleted, only build outputs, only accounting information and build map records, or only build map records. You can delete backed-up packages older than a specified period. You can also specify that nothing actually be deleted, but that a deletion report be generated.

Command invocation format

>>-FLMCMD--DELGROUP,project--,-+---------+--,-+-group-+--------->
                               '-prj_def-'    '-*-----'   

                                             .-REPORT--.   
>--,-+-type-+--,-+-member-+--,-+-ACCT---+--,-+---------+-------->
     '-*----'    '-*------'    +-BMAP---+    '-EXECUTE-'   
                               +-TEXT---+                  
                               '-OUTPUT-'                  

>--,-+---------+--,-+---------+--,-+---------+--,-+---------+--->
     '-dd_list-'    '-dd_msgs-'    '-dd_rept-'    '-dd_exit-'   

>--,-+-Y-+--,-+-----------+------------------------------------><
     '-N-'    '-pack_days-'   

Call invocation format

>>-lastrc--:=--FLMLNK('DELGROUP',sclm_id--,-+-group-+----------->
                                            '-*-----'   

>--,-+-type-+--,-+-member-+--,-+-ACCT---+--,-+-EXECUTE-+-------->
     '-*----'    '-*------'    +-BMAP---+    '-REPORT--'   
                               +-TEXT---+                  
                               '-OUTPUT-'                  

>--+---------------------------------------------------------------------------------+-->
   '-,dd_list--+-------------------------------------------------------------------+-'   
               '-,dd_msgs--+-----------------------------------------------------+-'     
                           '-,dd_rept--+---------------------------------------+-'       
                                       '-,dd_exit--+---------+--+------------+-'         
                                                   '-,-+-Y-+-'  '-,pack_days-'           
                                                       '-N-'                             

>--);----------------------------------------------------------><

ISPF interface panel

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                   SCLM FLMCMD DELGROUP Service - Entry Panel
                                                                    More:     +
 Delete from Group Input:
    Project . . . SCLMTEST
    Alternate . .         
    Group . . . .                    (Group or pattern to delete)
    Type  . . . .                    (Type or pattern to delete)
    Member  . . .                    (Member or pattern to delete)

 Access key  . . . . . .                 

 Data type . .    1. Account           Delete Mode . .    1. Execute
                  2. Build map                            2. Report
                  3. Text
                  4. Output

 DD Names for output data sets:
    Error message data set           (Blank to write messages to the terminal)
    Report data set  . . .           (Blank to write report to the terminal)
 Command ===>                                                                  
  F1=HELP      F2=          F3=END       F4=DATASETS  F5=FIND      F6=CHANGE
  F9=SWAP     F10=LEFT     F11=RIGHT    F12=SUBMIT                              

Parameters

project

The project name. The maximum parameter length is 8 characters. This parameter is used for FLMCMD only.

prj_def

The project definition name used for the delete. It defaults to the project parameter. The maximum parameter length is 8 characters. This parameter is used for FLMCMD only.

sclm_id

An SCLM ID associated with a given project and project definition. The SCLM ID is generated by the INIT service. The maximum parameter length is 8 characters. This parameter is used for FLMLNK only.

group|*

The group to be deleted. Only groups that are defined in the project definition will have members deleted. Records in the VSAM data sets for groups that match the pattern but are not in the project definition are not deleted. The maximum parameter length is 17 characters. You can specify an individual group, an asterisk (*) for all groups, or a valid pattern.

Attention: If you specify an asterisk, all groups are deleted, so use extreme caution when using the asterisk.

If you use the Delete from Group Utility panel to invoke Delete from Group, you cannot specify a pattern for the group field. Pattern matches in this field are restricted because of the possible hazards of using a pattern in this field.

type|*

The type containing the members, accounting records, and build maps to be deleted. The maximum parameter length is 17 characters. You can specify an individual type, an asterisk (*) for all types, or a valid pattern. You must specify a type. Only members with types defined in the project definition will be deleted.

The member pattern must also match.

member|*

The name of the members, accounting records, and build maps to be deleted. The maximum parameter length is 17 characters. You can specify an individual member, an asterisk (*) for all members, or a valid pattern. See Selection parameters for more information about specifying wildcard characters.

The type pattern must also match.

ACCT|BMAP|TEXT|OUTPUT

Indicates which types of data SCLM is to delete.

If you specify BMAP, SCLM deletes only the group's build maps.

If you specify ACCT, SCLM deletes the group's build maps and accounting records.

If you specify TEXT, SCLM deletes the group's build maps, accounting records, and the PDS members associated with those records. If there is no build map or accounting information for a PDS member, the member is not deleted even if you specify the TEXT option.

If you specify OUTPUT, SCLM deletes the group's build outputs that match the selection criteria.

The maximum parameter length is 24 characters.

Because this service deletes information and there is no "Undelete" service, there is no default for this parameter.

Note: SCLM can continue to search for deleted data sets that were once active in the project. SCLM issues warning messages if references to deleted data sets are found.

EXECUTE|REPORT

If you specify EXECUTE, any members that match the selection criteria for the specified delete flag are deleted. A report indicating which members were deleted is produced.

If you specify REPORT, no members are deleted. Instead, SCLM produces a report indicating which members are eligible for deletion. SCLM sends this report to the default output device. Specifying REPORT is a good way to identify the outcome of the delete process before deleting any members. The maximum parameter length is 24 characters. For FLMCMD, the default value is REPORT. There is no default value for FLMLNK. You are required to have update authority to the hierarchy data sets to use the DELGROUP service in either REPORT or EXECUTE mode.

dd_list

The ddname indicating the destination of the purge listing for deletion of intermediate code. You must also specify TEXT or OUTPUT and intermediate code must be deleted to produce this report. If you specify a blank ddname, no listing is produced. Otherwise, before you call the DELGROUP service, you must allocate the ddname. The following attributes should be used: RECFM=VBA, LRECL=137, BLKSIZE=3120. The maximum parameter length is 8 characters.

dd_msgs

The ddname indicating the destination of the DELGROUP messages. If you specify a blank ddname, SCLM routes the messages to the default output device. Otherwise, before you call the DELGROUP service, you must allocate the ddname. The following attributes should be used: RECFM=F, LRECL=80, BLKSIZE=80. The maximum parameter length is 8 characters.

dd_rept

The ddname indicating the destination of the DELGROUP report. If you specify a blank ddname, SCLM sends the DELGROUP report to the default output device, such as your terminal. Otherwise, before you call the DELGROUP service, you must allocate the ddname; the following attributes should be used: RECFM=F, LRECL=80, BLKSIZE=80. The maximum parameter length is 8 characters.

dd_exit

The ddname indicating the destination of the delete user exit data. Specify this parameter only if your project definition defines a notify delete user exit routine. Ask your project manager if your project is using a notify delete user exit routine. If you specify a blank ddname, SCLM routes the delete user exit data to NULLFILE. Otherwise, before you call the DELGROUP service, you must allocate the ddname. The following attributes should be used: RECFM=FB, LRECL=160, BLKSIZE=3200. The maximum parameter length is 8 characters.

Y|N

Set to Y to delete a package and any backed up modules within that package.

pack_days

Indicates an age in days up to which packages will not be deleted. If the pack_days parameter is set, only backed up packages that are older than this value will be deleted.

Note:

1. The pack_del and pack_days parameters can only be used for deleting packages.
2. To delete packages you must specify values for group and type; "*" is not allowed. However you can specify "*" in the member name to delete all the members.
3. If the pack_del parameter is set, a DELGROUP report is not produced. If REPORT is specified, entries are added to the message file detailing the packages that will be deleted.

Return codes

Additional special services messages are written to the FLMMSGS ddname. See SCLM service messages for more information.

Other return codes might be produced by the FLMCMD or the FLMLNK processor. See SCLM service return codes for more information.

Example of command invocation

FLMCMD DELGROUP,PROJ1,,USER1,*,*,ACCT,EXECUTE

This service command deletes the build map and accounting records for all types and members that are associated with the USER1 group in the PROJ1 project. SCLM sends messages to the terminal.