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
.-N-.
>>-FLMCMD--EXPORT,project--,-+---------+--,group--,-+---+------->
'-prj_def-' '-Y-'
>--,-+---------+--,-+---------+--------------------------------><
'-dd_msgs-' '-dd_rept-'
Call invocation format
>>-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.