z/OS ISPF Software Configuration and Library Manager Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


EXPORT—Extract SCLM Accounting Information for a Group

z/OS ISPF Software Configuration and Library Manager Guide and Reference
SC19-3625-00

The export service captures all SCLM accounting and build map information associated with a specified group. You can use this service with the IMPORT service to create a consistent set of data that can be archived or used to create a new release, rename a group, or transport software from one hierarchy to another. Although the SCLM Migration Utility provides a similar function, using the EXPORT and IMPORT services allows you to save build maps. Data presently residing in the group specified is not changed by this service.

Command invocation format

Read syntax diagramSkip visual syntax diagram
                                                    .-N-.   
>>-FLMCMD--EXPORT,project--,-+---------+--,group--,-+---+------->
                             '-prj_def-'            '-Y-'   

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

Call invocation format

Read syntax diagramSkip visual syntax diagram
>>-lastrc--:=--FLMLNK('EXPORTbb',sclm_id--,group--,-+-Y-+------->
                                                    '-N-'   

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

ISPF interface panel

Figure 1. EXPORT Service panel
   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                    SCLM FLMCMD EXPORT Service - Entry Panel

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

 Enter "/" to select option
    Replace export data

 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 export. It defaults to the project definition. 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 exported. The maximum parameter length is 8 characters. The group must be defined in the project definition. The group must have export VSAM data sets defined in the project definition.
Y|N
Indicates whether to purge previously exported data from the export data sets for the group. The export data sets must be empty before new export data can be stored in them. If you specify Y, SCLM attempts to purge the data in the data sets. If you specify Y and the purge fails, the export does not occur. If you specify N, SCLM assumes that the export data sets are empty and does not attempt to purge the data sets. If the export data sets are not empty, the export does not occur. The maximum parameter length is 24 characters. For FLMCMD, the default value is N. There is no default value for FLMLNK.
dd_msgs
The ddname indicating the destination of the export messages. If you specify a blank ddname, SCLM routes the export messages to the default output device, such as your terminal. Otherwise, before you call the EXPORT 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 export report. If you specify a blank ddname, SCLM routes the export report to the default output device, such as your terminal. Otherwise, before you call the EXPORT 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.

Possible return codes are:
0
Normal completion. See the SCLM messages for more information.
4
Warning condition. See the SCLM messages for more information.
8
Error condition. See the SCLM messages for more information.
12
Severe error condition. SCLM does not produce messages because there was an error invoking the EXPORT module.
16
Severe error condition. SCLM does not produce messages because it was unable to retrieve SCLM ID information.

Example of command invocation

FLMCMD EXPORT,PROJ1,,USER1,Y

This service command exports the USER1 group of the PROJ1 project. The export data sets are purged of any existing information before the SCLM accounting information is exported. SCLM sends messages and the report to the terminal.

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('EXPORT  ',                  (* service             *)
                 sclm_id,                     (* SCLM ID             *)
                 'USER1   ',                  (* group               *)
                 'Y                       ',  (* purge exported data *)
                 'EXPMSGS ',                  (* messages            *)
                 'EXPREPT ');                 (* report              *)

This service call exports the USER1 group. The sclm_id parameter contains a valid SCLM ID returned from the INIT service. The export data sets are purged of any existing information before the SCLM accounting information is exported. SCLM sends messages and the report to the terminal.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014