The MIGRATE service creates or updates SCLM accounting information for members in a development library that match a given pattern.

MIGRATE checks each member whose name matches the pattern for valid SCLM accounting information. If a selected member does not have valid accounting information or if Forced mode is specified, MIGRATE invokes the SAVE service to lock, parse, and store the member. All of the rules and restrictions that apply to the SAVE service also apply to the MIGRATE service.

For more information about the SAVE, LOCK, PARSE, and STORE services, see their service descriptions in this chapter.

Command invocation format

>>-FLMCMD--MIGRATE,project,-+---------+--,group,type,member----->
                            '-prj_def-'                       

                                                        .-C-.   
>--,-+----------+--,-+----------+--,-+-------------+--,-+---+--->
     '-authcode-'    '-language-'    '-change_code-'    +-U-+   
                                                        '-F-'   

>--,-+------------+--,-+------------+--,-+------------+--------->
     '-dd_migmsgs-'    '-dd_miglist-'    '-dd_migrept-'   

>--,-+------+--,-+------+--,-+------------+--------------------><
     '-date-'    '-time-'    '-subproject-'   

Call invocation format

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

                                         .-C-.   
>--,authcode--,language--,change_code--,-+---+------------------>
                                         +-U-+   
                                         '-F-'   

>--,-+------------+--,-+------------+--,-+------------+--------->
     '-dd_migmsgs-'    '-dd_miglist-'    '-dd_migrept-'   

>--,-+------+--,-+------+--,-+------------+-);-----------------><
     '-date-'    '-time-'    '-subproject-'      

ISPF interface panel

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

 Authorization code  . .           (If blank, the default auth code is used)
 Language  . . . . . . . COB     
 Change code . . . . . .         

 Mode  . .    1. Conditional
              2. Unconditional
              3. Forced

 Accounting date for migrate . . . .             (Blank to use current date)
 Accounting time for migrate . . . .           (Blank to use current time)
 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 the lock, parse, and store of migrated members. It defaults to the project parameter. The maximum parameter length is 8 characters.

group

The group in which the migration is to occur. The specified group must be a development group. The maximum parameter length is 8 characters.

type

The type containing the members. The maximum parameter length is 8 characters.

member

A pattern used to select the members to be migrated. The maximum parameter length is 10 characters. You must specify a valid member name or valid pattern, or an error message appears.

authcode

The authorization code to be used for locking selected members. If you do not supply an authcode or the authcode is blank, SCLM uses default values as follows:

• The authorization code from the existing member if the member being migrated 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.

language

The language of the member. The maximum parameter length is 8 characters. You must specify the language the first time you save a member.

change_code

A change_code to be added to the information obtained by parsing the member. 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.

C|U|F

Indicates the migrate mode (C=Conditional; U=Unconditional; F=Forced). The maximum parameter length is 24 characters. The default value for FLMCMD is C. There is no default value for FLMLNK.

dd_migmsgs

The ddname indicating the destination of the messages generated by the MIGRATE service. If you specify a blank ddname, SCLM routes the MIGRATE service messages to the default output device, such as your terminal. Otherwise, before you call the MIGRATE 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_miglist

The ddname indicating the destination of the parser listings. If you specify a blank ddname, SCLM does not generate the parser listings. The maximum parameter length is 8 characters.

If the parser for the specified language does not produce a listing, specify a blank ddname. The language parsers supplied by SCLM do not produce a listing. If the parser for the specified language does produce a listing and you specified a ddname, allocate the ddname with the attributes required by the parser. Project-specific parsers can produce a listing. See FLMTRNSL macro for more information about project-defined parsers.

dd_migrept

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

date

The date to assign to the accounting record and member statistics. Use this field if you want to keep audit records and versions from another library system. The date defaults to the current date. This parameter is required if the "time" parameter is entered. The parameter length is 10 characters. The date, with a 4-character year, must be specified in the national language format.

time

The time to assign to the accounting record and member statistics. This parameter is required if the "date" parameter is entered. The time must be specified in the national language format. The parameter length is 8 characters.

subproject

The name of the subproject to be assigned to the member. This parameter must only be specified if the SCLM project has been defined with subprojects. For more information about subprojects, see SCLM security.

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

FLMCMD MIGRATE,PROJ1,,USER1,SOURCE,MOD*,TESTAC,COBOL,CC001234,,,PARSEDD

This service command migrates (locks, parses, and stores accounting information) members with names beginning MOD (such as MOD1, MOD2, or MODULE) of the type SOURCE in the USER1 group. The project name is PROJ1 and the authorization code is TESTAC. Change code CC001234 is to be added to the information obtained by parsing the member with the COBOL parser.

SCLM copies parser listings to the PARSEDD ddname only if errors occur. You must allocate the PARSEDD ddname before you call the service.

Messages generated by the MIGRATE service appear on the default output device. This is probably the terminal if you are running under a foreground TSO session.