The EDIT service brings up an SCLM edit session for the requested member. All of the functions of the SCLM edit panel are available from the edit service, including locking, parsing, and storing SCLM accounting data. The SCLM edit commands, such as SPROF, SCREATE, SREPLACE, and SMOVE, are the same as from the SCLM edit dialog.

Command invocation format

>>-FLMCMD--EDIT,project--,-+---------+--,group1--,-+--------+--->
                           '-prj_def-'             '-group2-'   

                                                 .-N-.   
>--,-+--------+--,-+--------+--,type--,member--,-+---+---------->
     '-group3-'    '-group4-'                    '-Y-'   

                             .-Y-.    .-N-.    .-N-.    .-N-.   
>--,-+------+--,-+------+--,-+---+--,-+---+--,-+---+--,-+---+--->
     '-imac-'    '-prof-'    '-N-'    '-Y-'    '-Y-'    '-Y-'   

>--,-+----------+--,-+---------+--,-+--------+------------------>
     '-authcode-'    '-chgcode-'    '-volser-'   

>--,-+-------------+-------------------------------------------><
     '-dd_editmsgs-'   

Call invocation format

>>-lastrc--:=--FLMLNK('EDIT',sclm_id--,group1--,group2---------->

>--,group3--,group4--,type--,member--,-+-Y-+--,imac--,prof------>
                                       '-N-'                 

>--,-+-Y-+--,-+-Y-+--,-+-Y-+--,-+-Y-+--------------------------->
     '-N-'    '-N-'    '-N-'    '-N-'   

>--+---------------------------------------------------------+-->
   '-,authcode--+------------------------------------------+-'   
                '-,chgcode)--+---------------------------+-'     
                             '-,volser--+--------------+-'       
                                        '-,dd_editmsgs-'         

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

ISPF interface panel

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                     SCLM FLMCMD EDIT Service - Entry Panel
                                                                    More:     +
 SCLM Library:
    Project . . . SCLMTEST
    Alternate . .         
    Group . . . . DEV1      . . . TEST     . . . RELEASE  . . .         
    Type  . . . . SOURCE                                 
    Member  . . .          

 Initial Macro . . . . .         
 Profile Name  . . . . .           (If blank, defaults to data set type)

 Options
    Allocate Hierarchy
 /  Confirm Cancel/Move/Replace
    Mixed Mode
    Edit on Workstation
    Preserve VB record length

 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.

prj_def

The project definition name to be used for edit. It defaults to project. The maximum parameter length is 8 characters.

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.

group1

The development group at which the member is to be edited. The maximum parameter length is 8 characters.

group2

Name of the second group in the concatenation. The maximum parameter length is 8 characters.

group3

Name of the third group in the concatenation. The maximum parameter length is 8 characters.

group4

Name of the fourth group in the concatenation. The maximum parameter length is 8 characters.

type

The type containing the member to be edited. The maximum parameter length is 8 characters.

member

The member to be edited. The maximum length for this parameter is 8 characters.

Y|N

Y indicates that SCLM will allocate the entire hierarchy, beginning with group1. If Y is selected, group2, group3 and group4 must be blank. N indicates that SCLM will allocate only group1, group2, group3, and group4 (default).

imac

The name of an initial macro to be run. The maximum parameter length is 8 characters.

prof

The edit profile name to use for the edit session. The maximum parameter length is 8 characters.

Y|N

Y indicates that you will have an opportunity to confirm cancel, move, and replace (default). N indicates that cancel, move, and replace commands will execute without confirmation. The maximum parameter length is 24 characters.

Y|N

Y indicates that mixed edit mode is to be used. N indicates that mixed edit mode is not to be used (default). The maximum parameter length is 24 characters.

Y|N

Y indicates that the data will be edited on the workstation. N indicates that the data will be edited on the host (default). The maximum parameter length is 24 characters.

Y|N

Y indicates that the length of variable blocked data will be preserved. N indicates that blanks at the end of the data are retained (default). The maximum parameter length is 24 characters.

authcode

The authorization code to be used for the edit session. SCLM uses the authorization code for the verification just like the SCLM edit dialog. If you do not enter a blank or do not supply an authcode SCLM uses one of the following default values:

• The authorization code from the existing member, if the member being edited exists in the hierarchy.
• The default authorization code for the group if the member does not exist in the hierarchy.

The maximum parameter length is 8 characters.

chgcode

The default change code for the edit session. If the member's accounting record lists the change code, SCLM updates the date and time stamps for the existing change code entry. The maximum parameter length is 8 characters.

volser

Volume serial for parser listings data set. The maximum parameter length is 8 characters.

dd_editmsgs

DDNAME of the destination of the edit messages. Allocate this ddname with DISP=MOD. The maximum parameter length is 8 characters.

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 format

FLMCMD EDIT,sclm70,sclm7044,user,,,,SOURCE,A,Y

This service command edits SCLM70.USER.SOURCE(A), drawing down member a from the hierarchy, if it is not in group USER. Alternate SCLM7044 is used to determine the hierarchy.

Call invocation format

CALL FLMLNK('EDIT ',SLMID,'USER ',BLNK8,BLNK8,BLNK8,
   'SOURCE ','A ',Y,BLNK8,BLNK8,
   Y,N,N,N,'PRIVATE ','R8EDS ',BLNK8,
   DDEDIT)
   RETCODE(R15);

This service call edits member A in group USER with type SOURCE, drawing down member EDIT service. The example assumes that the START and INIT services have already completed successfully, so that the SLMID value is valid.

The ddname DDEDIT has been allocated to a data set with valid characteristics.

The authcode is set to 'PRIVATE' and the change code is set to 'R8EDS'.