The IMPORT service reintroduces the exported SCLM accounting information into the context of the current project, after first verifying that this data corresponds to the current contents of the SCLM-controlled data sets.

Command invocation format

>>-FLMCMD--IMPORT,project--,-+---------+--,group---------------->
                             '-prj_def-'           

     .-'b'------.    .-'b'---------.    .-'b'----.    .-C-.   
>--,-+-authcode-+--,-+-------------+--,-+--------+--,-+---+----->
                     '-change_code-'    '-userid-'    +-U-+   
                                                      '-R-'   

>--,-+---------+--,-+---------+--------------------------------><
     '-dd_msgs-'    '-dd_rept-'   

Call invocation format

>>-lastrc--:=--FLMLNK('IMPORTbb',sclm_id--,group---------------->

>--,-+----------+--,-+-------------+--,-+--------+--,-+-C-+----->
     '-authcode-'    '-change_code-'    '-userid-'    +-U-+   
                                                      '-R-'   

>--+------------------------+--);------------------------------><
   '-,dd_msgs--+----------+-'       
               '-,dd_rept-'         

ISPF interface panel

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

 SCLM Import Criteria:
    Project . . . SCLMTEST
    Alternate . .         
    Group . . . . DEV1    

 Mode  . .    1. Conditional
              2. Unconditional
              3. Report
 Authorization code  . .           (If blank, the default auth code is used)
 Change code . . . . . .          

 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 import. 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 into which data is being imported. The maximum parameter length is 8 characters. The group must be defined in the project definition as a development group. As well, export accounting data sets must be defined for the group for import to work.

authcode

The authorization code to be used for the lock. SCLM uses the authorization code for the verification steps described in LOCK—Lock a Member or Assign an Access Key. If you do not supply an authcode for FLMCMD, or if you specify a blank for either FLMCMD or FLMLNK, SCLM uses the authorization code from the exported accounting information. The maximum parameter length is 8 characters.

change_code

If you have a change code verification routine, when you specify this parameter, you must ensure that the change code is valid. When you specify a valid change code, the IMPORT service adds the change code to each editable member's accounting record and updates the change code date and time to the change date and time from the exported accounting record. If you specify a change code that is already listed in a member's exported accounting record, the IMPORT service does not add a duplicate change code to the accounting record. It uses the one from the exported accounting record. For FLMCMD, the default value is blank; unless a change code is specified, the IMPORT service will not perform verification. There is no default value for FLMLNK.

userid

If you supply a value for this parameter, SCLM replaces the USERID field in each exported accounting record with the value supplied. If you do not specify a value, SCLM uses the user ID from the exported accounting information. The maximum parameter length is 8 characters. If no value is specified for FLMCMD or blank is specified for either FLMCMD or FLMLNK, the user ID from the exported accounting information will be used.

C|U|R

Indicates the import mode, where C=conditional, U=unconditional, and R=report. The maximum parameter length is 24 characters.

When you specify C, the IMPORT service attempts to import the specified group only when each accounting record and build map record successfully passes all the necessary verifications. The IMPORT service fails if any one of these records cannot pass verification. Thus, when you specify conditional mode, the IMPORT service imports all records or none. The IMPORT service deletes the record from the export database once it has been imported successfully into the specified group.

When you specify U, the IMPORT service performs the same set of verifications, but attempts to import the group even if one or more records do not pass verification. In this case, the IMPORT service imports only those records that passed verification and leaves the records that failed verification in the export database. In addition, IMPORT attempts to store an accounting record with a predecessor baseline date/time verification error. The IMPORT service deletes the record from the export database once it has been imported successfully into the specified group.

When you specify R, the IMPORT service performs the verification and reports the eligibility of members for import. For FLMCMD, the default value is C. There is no default value for FLMLNK.

dd_msgs

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

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 IMPORT,PROJ1,,USER1,,,,C

This service command imports data into the USER1 group in the PROJ1 project in conditional mode. SCLM sends messages and listings to the terminal.