DELETE—Delete Database Components

The DELETE service deletes database components. You can delete an entire member plus its associated accounting record and build map, a member's accounting record and build map, or a member's build map.

If you delete a member from a development group, and the next higher group is non-key, you should also delete the same member from the non-key group if it exists there.

Note: The DELETE function requires update authority for the member in order to delete the build map and accounting information.

Command invocation format


>>-FLMCMD--DELETE,project--,-+---------+--,group--,type--------->
                             '-prj_def-'                  

                           .-TEXT-.   
>--,member--,access_key--,-+------+----------------------------><
                           +-ACCT-+   
                           '-BMAP-'

Call invocation format


>>-lastrc--:=--FLMLNK('DELETEbb',sclm_id--,group--,type--------->

>--,member--,access_key--,-+-ACCT-+--,$msg_array);-------------><
                           +-BMAP-+                  
                           '-TEXT-'

ISPF interface panel

Figure 1. DELETE Service panel

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                    SCLM FLMCMD DELETE Service - Entry Panel

 SCLM Library:
    Project . . . SCLMTEST
    Alternate . .         
    Group . . . . DEV1    
    Type  . . . . SOURCE  
    Member  . . .         

 Access key  . . . . . .                
 Data type . .    1. Account
                  2. Build map
                  3. Text






 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 to be used for the delete. It defaults to the project. 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 INIT service generates the SCLM ID. The maximum parameter length is 8 characters. This parameter is used for FLMLNK only.
group: The group in which the delete is to occur. The maximum parameter length is 8 characters.
type: The type containing the member, accounting record, and build map to be deleted. The maximum parameter length is 8 characters.
member: The name of the member, accounting record, and build map to be deleted. The maximum parameter length is 8 characters.
access_key: The access key assigned to the member with the LOCK service. If you supply the incorrect access key, the delete fails. The maximum parameter length is 16 characters.
ACCT|BMAP|TEXT: Indicates which types of data SCLM is to delete for the member. If you specify BMAP, SCLM deletes only the member's build map. If you specify ACCT, SCLM deletes the member's build map and accounting record. If you specify TEXT, SCLM deletes the member's build map, the member's accounting record, and the member. The maximum parameter length is 24 characters. For FLMCMD, the default value is TEXT. There is no default value for this parameter for FLMLNK.
$msg_array: An output parameter pointing to the message array. See Pointer parameter descriptions for more information about $msg_array. This parameter is used for FLMLNK only.

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.

Possible return codes are:

0: Normal completion.
4: Warning condition. The member, accounting record, or build map was not found. This return code is set whenever any of the data is missing, regardless of whether the request was for ACCT, BMAP, or TEXT.
8: Error condition. The $msg_array parameter contains the error message associated with this condition.

Example of command invocation

FLMCMD DELETE,PROJ1,,USER1,SOURCE,FLM01MD2,XXX#04,ACCT

This service command deletes the build map and accounting record for the FLM01MD2 member of the SOURCE type in the USER1 group. The project name is PROJ1. The access key for the member is XXX#04.

If the text for the member FLM01MD2 is missing, then the service returns a return code of 4, even though deletion of the text member was requested.

Example of call invocation

This example shows general syntax. Call invocations are language-specific. See Sample programs using SCLM services for specific examples.

lastrc := FLMLNK('DELETE  ',                   (* service              *)
                  sclm_id,                     (* SCLM ID              *)
                 'USER1   ',                   (* group                *)
                 'SOURCE  ',                   (* type                 *)
                 'FLM01MD2',                   (* member               *)
                 'XXX#04          ',           (* access key           *)
                 'ACCT                    ',   (* type of data to delete *)
                 $msg_array);                  (* message array pointer  *)

This service call deletes the accounting record and the build map for the FLM01MD2 member of the SOURCE type in the USER1 group. The sclm_id parameter contains a valid SCLM ID returned from the INIT service and the access key is XXX#04. SCLM returns all messages in the $msg_array.